工作日志操作

工作日志操作

本节将讨论与特定请求相关的工作日志操作，如添加工作日志、更新、删除和查看现有工作日志。


要执行工作日志相关操作，应使用以下 URL 模式。


为现有请求添加工作日志：


http://<servername>:<port number>/sdpapi/request/<request id>/worklogs


用于对特定工作日志进行操作：


http://<servername>:<port number>/sdpapi/request/<request id>/worklogs/<worklog id>


添加工作日志

要为现有请求添加工作日志，URL 应为

http://<servername>:<port number>/sdpapi/request/<request id>/worklogs

因此，在上述情况下，URL 为 http://localhost:8080/sdpapi/request/24/worklogs/

要点

  1. 操作名称 “ADD_WORKLOG ”应作为 “POST attribute ”发送，关键字为 “OPERATION_NAME”。

  2. 技术员密钥应作为 “POST attribute”发送，其关键字为 “TECHNICIAN_KEY”。

  3. 输入是一个 XML 字符串，作为 “POST attribute”发送，关键字为 “INPUT_DATA”。

注意：请注意输入和输出 XML 格式已变更。 但出于兼容性考虑，输入操作将同时支持这两种格式。

 

输入 - 格式 1：

 

<Operation>

<Details>

<Worklogs>

<Worklog>

<parameter>

<name>description</name>

<value>Adding a New Worklog</value>

</parameter>

<parameter>

<name>technician</name>

<value>Howard Stern</value>

</parameter>

<parameter>

<name>cost</name>

<value>25</value>

</parameter>

<parameter>

<name>workMinutes</name>

<value>20</value>

</parameter>

<parameter>

<name>workHours</name>

<value>6</value>

</parameter>

</Worklog>

</Worklogs>

</Details>

</Operation>

 

 

输入 - 格式 2：

 

<Operation>

<Details>

<Worklogs>

<Worklog>

<description>Adding a New Worklog</description>

<technician>Howard Stern</technician>

<cost>25</cost>

<workMinutes>20</workMinutes>

<workHours>6</workHours>

</Worklog>

</Worklogs>

</Details>

</Operation>

 

 

输出：

 

<?xml version="1.0" encoding="UTF-8"?>

<operation name="ADD_WORKLOG">

<result>

<status>Success</status>

<message>Work Log added successfully for request 24</message>

</result>

</operation>

 

编辑工作日志

要编辑现有请求的工作日志，可使用 URL：

http://<servername>:<port number>/sdpapi/request/<request id>/worklogs/<work log id>

假设要编辑的工作日志 ID 是 302，那么 URL 是: http://localhost:8080/sdpapi/request/24/worklogs/302

要点

  1. 操作名称 “EDIT_WORKLOG ”应作为 “POST attribute ”发送，关键字为 “OPERATION_NAME”。

  2. 技术员密钥应作为 “POST attribute”发送，其关键字为 “TECHNICIAN_KEY”。

  3. 输入是一个 XML 字符串，作为 “POST attribute”发送，关键字为 “INPUT_DATA”。

注意：请注意输入和输出 XML 格式已变更。 但出于兼容性考虑，输入操作将同时支持这两种格式。

 输入 - 格式 1：

 

<Operation>

<Details>

<Worklogs>

<Worklog>

<parameter>

<name>description</name>

<value>Editing Worklog</value>

</parameter>

</Worklog>

</Worklogs>

</Details>

</operation>

 

 

输入 - 格式 2：

 

<Operation>

<Details>

<Worklogs>

<Worklog>

<description>Editing Worklog</description>

</Worklog>

</Worklogs>

</Details>

</Operation>

 

 

输出：

 

<?xml version="1.0" encoding="UTF-8"?>

<operation name="EDIT_WORKLOG">

<result>

<status>Success</status>

<message>Work Log 302 successfully edited for request 24</message>

</result>

</operation>

 

 

查看工作日志

要查看一个现有请求的工作日志，可使用 URL：

http://<servername>:<port number>/sdpapi/request/<request id>/worklogs/<work log id>

假设查看工作日志的工作日志 ID 是 302，那么 URL 是: http://localhost:8080/sdpapi/request/24/worklogs/302

要点

  1. 操作名称 “GET_WORKLOG ”应以“POST attribute”的形式发送，关键字为 “OPERATION_NAME”。

  2. 技术员密钥应作为 “POST attribute ”发送，密钥为 “TECHNICIAN_KEY”。

  3. 在这种情况下不需要输入。

注：请注意输入和输出 XML 格式已变更。 但出于兼容性考虑，输入操作将同时支持这两种格式。

 

输出：

 

<?xml version="1.0" encoding="UTF-8"?>

