Los archivos XSD de extensión personalizada se utilizan para definir el esquema de
extensión personalizada.
Los archivos XSD de extensión personalizada se utilizan para definir un esquema de extensión
personalizada, incluidos los nuevos tipos de propiedad, entidad y control.
Virtual member manager proporciona un archivo XSD de extensión de ejemplo denominado
wimextension.xsd con el URI de espacio de nombres, http://www.yourco.com/wim/ext. Puede crear sus
propios archivos XSD, siempre y cuando importe el esquema incorporado de virtual member manager
(wimdatagraph.xsd) y tenga un espacio de nombres distinto del espacio de nombres incorporado de
virtual member manager, http://www.ibm.com/websphere/wim.
Nota: Los archivos
wimdatagraph.xsd y de soporte ahora se encuentran en el directorio VMM_SCHEMA_HOME/model. Si ya
utilizaba el archivo wimextension.xsd antes de actualizar a WebSphere Application Server versión 7,
debe actualizar el archivo wimextension.xsd para que apunte a la nueva ubicación del archivo
wimdatagraph.xsd después de actualizar a WebSphere Application Server
versión 7.
Puede colocar los archivos XSD de extensión personalizada en cualquier lugar; sin embargo, debe
definir la vía de acceso del archivo wimconfig.xml para que ese virtual member manager pueda
encontrar los archivos. Si los archivos XSD de extensión se encuentran en el directorio
<VMM_HOME>\model, no es necesario definir la vía de acceso.
Nota: VMM_HOME
es el directorio donde se encuentra el archivo de esquema de extensión. Esta ubicación se
establece en la propiedad del sistema wim.home o bien en
user.install.root/config/cells/local.cell/wim.
VMM_SCHEMA_HOME es el directorio donde se encuentran los archivos de esquema del sistema.
Esta ubicación se establece en la propiedad del sistema wim.schema.home o bien en
was.install.root/etc/wim/schema.
las siguientes extensiones se pueden definir en los archivos XSD de extensión personalizada:
- Propiedades personalizadas nuevas como la propiedad organizationalStatus en el ejemplo que se muestra a continuación.
- Tipos de entidad nuevos y propiedades asociadas. Los tipos de entidad nuevos se tienen que
extender desde los tipos de entidad incorporados de virtual member manager (por ejemplo, la
entidad EPerson que se extiende desde wim:PersonAccount en el ejemplo que viene a continuación).
- Tipos de control nuevos. Los tipos de control nuevos se tienen que extender desde los tipos de control incorporados de virtual member manager.
Nota: En
estos archivos XSD, los nuevos tipos de propiedad no se pueden añadir a los tipos de entidad
incorporados de virtual member manager, como PersonAccount o Group.
En el ejemplo siguiente se muestra la estructura inicial del archivo wimextension.xsd.
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema targetNamespace="http://www.yourco.com/wim/yourext"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:ecore="http://www.eclipse.org/emf/2002/Ecore"
xmlns:yourext="http://www.yourco.com/wim/yourext"
ecore:package="com.ibm.websphere.wim.model.ext"
xmlns="http://www.ibm.com/websphere/wim">
<xsd:import schemaLocation="wimdatagraph.xsd"
namespace="http://www.ibm.com/websphere/wim"/>
<!-- Propiedades personalizadas -->
<xsd:element name="organizationalStatus" type="xsd:string"/>
<!-- Entidades personalizadas -->
<xsd:complexType name="EPerson">
<xsd:complexContent>
<xsd:extension base="PersonAccount">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" ref="yourext:organizationalStatus"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:schema>
Si existen varios archivos XSD de extensión personalizada (por ejemplo, MyExt1.xsd, MyExt2.xsd y
MyExt3.xsd), deberán importarse mutuamente entre sí, como una cadena (MyExt3.xsd importa
MyExt2.xsd, MyExt2.xsd importa MyExt1.xsd). El último importa el esquema incorporado de virtual
member manager (MyExt1.xsd importa wimdatagraph.xsd).