PwsGetTimeCardApprovers

Overview


This web service retrieves a list of time card approvers (PwsUserSummary), based upon a unique time card identifier (PwsTimeCardRef)

Request Format


PwsGetTimeCardApprovers Request

Request Elements


Element

Data Type

Required?

Description

Sample Data

RequestId

Int32

No

Click here for more information.

1 

SessionTicket

String

Yes 

Click here for more information.

AT9QI7QhQKsYP2rPMg5Ilg== 

TimeCardIdentity

PwsTimeCardRef

Yes 

The identity of the time card.


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:PwsGetTimeCardApprovers>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AT9QI7QhQKsYP2rPMg5Ilg==</req:SessionTicket>
            <tim:TimeCardIdentity>
               <com:TimecardType>T</com:TimecardType>
               <com:TimecardUid>1152921504646141267</com:TimecardUid>
            </tim:TimeCardIdentity>
         </pws:serviceRequest>
      </pws:PwsGetTimeCardApprovers>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


PwsGetTimeCardApprovers 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-12T14:50:07.7100629Z

Approvers

PwsUserSummary[]

The identity of the time card approver(s).


Response Usage Example(s)


Example 01
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsGetTimeCardApproversResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsGetTimeCardApproversResult 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-12T15:59:21.1141408Z</ServerTimestampUtc>
            <a:Approvers xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
               <b:PwsUserSummary>
                  <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"/>
               </b:PwsUserSummary>
               <b:PwsUserSummary>
                  <b:UserDisplayName>Katrina Jones</b:UserDisplayName>
                  <b:UserId i:nil="true"/>
                  <b:UserReferenceSystemId>EX (USA) - 01</b:UserReferenceSystemId>
                  <b:UserUid>1152921504607062079</b:UserUid>
                  <b:EmailAddress>katrina@revcorp.bb</b:EmailAddress>
                  <b:FirstName>Katrina</b:FirstName>
                  <b:LastName>Bautista</b:LastName>
                  <b:MiddleName i:nil="true"/>
               </b:PwsUserSummary>
               <b:PwsUserSummary>
                  <b:UserDisplayName>Michael Simpson</b:UserDisplayName>
                  <b:UserId i:nil="true"/>
                  <b:UserReferenceSystemId>mouse01</b:UserReferenceSystemId>
                  <b:UserUid>1152921504607112371</b:UserUid>
                  <b:EmailAddress>mickey@revcorp.bb</b:EmailAddress>
                  <b:FirstName>Mickey</b:FirstName>
                  <b:LastName>Mouse</b:LastName>
                  <b:MiddleName i:nil="true"/>
               </b:PwsUserSummary>
            </a:Approvers>
         </PwsGetTimeCardApproversResult>
      </PwsGetTimeCardApproversResponse>
   </s:Body>
</s:Envelope>

PwsGetTimeCardApprovers - Common Errors and Warnings

ErrorNumber

ErrorCode

ErrorText

19093UnexpectedTimeCardTypeUnexpected value for TimeCardType. Valid values are T or R.
64220InvalidTimeCardA specified time card identity was incomplete. Each time card identity must specify either a time card id or time card uid.