createAsset

Web-Service-Methoden › Anlagenverwaltungsmethoden › createAsset

createAsset

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

Parameter	Typ	Beschreibung
SID	Ganzzahl	Gibt die Sitzung an, die durch die Anmeldung abgerufen wurde.
attrVals	Zeichenfolge[]	Gibt das Array von Name-Wert-Paaren an, die zur Festlegung des anfänglichen Attributwerts für die neue Anlage verwendet werden.
Attribute	Zeichenfolge[]	Gibt die Sequenz der Attributnamen aus dem neuen Objekt an, für die Werte zurückgegeben werden sollen. Punktnotation ist zulässig. Wenn dieses Feld leer ist, werden alle Attributwerte zurückgegeben.
createAssetResult	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten.
newAssetHandle	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten.
newExtensionHandle	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten.
newExtensionName	StringHolder	Bezeichnet das "StringHolder"-Objekt zum Erfassen von zurückgegebenen Daten.

Beschreibung

Beschreibt die für die Erstellung von Assets empfohlene Methode. Wenn Sie vorhaben, eine Anlage mit einer Erweiterung zu erstellen, legen Sie unbedingt das Attribut „Anlagenklasse“ im Abschnitt „attrVals“ fest.

Hinweis: Wenden Sie diese Methode bei Verwendung der ITIL Methodology zum Erstellen von Configuration Items an.

Rückgabe

Ein <UDSObject>-Element, das die Kennung des neuen 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.

XML-Element	Typ	Beschreibung
<createAssetResult>	N. rel.	Gibt das standardmäßige <UDSObject>-Element an, das die Kennung und die angeforderten Attributwerte enthält.
<newAssetHandle>	Zeichenfolge	Gibt die Kennung des neuen Request an.
<newExtensionHandle>	Zeichenfolge	Gibt die Kennung für die Erweiterung des neuen Assets an. Wenn keine Erweiterung erstellt wurde, ist dieses Feld leer.
<newExtensionName>	Zeichenfolge	Gibt den Namen für die Erweiterung des neuen Assets an. Wenn keine Erweiterung erstellt wurde, ist dieses Feld leer.