PwsProjectTaskRoleRef

Overview

This structure represents the unique set of elements associated with a project task role. Project task roles can be identified by a pair of ProjectRoleIdentity and ProjectTaskIdentity, or ProjectTaskRoleUid. When specifying a PwsProjectTaskRoleRef as an input to a web service, you may specify one or both of the pair and ProjectTaskTypeUid. However, if you do specify both, they must both refer to the same project task role or the project task role reference will not be considered valid. When a PwsProjectTaskRoleRef is returned in the response to a web service, both the pair and ProjectTaskRoleUid will be populated, and guaranteed to refer to a single project task role.

Format

PwsProjectTaskRoleRef

Elements

Element

Data Type

Required?

Default

Description

Sample Data

ProjectRoleIdentity

PwsProjectRoleRef

Yes when ProjectTaskRoleUid is not provided.


The identity of the project role that is associated with this project task role


ProjectTaskIdentity

PwsProjectTaskRef

Yes when ProjectTaskRoleUid is not provided.


The identity of the project task that is associated with this project task role.


ProjectTaskRoleId

Int32

No


The project task role Id is a unique identifier for a project task role. For internal use only. 


ProjectTaskRoleUid

Int64

Yes when the pair of ProjectRoleIndentity and ProjectTaskIndentity is not provided


A unique and immutable identifier for a project task role.

1152921504608653387

Usage Example(s)


Example 01
            <sch:ProjectTaskRoleIdentity>
               <com:ProjectRoleIdentity>
                  <com:ProjectRoleUid>1152921504609594610</com:ProjectRoleUid>
               </com:ProjectRoleIdentity>
               <com:ProjectTaskIdentity>
                  <com:ProjectTaskUid>1152921504608735153</com:ProjectTaskUid>
               </com:ProjectTaskIdentity>
               <com:ProjectTaskRoleUid>1152921504608653387</com:ProjectTaskRoleUid>
            </sch:ProjectTaskRoleIdentity>
Example 02
            <sch:ProjectTaskRoleIdentity>
               <com:ProjectRoleIdentity>
                  <com:ProjectRoleUid>1152921504609594610</com:ProjectRoleUid>
               </com:ProjectRoleIdentity>
               <com:ProjectTaskIdentity>
                  <com:ProjectTaskUid>1152921504608735153</com:ProjectTaskUid>
               </com:ProjectTaskIdentity>
            </sch:ProjectTaskRoleIdentity>