Versions Compared

Key

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

Overview


This structure is used to uniquely identify a Project Taskrepresents 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 project task or the Project Task 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 Taskproject task.

Format


Panel
titlePwsProjectTaskRef
  • PwsProjectTaskRef
    • ExternalSystemIdentifier: String (50)
    • ProjectTaskId: Int32
    • ProjectTaskUid: Int64

...

Element

Data Type

Required?Default

Description

Sample Data

ExternalSystemIdentifier

String External system identifier for task (may be null, but once set can only be updated to a different, non-null value)(50)

One of ExternalSystemIdentifier or ProjectTaskUid is required


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

ESI-123

ProjectTaskId

Int32Project Task Id

No

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


ProjectTaskUid

Int64The Project Task Uid is a

See ExternalSystemIdentifier

A unique and immutable identifier for a Project Taskproject task.

1152921504608637358


Usage Example(s)

...

Code Block
languagexml
titleExample 01
collapsetrue
            <ProjectTaskIdentity><b:ProjectTaskIdentity>
               <ExternalSystemIdentifier>ESI<b:ExternalSystemIdentifier>ESI-123</b:ExternalSystemIdentifier>
               <ProjectTaskId<b:ProjectTaskId i:nil="true"/>
               <ProjectTaskUid>1152921504608637358<<b:ProjectTaskUid>1152921504608637358</b:ProjectTaskUid>
            </b:ProjectTaskIdentity>