DescendantControl é utilizado para solicitar os descendentes de uma entidade.
O objeto de dados DescendantControl estende a partir de HierarchyControl. Ele é utilizado no objeto de dados de entrada da API de obtenção, para solicitar os descendentes de uma entidade. Se DescendantControl for incluído no objeto de dados em uma operação de obtenção, os descendentes das entidades sob Root DataObject serão retornados no gráfico de dados de retorno.
Porque DescendantControl é estendido a partir de SearchControl, você pode especificar propriedades de procura no DescendantControl para retornar apenas os descendentes que satisfaçam o critério de procura. Por exemplo, é possível incluir a expressão de propriedade com o valor: entities[@xsi:type='PersonAccount'] para retornar apenas os descendentes que são do tipo de entidade PersonAccount. O DescendantControl também pode ser utilizado para especificar o nível e as propriedades a serem retornadas para os descendentes.
nível DescendantControl | Descrição |
---|---|
1 (padrão) | Retorna filhos apenas. |
Qualquer inteiro positivo | Retorna o nível especificado de descendentes. Por exemplo, especificar 2 retorna dois níveis, os filhos e os netos. |
0 | Retorna todos os descendentes. |
<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>