Metodi dei servizi Web › Metodi di gestione dei contatti › findContacts

Argomento precedente: getContact

Argomento successivo: Metodi di gestione dei gruppi

findContacts

I parametri seguenti sono validi per il metodo findContacts:

Parametro

Tipo

Descrizione

SID

Numero intero

Identifica la sessione recuperata dall'accesso.

userName

Stringa

Restituisce solo i contatti con questo nome utente. È possibile eseguire ricerche con carattere jolly utilizzando il segno di percentuale (%).

Ad esempio, per ricercare tutti i contatti il cui nome utente inizia con Smi, specificare Smi%.

lastName

Stringa

Restituisce solo i contatti con questo cognome. È possibile eseguire ricerche con carattere jolly utilizzando il segno di percentuale (%).

firstName

Stringa

Restituisce solo i contatti con questo nome. È possibile eseguire ricerche con carattere jolly utilizzando il segno di percentuale (%).

email

Stringa

Restituisce solo i contatti con questo indirizzo di posta elettronica. È possibile eseguire ricerche con carattere jolly utilizzando il segno di percentuale (%).

accessType

Stringa

Restituisce solo i contatti con questo tipo di accesso. È possibile specificare più ruoli separandoli con le virgole. Specificare quanto segue:

  • 10002 - Amministrazione
  • 10004 - Cliente
  • 10005 - Dipendente
  • 10009 - Staff IT
  • 10013 - Gestione della conoscenza
  • 10014 - Gestione processi
  • 10010 - Gestione Service Desk
  • 10008 - Staff Service Desk
  • 10020 - Staff dei vendor

inactiveFlag

Numero intero

Restituisce solo i contatti non attivi o attivi. Specificare quanto segue:

  • 0 per attivo
  • -999 per tutto
  • altro per inattivo

Descrizione

Recupera l'elenco dei contatti.

Valore restituito

Un nodo <UDSObjectList> con zero o più nodi <UDSObject> che descrive i contatti con i nodi figlio <Attributes> seguenti:

Valore elemento XML

Tipo

Descrizione

id

UUID

Specifica l'ID univoco del contatto.

id utente

Stringa

Specifica il nome utente del contatto.

last_name

Stringa

Identifica il cognome del contatto.

first_name

Stringa

Identifica il nome del contatto.

access_type

Numero intero

Specifica l'ID ruolo del contatto.

delete_flag

Numero intero

Indica se il contatto è attivo o non attivo:

  • 0 - Attivo
  • 1 - Inattivo

loginWithArtifact

I parametri seguenti sono validi per il metodo loginWithArtifact:

Parametro

Tipo

Descrizione

id utente

Stringa

Identifica l'ID utente.

artifact

Stringa

Identifica l'artifact ottenuto da CA EEM.

Descrizione

Esegue l'autenticazione utente dall'artifact fornito di CA EEM e apre una sessione con il server di back-end. È possibile utilizzare solo una volta l'artifact per l'autenticazione. Il SID restituito può essere utilizzato per il richiamo successivo di altri metodi dei servizi Web. L'artifact può essere acquisito direttamente da CA EEM o può essere ottenuto attraverso il metodo getArtifact.

Nota: Service Desk deve essere integrato con CA EEM per eseguire questa operazione.

Il SID dovrebbe essere rilasciato con il metodo logout(). Un SID può scadere se non viene utilizzato prima di un timeout.

Valore restituito

I valori restituiti sono i seguenti:

Parametro

Tipo

Descrizione

SID

Stringa

Identifica il SID univoco da utilizzare per tutte le altre chiamate ai servizi Web. È in formato di testo semplice.