上一主题: 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>

字符串

标识新对象句柄。