The following macros are not currently supported in the header:
  • style

update 调用

update 调用用于使用指定的值修改由记录标识符标识的现有记录(实体)。  

update 请求   

除常规的登录 ID 和密码参数外,update 调用还需要以下参数:    

成员:Bean 类

说明:实体特定的 java bean 类(复杂的数据类型),包含更新由记录标识符标识的现有实体时必须更新的字段的值。

在更新期间,您不需要为该实体类型指定所有字段。 请为希望在此调用期间更新的那些字段传递值。

未指定的字段将保持不变。 太长的字段将会截断。 如果您在 update 请求中发送无法识别的字段值,Service Desk WS API 将拒绝调用并发送状态代码 300 和相关的状态信息,该信息包括以下内容:

Rejecting the value supplied for input data element "{ 0} "; due to a correlation failure because the data transformation process could not resolve the supplied input data element into native format.
  • API 对无法识别的字段值应用严格的定义,以便调用中的所有字段对该操作的用户都必须有效。 例如:API 拒绝为已从用户的访问权限中删除或移除的自定义字段指定值的调用。
  • API 拒绝指定只读字段的调用。

update 响应:所有 API 调用的默认服务响应都包含将要以 update 调用所请求的输出格式更新的记录的记录标识符(行 ID)。

您可以通过输入 ##NULL##,来清除非必需的文本字段。 然而,当您在强制字段中输入 ##NULL## 后,您将收到标准消息,说明该字段是强制的。

用户尝试更新故障单时,将显示一条错误消息,指示以下字段为只读字段:

  • 请求人组织
  • 请求人位置
  • 请求人站点
  • 请求委托人组织
  • 请求委托人位置
  • 请求委托人站点
  • 上级情况

 

 

© 2017 ServiceAide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com