Versions Compared

Key

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

...

This structure contains the complete set of information about a project issue. The structure is used both to retrieve detailed project information and to pass information about a project back to the server to get updated. (Luke, update has an seems to be broken see issue #36112 on it; so it is any portion below pertaining to update is just my guess only.  )

Format

Panel
titlePwsProjectIssueDetail
  • PwsProjectIssueDetail
    • ProjectIssueId: Int32
    • ProjectIssueUid: Int64
    • ReferenceId: String (Luke, please add string length.)
    • AttachmentClearFlag: Boolean
    • Attachments: PwsProjectIssueAttachmentDetail (Luke, please list array size.)
    • CategoryIdentity: PwsProjectIssueCategoryRef
    • Description: String (255)
    • DueDate: DateTime
    • DueDateClearFlag: Boolean
    • EmailIssueOwnerFlag: Boolean
    • EmailPmTeamFlag: Boolean
    • IssueNumber: Int32
    • OwnerIdentity: PwsUserRef
    • Priority: String (1)
    • Resolution: String (4000)
    • ResolutionClearFlag: Boolean
    • StatusIdentity: PwsProjectIssueStatusRef
    • Timestamp: String

...

Element

Data Type

Required?

Default

Description

Sample Data

ProjectIssueId

Int32

No


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


ProjectIssueUid

Int64

On Insert: No

On Update: Yes


The project issue Uid is a unique and immutable identifier for a project issue.

1152921504606992779

ReferenceId

String

No


This is a user-defined ID for project issue. It allows user to tag project issues that are submitted in a web service request, and is echoed in the web service response to allow user to correlate project issues in response to the ones in request.

#1

AttachmentClearFlag

Boolean

No

false

If set to 'true, attachment document is cleared off an issue.

false

Attachments

PwsProjectIssueAttachmentDetail[???]

No


Document(s) attached to this project issue. Click here for more information.


CategoryIdentity

PwsProjectIssueCategoryRef

On Insert: Yes

On Update: No


The category of a project issue. Click here for more information.


Description

String (255)

On Insert: Yes

On Update: No


Description of a project issue

Costume design is behind schedule

DueDate

DateTime

No


Due date of a project issue

2018-02-28z

DueDateClearFlag

Boolean

No

false

If set to 'true', issue due date will be cleared.

false

EmailIssueOwnerFlag

Boolean

No

false

If set to 'true', email will be sent to issue owner when issue is saved.

false

EmailPmTeamFlag

Boolean

No

false

If set to 'true', email will be sent to project management team when issue is saved.

false

IssueNumber

Int32

No


Ignored in a save web service request and valid value is returned in response.

6

OwnerIdentity

PwsUserRef

On Insert: Yes

On Update: No


The owner of a project issue. Click here for more information.


Priority

String (1)

On Insert: Yes

On Update: No


The priority of a project issue:

'L' for low priority

'M' for medium priority

'H' for high priority

M

Resolution

String (4000)

No


The latest comment associated with a project issue.

Issue is no longer valid.

ResolutionClearFlag

Boolean

No


If set to 'true', the latest resolution will be cleared.

false

StatusIdentity

PwsProjectIssueStatusRef

On Insert: Yes

On Update: No


The status of a project issue and it is defined on a project basis. Click here for more information.


Timestamp

String

No


Base64 encoded timestamp. Meaningless on an insert. Caller may optionally supply the value retrieved earlier. If the issue has been updated since it was last retrieved, the update will fail. No checking is done if no value is specified


Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
				    <a:ProjectIssue>
                     <ProjectIssueId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">28509</ProjectIssueId>
                     <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875485</ProjectIssueUid>
                     <ReferenceId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">#10</ReferenceId>
                     <a:AttachmentClearFlag>false</a:AttachmentClearFlag>
                     <a:Attachments/>
                     <a:CategoryIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ProjectIssueCategoryId>351612</b:ProjectIssueCategoryId>
                        <b:ProjectIssueCategoryUid>1152921504606992779</b:ProjectIssueCategoryUid>
                     </a:CategoryIdentity>
                     <a:Description>new issue about the set production</a:Description>
                     <a:DueDate>2018-03-31T00:00:00Z</a:DueDate>
                     <a:DueDateClearFlag>false</a:DueDateClearFlag>
                     <a:EmailIssueOwnerFlag>false</a:EmailIssueOwnerFlag>
                     <a:EmailPmTeamFlag>false</a:EmailPmTeamFlag>
                     <a:IssueNumber>28</a:IssueNumber>
                     <a:OwnerIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:UserDisplayName>Larry Krakauer</b:UserDisplayName>
                        <b:UserId>217832</b:UserId>
                        <b:UserReferenceSystemId>097</b:UserReferenceSystemId>
                        <b:UserUid>1152921504606944254</b:UserUid>
                     </a:OwnerIdentity>
                     <a:Priority>M</a:Priority>
                     <a:Resolution>testtest</a:Resolution>
                     <a:ResolutionClearFlag>false</a:ResolutionClearFlag>
                     <a:StatusIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ProjectIssueStatusId>851626</b:ProjectIssueStatusId>
                        <b:ProjectIssueStatusUid>1152921504607253230</b:ProjectIssueStatusUid>
                     </a:StatusIdentity>
                     <a:Timestamp>AAAAAA+RVEI=</a:Timestamp>
                  </a:ProjectIssue>

...