Objet de données ChangeControl

L'objet de données ChangeControl fournit une application client pouvant rechercher dans les référentiels fédérés les entités modifiées, telles que les entités nouvelles, modifiées et supprimées, à partir d'un point de contrôle spécifié.

Une application client peut utiliser l'objet de données ChangeControl pour synchroniser sa cache interne ou d'autres référentiels, avec le registre d'utilisateurs, et fournir un environnement sécurisé à l'aide des informations les plus récentes dans sa mémoire cache ou les référentiels.

La structure des données de ChangeControl est décrite ci-après.
checkPoint
Définit le point de contrôle des référentiels configurés dans virtual member manager.
Il s'agit d'une liste contenant repositoryId et repositoryCheckPoint. Dans l'exemple suivant relatif à IBM Tivoli Directory Server, TDS_LDAP représente l'ID référentiel d'IBM Tivoli Directory Server et 21, le numéro de point de contrôle du LDAP configuré.
<wim:checkPoint>
  <wim:repositoryId>TDS_LDAP</wim:repositoryId>
  <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
</wim:checkPoint>	
Un objet de données ChangeControl peut contenir une ou plusieurs instances de point de contrôle, en fonction du nombre de référentiels impliqués dans une recherche.
changeTypes
Représente le type de modifications à renvoyer. Il s'agit d'une liste valide des types de modification. Par exemple, cette liste peut contenir les valeurs add et modify pour indiquer que seules les entités ajoutées ou modifiées doivent être renvoyées. Pour extraire tous les types de modification, utilisez l'astérisque (*).
Les valeurs et constantes de chaîne valides pour la propriété changeTypes sont add (pour CHANGETYPE_ADD), delete (pour CHANGETYPE_DELETE), modify (pour CHANGETYPE_MODIFY), rename (pour CHANGETYPE_RENAME) et * (pour CHANGETYPE_ALL pour extraire tous les types de modification). En outre, la transmission d'une valeur null permet d'extraire tous les types de modification.

Comme l'objet de données ChangeControl est dérivé de l'objet de données SearchControl, tous les autres paramètres applicables à une recherche normale, tels que la taille et les limites de temps, les propriétés à renvoyer, l'inclusion ou non des sous-types, l'expression de filtre et les bases de recherche sont également appliqués à une recherche d'entités modifiées.

Définition de schéma XML

La définition du schéma XML de l'objet de données ChangeControl est illustrée ici :
<xsd:complexType name="ChangeControl">
  <xsd:complexContent>
    <xsd:extension base="SearchControl">
      <xsd:sequence>
        <xsd:element name="checkPoint" type="CheckPointType" minOccurs="0" maxOccurs="unbounded"></xsd:element>
        <xsd:element name="changeTypes" type="xsd:token" maxOccurs="unbounded" minOccurs="0"></xsd:element>
      </xsd:sequence> 
    </xsd:extension>
  </xsd:complexContent>
</xsd:complexType>

Exemples d'objet de données

L'exemple suivant montre un objet de données ChangeControl sans aucun point de contrôle, utilisé dans l'interface API de recherche, lors de la première recherche d'entités modifiées, afin d'extraire le point de contrôle.
<wim:controls xsi:type="wim:ChangeControl" changeTypes="*"/>
L'exemple suivant montre un objet de données ChangeControl avec un point de contrôle sauvegardé à partir d'une recherche précédente, utilisés dans l'API de recherche lors d'une recherche ultérieure.
<wim:controls xsi:type="wim:ChangeControl" >
  <wim:changeTypes>*</wim:changeTypes>
  <wim:checkPoint>
    <wim:repositoryId>TDS_LDAP</wim:repositoryId>
    <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
  </wim:checkPoint>
  <wim:checkPoint>
    <wim:repositoryId>AD_LDAP</wim:repositoryId>
    <wim:repositoryCheckPoint>41</wim:repositoryCheckPoint>
  </wim:checkPoint>
</wim:controls>


Conditions d'utilisation | Commentaires