Versions Compared

Key

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

...

This web service retrieves the history for a list of specified project issue , based upon a unique project identifier (PwsProjectRef) and a list of optional filters. 

Request Format

Request Elements

(PwsProjectIssueRef). The history of an issue will provide a log of changes to the specified issue since it was first created, including who made the change, when the change was made and the nature of the change.

Request Format


Panel
titlePwsGetProjectIssueHistory Request

Request Elements


Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.


SessionTicket

String

Yes


Click here for more information.

ARNkL4C1bp7KLtsSXQW6/g==

ProjectIssueIdentity

PwsProjectIssueRef

Yes


The identity of this project issue whose history is being retrieved in this request


Request Usage Example(s)


Code Block
languagexml
titleExample 01 - without project issue identity
collapsetrue
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:pws="http://projectorpsa.com/PwsProjectorServices/" xmlns:req="http://projectorpsa.com/DataContracts/Requests/" xmlns:web="http://projectorpsa.com/DataContracts/Shared/Web/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsGetProjectIssueHistory>
         <pws:serviceRequest>
            <req:SessionTicket>ARNkL4C1bp7KLtsSXQW6/g==</req:SessionTicket>
            <web:ProjectIssueIdentity>
               <com:ProjectIssueUid>1152921504606875990</com:ProjectIssueUid>
            </web:ProjectIssueIdentity>
         </pws:serviceRequest>
      </pws:PwsGetProjectIssueHistory>
   </soapenv:Body>
</soapenv:Envelope>

Response Format


