attachChangeToRequest

Web-Service-Methoden › Geschäftsmethoden › attachChangeToRequest

attachChangeToRequest

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

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.
requestHandle	Zeichenfolge	Gibt die Anforderung an, an die die Änderung angehängt wird.
changeHandle	Zeichenfolge	Gibt die Kennung der hinzuzufügenden Änderung an. Ist dieses Feld leer, wird ein neuer Änderungsauftrag erstellt. Weitere Informationen sind in der folgenden Beschreibung enthalten.
changeAttrVals	Zeichenfolge[]	Gibt die Attribut-Wert-Paare an, die zur Initialisierung eines neuen Änderungsauftrags verwendet werden, wenn „changeHandle“ leer ist. Weitere Informationen sind in der folgenden Beschreibung enthalten.
description	Zeichenfolge	(optional) Gibt die Beschreibung der Aktivität an.

Beschreibung

Hängt einen neuen oder vorhandenen Änderungsauftrag an eine Anforderung an. Dies entspricht dem Befehl "Aktivitäten" > "Neue Change-Anfrage" bzw. "Aktivitäten" > "An vorhandene Anfrage anhängen" in den Anfragedetails in der CA SDM-Schnittstelle.

Um einen neuen Änderungsauftrag zu erstellen, übergeben Sie eine leere Zeichenfolge in „changeHandle“. Das System erstellt daraufhin einen neuen Change mit Werten, die von der Anfrage initialisiert werden, einschließlich des Benutzers, der den Change anfordert, sowie des betroffenen Endbenutzers, der Beschreibung und der Priorität (siehe CA SDM-Schnittstelle). Sie können sie überschreiben oder zusätzliche Werte mit changeAttrVals festlegen, wobei es sich um ein Name-Wert-Array ähnlich dem für createObject() handelt.

Um einen vorhandenen Änderungsauftrag anzuhängen, geben Sie eine Kennung im Parameter „changeHandle“ an. In diesem Fall wird changeAttrVals ignoriert.

Wenn ein neuer Änderungsauftrag erstellt wird, wird „description“ im Aktivitätsprotokoll des neuen Änderungsauftrags verwendet. Wenn eine vorhandene Änderung angehängt wird, wird "description" im Aktivitätsprotokoll der Anfrage verwendet.

Ist bereits ein Änderungsauftrag an die Anforderung angehängt worden, wird folgender Fehler ausgegeben:

UDS_CREATION_ERROR

Hinweis: Die Funktionsweise dieser Methode gilt ebenso für die ITIL Methodology. Achten Sie einfach darauf, dass Sie die korrekte Kennung eines ITIL-Incident oder -Problems an die Methode übergeben.

Rückgabe

Folgendes wird zurückgegeben:

XML-Element	Typ	Beschreibung
<changeHandle>	Zeichenfolge	Gibt die Kennung für den erstellten oder angehängten Änderungsauftrag an.