DescendantControl DataObject

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.

A estrutura de um objeto de dados DescendantControl 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
é utilizado para especificar 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 descendentes 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 descendente:
Tabela 1. Valores de Nível DescendantControl
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.

Definição de Esquema XML

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

Objeto de Dados de Amostra

A seguir, está o objeto de dados DescendantControl de amostra, que retorna todos os descendentes e suas propriedades uid, cn, o e ou, se existirem:
<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>


Termos de uso | Feedback