ChangeControl 数据对象

ChangeControl 数据对象为客户机应用程序提供以下功能:查询自指定检查点以来,联合存储库是否存在已更改实体,如新增、修改或删除的实体。

客户机应用程序可以使用 ChangeControl 数据对象将其内部高速缓存或其他存储库与用户注册表同步,并使用高速缓存或存储库中的最新信息提供安全的环境。

下面对 ChangeControl 数据对象的结构进行了描述。
checkPoint
定义 virtual member manager 中配置的存储库的检查点。
它是包含 repositoryId 和 repositoryCheckPoint 的列表。在 IBM Tivoli Directory Server 的以下示例中,TDS_LDAP 是 IBM Tivoli Directory Server 的存储库标识,而 21 是已配置 LDAP 的检查点编号。
<wim:checkPoint>
  <wim:repositoryId>TDS_LDAP</wim:repositoryId>
  <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
</wim:checkPoint>	
ChangeControl 数据对象中可以有一个或多个 checkPoint 实例,具体取决于搜索中涉及的存储库数。
changeTypes
表示要返回的更改的类型。它是有效更改类型的列表。例如,该列表可以包含值 addmodify,表示只有添加或修改的实体必须返回。要获取更改的所有类型,请传递星号 (*)。
changeTypes 属性的有效值和字符串常量是 add(对于 CHANGETYPE_ADD)、delete(对于 CHANGETYPE_DELETE)、modify(对于 CHANGETYPE_MODIFY)、rename(对于 CHANGETYPE_RENAME)和 *(对于 CHANGETYPE_ALL,用于检索所有更改类型)。此外,传递空值将检索所有更改类型。

由于 ChangeControl 数据对象派生自 SearchControl 数据对象,因此适用于普通搜索的所有其他参数(如大小和时间限制、要返回的属性、是否包含子类型、过滤表达式和搜索条件)也可应用于对已更改实体的搜索。

XML 模式定义

以下显示了 ChangeControl 数据对象的 XML 模式定义:
<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>

样本数据对象

以下示例显示在对已更改实体的第一次搜索期间,在 search API 中用于检索检查点的 ChangeControl 数据对象(不带任何检查点)。
<wim:controls xsi:type="wim:ChangeControl" changeTypes="*"/>
以下示例显示在后续搜索期间用在 search API 中的 ChangeControl 数据对象,它带有一个先前搜索中已保存的检查点。
<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>


使用条款 | 反馈