DescendantControl 用于请求实体的后代。
DescendantControl 数据对象扩展自 HierarchyControl。它在 get API 的输入数据对象中用于请求实体的后代。如果 DescendantControl 添加到 get 操作中的数据对象,那么返回数据图中将会返回 Root 数据对象下的实体的后代。
由于 DescendantControl 扩展自 SearchControl,因此可指定 DescendantControl 中的搜索属性,以便仅返回满足搜索条件的后代。例如,可以添加带有值 entities[@xsi:type='PersonAccount'] 的属性表达式,以便仅返回实体类型为 PersonAccount 的后代。DescendantControl 还可以用于指定级别和要为后代返回的属性。
DescendantControl 级别 | 描述 |
---|---|
1(缺省值) | 仅返回子级。 |
任何正整数 | 返回指定级别的后代。例如,指定 2 将返回两个级别,子级和孙级。 |
0 | 返回所有后代。 |
<xsd:complexType name="DescendantControl">
<xsd:complexContent>
<xsd:extension base="HierarchyControl">
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<wim:controls xsi:type="wim:DescendantControl" level="0">
<wim:properties>uid</wim:properties>
<wim:properties>cn</wim:properties>
<wim:properties>o</wim:properties>
<wim:properties>ou</wim:properties>
</wim:controls>