Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 28 Next »

Overview


This web service inserts, updates or deletes one or more project issues. Project issues to be inserted or updated are passed in SaveProjectIssues (PwsProjectIssueDetail). Issues to be deleted are passed in DeleteProjectissues (PwsProjectIssueRef). One or more of the project issues specified to this request may fail without preventing the remaining issues from being saved or deleted. The response will include ProjectIssueResults (PwsSaveProjectIssueResult) which will provide details about each specified issue, including the issue identity, whether the issue was successfully saved or deleted, and if not, the specific reason for the failure.

Request Format


PwsSaveProjectIssuesRq

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.


DeleteProjectIssues

PwsProjectIssueRef[]

No


This is the identity of the project issue to be deleted. Click here for more information.


ProjectIdentity

PwsProjectRef

Yes


This is the identity of the project. Click here for more information.


SaveProjectIssues

PwsProjectIssueDetail[]

No


The detailed project issue information to be inserted or updated. Click here for more information.


Request Usage Example(s)


Example 01 - delete
<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:PwsSaveProjectIssues>
         <pws:serviceRequest>
            <req:SessionTicket>ASA2SxZGgEWiNl525Vyqzw==</req:SessionTicket>
            <web:DeleteProjectIssues>
               <com:PwsProjectIssueRef>
                  <com:ProjectIssueUid>1152921504606875462</com:ProjectIssueUid>
               </com:PwsProjectIssueRef>
            </web:DeleteProjectIssues>
            <web:ProjectIdentity>
               <com:ProjectCode>P001053-WS2</com:ProjectCode>
            </web:ProjectIdentity>
            <web:SaveProjectIssues>
            </web:SaveProjectIssues>
         </pws:serviceRequest>
      </pws:PwsSaveProjectIssues>
   </soapenv:Body>
</soapenv:Envelope>
Example 02 - create
<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:PwsSaveProjectIssues>
         <pws:serviceRequest>
            <req:SessionTicket>ASA2SxZGgEWiNl525Vyqzw==</req:SessionTicket>
            <web:ProjectIdentity>
               <com:ProjectCode>P001053-WS2</com:ProjectCode>
            </web:ProjectIdentity>
            <web:SaveProjectIssues>
               <web:PwsProjectIssueDetail>
                  <com:ReferenceId>#1</com:ReferenceId>
                  <web:AttachmentClearFlag>true</web:AttachmentClearFlag>
                  <web:Attachments>
                  </web:Attachments>
                  <web:CategoryIdentity>
                     <com:ProjectIssueCategoryUid>1152921504606992779</com:ProjectIssueCategoryUid>
                  </web:CategoryIdentity>
                  <web:Description>Created via web service #5</web:Description>
                  <web:DueDate>2018-02-28z</web:DueDate>
                  <web:DueDateClearFlag>false</web:DueDateClearFlag>
                  <web:EmailIssueOwnerFlag>false</web:EmailIssueOwnerFlag>
                  <web:EmailPmTeamFlag>false</web:EmailPmTeamFlag>
                  <web:IssueNumber>3</web:IssueNumber>
                  <web:OwnerIdentity>
                     <com:UserDisplayName>larry krakauer</com:UserDisplayName>
                  </web:OwnerIdentity>
                  <web:Priority>M</web:Priority>
                  <web:Resolution>pending</web:Resolution>
                  <web:ResolutionClearFlag>false</web:ResolutionClearFlag>
                  <web:StatusIdentity>
                     <com:ProjectIssueStatusUid>1152921504607253230</com:ProjectIssueStatusUid>
                  </web:StatusIdentity>
               </web:PwsProjectIssueDetail>
            </web:SaveProjectIssues>
         </pws:serviceRequest>
      </pws:PwsSaveProjectIssues>
   </soapenv:Body>
</soapenv:Envelope>


Response Format


PwsSaveProjectIssuesRs

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

Click here for more information.


ServerTimestampUtc

DateTime

Click here for more information.

2018-02-06T14:14:21.9169814Z

ProjectIssueResults

PwsSaveProjectIssueResult[]

This structure is part of a response of web service PwsSaveProjectIssues. Click here for more information.


Response Usage Example(s)


Example 01 - delete
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsSaveProjectIssuesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveProjectIssuesResult 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-02-06T14:14:21.9169814Z</ServerTimestampUtc>
            <a:ProjectIssueResults/>
         </PwsSaveProjectIssuesResult>
      </PwsSaveProjectIssuesResponse>
   </s:Body>
</s:Envelope>
Example 02 - create
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsSaveProjectIssuesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveProjectIssuesResult 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-02-06T14:17:47.2506943Z</ServerTimestampUtc>
            <a:ProjectIssueResults>
               <a:PwsSaveProjectIssueResult>
                  <a:ErrorDetail i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                  <a:ProjectIssue>
                     <ProjectIssueId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">28487</ProjectIssueId>
                     <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875463</ProjectIssueUid>
                     <ReferenceId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">#1</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>Created via web service #5</a:Description>
                     <a:DueDate>2018-02-28T00:00:00Z</a:DueDate>
                     <a:DueDateClearFlag>false</a:DueDateClearFlag>
                     <a:EmailIssueOwnerFlag>false</a:EmailIssueOwnerFlag>
                     <a:EmailPmTeamFlag>false</a:EmailPmTeamFlag>
                     <a:IssueNumber>9</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>pending</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+RGxA=</a:Timestamp>
                  </a:ProjectIssue>
                  <a:ReferenceId>#1</a:ReferenceId>
               </a:PwsSaveProjectIssueResult>
            </a:ProjectIssueResults>
         </PwsSaveProjectIssuesResult>
      </PwsSaveProjectIssuesResponse>
   </s:Body>
</s:Envelope>


PwsSaveProject - Common Errors and Warnings

ErrorNumberErrorCodeErrorText
57550UserNotSpecifiedUser is required. (*owner identity is missing)
84007WorkspaceProjectIssueNotFoundProject issue not found.
84009ProjectIssueCategoryRefInvalidProjectIssueCategoryRef is required.
84011ProjectIssueCategoryNotFoundProject issue category not found.
84012ProjectIssueStatusRefInvalidProjectIssueStatusRef is required.
84014ProjectIssueStatusNotFoundProject issue status not found.
84015InvalidValueForIssuePriorityInvalid priority value.
84017PriorityRequiredForSaveProjectIssuePriority is required.
84018DescriptionRequiredForSaveProjectIssueDescription is required.



  • No labels