PwsProjectRoleHoursBucket

Owned by Bettina Borces
Last updated: Feb 07, 2020 by Luke Wright
3 min read

Overview


This structure represents hours that are requested or scheduled for a role as well as the pattern in which they are distributed. The structure represents one week worth of the project role's schedule. This structure is also used to specify requested or booked hours in web service requests for requesting or booking hours.

Format


PwsProjectRoleHoursBucket
  • PwsProjectRoleHoursBucket
    • BucketStartDate: DateTime
    • DailyMinutes: Int16[]
    • SchedulingMode: String
    • WeeklyMinutes: Int16

Elements


Element

Data Type

Required?

Default

Description

Sample Data

BucketStartDate

DateTime

No

 

The first day of the week represented by the requested or scheduled hours herein. Always the first day of a week, as configured for the account.

2020-01-06T00:00:00.000Z

DailyMinutes

Int16[]

No 

 

The number of daily minutes to be requested or scheduled for the role. This is applicable when the scheduling mode is "D" for Daily. In "Daily" mode the array must have exactly 7 entries. The array is indexed relative to the account's first day of week setting.


SchedulingMode

String

No 

 

The Scheduling Mode:

"D" for Daily

"W" for Weekly

W

WeeklyMinutes

Int16

No 

 

The number of weekly minutes to be requested or scheduled for the role. This is applicable when the scheduling mode is "W" for Weekly.

2400

Usage Example(s)


Example 01 - Daily Mode 
                  <com:HoursBuckets>
                     <com:PwsProjectRoleHoursBucket>
                        <com:BucketStartDate>2020-01-06T00:00:00.000Z</com:BucketStartDate>
                        <com:DailyMinutes>
                           <arr:short>480</arr:short>
                           <arr:short>480</arr:short>
                           <arr:short>480</arr:short>
                           <arr:short>480</arr:short>
                           <arr:short>480</arr:short>
                           <arr:short>0</arr:short>
                           <arr:short>0</arr:short>
                        </com:DailyMinutes>
                        <com:SchedulingMode>D</com:SchedulingMode>
                     </com:PwsProjectRoleHoursBucket>
                  </com:HoursBuckets>


Example 02 - Weekly Mode 
                  <com:HoursBuckets>
                     <com:PwsProjectRoleHoursBucket>
                        <com:BucketStartDate>2020-01-06T00:00:00.000Z</com:BucketStartDate>
                        <com:SchedulingMode>W</com:SchedulingMode>
                        <com:WeeklyMinutes>2400</com:WeeklyMinutes>
                     </com:PwsProjectRoleHoursBucket>
                  </com:HoursBuckets>