ChangeControl DataObject

El objeto de datos ChangeControl proporciona una aplicación cliente con la posibilidad de consultar los depósitos federados para ver si existen entidades cambiadas como, por ejemplo, entidades nuevas, modificada y suprimidas, desde un punto de comprobación especificado hacia adelante.

Una aplicación cliente puede utilizar el objeto de datos ChangeControl para sincronizar su memoria caché interna u otros depósitos con el registro de usuarios y proporcionar un entorno seguro utilizando la información más reciente de su memoria caché o depósitos.

A continuación se describe la estructura de los datos de ChangeControl.
checkPoint
define el punto de comprobación para los depósitos configurados en virtual member manager.
Es una lista que contiene repositoryId y repositoryCheckPoint. En el ejemplo siguiente para IBM Tivoli Directory Server, TDS_LDAP es el ID de depósito para IBM Tivoli Directory Server y 21 es el número de punto de comprobación para el LDAP configurado.
<wim:checkPoint>
  <wim:repositoryId>TDS_LDAP</wim:repositoryId>
  <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
</wim:checkPoint>	
Podría haber una o más instancias de checkPoint en un objeto de datos ChangeControl, según el número de depósitos implicados en una búsqueda.
changeTypes
representa el tipo de cambios que deben devolverse. Es una lista de tipos de cambios válidos. Por ejemplo, la lista podría tener los valores add y modify para indicar que sólo deben devolverse entidades que se hayan añadido o modificado. Para obtener todos los tipos de cambios, pase el asterisco (*).
Los valores y constantes de tipo serie válidos de la propiedad changeTypes son add (para CHANGETYPE_ADD), delete (para CHANGETYPE_DELETE), modify (para CHANGETYPE_MODIFY), rename (para CHANGETYPE_RENAME) y * (para CHANGETYPE_ALL, para recuperar todos los tipos de cambios). Además, si se pasa un valor nulo se recuperan todos los tipos de cambios.

Dado que el objeto de datos ChangeControl deriva del objeto de datos SearchControl, todos los demás parámetros aplicables a una búsqueda normal, como los límites de tamaño y tiempo, las propiedades a devolver, si se incluyen o no subtipos, expresión de filtro y bases de búsqueda también se aplican a una búsqueda de entidades cambiadas.

Definición de esquema XML

A continuación se muestra la definición del esquema XML para el objeto de datos ChangeControl:
<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>

Objetos de datos de ejemplo

El ejemplo siguiente muestra un objeto de datos ChangeControl sin ningún punto de comprobación, que se utiliza en la API de búsqueda, durante la primera búsqueda de entidades cambiadas, para recuperar el punto de comprobación.
<wim:controls xsi:type="wim:ChangeControl" changeTypes="*"/>
El ejemplo siguiente muestra un objeto de datos ChangeControl con un punto de comprobación guardado de una búsqueda anterior, que se utiliza en la API de búsqueda durante una búsqueda posterior.
<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>


Condiciones de uso | Comentarios