Rubrique précédente: getContactRubrique suivante: Méthodes de gestion des groupes


findContacts

Les paramètres suivants s'appliquent à la méthode findContacts :

Paramètre

Type

Description

SID

Nombre entier

Identifie la session extraite depuis la connexion.

userName

Chaîne

Renvoie uniquement les contacts portant ce nom d'utilisateur. Vous pouvez utiliser le caractère générique % pour effectuer des recherches.

Par exemple, pour rechercher tous les contacts dont le nom d'utilisateur commence par Smi, spécifiez Smi%.

lastName

Chaîne

Renvoie uniquement les contacts portant ce nom de famille. Vous pouvez utiliser le caractère générique % pour effectuer des recherches.

firstName

Chaîne

Renvoie uniquement les contacts portant ce prénom. Vous pouvez utiliser le caractère générique % pour effectuer des recherches.

email

Chaîne

Renvoie uniquement les contacts avec cette adresse électronique. Vous pouvez utiliser le caractère générique % pour effectuer des recherches.

accessType

Chaîne

Renvoie uniquement les contacts utilisant ce type d'accès. Vous pouvez déterminer plusieurs rôles en les séparant par des virgules. Indiquez les éléments suivants :

  • 10002 - Administration
  • 10004 - Client
  • 10005 - Employé
  • 10009 - Personnel d'IT
  • 10013 - Gestion des connaissances
  • 10014 - Gestion de Processus
  • 10010 - Gestion de Centre de Services
  • 10008 - Personnel du Centre de Services
  • 10020 - Personnel de Fournisseur

inactiveFlag

Nombre entier

Renvoie uniquement les contacts activés ou désactivés. Indiquez les éléments suivants :

  • 0 pour Activé
  • –999 pour tout
  • autre pour désactivé

Description

Extrait la liste des contacts.

Eléments renvoyés

Un nœud <UDSObjectList> comportant aucun, un ou plusieurs nœuds <UDSObject> décrivant les contacts avec les nœuds enfants <Attributes> suivants :

Valeur de l'élément XML

Type

Description

id

UUID

Spécifie l'ID unique du contact.

userid

Chaîne

Spécifie le nom d'utilisateur du contact.

last_name

Chaîne

Identifie le nom de famille du contact.

first_name

Chaîne

Identifie le prénom du contact.

access_type

Nombre entier

Spécifie l'ID Rôle du contact.

delete_flag

Nombre entier

Indique si le contact est activé ou désactivé :

  • 0 : Activé
  • 1 : Désactivé

loginWithArtifact

Les paramètres suivants s'appliquent à la méthode loginWithArtifact :

Paramètre

Type

Description

userid

Chaîne

Identifie l'ID d'utilisateur.

artifact

Chaîne

Identifie l'artefact obtenu à partir de CA EEM.

Description

Effectue l'authentification d'utilisateur à l'aide de l'artefact CA EEM fourni et ouvre une session sur le serveur d'arrière-plan. Vous ne pouvez utiliser l'artefact qu'une seule fois pour l'authentification. L'ID de session (SID) renvoyé peut être utilisé pour les appels de méthodes de services Web suivants. L'artefact peut être récupéré directement à partir de CA EEM ou obtenu via la méthode getArtifact.

Remarque : Pour pouvoir effectuer cette opération, CA Service Desk doit être intégré à CA EEM.

L'ID de session doit être libéré à l'aide de la méthode logout(). L'ID de session peut arriver à expiration s'il n'est pas utilisé avant la fin du délai.

Eléments renvoyés

Les éléments suivants sont renvoyés :

Paramètre

Type

Description

SID

Chaîne

Identifie l'ID de session unique (SID) à utiliser pour les autres services Web. Elle est au format de texte brut.