<sp:GetChangedWorkItemsRequest>

<FRUID>?</FRUID>

RUID

The identifier of the FRU from which the jobs are required.

<timeStampIn>?</timeStampIn>

timeStamp

A time stamp that is sent to indicate the time from which changes should be determined. It’s usually the time stamp returned from ServiceOptimizer in the previous call (TimeStampOut). This an opaque value that the caller should not interpret.

To get all of the jobs in an FRU for the whole memory horizon, or, if JeopOnly is set, all of the jobs in any of the configured set of jeopardy conditions (see 4.3), this field should not be supplied.

<options>

<JeopOnly>?</JeopOnly>

Boolean

If JeopOnly is set, the call will return only work items whose one or more of the configured set of jeopardy conditions has changed since the last call. This includes:

• where a work item was in jeopardy states X (e.g. unscheduled) at the previous call and is no longer in jeopardy at all; or
• where a work item wasn’t in jeopardy and now is in jeopardy states X; or
• where work item was in jeopardy states X and is now in different jeopardy states Y; or
• where overdue (P) and/or late (M) is in the set of configured jeopardy conditions, and a job was overdue or late by a certain amount and now is overdue or late by a different amount; or
• where early (B or Me) is in the set of configured jeopardy conditions and a job was early and is now early by a different amount.

</options>

</sp:GetChangedWorkItemsRequest>

<sp:GetChangedWorkItemsResponse>

<timeStampOut>?</timeStampOut>

timeStamp

TimeStampOut will normally be the time of this call to the Get Changed Work Items SOAP API (unless the supplied array is too small) and TimeStampIn will usually be the TimeStampOut returned from the previous call. 

<workItem>

<workItemID>?</workItemID>

WorkItemID

The identifier of the work item.

<workItemType>?</workItemType>

WorkItemType

Identifies whether a job or a standard activity.

<isFixed>?</isFixed>

Boolean

<jobJeopardy>

JeopStates

All of the jeopardy states for the work item, irrespective of whether they are in the configured set or not.

</jobJeopardy>

<attr>

This element is not returned for an unresourced job.

<empID>?</empID>

EmpID

The identifier of the operative that the job is allocated to.

<start>?</start>

spDateTime

The date and time that the operative is scheduled to start travelling to the job.

<arrival>?</arrival>

spDateTime

The date and time that the operative is scheduled to arrive at the job.

<finish>?</finish>

spDateTime

The date and time that the operative is scheduled to finish the working part of the job, i.e. excluding travel home if there is any.

<disStatus>?</disStatus>

DisStatus

The current dispatch status of the job, i.e. Tentative, Earmarked, Contacted, Started (Travelling), Logged On , Logged Off or Cleared.

<overdue>?</overdue>

int

Irrespective of whether overdue (P) or late appointment (M) or early (B or Me) is a configured jeopardy condition for this call, this is the amount by which the job is either:

• late if it’s an appointment (i.e. the time after its appointment latest), or
• overdue if it’s not an appointment (i.e. the time after its contract latest, taking its service hours into account), or
• early i.e. the time before its appointment earliest if it’s an appointment or before its contract earliest, taking service hours into account, if it’s not.

If it’s scheduled but isn’t overdue or late or early, overdue is 0.

</attr>

</workItem>

</sp:GetChangedWorkItemsResponse>