findContacts

Web-Service-Methoden › Kontaktverwaltungsmethoden › findContacts

findContacts

Die folgenden Parameter gelten für die Methode „findContacts“:

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
userName	Zeichenfolge	Gibt nur die Kontakte mit diesem Anwendernamen zurück. Sie können Suchvorgänge unter Verwendung des Platzhalters % durchführen. Um beispielsweise nach allen Kontakten zu suchen, deren Anwendername mit „Schm“ beginnt, geben Sie „Schm%“ an.
lastName	Zeichenfolge	Gibt nur die Kontakte mit diesem Nachnamen zurück. Sie können Suchvorgänge unter Verwendung des Platzhalters % durchführen.
firstName	Zeichenfolge	Gibt nur die Kontakte mit diesem Vornamen zurück. Sie können Suchvorgänge unter Verwendung des Platzhalters % durchführen.
email	Zeichenfolge	Gibt nur die Kontakte mit dieser E-Mail-Adresse zurück. Sie können Suchvorgänge unter Verwendung des Platzhalters % durchführen.
accessType	Zeichenfolge	Gibt nur die Kontakte mit diesem Zugriffstyp zurück. Sie können mehrfache Rollen festlegen, die durch Kommas zu trennen sind. Geben Sie Folgendes an: 10002 - Administration 10004 - Kunde 10005 - Mitarbeiter 10009 - IT-Mitarbeiter 10013 - Knowledge Management 10014 - Prozessmanagement 10010 - Service Desk-Management 10008 - Service Desk-Mitarbeiter 10020 - Mitarbeiter des Anbieters
inactiveFlag	Ganzzahl	Gibt nur die Kontakte zurück, die inaktiv bzw. aktiv sind. Geben Sie Folgendes an: 0 für aktiv –999 für alle Sonstiges für inaktiv

Beschreibung

Ruft die Liste der Kontakte auf.

Rückgabe

Ein <UDSObjectList>-Knoten mit keinem oder mehreren <UDSObject>-Knoten, die Kontakte mit den folgenden untergeordneten <Attributes>-Knoten beschreiben:

Wert des XML-Elements	Typ	Beschreibung
ID	UUID	Gibt die eindeutige ID des Kontakts an.
userid	Zeichenfolge	Gibt den Anwendernamen des Kontakts an.
last_name	Zeichenfolge	Gibt den Nachnamen des Kontakts an.
first_name	Zeichenfolge	Gibt den Vornamen des Kontakts an.
access_type	Ganzzahl	Gibt die Rollen-ID des Kontakts an.
delete_flag	Ganzzahl	Zeigt an, ob der Kontakt aktiv oder inaktiv ist: 0 - Aktiv 1 - Inaktiv

loginWithArtifact

Die folgenden Parameter gelten für die Methode „loginWithArtifact“:

Parameter	Typ	Beschreibung
userid	Zeichenfolge	Gibt die Anwender-ID an.
Artefakt	Zeichenfolge	Identifiziert das von CA EEM abgerufene Artefakt.

Beschreibung

Führt die Anwenderauthentifizierung über das angegebene CA EEM-Artefakt aus und öffnet eine Sitzung mit dem Backend-Server. Das Artefakt kann für die Authentifizierung nur einmal verwendet werden. Die zurückgegebene Sitzungs-ID (SID) kann für nachfolgende Webservices-Methodenaufrufe verwendet werden. Das Artefakt kann direkt von CA EEM oder über die Methode "getArtifact" abgerufen werden.

Hinweis: Service Desk muss in CA EEM integriert werden, um diesen Vorgang auszuführen.

Die SID sollte mit „logout()“ freigegeben werden. Eine SID kann ablaufen, sofern sie nicht innerhalb einer bestimmten Zeitdauer verwendet wird.

Rückgabe

Folgendes wird zurückgegeben:

Parameter	Typ	Beschreibung
SID	Zeichenfolge	Gibt die eindeutige Sitzungs-ID (SID) an, die für alle anderen Webservices-Aufrufe zu verwenden ist. Sie liegt im Nur-Text-Format vor.