AncestorControl は、エンティティーの祖先を要求するために使用します。
AncestorControl DataObject は HierarchyControl から拡張されます。 このデータ・オブジェクトは、エンティティーの祖先を要求するために、get API の入力データ・オブジェクトで使用されます。 AncestorControl を get 操作のデータ・オブジェクトに追加すると、Root DataObject の下にあるエンティティーの祖先が戻りデータ・オブジェクトで戻されます。
AncestorControl は SearchControl から拡張されるため、AncestorControl に検索プロパティーを指定して、検索条件を満たす祖先のみを戻すようにすることができます。 AncestorControl はまた、祖先について戻すレベルとプロパティーを指定するためにも使用できます。
AncestorControl level | 説明 |
---|---|
1 (デフォルト) | 親のみを戻します。 |
任意の正整数 | 指定されたレベルの祖先を戻します。 例えば、2 を指定すると、2 つのレベル (親と祖父母) が戻されます。 |
0 | Virtual member manager ノード以下のすべての祖先を戻します。 |
<xsd:complexType name="AncestorControl">
<xsd:complexContent>
<xsd:extension base="HierarchyControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:AncestorControl" level="0">
<wim:properties>uid</wim:properties>
<wim:properties>cn</wim:properties>
<wim:properties>o</wim:properties>
<wim:properties>ou</wim:properties>
</wim:controls>