Web Services Methods › Miscellaneous Methods › createObject

createObject

The following parameters apply to the createObject method:

Description

Creates a CA SDM object. The caller is responsible for setting any required fields in the attrVals parameter. Dotted-names are not permitted.

ObjectType

Identifies the name for an object type (factory).

attrVals

Describes the array of name-value pairs used to initialize the new object. For example, the following pseudo-code shows how to create a contact and return a <UDSObject> element with values for all its attributes:

String [4] attrVals;

attrVals[0] = “first_name”;	// attribute name

attrVals[1] = “Edgar”;	

attrVals[2] = “last_name”;

attrVals[3] = “Martin”;

string [0] emptyArray;

CreateObject(sid, “cnt”, attrVals, emptyArray, createObjectReturn, newHandle);

Note: Do not use this method for new assets, issues, requests, or change orders. Use the specialized createXXX() methods for those object types. This comment also applies if you are using the ITIL methodology—use the appropriate methods to create Configuration Items, Incidents, and Problems.

Returns

A <UDSObject> element containing the new objects handle, along 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.