HierarchyControl は、SearchControl DataObject からの拡張です。
HierarchyControl は SearchControl から拡張されます。
これは抽象コントロールであるので、データ・オブジェクトで直接使用されることはありません。
代わりに、その子孫である AncestorControl、DescendantControl、GroupMemberControl、および GroupMembershipControl が使用されます。
HierarchyControl DataObject の構造は、以下のものから構成されます。
- properties
- 検索条件を満たすエンティティーから戻す属性のリストです。
例えば、マーケティング部門に所属する個人の sn および givenName 属性を取得できます。
- searchBases
- 検索を制限するために使用される検索ベースのリストです。検索は、このリストに指定されたベースに制限されます。
- countLimit
- 検索操作で戻される検索結果の最大数を指定するために使用されます。
- timeLimit
- 検索の最長継続時間をミリ秒で指定します (プロファイル・リポジトリーが timeLimit をサポートしている場合)。
- expression
- XPath 形式の検索式です。
- level
- 戻す階層のレベルを指定するために使用されます。
コンテキストが異なれば意味も異なります。
例えば、DescendantControl では、子孫のレベルを指定します。
GroupMembershipControl では、ネストされたグループのレベルを指定します。
XML スキーマ定義
次に、HierarchyControl DataObject の XML スキーマ定義を示します。
<xsd:complexType name="HierarchyControl">
<xsd:complexContent>
<xsd:extension base="SearchControl">
<xsd:attribute name="level" type="xsd:int" default="1" />
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
サンプル・データ・オブジェクト
HierarchyControl は抽象コントロールであるため、サンプル・データ・オブジェクトはありません。