Content Comparison

<sp:DispInitRequest>

<FRUs>?</FRUs>

RUID

is a list of FRUID

A Final Responsibility Units (FRUsFRU) for which jobs are to be dispatched to the connected client.   FRUs are separated by the ‘;’ characterTo dispatch jobs for multiple FRUs, supply the FRUs parameter multiple times, once for each FRUID.

If the FRUs is “” and Teams (below) is “”and EmpID (below) is “” , teams and EmpID parameters are not supplied, then all FRUs and teams are included. 

For real-time mode dispatch, only FRUs can be specified.

For batch mode dispatch, either FRUs or Teams teams or EmpID can be specified, but not any combination of them.

For real-time mode dispatch, only FRUs can be specified.

<teams>?</teams>

is a list of TeamID

A teams for which jobs are to be dispatched to the connected client (batch mode only).  Teams are separated by the ‘;’ character To dispatch jobs for multiple teams, supply the teams parameter multiple times, once for each TeamID. If you do not want to specify teams do not supply the parameter.

<empID>?</empID>

EmpID

is the Id The ID of a single operative to be dispatched (batch mode only).

<timezone>?</timezone>

 string

specifies Specifies the timezone which the times (DateTime, ETS, ETA, ETF) returned by DispatchRequest are to be local to. It must be a POSIX timezone string that appears in the sp-56 table in the database, for example:

EST5EDT,M4.1.0,M10.5.

0

or

IST-5.30

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

<mode>?</mode>

1      SpareSource

DisMode

DispMode

Specifies whether real-time dispatch of jobs is required, or whether a batch run is required. 

In batch mode, dispatch completes one scan and then exits.

For batch mode only, BatchInfo (below) the batchInfo parameter must be populated.

<batchInfo>

determines Determines which jobs are candidates for dispatch.

If DispatchMode mode is set to RealTimereal-time, this parameter is ignored.

<jobsMax>?</jobsMax>

int

is the The maximum number of jobs to be dispatched, per operative.

This specifies the number of jobs per operative, within the time range specified, that are considered for dispatch, the jobs being considered in chronological order.  Thus Thus, for example, if JobsMax jobsMax were set to 2, the first 2 jobs starting within the time range specified would be considered for dispatch: if both were already at status Earmarked or above, then neither would actually be dispatched.

If JobsMax jobsMax is omitted then there is no limit to the number of jobs to be dispatched per operative.

If Earmark Same-site Jobs Together is true, JobsMax jobsMax will be ignored jobs so that jobs in a same-site group may be dispatched together.

Standard activities ARE included in the count for jobsMax.

Breaks are not included in the count for JobsMax jobsMax.

<rangeType>?</rangeType>

DispRangeTypesDispRangeType

determines Determines how RangeStart the rangeStart and RangeEnd rangeEnd parameter are interpreted.

If RangeType rangeType is set to Jobs, then all jobs that start between RangeStart rangeStart and RangeEnd rangeEnd are candidates for dispatch.

If RangeType rangeType is set to Shifts, then all jobs that start on an operative day that contains a shift that starts between RangeStart rangeStart and RangeEnd rangeEnd are candidates for dispatch.   If an operative day does not contain a shift, then jobs on that day are not dispatched.  If  If the shift start has been overridden, then it is the new shift start that must be between RangeStart and RangeEnd rangeStart and rangeEnd.

Applies to both Jobs and Standard activities.

<rangeStart>?</rangeStart>

spDateTime

If RangeStart rangeStart is not supplied, ServiceOptimizer will use a default value of start-of-day today.

<rangeEnd>?</rangeEnd>

spDateTime

If RangeEnd rangeEnd is not supplied, ServiceOptimizer will use a default value of end-of-day on RangeStart rangeStart (which may have defaulted to today).

</batchInfo>

</sp:DispInitRequest>