updateObject

以下参数适用于 updateObject 方法：

参数	类型	说明
SID	整型	标识从登录检索的会话。
objectHandle	字符串	标识要更新的 CA SDM 对象的句柄。
attrVals	字符串 []	标识用于更新的名称值对。
属性	字符串 []	标识对象中要返回值的属性名称序列。允许使用点标记法。如果此字段为空，则返回所有属性值。

说明

更新指定对象的一个或多个属性。

要设置对象的值，调用方需要传递属性名称值对的一维数组。值对的前半部分为属性名，后半部分为实际值。不允许使用点名称。

要更新指针类型的属性（例如，请求上的客户字段），则必须为该值使用句柄。对于整型、日期和期限类型，请传递整型的字符串表现形式。

例如，要使用新受理人、说明、优先级更新请求，数组将显示如下：

[0] – “受理人”

[1] – “cnt:555A043EDDB36D4F97524F2496B35E75”（联系人句柄）

[2] – “说明”

[3] – “我的新描述”

[4] – “优先级”

[5] – “pri:38903”（优先级句柄）

如果更新因为某些原因失败，则整个操作将中止并且不会发生更改。

注意：更新任务时，最后在属性数组中设置状态值。

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

getArtifact

以下参数适用于 getArtifact 方法：

参数

类型

说明

SID

整型

标识从登录检索的会话。

联系人

字符串

标识与返回的印证码关联的用户的名称。

注意：该名称是系统登录名称，不是 CA Service Desk Manager 的联系人姓名。

密码

字符串

标识密码。

说明

便于构建 Web 界面 URL，这些 URL 可用于在指定用户的上下文中启动 Web 界面，无需登录验证。该 URL 可能大体如下：

http://host/CAisd/pdmweb.exe?USERNAME=xxxxx+ARTIFACT=nnnnn+OP=xxxx....

要在指定用户（例如分析人员）的上下文中启动 Web 界面，调用应用程序必须首先构建 Web 界面 URL，该 URL 包括 CA EEM 印证码令牌（即 Web 界面安全令牌）。如果未能提供 CA EEM 印证码令牌，则尝试在所选上下文（如指定故障单的详细视图）中启动 Web 界面时，可能需要进行交互式登录验证。通过 getArtifact 方法可以在由联系人参数提供的用户上下文中生成 CA EEM 印证码。

注意：Service Desk 需要与 CA EEM 集成才能执行此操作。

基于所输入用户名的 CA EEM 印证码。您只能使用此印证码启动一次 Web 界面。