updateObject

Web-Service-Methoden › Sonstige Methoden › updateObject

updateObject

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

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
objectHandle	Zeichenfolge	Gibt die Kennung eines zu aktualisierenden CA SDM-Objekts an.
attrVals	Zeichenfolge[]	Gibt die Namen-Wert-Paare für die Aktualisierung an.
Attribute	Zeichenfolge[]	Gibt die Sequenz der Attributnamen aus dem Objekt an, für die Werte zurückgegeben werden sollen. Punktnotation ist zulässig. Wenn dieses Feld leer ist, werden alle Attributwerte zurückgegeben.

Beschreibung

Aktualisiert ein oder mehrere Attribute für das angegebene Objekt.

Um Werte für das Objekt festzulegen, übergibt der Anrufer ein eindimensionales Array von Attributname-Wert-Paaren. Die erste Hälfte eines solchen Paars ist ein Attributname, die zweite gibt den eigentlichen Wert an. Namen mit Punkten sind unzulässig.

Um ein Attribut des Zeigertyps zu aktualisieren (z. B. das Kundenfeld bei einem Request), muss eine Kennung für den Wert verwendet werden. Übergeben Sie für die Typen „Ganzzahl“, „Datum“ und „Dauer“ die Zeichenfolgendarstellung einer Ganzzahl.

Um beispielsweise einen Request mit einem neuen Zuständigen, einer Beschreibung und einer Priorität zu aktualisieren, würde das Array folgendermaßen aussehen:

[0] - "assignee"

[1] - "cnt:555A043EDDB36D4F97524F2496B35E75" (eine Kontaktkennung)

[2] - "description"

[3] - "My new description"

[4] - "priority"

[5] - "pri:38903" (eine Prioritätskennung)

Sollte die Aktualisierung fehlschlagen, wird der gesamte Vorgang abgebrochen, ohne dass Änderungen vorgenommen werden.

Hinweis: Legen Sie beim Aktualisieren einer Aufgabe den Statuswert im Attribut-Array zuletzt fest.

Rückgabe

Ein <UDSObject>-Element, das die Kennung des aktualisierten Objekts sowie die im Parameter „attributes“ angegebenen Attributwerte enthält. Bei leerem Parameter „attributes“ werden alle Attributwerte zurückgegeben. Listen- und LREL-Typen werden ebenfalls zurückgegeben, jedoch als leere Elemente.

getArtifact

Die folgenden Parameter gelten für die Methode "getArtifact":

Parameter

Typ

Beschreibung

SID

Ganzzahl

Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.

Kontakt

Zeichenfolge

Gibt den Namen des Anwenders an, der der zurückgegebenen ARTIFACT zugeordnet ist.

Hinweis: Dies ist der Systemanmeldename, nicht der CA Service Desk Manager-Kontaktname.

password

Zeichenfolge

Gibt das Kennwort an.

Beschreibung

Erleichtert das Erstellen von Web-Schnittstellen-URLs, die zum Starten der Web-Schnittstelle im Kontext eines bestimmten Anwenders ohne Anmeldeaufforderung verwendet werden können. Die URL kann ungefähr wie folgt aussehen:

http://host/CAisd/pdmweb.exe?USERNAME=xxxxx+ARTIFACT=nnnnn+OP=xxxx....

Zum Starten der Web-Schnittstelle im Kontext eines bestimmten Anwenders (z. B. eines Analysten) muss eine aufrufende Anwendung zunächst eine Web-Schnittstellen-URL erstellen, die ein CA EEM ARTIFACT-Token (ein Sicherheits-Token für Web-Schnittstellen) erstellen. Wird kein CA EEM ARTIFACT-Token bereitgestellt, kann es beim Starten der Web-Schnittstelle in dem gewählten Kontext (z. B. eine Detailansicht eines bestimmten Tickets) zu einer interaktiven Anmeldeaufforderung kommen. Mit der Methode "getArtifact" kann ein solches CA EEM ARTIFACT im Kontext des durch den Kontaktparameter angegebenen Anwenders generiert werden.

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

Rückgabe

Ein CA EEM ARTIFACT, das auf dem Namen des eingegebenen Anwenders basiert. Sie können ARTIFACT verwenden, um die Web-Schnittstelle nur einmal zu starten.