Versions Compared

Key

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

...

This structure is used to uniquely identify a project issue.  Project issues can be identified by ProjectIssueUid or ReferenceID. When specifying a PwsClientRef as an input to a web service, you may specify one or both the ClientNumber and ClientUid. However, if you do specify both they must both refer to the same client or the client reference will not be considered valid. When a PwsClientRef is returned in the response to a web service, both the ClientNumber and ClientUid will be populated, and guaranteed to refer to a single clientand it can also be tagged by a user defined ID called ReferenceId. The reference id is not stored with the issue in the database, but may be used as described below to correlate submitted issues (especially new ones) to errors that may be returned in the response from the PwsSaveProjectIssues service.

Format

Panel
titlePwsProjectIssueRef
  • PwsProjectIssueRef
    • ProjectIssueId: Int32
    • ProjectIssueUid: Int64
    • ReferenceId: String
    • ExternalSystemIdentifier; String (???) (Luke, what is the length of this string? 20)

Elements

Element

Data Type

Required?

Description

Sample Data

ProjectIssueId

Int32

No

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


ProjectIssueUid

Int64

Yes

A unique and immutable identifier for a project issue.

1152921504606875454

ReferenceId

String

(???)

No

This is a user-defined ID for project issue. It allows user to

identify

tag project issues that are

failed to process by web service such as PwsSaveProjectIssues. It is included in the error message in web service response.

#3

submitted in a web service request, and is echoed in the web service response to allow user to correlate project issues in the response to the ones in request.

#3

ExternalSystemIdentifierString (20)NoThe external system identifier is a unique identifier for a project issue.

Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
					 <ProjectIssueId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">28485</ProjectIssueId>
                     <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875461</ProjectIssueUid>
                     <ReferenceId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">#1</ReferenceId>
 					 <ExternalSystemIdentifier i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>