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 GroupMemberControlNivel 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 modifyModeGroupMemberControl 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"/>