ChangeResponseControl DataObject

ChangeReponseControl データ・オブジェクトは、クライアント・オブジェクトに戻されますが、ChangeControl データ・オブジェクトを使用した変更済みエンティティーの検索結果である変更済みエンティティーが含まれます。

この応答コントロールは、後続の変更済みエンティティーの検索で使用されるチェックポイントも戻します。

ChangeResponseControl データ・オブジェクトの構造について以下に説明します。
checkPoint
Virtual member manager で構成されているリポジトリーのチェックポイントを定義します。
これは、repositoryId と repositoryCheckPoint を含むリストです。 以下の IBM Tivoli Directory Server の例では、TDS_LDAP は IBM Tivoli Directory Server のリポジトリー ID、21 は構成済み LDAP のチェックポイント番号です。
<wim:checkPoint>
  <wim:repositoryId>TDS_LDAP</wim:repositoryId>
  <wim:repositoryCheckPoint>21</wim:repositoryCheckPoint>
</wim:checkPoint>
検索に使用されるリポジトリーの数に応じて、ChangeResponseControl データ・オブジェクトには 1 つ以上の checkPoint インスタンスが含まれることがあります。

XML スキーマ定義

次に、ChangeResponseControl データ・オブジェクトの XML スキーマ定義を示します。
<xsd:complexType name=”ChangeResponseControl”>
   <xsd:complexContent>
      <xsd:extension base=”SearchResponseControl”>
         <xsd:sequence>
            <xsd:element name=”checkPoint” type=”wim:checkPointType” minOccurs="0" maxOccurs="unbounded"/>
         </xsd:sequence>
      </xsd:extension>
   </xsd:complexContent>
</xsd:complexType>

サンプル・データ・オブジェクト

次の例は、TDS リポジトリーに処理対象の変更が 20 個あり、Active Directory に処理対象の変更が 40 個ある場合に、検索 API により戻される ChangeResponseControl データ・オブジェクトを示します。
<wim:controls xsi:type="wim:ChangeResponseControl">
  <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>


利用条件 | フィードバック