GroupMembershipControl DataObject

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

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

Porque GroupMembershipControl é estendido a partir de SearchControl, você pode especificar propriedades para retornar apenas os grupos que satisfaçam o critério de procura. Por exemplo, você pode incluir a expressão de propriedade com valor: “entities[@xsi:type='Group' and cn='Admin*']” para retornar apenas os grupos cuja propriedade “cn” inicie com “Admin”.

A estrutura de um objeto de dados GroupMembershipControl 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
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
é utilizado para indicar o nível dos grupos aninhados 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:
Tabela 1. Valores de Nível GroupMembershipControl
nível GroupMembershipControl Descrição
1 (padrão) Retorna apenas grupos imediatos.
0 Retorna todos os grupos aninhados.
A estrutura de um objeto de dados GroupMembershipControl 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 GroupMembershipControl modifyMode
GroupMembershipControl modifyMode Descrição
1 (padrão) Modo Designar. Os grupos contidos no objeto de dados da entidade incluem a entidade como um membro.
2 Modo Substituir. Os grupos contidos no objeto de dados da entidade incluem a entidade como um membro e todos os membros existentes são removidos.
3 Modo Remover Atribuição. Os grupos contidos no objeto de dados da entidade removem a entidade de seus membros.

Definição de Esquema XML

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

Objeto de Dados de Amostra

A seguir, um GroupMembershipControl DataObject de amostra utilizado na API de obtenção. Ele pede os grupos imediatos (nível=1) aos quais a entidade pertence. Ele também indica para retornar o atributo “cn” para os grupos, se o atributo existir.
<wim:controls xsi:type="wim:GroupMembershipControl" level="1">
      <wim:properties>cn</wim:properties>
      <wim:properties>displayName</wim:properties>
</wim:controls>
A seguir, um GroupMembershipControl DataObject de amostra utilizado na API de atualização. Ele indica a entidade deve ter a atribuição removida dos grupos.
<wim:controls xsi:type="wim:GroupMembershipControl" modifyMode="3"/>


Termos de uso | Feedback