PwsGetResourceSchedule

Overview


This web service retrieves a resource's scheduled time and/or scheduled time off per day within a given date range

Request Format


PwsGetResourceSchedule Request
  • PwsGetResourceSchedule

Request Elements


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.

ATtx2+k3au/+YimAUXob5g==

EndDate

DateTime

Yes 


The EndDate and the StartDate (in UTC format) defines the date range that will be applied as a filter in the search.

2018-03-31T00:00:00.000Z

IncludeScheduledTimeFlag

Boolean

No 

 false

If set to 'true', scheduled time (booked hours on projects) will be included in the response.

true

IncludeTimeOffFlag

Boolean

No 

false 

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

true

ProjectIdentity

PwsProjectRef

No 


The project identity filter. If this value is set only booked hours associated with this project will be included in the response.


ResourceIdentity

PwsResourceRef

No 


The resource identity when acting on behalf of another user. If this value is not set, the scheduled time or time off hours associated with the authenticated user will be included in the response.


StartDate

DateTime

 Yes


The EndDate and the StartDate (in UTC format) defines the date range that will be applied as a filter in the search.

2018-03-28T00:00:00.000Z

Request Usage Example(s)


Example 01
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:tim="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsGetResourceSchedule>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>ATtx2+k3au/+YimAUXob5g==</req:SessionTicket>
            <tim:EndDate>2018-03-31T00:00:00.000Z</tim:EndDate>
            <tim:IncludeScheduledTimeFlag>true</tim:IncludeScheduledTimeFlag>
            <tim:IncludeTimeOffFlag>true</tim:IncludeTimeOffFlag>
            <tim:ProjectIdentity>
               <com:ProjectCode>P001395-001</com:ProjectCode>
            </tim:ProjectIdentity>
            <tim:StartDate>2018-03-28T00:00:00.000Z</tim:StartDate>
         </pws:serviceRequest>
      </pws:PwsGetResourceSchedule>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


PwsGetResourceSchedule Response

Response Elements


Element

Data Type

Description

Sample Data

Messages

PwsMessage[]

The web service response status and message. Click here for more information.


ResponseId

Int32

Click here for more information.

1

Status

RequestStatus

Click here for more information.

Ok

ServerTimestampUtc

DateTime

Click here for more information.

2018-03-20T18:09:59.6239166Z

ResourceSchedule

PwsSchedule

The full details of the resource's scheduled time or time off hours.


Response Usage Example(s)


