上一主题: createDocument下一主题: deleteDocument


modifyDocument

以下参数适用于 modifyDocument 方法:

参数

类型

描述

SID

整型

标识从登录检索的会话。

docId

整型

标识要修改的文档的唯一 ID。

kdAttributes

String[]

指定用于更新的名称值对,例如“SUMMARY”、“摘要文本”、“TITLE”和“标题文本”。

作为 modifyDocument 方法的一部分,下表反映了文档的常用有效属性值的示例。“类型”列的数据反映了实际类型,必须在 attrVals 字符串数组中以字符串格式传递给方法。

参数

类型

描述

MODIFY_DATE

(字符串)

表示用于“记录锁定”的特殊字段,以确保在您更新文档的同时没有其他人正在更新文档。您必须传入文档的现有 MODIFY_DATE。如果将修改日期留空,您将收到一则表示其他用户已经更新此文档的错误消息。

USER_DEF_ID

字符串

指定用于表示文档的任意 ID。

TITLE

字符串

表示文档的标题。

SUMMARY

字符串

表示文档的摘要。

PROBLEM

字符串

表示文档的问题。

RESOLUTION

字符串

表示文档的解决方法。可包含 html。

STATUS_ID

整型

表示文档的状态 ID。默认值为 10(草稿)。

PRIORTY_ID

整型

表示文档的优先级 ID。默认值为 20(正常)。

START_DATE

日期(字符串)

表示文档被激活的日期,还与 ExpirationDate 一起使用。留空以不指定开始日期,只要没超过截止日期,文档将为活动状态。

EXPIRATION_DATE

日期(字符串)

表示文档到期的日期,与 StartDate 一起使用。保留为空白则不指定截止日期。

SD_PRODUCT_ID

整型

表示用以关联此文档的 CA SDM 中的产品 ID。

ASSIGNEE_ID

UUID

表示将此文档分配到的 CA SDM 中的唯一 ID。

SD_ASSET_ID

UUID

表示用以关联此文档的 CA SDM 中的资产 ID。

SD_ROOTCAUSE_ID

整型

表示用以关联此文档的 CA SDM 中的根本原因 ID。

SD_PRIORITY_ID

整型

表示用以关联此文档的 CA SDM 中的优先级 ID。

SD_SEVERITY_ID

整型

表示用以关联此文档的 CA SDM 中的严重度 ID。

SD_IMPACT_ID

整型

表示用以关联此文档的 CA SDM 中的影响 ID。

SD_URGENCY_ID

整型

指定用以关联此文档的 CA SDM 中的紧急度 ID。

AUTHOR_ID

UUID

标识编写此文档的联系人的唯一 ID。如果作者不是内部联系人,您可以将此字段设为零 (0) 并使用“Author”参数。

OWNER_ID

UUID

标识拥有此文档的联系人的唯一 ID。

SUBJECT_EXPERT_ID

UUID

表示联系人的唯一 ID,该联系人为此文档的主题专家。

NOTES

字符串

表示文档的注释。

READ_GROUP_LIST

字符串

表示对此文档具有读权限且以短划线分隔的组 ID 列表(如 1-3-4)。使用 A 向所有人分配权限。

WRITE_GROUP_LIST

字符串

表示对此文档具有写权限且以短划线分隔的组 ID 列表(如 1-3-4)。使用 A 向所有人分配权限。

INHERIT_PERMISSION

布尔值

表示继承权限标志的状态。如果要从创建文档的类别中继承权限,则将其设置为“真”。如果设置为“真”,将忽略 ReadPermissions 和 WritePermissions 参数。

DOC_TYPE_ID

整型

标识此文档要成为的文档类型的 ID:常规文档或树型文档。默认为常规文档。

HITS

整型

表示文档已被查看的次数。

DOC_TEMPLATE_ID

整型

标识需要分配给此文档的模板的 ID。

WF_TEMPLATE

整型

标识需要分配给此文档的工作流模板的 ID。

WF_ACTION

字符串

标识需要分配给此文档的工作流的操作。例如,wf_unpublish 可让文档变为取消发布状态。

WF_COMMENT

字符串

标识需要分配给此文档的工作流的注释。例如,取消发布。

WF_CONTACT_ID

UUID

标识需要分配给此文档的工作流的用户 ID。

WF_REJECT_TO_ID

整型

标识需要分配给此文档的工作流的任务 ID,与其审批流程相匹配。任务 ID 存储在 CI_ACTIONS 表中。

CUSTOM1

字符串

表示自定义字段。

CUSTOM2

字符串

表示自定义字段。

CUSTOM3

字符串

表示自定义字段。

CUSTOM4

字符串

表示自定义字段。

CUSTOM5

字符串

表示自定义字段。

CUSTOMNUM1

双精度型

表示数字自定义字段。

CUSTOMNUM2

双精度型

表示数字自定义字段。

描述

修改文档。

返回

描述被修改的知识文档的 <UDSObject> 节点。