The ChangeControl data object provides a client application with the ability to query federated repositories for changed entities, such as new, modified, and deleted entities, from a specified checkpoint onwards.
A client application can use the ChangeControl data object to synchronize its internal cache or other repositories, with the user registry, and provide a secure environment using the latest information in its cache or repositories.
<wim:checkPoint> <wim:repositoryId>TDS_LDAP</wim:repositoryId> <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint> </wim:checkPoint>
As the ChangeControl data object is derived from the SearchControl data object, all of the other parameters applicable to a normal search, such as size and time limits, properties to return, whether or not to include sub-types, filter expression, and search bases are also applied to a search for changed entities.
<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>
<wim:controls xsi:type="wim:ChangeControl" changeTypes="*"/>
<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>