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

Yes


Click here for more information.

Ab54WRQ1LlgW9CoQrXhyzw==

EngagementIdentity

PwsEngagementRef

No 


The unique keys used to identify the engagement(s) to be retrieved. Click here for more information.


IncludeClosedFlag

Boolean

Yes 

false

If set to 'true', engagements that are open or closed according to the current engagement stage settings will be returned. Otherwise, only engagements that are not considered closed will be returned. This flag is disregarded if an engagement is specified.

  • EngagementId/EngagementUid/EngagementCode. If specified, the identified engagement will be returned (QueryString and IncludeClosedFlag will be ignored).
true

MaxRowsToReturn

Int32

No 


The maximum number of engagements to be retrieved. This flag is disregarded if an engagement is specified.

5

QueryString

String

No 


The engagements that are returned will contain the value in this field. This flag is disregarded if an engagement is specified.


LastUpdatedSinceTimestamp

DateTime

No 


Only engagements that have been updated on or after the specified date/time will be retrieved. This flag is disregarded if an engagement is specified.

2018-01-01

PurchaseOrderNumber

String

No 


The purchase order number(s) associated with the engagement(s). This flag is disregarded if an engagement is specified.


Request Usage Example(s)


Code Block
languagexml
titleExample 01 - Engagement is not specified
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:PwsGetEngagementList>
         <pws:serviceRequest>
            <req:RequestId>1</req:RequestId>
            <req:SessionTicket>Ab54WRQ1LlgW9CoQrXhyzw==</req:SessionTicket>
            <sch:IncludeClosedFlag>true</sch:IncludeClosedFlag>
            <sch:MaxRowsToReturn>5</sch:MaxRowsToReturn>
            <sch:LastUpdatedSinceTimestamp>2018-01-01</sch:LastUpdatedSinceTimestamp>
         </pws:serviceRequest>
      </pws:PwsGetEngagementList>
   </soapenv:Body>
</soapenv:Envelope>

...