OpsUpdateResourceTimeoff

This service is used to both schedule future time off and to report time-off.

Request

The service request contains:

Name

Data Type

Required?

Default Value

Discussion

ResourceTimeOffList

list

yes

 

Each list item is defined in the ResourceTimeOff section described below

ApprovedFlag

boolean

no

false

Scheduling: omit this

Reporting: Mark entered time as approved

ResourceTimeOffList

Name

Data Type

Required?

Default Value

Discussion

ReferenceSystemId

string

yes

 

The employee's EmployeeId. You can use ExportResources to retrieve resources and their id numbers. Or look in the resource editor.

TimeOffDate

date

yes

 

Scheduling: Date that the resource has off

Reporting: The date that the resource took time-off.

TimeOffMinutes

int

yes

 

Scheduling: You can enter a full day of minutes, 1440 to block off the entire day. If the person is scheduled for a half-day off then you will need to know their working schedule. For example, eight hours a day. If they work half a day then enter 4 * 60 = 240 minutes.

Reporting: The number of hours the resource took off for today.

TimeOffReason

string

yes

 

This is a string that must exactly match a list defined in Projector. The list is defined on a per installation basis through the Time Off Reason Editor.

Narrativestringno 

Scheduling: omit this

Reporting: Creates a description on the time card

ScheduledFlag

boolean

no

false

Set to true if you are scheduling this time. False if you are reporting the time.

 

Response

The following data is returned:

Name

Data Type

Discussion

ResourceTimeOffErrors

list of ResourceTimeoffError items

see below

ResourceTimeOffErrors

 

Name

Data Type

Discussion

Index

int

Index of the timeoff record (position in ResourceTimeoffList) that failed.

OpsError

OpsWebError

See Responses