上一主题: createActivityLog下一主题: detachChangeFromRequest


attachChangeToRequest

以下参数适用于 attachChangeToRequest 方法:

参数

类型

描述

SID

整型

标识从登录检索的会话。

创建者

字符串

标识负责此活动的联系人的句柄。

requestHandle

字符串

标识要附加变更的请求。

changeHandle

字符串

标识要添加的变更的句柄。如果为空,将新建变更单。有关附加信息,请参见以下描述。

changeAttrVals

String[]

在 changeHandle 为空时标识用于初始化新变更单的属性值对。有关详细信息,请参见以下描述。

description

字符串

(可选)标识活动的描述。

描述

将新变更单或现有变更单附加至请求。它与 CA SDM 界面中“请求详细信息”上的“活动 - 新建变更请求”或“活动 - 附加至现有请求”相对应。

要新建变更单,请在 changeHandle 中传递空字符串。系统将新建变更单,该变更单具有请求所初始化的值,包括变更的“请求人”、“受影响的最终用户”、“说明”以及“优先级”(您可以在 CA SDM 界面中查看此结果)。您可以使用 changeAttrVals 改写这些值或设置附加值,它是一个与传递给 createObject() 的内容相类似的名称值数组。

要附加现有变更单,请在 changeHandle 参数中指定句柄。在此情况下,将忽略 changeAttrVals

如果创建了新变更单,则在新变更单的活动日志中使用 description。如果附加了现有变更,则在请求的活动日志中使用 description

如果请求已附加变更单,则返回以下错误:

UDS_CREATION_ERROR

注意:此方法的工作方式与 ITIL 方法的工作方式相同,只需确认您将 ITIL 突发事件或问题的合适句柄传递给方法。

返回

返回以下内容:

XML 元素

类型

描述

<changeHandle>

字符串

标识创建或附加的变更单的句柄。