HierarchyControl DataObject

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 は抽象コントロールであるため、サンプル・データ・オブジェクトはありません。



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