Eskalieren

Web-Service-Methoden › Geschäftsmethoden › Eskalieren

Eskalieren

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

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
creator	Zeichenfolge	Gibt die Kennung des für die Aktivität zuständigen Kontakts an.
objectHandle	Zeichenfolge	Gibt die Kennung für eine Anforderung, Problemanfrage oder einen Änderungsauftrag an. Andere Objekttypen werden zurückgewiesen.
description	Zeichenfolge	Gibt die Beschreibung für die Aktivität an, die im Aktivitätsprotokoll angezeigt werden wird.
setAssignee	Boolescher Wert	Aktualisiert das Feld „assignee“, wenn der Wert wahr ist.
newAssigneeHandle	Zeichenfolge	Gibt die Kennung des neuen Verantwortlichen für das Objekt an.
setGroup	Boolescher Wert	Aktualisiert das Gruppenfeld mit dem Wert in „newGroupHandle“, wenn der Wert wahr ist.
newGroupHandle	Zeichenfolge	Gibt die Kennung der neuen Gruppe für das Objekt an.
setOrganization	Boolescher Wert	Stellt das Feld „Organisation“ auf den in „newOrganizationHandle“ angegebenen Wert ein, wenn der Wert wahr ist.
newOrgnizationHandle	Zeichenfolge	(nur Issues und Changes) Gibt die Kennung der neuen Organisation für das Objekt an.
setPriorityHandle	Boolescher Wert	Aktualisiert das Prioritätsfeld durch den in „newPriority“ angegebenen Wert ein, wenn der Wert wahr ist.
newPriority	Zeichenfolge	Gibt die Kennung der neuen Priorität für das Objekt an.

Beschreibung

Führt eine Eskalierungsaktivität auf einer Problemanfrage, einer Anforderung oder einem Änderungsauftrag durch. Durch diese Methode wird ein Aktivitätsprotokoll generiert und optional ein neuer Zuständiger, eine neue Gruppe, eine neue Priorität und/oder eine neue Organisation eingerichtet.

Dies entspricht dem Befehl "Aktivitäten – Eskalieren" in der CA SDM-Schnittstelle.

Der Zuständige, die Gruppe oder die Organisation wird erst aktualisiert, wenn mindestens einer der entsprechenden Parameter "setAssignee"/"setGroup"/"setOrganization" auf den Wert "True" gesetzt wird. Wenn der begleitende Parameter falsch ist, wird bei der Eskalierung nicht versucht, das Feld zu aktualisieren, selbst wenn ein Wert an das Feld übergeben wird. Wird beispielsweise "setAssignee" als "False" übergeben, wird der Zuständige bei der Eskalierung nicht aktualisiert, selbst wenn in "newAssignee" ein Wert angegeben ist. Ist der Parameter „setXXXX“ wahr, wird das Feld aktualisiert. Übergeben Sie eine leere Zeichenfolge, um ein Feld auf „Leer/Null“ zu setzen.

Hinweis: Die Organisation findet bei Anfragen keine Anwendung.

Rückgabe

Ein oder mehrere Kennungen für die erstellten Aktivitätsprotokollobjekte.

XML-Element	Typ	Beschreibung
<LogHandle>	Zeichenfolge	Gibt die Kennung für das neue Aktivitätsprotokoll an (es können keine oder mehrere zurückgegeben werden).