AncestorControl DataObject

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.

A estrutura de gráfico de dados de um objeto de dados AncestorControl consiste em:
propriedades
é uma lista dos atributos que você deseja retornar a partir das entidades que correspondem ao critério de procura. Por exemplo, você deseja obter os atributos sn e givenName das pessoas que estão no departamento de marketing.
searchBases
é uma lista das bases da procura utilizadas para limitar a procura àquelas bases especificadas na lista.
countLimit
especifica o número máximo de resultados da procura retornados pela operação de procura.
timeLimit
Se o repositório de perfil suporta timeLimit, ele especifica, em milissegundos, a duração máxima da procura.
expressão
é a expressão de procura no formato XPath.
nível
especifica o nível dos ascendentes a ser retornado. O valor padrão para o nível é 1. Consulte a seguinte tabela.
Essa tabela resume os valores possíveis do nível de ascendente:
Tabela 1. Valores de Nível AncestorControl
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.

Definição de Esquema XML

A seguir está a definição de esquema XML para o AncestorControl DataObject.
<xsd:complexType name="AncestorControl">
		<xsd:complexContent>
			<xsd:extension base="HierarchyControl">
			</xsd:extension>
		</xsd:complexContent>
	</xsd:complexType>

Objeto de Dados de Amostra

A seguir, está um AncestorControl DataObject de amostra, que retorna todos os ascendentes e suas propriedades uid, cn, o e ou, se existirem:
<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>


Termos de uso | Feedback