The following macros are not currently supported in the header:
- style
日期时间字段
所有日期/时间字段使用 XML-RPC 类型 dateTime.iso8601 或 SOAP 类型 dateTime 都通过 Service Desk WS API 传输。 然而,Service Desk 在内部对日期和时间采用两种不同的处理方式。
在某些情况下,您可以采用相同的方式处理日期/时间字段,但是在某些情况下,您可能需要以不同的方式处理。
常规日期/时间字段:
在 GMT 时间 1970 年 1 月 1 日午夜后,“常规日期/时间”字段作为秒数存储。 它们会在 GMT/UTC 时区间自动转换。 您无需将本地时间戳转换为 GMT/UTC 时区值。
常规“日期/时间”字段的示例包括所有“创建日期”字段、“开始日期/时间”字段和“结束日期/时间”字段。
仅日期字段:
Service Desk 中的某些字段是仅日期字段。 “仅日期”字段的时间部分无关,并设为 GMT/UTC 时区的午夜。
由于 XMLRPC 没有“仅日期”类型,因此在 API 中,对于 SOAP,“仅日期”字段作为 dateTime 类型传输;对于 XML-RPC 调用,“仅日期”字段作为 dateTime.iso8601 类型传输。
考虑以下最佳实践:
- 您应该使用与常规日期/时间值不同的方式处理“仅日期”字段值:
- 忽略任何时间部分。
- 将时间部分作为零发送。
Service Desk 接受包含非零时间部分的“仅日期”值。 然而,时间部分始终被截短到零。 请不要改变任何“仅日期”值以说明时区变化,因为时间部分没有意义。
© 2017 ServiceAide 1-650-206-8988 http://www.serviceaide.com info@serviceaide.com