Les fichiers XSD d'extension personnalisée permettent de définir un
schéma d'extension personnalisée.
Les fichiers XSD d'extension personnalisée permettent de définir un
schéma d'extension personnalisée, notamment les nouveaux types de propriété,
d'entité et de contrôle. Virtual member manager fournit un exemple de
fichier XSD d'extension appelé wimextension.xsd et l'URI d'espace de nom,
http://www.yourco.com/wim/ext. Vous pouvez créer vos propres fichiers XSD si vous
importez le schéma intégré virtual member manager (wimdatagraph.xsd)
et disposez d'un espace de nom différent de celui de virtual
member manager, http://www.ibm.com/websphere/wim.
Remarque : Les fichiers wimdatagraph.xsd et de prise en charge résident désormais dans le répertoire VMM_SCHEMA_HOME/model. Si vous utilisiez déjà le fichier wimextension.xsd avant la mise à niveau de WebSphere Application Server version 7, vous devez mettre à jour le fichier wimextension.xsd afin qu'il pointe vers le nouvel emplacement du fichier wimdatagraph.xsd après la mise à niveau de WebSphere Application Server version 7.
Vous pouvez enregistrer vos fichiers XSD d'extension personnalisée dans
l'emplacement de votre choix ; toutefois, vous devez définir le chemin d'accès
dans le fichier wimconfig.xml afin que virtual member manager puisse les
trouver. Si vous placez vos fichiers XSD d'extension sous
<VMM_HOME>\modèle de répertoire, vous n'avez pas à définir de chemin d'accès.
Remarque : VMM_HOME est le répertoire dans lequel se trouve l'exemple de fichier schéma d'extension. Cet emplacement est la propriété système wim.home ou user.install.root/config/cells/local.cell/wim.
VMM_SCHEMA_HOME est le répertoire dans lequel se trouvent les fichiers schéma du système. Cet emplacement est défini dans la propriété système wim.schema.home ou dans racine.install.utilisateur/etc/wim/schema.
Les extensions suivantes peuvent être définies dans les fichiers XSD
d'extension personnalisée :
- Nouvelles propriétés personnalisées, telles que la
propriété organizationalStatus de l'exemple qui suit.
- Nouveaux types d'entité et propriétés associées. Les nouveaux types d'entité doivent
être des extensions des types d'entité intégrée de virtual member manager (l'entité
EPerson qui provient de wim:PersonAccount dans l'exemple qui suit, par exemple).
- Nouveaux
types de contrôle. Les nouveaux types de contrôle doivent être des extensions
des types de contrôle intégrés de virtual member manager.
Remarque : Dans ces
fichiers XSD, les nouveaux types de propriété ne s'ajoutent pas aux types d'entité
intégrée de virtual member manager comme les types PersonAccount ou Group.
L'exemple
suivant décrit la structure de début du fichier 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"/>
<!-- Propriétés personnalisées -->
<xsd:element name="organizationalStatus" type="xsd:string"/>
<!-- Entités personnalisées -->
<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
plusieurs fichiers XSD d'extension existent (MyExt1.xsd,
MyExt2.xsd et MyExt3.xsd, par exemple), l'importation de l'un à l'autre doit
s'effectuer en chaîne (MyExt3.xsd importe MyExt2.xsd, MyExt2.xsd importe MyExt1.xsd).
Le
dernier fichier importe le schéma intégré de virtual member manager (MyExt1.xsd
importe wimdatagraph.xsd).