Métodos de servicios Web › Métodos de gestión de grupos › getGroupMemberListValues

getGroupMemberListValues

Los siguientes parámetros se aplican al método getGroupMemberListValues:

Description

Funciona de manera parecida a getListValues(), excepto que consulta las relaciones entre el grupo del sistema y el miembro. El sistema utiliza un objeto "Group Member" (grpmem, miembro de grupo) especial para cada relación grupo/miembro. El sistema CA SDM administra objetos grpmem en segundo plano (no los manipula directamente), que son esenciales para determinadas consultas.

El objeto grpmem sólo contiene dos punteros, uno para un contacto y el otro para un grupo, que es a la vez un objeto de contacto. Los nombres de atributo son "member" (miembro) y "group" (grupo) respectivamente. Como son punteros, debe utilizar la notación con puntos para formular una consulta como de costumbre. Por ejemplo, para buscar todos los contactos con un apellido que empiece por "B" y que estén en un grupo con el nombre “Seattle” debe utilizar lo siguiente:

member.last_name LIKE "B%" AND group.last_name = "Seattle"

También puede utilizar los identificadores como habitualmente, tal y como se muestra a continuación:

member.last_name LIKE "A%" AND group.id = U"555A043EDDB36D4F97524F2496B35E75"

Es importante señalar que este método puede recuperar valores de todos los miembros y grupos, no sólo de un grupo. Para obtener información sobre todos los miembros de un grupo o un miembro específico, sólo tiene que especificar un identificador en la cláusula Where. Por ejemplo, lo siguiente devolvería valores de un grupo específico:

group.id = U"555A043EDDB36D4F97524F2496B35E75"

Es importante recordar los conceptos siguientes:

• El objeto grpmem contiene dos atributos de puntero, uno para el miembro y otro para el grupo.
• Existe un objeto grpmem para cada relación grupo/miembro.

El método grpmem consulta en realidad la tabla de objetos grpmem, por lo que devuelve un objeto que representa una relación entre dos contactos. Por tanto, los valores de atributo que desea buscar en los atributos deben utilizar la notación con puntos del objeto grpmem. Para buscar valores del miembro, todos los nombres de atributo deben tener el formato "member.ATTRNAME", como se muestra en el ejemplo siguiente:

‘member.last_name’

Para buscar valores del grupo, utilice "group.ATTRNAME".

Nota: Para obtener un ejemplo de consulta eficaz de grupos y miembros, consulte la sección Cláusulas Where.

Resultado

No devuelve ningún identificador automáticamente. El elemento <Handle> del resultado siempre está vacío. Para solicitar el miembro o identificador de grupo de cada fila, utilice uno de los siguientes elementos en el parámetro attributes descrito en la tabla.

• “member.persistent_id”
• “group.persistent_id”