Pass Through Call to ServiceScheduling's "Get Changed Work Items" API

This RESTified API will perform a pass-through call to the ServiceScheduling sub-system's "Get Changed Work Items" API (when configured).

URL

PUT /up/v5/rest/scheduling/GetChangedWorkItems

HTTP Request Body

This request requires a JSON object supplied in the HTTP request body, which defines the parameters that will be passed through to the ServiceScheduling "Get Changed Work Items" APi.

GetChangedWorkItems Object Format

Get Changed Work Items JSON

js

GetChangedWorkItems Object Properties

Property	Type	Length	Description	Req?	Mapping Field: Service Scheduling
`FRU`	`string`	SS: 8	Pass through parameter to the ServiceScheduling UpdateJobStartTime API.	Yes	`FRUID`
`OffsetId`	string		Pass through parameter to the ServiceScheduling UpdateJobStartTime API.	No	`timeStampIn`
`Options`	object		Pass through parameter to the ServiceScheduling UpdateJobStartTime API.	Yes	see GetChangedWorkItem Options Objects

HTTP Response

Success

On success, a JSON-formatted version of the ServiceScheduling "Get Changed Work Items" API response will be returned.

js

Error

On error, a JSON-formatted version of the ServiceScheduling "Get Changed Work Items" API response will be returned.

js

Please Note:

Note: There is no guarantee that a changed work item is returned only once for each change.

Note: Because a work item is returned if any of its attributes have changed (unless JeopOnly is set), not just a change to those attributes returned, there will be circumstances when a work item is returned for which there has been no change apparent in the attributes returned.

Note: If a job is cancelled (via the Cancel Job SOAP API), or a standard activity removed, nothing will be reported about it thereafter, since it will have been removed from ServiceOptimizer. It’s assumed that the same system that called the Cancel Job SOAP API will be calling the Get Changed Work Items SOAP API and will therefore know not to expect anything to be reported about the job after cancellation.

All of the fields to do with dates and times are local to what is specified in the tz_GCJAPI database parameter. These can be set such that dates and times are local to the timezone of the region where the work item is located, local to the timezone of the responsibility unit which contains the work item, local to the employee that the work item is allocated to, local to a specified or default timezone, or in GMT with or without daylight saving (BST).

Return Codes

In addition to the Standard Return Codes, and the ServiceScheduling Error codes, individual API calls from this API are:

SP_OK (0)
SP_OPTIONS_INVALID (80)
SP_FRUID_INVALID (278)
SP_MAX_INVALID (281)
SP_TIMESTAMP_INVALID (504)

Browser not supported