|
|
|
|
UpdateTicket
更新工单一个或多个字段。仅可以更新在“工单处理”>“电子邮件读取器”页面中列出的字段。
更新列表字段
在以下示例中，“原始”字段是具有四个可能值的“列表”类型字段。请求将传递字段的名称“原始”，以及表示值在列表中的位置的编号，从 1 开始计数。例如，值“电话”在列表中的第二个位置，因此传递以将“原始”字段更改为“电话”的值为 2。
警告：通过重新排序或在列表中输入新值来更改下拉列表值的顺序，将更改 UpdateTicket 操作所选的值。请确保用户在对“电子邮件读取器”字段值进行更改前，了解此整合约束
关闭工单
更新工单可能包括通过将“状态”字段的值更新为 3（表示“状态”字段下拉列表中的第三个值）来关闭提交的 MonitorTicketID。以下显示了一个示例。可以向以下示例添加其他 <TicketField> 名称/值元素来更新多个字段。
<UpdateTicketRequest>
<TicketID>1</TicketID>
<TicketFields>
<TicketField>
<Name>状态</Name>
<Value>3</Value>
</TicketField>
</TicketFields>
<SessionID>13642146236194247244181221</SessionID>
</UpdateTicketRequest>
更新字段的其他类型
可以更新工单字段的以下其他类型：
字符串- 最多可包含长达 500 个字符任意文本。最适合用于保留诸如问题位置或不属于摘要行的其他变量等内容。整数- 可包含任意正整数或负整数值。数字 (nn.d)- 始终在小数点右侧显示一位数的数字。数字 (nn.dd)- 始终在小数点右侧显示两位数的数字。数字 (nn.ddd)- 始终在小数点右侧显示三位数的数字。数字 (nn.dddd)- 始终在小数点右侧显示四位数的数字。
返回的字段
将返回以下字段的单个记录。
Method |
字符串 |
请求此响应的操作。 |
TransactionID |
小数 |
此消息的唯一消息 ID。 |
ErrorMessage |
字符串 |
如果为空，表示未返回错误。 |
ErrorLocation |
字符串 |
如果为空，表示未返回错误。 |
工单附件
API Web 服务不能用于获取或更新工单文件附件。工单文件附件通常位于 KServer 的 C:\Kaseya\WebPages\ManagedFiles 目录中。API 开发人员负责编写代码，以在此目录中放置附件文件，然后再创建引用这些附件的 Web 服务 API 调用。