/
_API FixBreakTimesRequest Definition
Document toolboxDocument toolbox

_API FixBreakTimesRequest Definition

Owned by Matthew Wren (Unlicensed)
Jul 12, 2023
 Click here to expand...

Web Service

Type

Description

Req?

Val?

<sp:FixBreakTimesRequest>

 

 

 

 

 

<empID>?</empID>

EmpID

The identifier of the employee to whom the break is assigned.

(tick)

(tick)

 

<breaks>

 

 

(tick)

 

 

 

<BreakName>?</BreakName>

BreakName

The name of the break.

(tick)

(tick)

 

 

<BreakType>?</BreakType>

BreakType

The type of the break.

(tick)

(tick)

 

 

<BreakStart>?</BreakStart>

spDateTime

The date and time at which the Break will start/has started.

(tick)

(tick)

 

 

<BreakDuration>?</BreakDuration>

int

The length of the break in minutes. The length of the break can be 0 to 999 minutes.

(tick)

 

 

</breaks>

 

 

 

 

 <breaks> Up to 4 additional breaks structures can be supplied, if multiple named breaks are to be updated.(error) 
  If supplied, the additional breaks structure(s) match the structure above.  
 </breaks>    

 

<options>

 

Only one options structure can be supplied.

(error)

 

 

 

<Started>?</Started>

boolean

When supplied and true, all named breaks supplied will be updated to have a status of Started.

If the options value of Finished is also supplied, SP_OPTION_COMBINATION_INVALID (159) is returned.

If not supplied, and the options value of Finished is also not supplied, then any of the breaks being updated that have previously been set to have a status of either Started or Finished will be set to the Fixed state and SP_OK_BREAK_STATUS_LOST (695) is returned

(error)

 

  <Finished>?</Finished>boolean

When supplied and true, all named breaks supplied will be updated to have a status of Finished.

If the options value of Started is also supplied, SP_OPTION_COMBINATION_INVALID (159) is returned.

If not supplied, and the options value of Started is also not supplied, then any of the breaks being updated that have previously been set to have a status of either Started or Finished will be set to the Fixed state and SP_OK_BREAK_STATUS_LOST (695) is returned

(error) 

 

</options>

 

 

 

 

</sp:FixBreakTimesRequest>

 

 

 

 

The BreakStart value is local to what is specified in the tz_CJS database parameter.

This can be set such that BreakStart is local to the timezone of the responsibility unit which contains the break, local to the employee that the break is allocated to, or local to a specified or default timezone. It may also be set such that it is local to the region of a job – either the job which contains the break or, if the break is standalone, the job immediately prior to the break.