createRequest

以下参数适用于 createRequest 方法：

参数	类型	说明
SID	整型	标识从登录检索的会话。
creatorHandle	字符串	标识负责创建请求的联系人的句柄（日志代理）。传递一个空字符串，以指定默认的 CA SDM 用户。
attrVals	字符串 []	标识用于设置新请求的初始属性值的名称值对的数组。注意：名称中不允许带点。
propertyValues	字符串 []	标识附加至新请求的任何属性的值数组。
模板	字符串	（可选）标识用于创建请求的请求模板 (cr_tpl) 的句柄。
属性	字符串 []	指定新对象中要返回值的属性名称序列。允许使用点标记法。如果此字段为空，则返回所有基于值的属性值。
newRequestHandle	String Holder	指定用于捕获返回数据的 String Holder 对象。有关详细信息，请参阅下面的“XML 元素返回”列表。
newRequestNumber	String Holder	指定用于捕获返回数据的 String Holder 对象。有关详细信息，请参阅下面的“XML 元素返回”列表。

说明

创建 CA SDM 请求 (cr) 对象。您必须使用此功能创建请求；而不要使用 createObject()。

propertyValues 是每个附加至新请求的属性对象的值列表。附加的属性由新请求的‘category’属性值确定。从 CA SDM Web 服务界面创建的所有属性将有默认值（有关详细信息，请参阅“类别和属性”），这一点非常重要，因为只有当请求的所有标记为“必需”的属性都具有值时，才会保存该请求。

对于在创建请求时附加的任何属性，您可以通过提供值来改写其默认值。由于 createRequest() 试图后台存储您最近创建的对象，因此您必须在创建请求之前提供此信息。使用 getPropertyInfoForCategory() 获取特定类别的属性列表。此功能按‘sequence’属性的顺序返回属性，该顺序是 propertyValues 数组的期望顺序。例如，如果属性的序列和符号如下：

100 – 硬盘驱动器大小

200 – CPU

300 – 内存

根据编程语言，propertyValues 数组可能显示如下：

[“40 GB”, “Pentium 4 1.7 Ghz”, “256”]

getPropertyInfoForCategory() 指明哪些属性标记为必需。

如果您未设置请求类别或不想设置任何属性值，则为 propertyValues 传递空字符串。

如果您不想使用默认属性值，以下是新建请求（或问题或变更单）的建议顺序：

检索类别/区域列表。请求区域的对象名称为‘pcat’。
调用 getPropertyInfoForCategory() 并检查新请求/问题/变更单类别的属性列表。
为每个返回的属性创建值数组。这通过创建操作的 propertyValues 参数来标识。
汇编 attrVals 数组并调用创建方法。

作为以上步骤的替代方法，您可以在 createRequest() 返回后，使用 getRelatedListValues() 检索属性列表。属性存储在请求的“属性”列表中。

根据应用程序，至少缓存类别列表时可以运行速度更快，因为此数据在许多客户端站点常常都不会发生变更。

注意：默认情况下，此方法会创建请求。如果您正在使用 ITIL 方法，则需要在 attrVals 数组中设置‘type’属性，以定义是创建事件票据还是故障票据。有关 ITIL 过程的详细信息，请参阅“使用 ITIL 方法安装的注意事项”。

返回新对象句柄及其全部属性值。也返回列表和 LREL 类型，但以空元素返回。

XML 元素	类型	说明
<UDSObject>	N/A	标识包含句柄和所需属性值的标准 UDSObject 元素。
<newRequestHandle>	字符串	标识新请求句柄。
<newRequestNumber>	字符串	标识新请求编号（其“ref_num”属性）。