Objeto de Dados ChangeControl

O objeto de dados ChangeControl fornece a um aplicativo cliente a capacidade de consultar repositórios associados em busca de entidades alteradas, como entidades novas, modificadas e excluídas, de um determinado ponto de verificação em diante.

Um aplicativo cliente pode usar o objeto de dados ChangeControl para sincronizar seu cache interno ou outros repositórios, com o registro do usuário, e fornecer um ambiente seguro usando as últimas informações em seu cache ou repositórios.

A estrutura do objeto de dados ChangeControl é descrita a seguir.
checkPoint
define o ponto de verificação para os repositórios configurados no gerenciador de membro virtual.
É uma lista que contém o repositoryId e o repositoryCheckPoint. No exemplo a seguir para o IBM Tivoli Directory Server, TDS_LDAP é o ID do repositório para o IBM Tivoli Directory Server e 21 é o número do ponto de verificação para o LDAP configurado.
<wim:checkPoint>
  <wim:repositoryId>TDS_LDAP</wim:repositoryId>
  <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
</wim:checkPoint>	
Pode haver uma ou mais instâncias de checkPoint em um objeto de dados ChangeControl, dependendo do número de repositórios envolvidos em uma procura.
changeTypes
representa o tipo de mudanças a serem retornadas. É uma lista de tipos de mudança válidos. Por exemplo, a lista poderia ter os valores add e modify para indicar que apenas entidades que foram incluídas ou modificadas devem ser retornadas. Para obter todos os tipos de mudanças, transmita o asterisco (*).
Os valores válidos e as constantes de sequência da propriedade changeTypes são add (para CHANGETYPE_ADD), delete (para CHANGETYPE_DELETE), modify (para CHANGETYPE_MODIFY), rename (para CHANGETYPE_RENAME) e * (para CHANGETYPE_ALL para recuperar todos os tipos de mudanças). Além disso, transmitir um valor nulo recupera todos os tipos de mudanças.

Como o objeto de dados ChangeControl é derivado do objeto de dados SearchControl, todos os outros parâmetros aplicáveis a uma procura normal, como limites de tamanho e tempo, propriedades a serem retornadas, se inclui ou não subtipos, expressão de filtro e bases de procura, também são aplicados a uma procura por entidades alteradas.

Definição de Esquema XML

A definição de esquema XML para o objeto de dados ChangeControl é mostrada aqui:
<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 Dados de Amostra

O exemplo a seguir mostra um objeto de dados ChangeControl sem nenhum ponto de verificação, usado na API de procura, durante a primeira procura por entidades alteradas, para recuperar o ponto de verificação.
<wim:controls xsi:type="wim:ChangeControl" changeTypes="*"/>
O exemplo a seguir mostra um objeto de dados ChangeControl com um ponto de verificação salvo de uma procura anterior, usado na API de procura durante uma procura subsequente.
<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>


Termos de uso | Feedback