Example 01
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetResourceScheduleResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetResourceScheduleResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/TimeAndCost/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
            <ResponseId xmlns="http://projectorpsa.com/CommonServices/">1</ResponseId>
            <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-20T18:09:59.6239166Z</ServerTimestampUtc>
            <a:ResourceSchedule>
               <a:Holidays/>
               <a:Roles>
                  <a:PwsScheduleRole>
                     <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <ProjectRoleId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <ProjectRoleUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504609522500</ProjectRoleUid>
                     <a:AssignedTasks>
                        <a:PwsScheduleProjectTask>
                           <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ProjectTaskId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <ProjectTaskUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504608644258</ProjectTaskUid>
                           <a:Description>Task A1</a:Description>
                           <a:Name>Task A1</a:Name>
                           <a:Notes>
                              <a:PwsProjectTaskNoteHistory>
                                 <a:CreatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                                    <b:UserDisplayName>Beth Brown</b:UserDisplayName>
                                    <b:UserId i:nil="true"/>
                                    <b:UserReferenceSystemId>E125</b:UserReferenceSystemId>
                                    <b:UserUid>1152921504607011056</b:UserUid>
                                 </a:CreatedByUser>
                                 <a:CreatedTimestamp>2018-03-07T18:10:20.357Z</a:CreatedTimestamp>
                                 <a:ProjectTaskNotes>This is the first task of this project</a:ProjectTaskNotes>
                              </a:PwsProjectTaskNoteHistory>
                              <a:PwsProjectTaskNoteHistory>
                                 <a:CreatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                                    <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                                    <b:UserId i:nil="true"/>
                                    <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                                    <b:UserUid>1152921504607112369</b:UserUid>
                                 </a:CreatedByUser>
                                 <a:CreatedTimestamp>2018-03-07T18:24:42.013Z</a:CreatedTimestamp>
                                 <a:ProjectTaskNotes>Please speak to Jack before starting this task</a:ProjectTaskNotes>
                              </a:PwsProjectTaskNoteHistory>
                           </a:Notes>
                           <a:OpenForTimeFlag>true</a:OpenForTimeFlag>
                           <a:ParentProjectTaskIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                              <b:ExternalSystemIdentifier i:nil="true"/>
                              <b:ProjectTaskId i:nil="true"/>
                              <b:ProjectTaskUid>1152921504608637335</b:ProjectTaskUid>
                           </a:ParentProjectTaskIdentity>
                           <a:ParentTaskName>Task A</a:ParentTaskName>
                           <a:PlannedEndDateTime>2018-03-30T08:00:00Z</a:PlannedEndDateTime>
                           <a:PlannedStartDateTime>2018-03-01T00:00:00Z</a:PlannedStartDateTime>
                           <a:ProjectTaskTypeIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                              <b:ExternalSystemIdentifier i:nil="true"/>
                              <b:ProjectTaskTypeId i:nil="true"/>
                              <b:ProjectTaskTypeUid>1152921504608115974</b:ProjectTaskTypeUid>
                           </a:ProjectTaskTypeIdentity>
                           <a:Roles/>
                           <a:SequenceNumber>1</a:SequenceNumber>
                           <a:WbsCode>1.1</a:WbsCode>
                           <a:ParentTaskWbsCode>1</a:ParentTaskWbsCode>
                           <a:BudgetedMinutes>10560</a:BudgetedMinutes>
                           <a:Estimate>
                              <a:CompletedFlag>false</a:CompletedFlag>
                              <a:RemainingAsOfDate>2018-03-05T00:00:00Z</a:RemainingAsOfDate>
                              <a:RemainingMinutes>480</a:RemainingMinutes>
                           </a:Estimate>
                           <a:LateFlag>false</a:LateFlag>
                           <a:RemainingMinutesPriorToDateRange>480</a:RemainingMinutesPriorToDateRange>
                           <a:TotalMinutesToDate>0</a:TotalMinutesToDate>
                        </a:PwsScheduleProjectTask>
                     </a:AssignedTasks>
                     <a:Bookings>
                        <a:PwsScheduleBooking>
                           <a:DailyWeeklyFlag>W</a:DailyWeeklyFlag>
                           <a:Date>2018-03-25T00:00:00Z</a:Date>
                           <a:Notes xmlns:b="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                              <b:string i:nil="true"/>
                           </a:Notes>
                           <a:ScheduledMinutes>1200</a:ScheduledMinutes>
                        </a:PwsScheduleBooking>
                     </a:Bookings>
                     <a:ProjectDescriptor>
                        <ProjectCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">P001395-001</ProjectCode>
                        <ProjectId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                        <ProjectUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607412209</ProjectUid>
                        <a:ColorMapColor>0x00ffff</a:ColorMapColor>
                        <a:EngagementDescriptor>
                           <EngagementCode xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">E001395</EngagementCode>
                           <EngagementId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                           <EngagementUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504607324698</EngagementUid>
                           <a:ClientDescriptor>
                              <ClientId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                              <ClientNumber xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">PR-PSA</ClientNumber>
                              <ClientUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606961482</ClientUid>
                              <a:ClientName>Projector PSA</a:ClientName>
                           </a:ClientDescriptor>
                           <a:EngagementManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                              <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                              <b:UserId i:nil="true"/>
                              <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                              <b:UserUid>1152921504607112369</b:UserUid>
                              <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                              <b:FirstName>Jack</b:FirstName>
                              <b:LastName>Spratt</b:LastName>
                              <b:MiddleName i:nil="true"/>
                           </a:EngagementManager>
                           <a:EngagementName>Web Services Engagement</a:EngagementName>
                           <a:EngagementTypeDescriptor>
                              <EngagementTypeId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                              <EngagementTypeName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">Billable - Time and Materials</EngagementTypeName>
                              <EngagementTypeShortName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">TandM</EngagementTypeShortName>
                              <EngagementTypeUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606863884</EngagementTypeUid>
                              <a:BillableFlag>true</a:BillableFlag>
                              <a:BusyFlag>true</a:BusyFlag>
                           </a:EngagementTypeDescriptor>
                        </a:EngagementDescriptor>
                        <a:ProjectCloseDate i:nil="true"/>
                        <a:ProjectDescription>New Web Services Project (A) - 2018</a:ProjectDescription>
                        <a:ProjectManager xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:UserDisplayName>Jack Spratt</b:UserDisplayName>
                           <b:UserId i:nil="true"/>
                           <b:UserReferenceSystemId>E123</b:UserReferenceSystemId>
                           <b:UserUid>1152921504607112369</b:UserUid>
                           <b:EmailAddress>jack@revcorp.bb</b:EmailAddress>
                           <b:FirstName>Jack</b:FirstName>
                           <b:LastName>Spratt</b:LastName>
                           <b:MiddleName i:nil="true"/>
                        </a:ProjectManager>
                        <a:ProjectName>New Web Services Project (A)</a:ProjectName>
                        <a:ProjectOpenDate>2018-01-01T00:00:00Z</a:ProjectOpenDate>
                        <a:ProjectStageIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:ProjectStageId i:nil="true"/>
                           <b:ProjectStageName>Delivery</b:ProjectStageName>
                           <b:ProjectStageShortName>Delivery</b:ProjectStageShortName>
                           <b:ProjectStageUid>1152921504606853304</b:ProjectStageUid>
                        </a:ProjectStageIdentity>
                        <a:ColorMapBackgroundColor xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                           <b:B>255</b:B>
                           <b:G>255</b:G>
                           <b:R>0</b:R>
                        </a:ColorMapBackgroundColor>
                     </a:ProjectDescriptor>
                     <a:RoleEndDate i:nil="true"/>
                     <a:RoleName>JS</a:RoleName>
                     <a:RoleStartDate i:nil="true"/>
                  </a:PwsScheduleRole>
               </a:Roles>
               <a:ScheduleDates>
                  <a:PwsScheduleDate>
                     <a:Date>2018-03-28T00:00:00Z</a:Date>
                     <a:NormalWorkingMinutes>480</a:NormalWorkingMinutes>
                     <a:UtilizationBasisMinutes>480</a:UtilizationBasisMinutes>
                  </a:PwsScheduleDate>
                  <a:PwsScheduleDate>
                     <a:Date>2018-03-29T00:00:00Z</a:Date>
                     <a:NormalWorkingMinutes>480</a:NormalWorkingMinutes>
                     <a:UtilizationBasisMinutes>480</a:UtilizationBasisMinutes>
                  </a:PwsScheduleDate>
                  <a:PwsScheduleDate>
                     <a:Date>2018-03-30T00:00:00Z</a:Date>
                     <a:NormalWorkingMinutes>480</a:NormalWorkingMinutes>
                     <a:UtilizationBasisMinutes>0</a:UtilizationBasisMinutes>
                  </a:PwsScheduleDate>
                  <a:PwsScheduleDate>
                     <a:Date>2018-03-31T00:00:00Z</a:Date>
                     <a:NormalWorkingMinutes>0</a:NormalWorkingMinutes>
                     <a:UtilizationBasisMinutes>0</a:UtilizationBasisMinutes>
                  </a:PwsScheduleDate>
               </a:ScheduleDates>
               <a:TimeOff>
                  <a:PwsScheduleTimeOff>
                     <TimeOffReasonId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <TimeOffReasonName xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">Vacation</TimeOffReasonName>
                     <TimeOffReasonUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606858293</TimeOffReasonUid>
                     <a:TimeOffDates>
                        <a:PwsScheduleTimeOffDate>
                           <a:Date>2018-03-30T00:00:00Z</a:Date>
                           <a:TimeOffMinutes>1440</a:TimeOffMinutes>
                        </a:PwsScheduleTimeOffDate>
                     </a:TimeOffDates>
                  </a:PwsScheduleTimeOff>
               </a:TimeOff>
            </a:ResourceSchedule>
         </PwsGetResourceScheduleResult>
      </PwsGetResourceScheduleResponse>
   </s:Body>
</s:Envelope>

PwsGetResourceSchedule - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

10103NothingToDoThere is nothing to do.
20024StartDateRequiredForGetResourceScheduleA start date must be specified.
20025InvalidValueForResourceScheduleStartDateThe specified start date must be expressed as midnight UTC on the desired date.

20026

EndDateRequiredForGetResourceScheduleAn end date must be specified
20027InvalidValueForResourceScheduleEndDateThe specified end date must be expressed as midnight UTC on the desired date.
50045ViewPermissionDeniedYou do not have permission to view this item.
54282ProjectNotFoundSpecified project does not exist.
57545ResourceNotFoundThe specified resource does not exist.