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.A search string to narrow down the results. An engagement will be included in the results if the search string matches the engagement code or engagement name. This value is disregarded if a cost center is specified in EngagementIdentity. Click here for more information.


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.


...

Panel
titlePwsGetEngagementList Response

...

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-01-19T16:51:13.0252909Z

Engagements

PwsEngagementSummary [0..infinity]

The engagement summary records that were fetched by the service. Click here for more information.


...