Modèle dynamique : ajout de nouvelles entités et propriétés en phase de déploiement à l'aide du fichier wimxmlextension.xml

Virtual member manager est configuré pour utiliser le modèle dynamique. Vous pouvez créer de nouveaux types d'entité et leurs nouveaux types de propriétés associés en phase de déploiement.

Pourquoi et quand exécuter cette tâche

Vous devez ajouter de nouveaux types d'entités et leurs nouveaux types de propriété associés. Dans les exemples suivants, vous allez créer un nouveau type d'entité, ContactPerson, puis lui ajouter un nouveau type de propriété, cellPhone. Vous allez définir les schémas des nouveaux types d'entité et de propriétés dans le fichier wimxmlextension.xml.

Procédure

  1. Arrêtez le service virtual member manager.
  2. Ouvrez le fichier wimxmlextension.xml sous VMM_HOME\model. Si ce fichier n'existe pas, vous devez en créer un nouveau du même nom.
    Remarque : VMM_HOME est le répertoire qui contient les fichiers virtual member manager. Cet emplacement est défini dans la propriété du système wim.home ou user.install.root/config/cells/local.cell/wim.
  3. Modifiez le fichier wimxmlextension.xml et ajoutez les définitions des nouveaux types d'entité et de propriété. Assurez-vous que le XML est syntaxiquement correct et conforme au schéma défini dans wimschema.xsd.
    L'exemple suivant définit un nouveau type d'entité ContactPerson et un nouveau type de propriété appelé cellPhone puis ajoute ce type de propriété au nouveau type d'entité ContactPerson :
    <?xml version="1.0" encoding="UTF-8"?>
    <sdo:datagraph xmlns:sdo="commonj.sdo"
        xmlns:wim="http://www.ibm.com/websphere/wim">
      <wim:schema>
        <wim:entitySchema nsPrefix="yourext" 
                          nsURI="http://www.yourco.com/wim/yourext"
            entityName="ContactPerson" parentEntityName="PersonAccount"/>
        <wim:propertySchema nsURI="http://www.yourco.com/yourext" 
                            dataType="STRING" 
                            multiValued="true"
                            propertyName="cellPhone">
          <wim:applicableEntityTypeNames>ContactPerson</wim:applicableEntityTypeNames>
          <wim:metaData name="repositoryPropertyName" 
                       value="cellularTelephoneNumber"/>
        </wim:propertySchema>
      </wim:schema>
    </sdo:datagraph>
    Remarque : Pour plus d'informations sur l'utilisation des objets de données propertySchema et extensionPropertySchema, voir la section Schéma de propriété étendu de la rubrique Prérequis pour la programmation. Reportez-vous également à la rubrique Configuration d'un référentiel d'extension de propriété dans une configuration de référentiel fédéré dans le centre de documentation WebSphere Application Server.
  4. Ajoutez manuellement les nouveaux types d'entité au fichier de configuration de virtual member manager (wimconfig.xml).
    <config:supportedEntityTypes defaultParent="cn=users,dc=yourco,dc=com" 
        name="yourext:ContactPerson"> 
        <config:rdnProperties>uid</config:rdnProperties>
    </config:supportedEntityTypes>
    
    <config:repositories xsi:type="config:LdapRepositoryType" ...> 
        <config:EntityTypesNotAllowDelete>yourext:ContactPerson</config:EntityTypesNotAllowDelete> 
        <config:ldapEntityTypes name="yourext:ContactPerson"> 
            <config:rdnAttributes name="uid"/>
            <config:objectClasses>eContactPerson</config:objectClasses>
            <config:objectClassesForCreate>eContactPerson</config:objectClassesForCreate>
            <config:objectClassesForCreate>inetOrgPerson</config:objectClassesForCreate>
        </config:ldapEntityTypes>
    </config:repositories>
  5. Ajoutez manuellement les nouveaux types de propriété à chaque adaptateur de référentiel.
    Adaptateur LDAP
    Ajoutez le mappage des nouveaux types de propriété avec les attributs LDAP au fichier de configuration wimconfig.xml.
    Adaptateur de base de données
    Ajoutez la définition des nouveaux types de propriété au fichier XML de propriété de l'adaptateur de base de données (wimDBProperties.xml) puis exécutez le chargeur de propriété de base de données.
  6. Redémarrez le service virtual member manager.


Conditions d'utilisation | Commentaires