AncestorControl é utilizado para solicitar os ascendentes de uma entidade.
O objeto de dados AncestorControl estende a partir de HierarchyControl. Ele é utilizado no objeto de dados de entrada da API de obtenção, para solicitar os ascendentes de uma entidade. Se AncestorControl for incluído no objeto de dados em uma operação de obtenção, os ascendentes das entidades sob Root DataObject serão retornados no objeto de dados de retorno.
Porque AncestorControl é estendido a partir de SearchControl, você pode especificar propriedades de procura no AncestorControl para retornar apenas os ascendentes que satisfaçam o critério de procura. O AncestorControl também pode ser utilizado para especificar o nível e as propriedades a serem retornadas para os ascendentes.
nível AncestorControl | Descrição |
---|---|
1 (padrão) | Retorna pai apenas. |
Qualquer inteiro positivo | Retorna o nível especificado de ascendentes. Por exemplo, especificar 2 retorna dois níveis, o pai e o avô. |
0 | Retorna todos os ascendentes até o nó do 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>