Versions Compared

Key

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

Overview


This web service deletes a specified resource's (PwsResourceRef) available time off hours for a specific time off reason (PwsTimeOffReasonRef). 

Request Format


Panel
titlePwsDeleteResourceAvailableTimeOff 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.

AUL1Tsqbhar4SWXC5j9T+w== 

EndDate

DateTime

No 

The EndDate and the StartDate define the period in which the time off hours should be deleted. Leaving EndDate null will result in deleting all available time off hours after the specified StartDate. Leaving StartDate null will result in deleting all available time off hours up until the EndDate. Leaving both null will result deleting all available time off hours.

2018-01-31T00:00:00.000Z

ResourceIdentity

PwsResourceRef

Yes 

The resource identity


StartDate

DateTime

No 

See EndDate

2018-01-01T00:00:00.000Z

TimeOffReasonIdentity

PwsTimeOffReasonRef

Yes 

The time off reason identity


Request Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsDeleteResourceAvailableTimeOff>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AUL1Tsqbhar4SWXC5j9T+w==</req:SessionTicket>
            <req:EndDate>2018-01-31T00:00:00.000Z</req:EndDate>
            <req:ResourceIdentity>
               <com:ResourceDisplayName>Jack Spratt</com:ResourceDisplayName>
               <com:ResourceReferenceSystemId>E123</com:ResourceReferenceSystemId>
            </req:ResourceIdentity>
            <req:StartDate>2018-01-01T00:00:00.000Z</req:StartDate>
            <req:TimeOffReasonIdentity>
               <com:TimeOffReasonName>Vacation</com:TimeOffReasonName>
               <com:TimeOffReasonUid>1152921504606858293</com:TimeOffReasonUid>
            </req:TimeOffReasonIdentity>
         </pws:serviceRequest>
      </pws:PwsDeleteResourceAvailableTimeOff>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


Panel
titlePwsDeleteResourceAvailableTimeOff 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-01T20:47:10.0345768Z

Response Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsDeleteResourceAvailableTimeOffResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsDeleteResourceAvailableTimeOffResult xmlns:a="http://projectorpsa.com/DataContracts/Responses/" 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-01T20:47:10.0345768Z</ServerTimestampUtc>
         </PwsDeleteResourceAvailableTimeOffResult>
      </PwsDeleteResourceAvailableTimeOffResponse>
   </s:Body>
</s:Envelope>

PwsDeleteResourceAvailableTimeOffResponse - Common Errors and Warnings


ErrorNumber

ErrorCode

ErrorText

10116InvalidDateValueSpecifiedThe date specified in the field "{FieldName}" in the class "{TypeName}" is invalid or out of range. The time component of the specified date must be midnight UTC.