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?

Description

Sample Data

ExternalSystemIdentifier

String (50)

One of ExternalSystemIdentifier or ProjectTaskUid is required

The external system identifier is a unique identifier for a project task.

ESI-123

ProjectTaskId

Int32

No

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

ProjectTaskUid

Int64

See ExternalSystemIdentifier

A unique and immutable identifier for a project task.

1152921504608637358

Usage Example(s)

Example 01

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