<sp:JeopReportRequest>

<FRUs>?</FRUs>

RUID

A list of Final Responsibility Units (FRUs) for which work items in jeopardy are to be reported to the connected client. FRUs are separated by the ‘;’ character

If teams (below) is empty and FRUs is empty then all FRUs (and teams) are reported.

Either FRUs or teams can be specified, but not both.

<teams>?</teams>

A list of teams for which work items in jeopardy are to be reported to the connected client. Teams are separated by the ‘;’ character.

If FRUs (above) is empty and teams is empty then all teams (and FRUs) are reported.

Either teams or FRUs can be specified, but not both.

<APITimeZone>?</APITimeZone>

Specifies the timezone which the times (LatestAccess, ExpectedStart, ExpectedArrival, LatestEarliest and StateDue) returned by sp:JeopReportRequest are to be local to. It must be a POSIX timezone string (in sp056), for example:

EST5EDT,M4.1.0,M10.5.0 or IST-5.30

If not supplied, the database parameter tz_jeop_api will be used.

<statesToReport>

See the "Jeopardy States" for the optional boolean values which can be passed in as part of the statesToReport structure.

When one or more jeopardy states are set, the results of the call will be restricted to the subset of work items in jeopardy that match the conditions specified.

When no jeopardy states are set, then no filtering is applied and all available work items in jeopardy will be returned.

JeopStates

</statesToReport>

<options>

If any other options, other than those shown below, are specified, SP_OPTIONS_INVALID (80) will be returned.

<unresApptMissed>?</unresApptMissed>

boolean

If true, an unresourced work item will only be reported as being in jeopardy if the Appointment Latest time has now passed.

<unresContractMissed>?</unresContractMissed>

boolean

If true, an unresourced work item will only be reported as being in jeopardy if the Contract Latest time has now passed.

<apptMissed>?</apptMissed>

boolean

If true, a resourced work item will only be reported as being in jeopardy if the Appointment Latest time has now passed.

<contractMissed>?</contractMissed>

boolean

If true, a resourced work item will only be reported as being in jeopardy if the Contract Latest time has now passed.

</options>

</sp:JeopReportRequest>

<sp:JeopReportResponse>

<jobJeopardy>

<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 defined to be in the “OD(Early)” column of the Jeopardy Report on the Gantt (see [2], ch 8 – “OD(Early) Column”).

<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>

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

<importance>?</importance>

</jobJeopardy>

</sp:JeopReportResponse>