Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.

1

SessionTicket

String

Yes


Click here for more information.

AdW9hL5iEq/mAQnDQ5AweA==

EndDate

DateTime

Yes


The end date (in midnight UTC) of a time period. The StartDate and EndDate together define the period in which the time cards will be retrieved. The time cards that are to be retrieved must be dated on or after the StartDate and on or prior to the EndDate.

2018-12-31T00:00:00.000Z

IncludeApprovedFlag

Boolean

No

false

If set to 'true', approved time cards will be included in the response.

false

IncludeBookedAndAssignedRolesFlag

Boolean

No

false

If set to 'true', projects on which the resource is booked for hours during the period or booked or requested on a role that is assigned to a task that is active during the period are included, regardless of whether time cards exist. Active tasks are tasks whose planned dates overlap with this period, or whose planned dates are prior to the period but is not marked complete.

true

IncludeDraftFlag

Boolean

No

false

If set to 'true', draft time cards will be included in the response.

true

IncludeReferencedTasksOnlyFlag

Boolean

No

false

If set to 'true', only tasks that are referred to by existing time cards will be included in the response.

true

IncludeReferencedTimeOffReasonsOnlyFlag

Boolean

No

false

If set to 'true', only time off reaons that are referred to by existing time off cards will be included in the response.

true

IncludeRejectedFlag

Boolean

No

false

If set to 'true', rejected time cards will be included in the response.

false

IncludeSubmittedFlag

Boolean

No

false

If set to 'true', submitted time cards will be included in the response.

true

IncludeTimeCardsFlag

Boolean

No

false

If set to 'true', time cards (as opposed to time off cards) will be included in the response.

true

IncludeTimeOffCardsFlag

Boolean

No

false

If set to 'true, time off cards will be included in the response.

false

ProjectIdentity

PwsProjectRef

Yes/No


Identity of project, if requesting time cards for a single projectThe ResourceIdentity and ProjectIdentity fields are not required, but practically speaking one of them should always be specified.

The reason they aren't technically required is that we will get time cards for the user making the API call. However, if that user has no resource profile, you'll get a 50406 error. Since most API users never enter time, you'll almost certainly encounter this.


ResourceIdentity

PwsResourceRef

Yes/No


You probably always want to specify a resource identity. It's not technically required since we fall back to getting The ResourceIdentity and ProjectIdentity fields are not required, but practically speaking one of them should always be specified.

The reason they aren't technically required is that we will get time cards for the user making the API call, but functionally the user making the call almost never has a resource profile since it's usually an API only user. However, if that user has no resource profile, you'll get a 50406 error. Since most API users never enter time, you'll almost certainly encounter this.


StartDate

DateTime

Yes


The start date (in midnight UTC) of a time period. The StartDate and EndDate together define the period in which the time cards will be retrieved. The time cards that are to be retrieved must be dated on or after the StartDate and on or prior to the EndDate.

2018-01-01T00:00:00.000Z

IncludeTaskHierarchyFlag

Boolean

No

false

If set to 'true', all the entire task hierarchy of the task associated with the time card(s) will be included.

false

AutoMemorizeBookedAndAssignedRolesFlag

Boolean

No

false

If set to 'true', anything that was on the timesheet last week will be on it this week. If set to 'false', timesheet start from scratch each week. This is intended for internal use and you likely want to set this to false.

false

IncludeMemorizedRolesAndTasksFlag

Boolean

No

false

If set to 'true', memorized roles and tasks will be included in the response. Memorized roles and tasks are roles that may not have any time cards associated with them, but have been explicitly added to a resource's time sheet through the Projector UI.

false

RespectMemorizedRemovedRolesAndTasksFlag

Boolean

No

false

If set to 'true', roles and tasks that were removed from the timesheet will be excluded from the response. Again, this refers to rows on a resource's time sheet that may be connected to tasks that the resource is assigned to, but have been explicitly removed from the resource's timesheet through the Projector UI.

false

TimeCardIdentity

PwsTimeCardRef

No


Identity of the time card, if requesting a single time card. This can refer to a time card or a time off card.


...