Panelcode
titlelanguagePwsGetProjectIssueHistory Responsexml
  • PwsGetProjectIssueHistoryResponse
    titleExample 02 - with project issue identity
    collapsetrue
    </soapenv:Envelope>
    

    Response Format

    Response Elements

    Response Elements


    Element

    Data Type

    Description

    Sample Data

    Messages

    PwsMessage[]

    The web service response status and message. Click here for more information.


    ResponseId

    Int32

    Click here for more information.

    0

    Status

    RequestStatus

    Result of this request. Click here for more information.

    Ok

    ServerTimestampUtc

    DateTime

    Click here for more information.

    2018-03-06T20:23:53.0303932Z

    ProjectIssueHistory

    PwsProjectIssueHistory[]

    The history records for the specified project issue. Click here for more information.


    Response Usage Example(s)

    ...

    Code Block
    languagexml
    titleExample 01 - without project issue identity
    collapsetrue
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
       <s:Body>
          <PwsGetProjectIssueHistoryResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
             <PwsGetProjectIssueHistoryResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/Web/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
                <Messages xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                <ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId>
                <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
                <ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-03-06T20:23:53.0303932Z</ServerTimestampUtc>
                <a:ProjectIssueHistory>
                   <a:PwsProjectIssueHistory>
                      <a:DescriptionChangedFlag>false</a:DescriptionChangedFlag>
                      <a:DueDateChangedFlag>false</a:DueDateChangedFlag>
                      <a:HistoryType>U</a:HistoryType>
                      <a:OwnerChangedFlag>false</a:OwnerChangedFlag>
                      <a:PriorityChangedFlag>false</a:PriorityChangedFlag>
                      <a:ProjectIssue>
                         <ProjectIssueId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                         <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875990</ProjectIssueUid>
                         <ReferenceId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                         <a:AttachmentClearFlag>false</a:AttachmentClearFlag>
                         <a:Attachments/>
                         <a:CategoryIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:ProjectIssueCategoryId>467545</b:ProjectIssueCategoryId>
                            <b:ProjectIssueCategoryUid>1152921504607314521</b:ProjectIssueCategoryUid>
                         </a:CategoryIdentity>
                         <a:Description>Backup conductor still vacant</a:Description>
                         <a:DueDate i:nil="true"/>
                         <a:DueDateClearFlag>false</a:DueDateClearFlag>
                         <a:EmailIssueOwnerFlag>false</a:EmailIssueOwnerFlag>
                         <a:EmailPmTeamFlag>false</a:EmailPmTeamFlag>
                         <a:IssueNumber>1</a:IssueNumber>
                         <a:OwnerIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:UserDisplayName>Peter Gelb</b:UserDisplayName>
                            <b:UserId i:nil="true"/>
                            <b:UserReferenceSystemId i:nil="true"/>
                            <b:UserUid>1152921504607005072</b:UserUid>
                         </a:OwnerIdentity>
                         <a:Priority>M</a:Priority>
                         <a:Resolution>Peter, Yarnick might back out.  We need a backup conductor SOON.</a:Resolution>
                         <a:ResolutionClearFlag>false</a:ResolutionClearFlag>
                         <a:StatusIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:ProjectIssueStatusId>1119750</b:ProjectIssueStatusId>
                            <b:ProjectIssueStatusUid>1152921504607966726</b:ProjectIssueStatusUid>
                         </a:StatusIdentity>
                         <a:Timestamp>AAAAAA+7GYU=</a:Timestamp>
                      </a:ProjectIssue>
                      <a:ProjectIssueCategoryChangedFlag>false</a:ProjectIssueCategoryChangedFlag>
                      <a:ProjectIssueStatusChangedFlag>false</a:ProjectIssueStatusChangedFlag>
                      <a:UpdatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                         <b:UserDisplayName>Bruce Wayne</b:UserDisplayName>
                         <b:UserId i:nil="true"/>
                         <b:UserReferenceSystemId>BW-01</b:UserReferenceSystemId>
                         <b:UserUid>1152921504606950320</b:UserUid>
                         <b:EmailAddress>bruce@revcorp.doc</b:EmailAddress>
                         <b:FirstName>Bruce</b:FirstName>
                         <b:LastName>Wayne</b:LastName>
                         <b:MiddleName i:nil="true"/>
                      </a:UpdatedByUser>
                      <a:UpdatedTimestamp>2018-03-06T20:19:37.53Z</a:UpdatedTimestamp>
                   </s:Envelope>
    Code Block
    languagexml
    titleExample 02 - with project issue identity
    collapsetrue
    </s:Envelope>
    

    ...

    /a:PwsProjectIssueHistory>
                   <a:PwsProjectIssueHistory>
                      <a:DescriptionChangedFlag>true</a:DescriptionChangedFlag>
                      <a:DueDateChangedFlag>false</a:DueDateChangedFlag>
                      <a:HistoryType>N</a:HistoryType>
                      <a:OwnerChangedFlag>true</a:OwnerChangedFlag>
                      <a:PriorityChangedFlag>true</a:PriorityChangedFlag>
                      <a:ProjectIssue>
                         <ProjectIssueId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                         <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875990</ProjectIssueUid>
                         <ReferenceId i:nil="true" xmlns="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                         <a:AttachmentClearFlag>false</a:AttachmentClearFlag>
                         <a:Attachments/>
                         <a:CategoryIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:ProjectIssueCategoryId>467545</b:ProjectIssueCategoryId>
                            <b:ProjectIssueCategoryUid>1152921504607314521</b:ProjectIssueCategoryUid>
                         </a:CategoryIdentity>
                         <a:Description>Backup conductor still vacant</a:Description>
                         <a:DueDate i:nil="true"/>
                         <a:DueDateClearFlag>false</a:DueDateClearFlag>
                         <a:EmailIssueOwnerFlag>false</a:EmailIssueOwnerFlag>
                         <a:EmailPmTeamFlag>false</a:EmailPmTeamFlag>
                         <a:IssueNumber>1</a:IssueNumber>
                         <a:OwnerIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:UserDisplayName>Peter Gelb</b:UserDisplayName>
                            <b:UserId i:nil="true"/>
                            <b:UserReferenceSystemId i:nil="true"/>
                            <b:UserUid>1152921504607005072</b:UserUid>
                         </a:OwnerIdentity>
                         <a:Priority>M</a:Priority>
                         <a:Resolution i:nil="true"/>
                         <a:ResolutionClearFlag>false</a:ResolutionClearFlag>
                         <a:StatusIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                            <b:ProjectIssueStatusId>1119750</b:ProjectIssueStatusId>
                            <b:ProjectIssueStatusUid>1152921504607966726</b:ProjectIssueStatusUid>
                         </a:StatusIdentity>
                         <a:Timestamp>AAAAAA+7GYU=</a:Timestamp>
                      </a:ProjectIssue>
                      <a:ProjectIssueCategoryChangedFlag>true</a:ProjectIssueCategoryChangedFlag>
                      <a:ProjectIssueStatusChangedFlag>true</a:ProjectIssueStatusChangedFlag>
                      <a:UpdatedByUser xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                         <b:UserDisplayName>Bruce Wayne</b:UserDisplayName>
                         <b:UserId i:nil="true"/>
                         <b:UserReferenceSystemId>BW-01</b:UserReferenceSystemId>
                         <b:UserUid>1152921504606950320</b:UserUid>
                         <b:EmailAddress>bruce@revcorp.doc</b:EmailAddress>
                         <b:FirstName>Bruce</b:FirstName>
                         <b:LastName>Wayne</b:LastName>
                         <b:MiddleName i:nil="true"/>
                      </a:UpdatedByUser>
                      <a:UpdatedTimestamp>2018-03-06T20:17:04.7Z</a:UpdatedTimestamp>
                   </a:PwsProjectIssueHistory>
                </a:ProjectIssueHistory>
             </PwsGetProjectIssueHistoryResult>
          </PwsGetProjectIssueHistoryResponse>
       </s:Body>
    </s:Envelope>

    PwsGetProjectIssueHistory - Common Errors and Warnings


    ErrorNumber

    ErrorCode

    ErrorText

    84007WorkspaceProjectIssueNotFoundProject issue not found.