上一主题: callServerMethod

下一主题: getBopsid

createObject

以下参数适用于 createObject 方法:

参数

类型

说明

SID

整型

标识从登录检索的会话。

ObjectType

字符串

标识要创建的对象类型(majic 工厂名)。

attrVals

字符串 []

标识用于设置新问题初始属性值的名称值对的序列。

注意:名称中不允许带点。

属性

字符串 []

标识用于返回值的新对象属性名称的顺序。 允许使用点标记法。 如果此字段为空,则返回所有属性值。

createObjectResult

String Holder

标识用于捕获返回数据的 String Holder 对象。 有关详细信息,请参阅下面的“XML 元素返回”列表。

newHandle

String Holder

标识用于捕获返回数据的 String Holder 对象。 有关详细信息,请参阅下面的“XML 元素返回”列表。

说明

创建 CA SDM 对象。 调用方负责设置 attrVals 参数中所需的任何字段。 不允许使用点名称。

ObjectType

标识对象类型(工厂)的名称。

attrVals

描述用于初始化新对象的名称值对的数组。 例如,以下伪代码显示如何创建联系人并返回带有全部属性值的 <UDSObject> 元素:

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);

注意:不要将此方法用于新资产、投诉、请求或变更单。 为这些对象类型使用专用的 createXXX() 方法。 此注释还适用于您使用 ITIL 方法的时候 - 使用适当的方法创建配置项、突发事件及问题。

返回

包含新对象句柄的 <UDSObject> 元素,以及 attributes 参数中指定的属性值。 如果 attributes 参数为空,则返回全部属性值。 也返回列表和 LREL 类型,但以空元素返回。

XML 元素

类型

说明

<createObjectResult>

N/A

标识包含句柄和所需属性值的标准 UDSObject 元素。

<newHandle>

字符串

标识新对象句柄。