Overview

This structure is used to uniquely identify an Engagement. Engagements can be identified by EngagementCode or EngagementUid. When specifying a PwsEngagementRef as an input to a web service, you may specify one or both the EngagementCode and/or EngagementUid. However, if you do specify both, they must both refer to the same Engagement or the engagement reference will not be considered valid. When a PwsEngagementRef is returned in the response to a web service, both the EngagementCode and EngagementUid will be populated, and guaranteed to refer to a single Engagement.

Format

PwsEngagementRef

PwsEngagementRef
- EngagementCode: String
- EngagementId: Int32
- EngagementUid: Int64

Element

Element	Data Type	Description	Sample Data
EngagementCode	String	The Engagement Code is a unique identifier for an Engagement.	E001395
EngagementId	Int32	The Engagement Id is a unique identifier for an Engagement. For internal use only.
EngagementUid	Int64	The Engagement Uid is a unique and immutable identifier for an Engagement.	1152921504607324698

Usage Example(s)

Example 01 - EngagementCode Only

               <com:PwsEngagementRef>
                  <com:EngagementCode>E001395</com:EngagementCode>
                  <!--com:EngagementId>?</com:EngagementId-->
                  <!--com:EngagementUid>?</com:EngagementUid-->
               </com:PwsEngagementRef>

Example 02 - EngagementCode and EngagementUid

                <com:PwsEngagementRef>
                  <com:EngagementCode>E001395</com:EngagementCode>
                  <!--com:EngagementId>?</com:EngagementId-->
                  <com:EngagementUid>1152921504607324698</com:EngagementUid>
               </com:PwsEngagementRef>