Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space SCHUD and version 9.3
Expand

Web Service

Type

Description

Req?

Val?

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

(error)

(tick)

 

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

Note

Since an unresourced job is not associated with a team, unresourced jobs will not be returned if a list of teams is supplied.

(error)

(tick)

 

<APITimeZone>?</APITimeZone>

 

Specifies the timezone which the times (LatestAccess, ExpectedStart, ExpectedArrivalLatestEarliest 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.

(error)

 

 

<statesToReport>

 

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

When one or more jeopardy state options is 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 state options states are set, then no filtering is applied and all available work items in jeopardy will be returned.

Note

The jeop_check_states database parameter controls which types of jeopardy states are returned by the API. Only those Jeopardy OptionsStates set via the jeop_check_states database parameter to be jeopardy states "in use" can ever be returned by the API, regardless of the value of the StatesToReport parameter passed into the API call.

(error)

 

 

 

 

JeopOptionsJeopStates

 

(error)

(tick)

 

</statesToReport>

 

 

 

 

 

<options>

 

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

(error)

 

 

 

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

(error)

 

 

 

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

(error)

 

 

 

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

(error)

 

 

 

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

(error)

 

 

</options>

 

 

 

 

</sp:JeopReportRequest>