Overview

This structure represents the unique key fields associated with identifying an project stage. Project Stages can be identified by ProjectStageName, ProjectStageShortName or ProjectStageUid. When specifying a PwsProjectStageRef as an input to a web service, you may specify one or all three fields the ProjectStageName, ProjectStageShortName and/or ProjectStageUid. However, if you do specify all three, they must refer to the same project stage or the project stage reference will not be considered valid. When a PwsProjectStageRef is returned in the response to a web service, the ProjectStageName, ProjectStageShortName and/or ProjectStageUid will be populated, and guaranteed to refer to a single Project stage.

Format

PwsProjectStageRef

PwsProjectStageRef
- ProjectStageId: Int32
- ProjectStageName: String (50)
- ProjectStageShortName: String (15)
- ProjectStageUid: Int64

Elements

Element	Data Type	Required?	Description	Sample Data
ProjectStageId	Int32	On Insert: No On Update: No	The project stage Id is a unique identifier for a project stage. For internal use only.
ProjectStageName	String (50)	On Insert: Yes On Update: Yes (if EngagementStageUid is not supplied)	The project stage name is a unique identifier for a project stage.	Planning
ProjectStageShortName	String (15)	On Insert: No On Update: No	The project stage short name is a unique identifier for a project stage.	Planning
ProjectStageUid	Int64	On Insert: No On Update: Yes (if ProjectStageName is not supplied)	The project stage Uid is a unique and immutable identifier for a project stage.	1152921504606849648

Usage Example(s)

Example 01

   					 <b:ProjectStageIdentity>
                        <b:ProjectStageId i:nil="true"/>
                        <b:ProjectStageName>Planning</b:ProjectStageName>
                        <b:ProjectStageShortName>Planning</b:ProjectStageShortName>
                        <b:ProjectStageUid>1152921504606849648</b:ProjectStageUid>
                     </b:ProjectStageIdentity>