Overview

This structure represents the unique key fields associated with identifying a project task. Project Tasks can be identified by an ExternalSystemIdentifier or ProjectTaskUid. When specifying a PwsProjectTaskRef as an input to a web service, you may specify one or both the ExternalSystemIdentifier and ProjectTaskUid. However, if you do specify both, they must both refer to the same project task or the project task reference will not be considered valid. When a PwsProjectTaskRef is returned in the response to a web service, both the ExternalSystemIdentifier and ProjectTaskUid will be populated, and guaranteed to refer to a single project task.

Format

PwsProjectTaskRef

PwsProjectTaskRef
- ExternalSystemIdentifier: String (50)
- ProjectTaskId: Int32
- ProjectTaskUid: Int64

Elements

Element

Data Type

Required?

Default

Description

Sample Data

ExternalSystemIdentifier

String (50)

On Insert: Yes (if ProjectTaskUid is not supplied)

On Update: Yes (if ProjectTaskUid is not supplied)

The external system identifier is a unique identifier for a project task (may be null, but once set can only be updated to a different, non-null value)

ESI-123

ProjectTaskId

Int32

On Insert: No

On Update: No

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

ProjectTaskUid

Int64

On Insert: Yes (if ExternalSystemIdentifier is not supplied)

On Update: Yes (if ExternalSystemIdentifier is not supplied)

The project task Uid is a unique and immutable identifier for a project task

1152921504608637358

Usage Example(s)

Example 01

            <ProjectTaskIdentity>
               <ExternalSystemIdentifier>ESI-123</ExternalSystemIdentifier>
               <ProjectTaskId i:nil="true"/>
               <ProjectTaskUid>1152921504608637358</ProjectTaskUid>
            </ProjectTaskIdentity>