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 (50)

Yes


Click here for more information

AavFwbZgVb9V4tr3R7BbzQ==

EngagementIdentities

PwsEngagementRef [1..100]

Yes


One or more (up to 100) engagements to be retrieved. Click here for more information.


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:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsGetEngagement>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>AavFwbZgVb9V4tr3R7BbzQ==</req:SessionTicket>
            <sch:EngagementIdentities>
               <com:PwsEngagementRef>
                  <com:EngagementCode>P001320</com:EngagementCode>
               </com:PwsEngagementRef>
            </sch:EngagementIdentities>
         </pws:serviceRequest>
      </pws:PwsGetEngagement>
   </soapenv:Body>
</soapenv:Envelope>

...

Panel
titlePwsGetEngagement Response


Response Elements


ElementDataTypeDescriptionSample Data
MessagesPwsMessage[]

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


ResponseIdInt32Click here for more information
1
StatusStringRequestStatusClick here for more information
Ok
ServerTimestampUtcDateTimeClick here for more information
2018-01-17T19:38:01.0608747Z
EngagementsPwsEngagementElement [01..100]The details of the engagements that were fetched. Click here for more information.


Response Usage Example(s)

...

ErrorNumber

ErrorCode

ErrorText

105AtLeastOneItemNotFoundOne or more specified engagements not found
12042NoEngagementsSpecifiedNo engagements specified for retrieval
12044MaximumEngagementIdentitiesExceededAttempt to retrieve more than the maximum allowable number of engagements at once

50045

ViewPermissionDeniedPermission denied
54059EngagementNotSpecifiedA specified engagement reference was incomplete or missing
54064UnexpectedErrorRetrievingEngagementsUnexpected error retrieving engagements
54370NoPermissionToViewEngagementPermission denied to view specific engagement