createAsset

Web Services Methods › Asset Management Methods › createAsset

createAsset

The following parameters apply to the createAsset method:

Parameter	Type	Description
SID	Integer	Identifies the session retrieved from logging in.
attrVals	String[]	Identifies the array of name-value pairs used to set the initial attribute values for the new asset.
attributes	String[]	Identifies the sequence of attribute names from the new object for which to return values. Dot-notation is permitted. If this field is empty, all attribute values are returned.
createAssetResult	String Holder	Identifies the String Holder object for capturing returned data.
newAssetHandle	String Holder	Identifies the String Holder object for capturing returned data.
newExtensionHandle	String Holder	Identifies the String Holder object for capturing returned data.
newExtensionName	String Holder	Identifies the String Holder object for capturing returned data.

Description

Describes the recommend method for creating an asset. If you intend to create an asset with an extension, be sure to set the Asset Class attribute in the attrVals section.

Note: If you are using the ITIL methodology, use this method to create a Configuration Item.

Returns

A <UDSObject> element containing the handle for the new object, with attribute values specified in the attributes parameter. If the attributes parameter is empty, all attribute values are returned. List and LREL types are also returned, but as empty elements.

XML Element	Type	Description
<createAssetResult>	N/A	Identifies the standard <UDSObject> element containing the handle and requested attribute values.
<newAssetHandle>	String	Identifies the new request’s handle.
<newExtensionHandle>	String	Identifies the handle for the new Asset’s extension. If no extension was created, this field is empty.
<newExtensionName>	String	Identifies the name for the new asset’s extension. If no extension was created, this field is empty.