GroupMemberControl DataObject

GroupMemberControl se utiliza en el objeto de datos de entrada tanto de la API de obtención (get) como de la API de actualización (update).

En la API de obtención (get), GroupMemberControl se utiliza para solicitar los miembros de un grupo. Si GroupMemberControl se añade al objeto de datos de entrada, se devuelven los miembros del grupo. GroupMemberControl también se puede utilizar para especificar las propiedades que se devolverá para los miembros así como el nivel de los miembros anidados que se devolverá.

Debido a que GroupMemberControl se extiende desde SearchControl, puede especificar propiedades para devolver únicamente los grupos que cumplan los criterios de búsqueda. Por ejemplo, puede añadir una expresión de propiedad con el valor: “entities[@xsi:type='PersonAccount']” para devolver únicamente los miembros del tipo de entidad PersonAccount.

La estructura del gráfico de datos de un objeto de datos GroupMemberControl en la API de obtención (get) está formada por los elementos siguientes:
properties
es una lista de los atributos que desea que se devuelvan de las entidades que coinciden con los criterios de búsqueda. Por ejemplo, desea obtener los atributos sn y givenName de las personas que están en el departamento de marketing.
searchBases
es una lista de las bases de búsqueda que se utilizan para limitar la búsqueda a las bases especificadas en la lista.
countLimit
se utiliza para especificar el número máximo de resultados de la búsqueda devueltos por la operación de búsqueda.
timeLimit
Si el depósito del perfil da soporte a timeLimit, especifica en milisegundos la duración máxima de la búsqueda.
expression
es la expresión de búsqueda en formato XPath.
level
se utiliza para indicar el nivel de la jerarquía que se debe devolver. En GroupMemberControl, indica el nivel de los miembros anidados. Consulte la tabla siguiente.
Esta tabla resume los valores posibles del nivel:
Tabla 1. Valores de nivel de GroupMemberControl
Nivel de GroupMemberControl Descripción
1 (valor predeterminado) Sólo devuelve miembros inmediatos.
0 Devuelve todos los miembros anidados.
La estructura del gráfico de datos de un objeto de datos GroupMemberControl en la API de actualización (update) está formada por los elementos siguientes:
modifyMode
especifica el uso de la modalidad de asignación, modificación o desasignación. Consulte la tabla siguiente.
Esta tabla resume los valores posibles de modifyMode:
Tabla 2. Valores de GroupMemberControl modifyMode
GroupMemberControl modifyMode Descripción
1 (valor predeterminado) Modalidad de asignación. Los miembros contenidos en el objeto de datos de grupo se añaden a este grupo como miembros.
2 Modalidad de sustitución. Los miembros contenidos en el objeto de datos de grupo se añaden al grupo como miembros suyos y se eliminan todos los miembros existentes del grupo.
3 Modalidad de desasignación. Los miembros contenidos en el objeto de datos de grupo se eliminan del grupo.

Definición de esquema XML

A continuación se proporciona la definición del esquema XML para GroupMemberControl DataObject:
<xsd:complexType name="GroupMemberControl">
    <xsd:complexContent>
	 <xsd:extension base="GroupControl">
	 </xsd:extension>
    </xsd:complexContent>
	</xsd:complexType>

Objetos de datos de ejemplo

A continuación se proporciona un objeto de datos GroupMemberControl de ejemplo que se utiliza en la API de obtención (get). Solicita los miembros inmediatos (nivel=1) del grupo. También indica que se devuelvan los atributos uid, cn, o y ou para los miembros, si existen estos atributos.
    <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 continuación se proporciona un objeto de datos GroupMemberControl de ejemplo que se utiliza en la API de actualización (update). Indica que los miembros deben desasignarse de los grupos.
<wim:controls xsi:type="wim:GroupMemberControl" modifyMode="3"/>


Condiciones de uso | Comentarios