Previous Topic: createRequestNext Topic: getPropertyInfoForCategory


createChangeOrder

The following parameters apply to the createChangeOrder method:

Parameter

Type

Description

SID

Integer

Identifies the session retrieved from logging in.

creatorHandle

String

Identifies the handle of the contact responsible for the creation of the change order (the log agent). Pass an empty string to specify the default CA SDM user.

attrVals

String[]

Identifies an array of name-value pairs that is used to set the initial attribute values for the change order.

Note: Dotted names are not permitted.

propertyValues

String[]

(Optional) Identifies the array of values for any properties that are attached to the new change order.

template

String

(Optional) Identifies the handle of the change template (chg_tpl object) from which to create the change order.

attributes

String[]

Specifies the sequence of attribute names from the new object for which to return values.

Dot-notation is permitted. If this field is empty, all value-based attribute values are returned.

newChangeHandle

String Holder

Specifies the String Holder object for capturing returned data.

newChangeNumber

String Holder

Specifies the String Holder object for capturing returned data.

Description

Creates a CA SDM Change Order (chg) object. You must use this function to create a change order; do not use createObject().

Returns

The new object handle with all of its attribute values. List and LREL types are also returned, but as empty elements.

XML Element

Type

Description

<UDSObject>

N/A

Identifies the standard UDSObject element containing the handle and request attribute values.

<newChangeHandle>

String

Identifies the new change order handle.

<newChangeNumber>

String

Identifies the new change order number (its ‘chg_ref_num’ attribute).