Versions Compared

Key

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

Overview

The PwsEngagementSummary PwsProjectSummary data type includes basic information about an engagementa project. The information represented in this structure is not comprehensive and only includes certain key attributes of an engagement to be useful in a listing of engagements.a project that is part of a list. 

Format

Panel
titlePwsEngagementSummaryPwsProjectSummary
  • PwsEngagementSummaryPwsProjectSummary
    • EngagementCodeProjectCode: String (20)
    • EngagementIdProjectId: Int32
    • EngagementUidProjectUid: Int64
    • ClientIdentityEngagementIdentity: PwsClientRef PwsEngagementRef
    • EngagementNameProjectName: String (255)

Elements

Element

Data Type

Required?

Default

Description

Sample Data

EngagementCode

ProjectCode

String

(20)

On Insert: Yes

On Update: Yes (if EngagementUid is not supplied)

The engagement code is a unique identifier for an engagement. See "NewEngagementCode" in PwsEngagementDetail for guidance on how to change the engagement code of an existing engagement. 

P001320

EngagementId

Int32

On Insert: No

On Update: No

The engagement Id is a unique identifier for an engagement. For internal use only.

EngagementUid

Int64

On Insert: No

On Update: Yes (if EngagementCode is not supplied)

A unique and immutable identifier for an engagement

1152921504607326368

ClientIdentity

PwsClientRef

On Insert: Yes

On Update: No

The client associated with the engagement

EngagementName

String (255)

On Insert: Yes

On Update: No

The engagement name

Web Services Documentation





ProjectId

Int32





ProjectUid

Int64





EngagementIdentity

PwsEngagementRef





ProjectName

String





Usage Example(s)


<b:PwsEngagementSummary> <b:EngagementCode>P001320</b:EngagementCode> <b:EngagementId i:nil="true"/> <b:EngagementUid>1152921504607326368</b:EngagementUid> <b:ClientIdentity> <b:ClientId i:nil="true"/> <b:ClientNumber>C000121</b:ClientNumber> <b:ClientUid>1152921504606998462</b:ClientUid> </b:ClientIdentity> <b:EngagementName>Web Services Documentation</b:EngagementName> </b:PwsEngagementSummary>
Code Block
languagexml
titleExample 01
collapsetrue