Web-Service-Methoden › Geschäftsmethoden › createRequest

createRequest

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

Beschreibung

Erstellt ein CA SDM-Request-Objekt ("cr"). Sie müssen diese Funktion zum Erstellen von Requests verwenden. Verwenden Sie nicht "createObject()".

"propertyValues" ist eine Liste mit Werten für jedes Eigenschaftsobjekt, das an den neuen Request angehängt wird. Die anzuhängenden Eigenschaften werden durch den Attributwert "category" des neuen Request festgelegt. Alle über die Webservices-Schnittstelle von CA SDM erstellten Eigenschaften weisen einen Standardwert auf (weitere Informationen finden Sie unter "Kategorien und Eigenschaften"). Dies ist wichtig, da ein Request erst dann gespeichert wird, wenn alle zugehörigen und als erforderlich gekennzeichneten Eigenschaften einen Wert haben.

Sie können die Standardwerte durch Angabe von Werten für beliebige Eigenschaften überschreiben, die bei Erstellung des Request angehängt werden. Sie müssen diese Angaben vor der Erstellung des Request machen, da "createRequest()" versucht, das zuletzt von Ihnen erstellte Objekt zu speichern. Mit „getPropertyInfoForCategory()“ erhalten Sie eine Liste der Eigenschaften für eine bestimmte Kategorie. Diese Funktion gibt die Eigenschaften in der Reihenfolge ihres Attributs „sequence“ zurück. Dies ist die für das Array „propertyValues“ erwartete Reihenfolge. Betrachten Sie die Sequenz und die Symbole der Eigenschaften im folgenden Beispiel:

100 - Festplattengröße

200 - CPU 

300 - Speicher

Das Array „propertyValues“ wird je nach Programmiersprache z. B. folgendermaßen angezeigt:

["40 GB", "Pentium 4 1.7 GHz", "256"]

„getPropertyInfoForCategory()“ gibt an, welche Eigenschaften als erforderlich gekennzeichnet sind.

Wenn Sie die Request-Kategorie nicht festlegen oder keine Eigenschaftswerte angeben möchten, übergeben Sie eine leere Zeichenfolge für "propertyValues".

Wenn Sie nicht die standardmäßigen Eigenschaftswerte übernehmen möchten, empfiehlt sich die folgende Reihenfolge für die Erstellung eines neuen Request (bzw. eines Issue oder Change):

1. Rufen Sie eine Liste der Kategorien/Bereiche ab. Der Objektname für den Request-Bereich lautet "pcat".
2. Rufen Sie "getPropertyInfoForCategory()" auf, und betrachten Sie die Liste der Eigenschaften für die Kategorie der/des neuen Request/Issue/Change.
3. Erstellen Sie ein Werte-Array für jede zurückgegebene Eigenschaft. Dies wird durch den Parameter propertyValues für den Erstellungsvorgang identifiziert.
4. Stellen Sie das Array „attrVals“ zusammen, und rufen Sie die Erstellungsmethode auf.

Alternativ zum vorherigen Verfahren können Sie die Liste der Eigenschaften anhand von „getRelatedListValues()“ nach Rückgabe von „createRequest()“ verwenden. Eigenschaften werden in der Liste "properties" eines Request gespeichert.

Je nach vorliegender Anwendung kann der Vorgang beschleunigt werden, wenn zumindest die Liste der Kategorien im Zwischenspeicher abgelegt wird, da die entsprechenden Daten an den meisten Client-Standorten nur selten geändert werden.

Hinweis: Standardmäßig wird durch diese Methode ein Request erstellt. Bei Verwendung der ITIL Methodology müssen Sie das Attribut „type“ im „attrVals“-Array festlegen, um anzugeben, ob Sie einen Incident oder ein Problemticket erstellen. Weitere Informationen zu ITIL-Verfahren finden Sie unter „Hinweis zur Verwendung der ITIL Methodology-Installation“.

Rückgabe

Gibt die Kennung des neuen Objekts mit allen seinen Attributwerten zurück. Listen- und LREL-Typen werden ebenfalls zurückgegeben, jedoch als leere Elemente.