<operation name="GET_WORKLOG">

<result>

<status>Success</status>

<message>Work log details fetched successfully</message>

</result>

<Details>

<Worklogs>

<Worklog>

<parameter>

<name>dateTime</name>

<value>1275375445281</value>

</parameter>

<parameter>

<name>executedTime</name>

<value>1275375433484</value>

</parameter>

<parameter>

<name>cost</name>

<value>21.6666666666667</value>

</parameter>

<parameter>

<name>WORKORDERID</name>

<value>24</value>

</parameter>

<parameter>

<name>workHours</name>

<value>0</value>

</parameter>

<parameter>

<name>workMinutes</name>

<value>7800000</value>

</parameter>

<parameter>

<name>technician</name>

<value>Howard Stern</value>

</parameter>

<parameter>

<name>description</name>

<value>Worklog 2</value>

</parameter>

<parameter>

<name>requestCostID</name>

<value>301</value>

</parameter>

</Worklog>

</Worklogs>

</Details>

</Operation>

 

查看工作日志

要查看某个请求的所有工作日志，可使用 URL：

http://<servername>:<port number>/sdpapi/request/<request id>/worklogs/

假设查看所有工作日志的请求 ID 为 302，则 URL 为 http://localhost:8080/sdpapi/request/24/worklogs/

要点

  1. 操作名称 “GET_WORKLOGS ”应作为 “POST attribute”发送，关键字为 “OPERATION_NAME”。

  2. 技术员密钥应作为 “POST attribute ”发送，密钥为 “TECHNICIAN_KEY”。

  3. 在这种情况下不需要输入。

注意：请注意输入和输出 XML 格式已变更。 但出于兼容性考虑，输入操作将同时支持这两种格式。

 

输出：

 

<?xml version="1.0" encoding="UTF-8"?>

<operation name="GET_WORKLOGS">

<result>

<status>Success</status>

<message>Work log details fetched successfully</message>

</result>

<Details>

<Worklogs>

<Worklog URI="http://localhost:8080/sdpapi/request/24/worklogs/301/">

<parameter>

<name>dateTime</name>

<value>1275375445281</value>

</parameter>

<parameter>

<name>executedTime</name>

<value>1275375433484</value>

</parameter>

<parameter>

<name>cost</name>

<value>21.6666666666667</value>

</parameter>

<parameter>

<name>WORKORDERID</name>

<value>24</value>

</parameter>

<parameter>

<name>workHours</name>

<value>0</value>

</parameter>

<parameter>

<name>workMinutes</name>

<value>7800000</value>

</parameter>

<parameter>

<name>technician</name>

<value>Howard Stern</value>

</parameter>

<parameter>

<name>description</name>

<value>Worklog 2</value>

</parameter>

<parameter>

<name>requestCostID</name>

<value>301</value>

</parameter>

</Worklog>

<Worklog URI="http://localhost:8080/sdpapi/request/24/worklogs/302/">

<parameter>

<name>dateTime</name>

<value>1275375861188</value>

</parameter>

<parameter>

<name>executedTime</name>

<value>1275375861188</value>

</parameter>

<parameter>

<name>cost</name>

<value>25.0</value>

</parameter>

<parameter>

<name>WORKORDERID</name>

<value>24</value>

</parameter>

<parameter>

<name>workHours</name>

<value>0</value>

</parameter>

<parameter>

<name>workMinutes</name>

<value>22800000</value>

</parameter>

<parameter>

<name>technician</name>

<value>Howard Stern</value>

</parameter>

<parameter>

<name>description</name>

<value>Adding a New Worklog</value>

</parameter>

<parameter>

<name>requestCostID</name>

<value>302</value>

</parameter>

</Worklog>

<Worklogs>

</Details>

</operation>

 

 

删除工作日志

要从请求中删除工作日志，URL 应为

http://<servername>:<port number>/sdpapi/request/<request id>/worklogs/<work log id>

假设要删除的工作日志 ID 是 301，则 URL 为 http://localhost:8080/sdpapi/request/24/worklogs/301

要点

  1. 操作名称 “DELETE_WORKLOG ”应作为 “POST attribute”发送，关键字为 “OPERATION_NAME”。

  2. 技术员密钥应作为 “POST attribute ”发送，密钥为 “TECHNICIAN_KEY”。

  3. 在这种情况下不需要输入。

注意：请注意输入和输出 XML 格式已变更。 但出于兼容性考虑，输入操作将同时支持这两种格式。

 

输出：

 

<?xml version="1.0" encoding="UTF-8"?>

<operation name="DELETE_WORKLOG">

<result>

<status>Success</status>

<message>Work Log deleted successfully</message>

</result>

</operation>