Tema anterior: getContactTema siguiente: Métodos de gestión de grupos


findContacts

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

Parámetro

Tipo

Descripción

SID

Entero

Identifica la sesión recuperada del inicio de sesión.

userName

Cadena

Devuelve sólo los contactos con este nombre de usuario. Puede realizar búsquedas con caracteres comodín con el símbolo de porcentaje (%).

Por ejemplo, para buscar todos los contactos cuyo nombre de usuario empiece por Gut, especifique Gut%.

lastName

Cadena

Devuelve sólo los contactos con este apellido. Puede realizar búsquedas con caracteres comodín con el símbolo de porcentaje (%).

firstName

Cadena

Devuelve sólo los contactos con este nombre. Puede realizar búsquedas con caracteres comodín con el símbolo de porcentaje (%).

email

Cadena

Devuelve sólo los contactos con esta dirección de correo electrónico. Puede realizar búsquedas con caracteres comodín con el símbolo de porcentaje (%).

accessType

Cadena

Devuelve sólo los contactos con este tipo de acceso. Puede especificar varios roles separándolos con comas. Especifique lo siguiente:

  • 10002: Administración
  • 10004: Cliente
  • 10005: Empleado
  • 10009: Personal de IT
  • 10013: Gestión del conocimiento
  • 10014: Gestión del proceso
  • 10010: Gestión de Service Desk
  • 10008: Personal de Service Desk
  • 10020: Personal de distribución

inactiveFlag

Entero

Devuelve sólo los contactos inactivos o activos. Especifique lo siguiente:

  • 0 para activo
  • –999 para todos
  • otro para inactivo

Descripción

Recupera la lista de contactos.

Resultado

Un nodo <UDSObjectList> con cero o más nodos <UDSObject> que describen los contactos con los siguientes nodos <Attributes> secundarios:

Valor del elemento XML

Tipo

Descripción

id

UUID

Especifica el ID único del contacto.

ID de usuario

Cadena

Especifica el nombre de usuario del contacto.

last_name

Cadena

Identifica los apellidos del contacto.

first_name

Cadena

Identifica el nombre del contacto.

access_type

Entero

Especifica el ID de rol del contacto.

delete_flag

Entero

Indica si el contacto está activo o inactivo:

  • 0: activo
  • 1: inactivo

loginWithArtifact

Se aplican los siguientes parámetros al método loginWithArtifact:

Parámetro

Tipo

Descripción

ID de usuario

Cadena

Identifica el ID de usuario.

artefacto

Cadena

Identifica el artefacto obtenido de CA EEM.

Descripción

El artefacto de CA EEM proporcionado realiza la autenticación del usuario y abre una sesión con el servidor de back-end. El artefacto sólo se puede usar una vez para la autenticación. El SID devuelto puede utilizarse en invocaciones de métodos de servicios Web posteriores. El artefacto se puede adquirir directamente de CA EEM o lo puede obtener el método getArtifact.

Nota: Service Desk se debe integrar con CA EEM para realizar esta operación.

El SID se debe liberar sin logout(). Un ID de sesión puede vencer si no se utiliza antes de que se agote el tiempo de espera.

Resultado

Se devuelve lo siguiente:

Parámetro

Tipo

Descripción

SID

Cadena

Identifica el SID único que se va a utilizar para el resto de las llamadas a Servicios Web. Está en texto sin formato.