GroupMemberControl DataObject

GroupMemberControl é utilizado no objeto de dados de entrada da API de obtenção e da API de atualização.

Na API de obtenção, GroupMemberControl é utilizado para solicitar os membros de um grupo. Se o GroupMemberControl for incluído no objeto de dados de entrada, os membros do grupo serão retornados. GroupMemberControl também pode ser utilizado para especificar as propriedades a serem retornadas para os membros, bem como o nível dos membros aninhados a serem retornados.

Porque GroupMemberControl é estendido a partir de SearchControl, você pode especificar propriedades para retornar apenas os grupos 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 membros que são do tipo de entidade PersonAccount.

A estrutura de gráfico de dados de um objeto de dados GroupMemberControl na API de obtenção 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
é utilizado para indicar o nível da hierarquia a ser retornado. No GroupMemberControl, ele indica o nível de membros aninhados. Consulte a tabela a seguir.
Essa tabela resume os valores possíveis do nível:
Tabela 1. Valores de Nível GroupMemberControl
nível GroupMemberControl Descrição
1 (padrão) Retorna apenas membros imediatos.
0 Retorna todos os membros aninhados.
A estrutura de gráfico de dados de um objeto de dados GroupMemberControl na API de atualização consiste em:
modifyMode
especifica o uso do modo designar, modificar e remover atribuição. Consulte a tabela a seguir.
Essa tabela resume os valores possíveis de modifyMode:
Tabela 2. Valores de GroupMemberControl modifyMode
GroupMemberControl modifyMode Descrição
1 (padrão) Modo Designar. Os membros contidos no objeto de dados de grupo são incluídos nesse grupo como membros.
2 Modo Substituir. Os membros contidos no objeto de dados de grupo são incluídos nesse grupo como seus membros e todos os membros do grupo são removidos.
3 Modo Remover Atribuição. Os membros contidos no objeto de dados de grupo são removidos do grupo.

Definição de Esquema XML

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

Objeto de Dados de Amostra

A seguir, um objeto de dados GroupMemberControl de amostra utilizado na API de obtenção. Ele pede os membros imediatos (nível=1) do grupo. Ele também indica para retornar os atributos uid, cn, o e ou para os membros, se esses atributos existirem.
    <wim:controls xsi:type="wim:GroupMemberControl" level="1">
      <wim:properties>cn</wim:properties>
      <wim:properties>uid</wim:properties>
      <wim:properties>o</wim:properties>
      <wim:properties>ou</wim:properties>
 </wim:controls>
A seguir, um objeto de dados GroupMemberControl de amostra utilizado na API de atualização. Ele indica os membros devem ter a atribuição removida dos grupos.
<wim:controls xsi:type="wim:GroupMemberControl" modifyMode="3"/>


Termos de uso | Feedback