_API JeopReportRequest Response

<sp:JeopReportResponse>

<jobJeopardy>

One or more jobJeopardy structures will be present, with each describing the details of a job or standard activity that is in jeopardy.

The jobJeopardy structure is only returned when the allJeopardyStatus field in the API call is false (or not supplied).

When allJeopardyStatus has been set to true, only the jeopardyList structure will be returned.

<workItemID>?</workItemID>

WorkItemID

The identifier of the job or standard activity in jeopardy.

<workItemType>?</workItemType>

Identifies whether it is a job or activity that is being reported.

<jeopStates>

JeopStates

The set of "Jeopardy States" that note the reason(s) for the job or standard activity being in jeopardy.

</jeopStates>

<currEmpID>?</currEmpID>

EmpID

The employee currently assigned to do the job or standard activity. Empty if a job and it is unresourced

<latestAccess>?</latestAccess>

If a job and is not an appointment, this contains the latest date & time at which access is possible (if there is such thing – there may be an Access Hours pattern that has no end date) - for the job’s ETF if call-to-fix, otherwise its ETA. This corresponds to what’s in the ‘Latest Access’ control on the Gantt Job Details dialog and may be NULL if the job’s last Access Hours pattern has no end date.

If the job is an appointment, it contains the Appointment Latest.

<expectedStart>?</expectedStart>

Time

The time at which the employee is expected to start travelling to the work item. Empty if a job and is unresourced.

<expectedArrival>?</expectedArrival>

Time

The time at which the employee is expected to start working on the work item. Empty if a job and is unresourced.

<latestEarliest>?</latestEarliest>

spDateTime

If a job and is an appointment, LatestEarliest will contain:

• the Appointment Latest date & time if the jeopardy condition is “Missed Appointment – Late”; or
• the Appointment Earliest date & time if it’s “Missed Appointment – Early”.

If the job isn’t an appointment, LatestEarliest will contain the Contract Latest date time if the job is “Overdue – Past Contract Latest” or the Contract Earliest date & time if it’s “Early – Before Contract Earliest”.

<overdue>?</overdue>

int

The value (in minutes) of what is defined to be in the OD(Early) column of the Jeopardy Report on the Gantt.

<stateDue>?</stateDue>

Time

For the late dispatch states (late earmarked etc.), the time at which the work item was due to enter the reported state e.g. for late earmarked, it’s the time at which the work item should have been earmarked.  Empty if not in a late dispatch state.

<FRU>?</FRU>

RUID

The FRU the work item is assigned to.

<team>?</team>

TeamID

The team of the allocated operative. Empty if a job and is unresourced.

<importance>?</importance>

</jobJeopardy>

One or more jeopardyList structures will be present, with each describing the day by day breakdown of jobs and standard activities in jeopardy, broken down by FRU, team, day, and jeopardy type.

The jeopardyList structure is only returned when the allJeopardyStatus field in the API call is true.

When allJeopardyStatus has been set to false, (or not supplied) only the jobJeopardy structure will be returned.

The ID of the FRU to which the parent jeopardyList structure relates to.

One or more jeopardyListPerTeam structures will be present, with each describing the statistics for the team in the FRU.

The date for which the parent JobStatPerDate structure relates to.

The identifier of the job or standard activity in jeopardy.

An unresourced workItemID is returned if:

• Unresourced Job Contract Latest ≥ Start Date AND Unresourced Job Contract Latest ≤ End Date

<jeopStates>?</jeopStates>

<jeopStates2>?</jeopStates2>

</sp:JeopReportResponse>