Versions Compared

Key

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

...

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 identityfull details of the saved issue (PwsProjectIssueDetail), whether the issue was successfully saved or deleted, and if not, the specific reason for the failure.

...

Panel
titlePwsSaveProjectIssuesRq

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)

...

languagexml
titleExample 01 - delete
collapsetrue

...


OverrideDocumentLockFlagBooleanNo
If set to 'true', then request can update the attachment on the issue even if it is checked out/locked. If set to 'false', the save will fail if the attachment on the issue is checked out/locked.

Request Usage Example(s)


Code Block
languagexml
titleExample 01 - create
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:PwsSaveProjectIssues>
         <pws:serviceRequest>
            <req:SessionTicket>ASA2SxZGgEWiNl525VyqzwSessionTicket>Ade8vXDjCIr0kcDpdVTbCw==</req:SessionTicket>
            <web:DeleteProjectIssues>ProjectIdentity>
               <com:PwsProjectIssueRef>:ProjectCode>P001125-001</com:ProjectCode>
            </web:ProjectIdentity>
     <com:ProjectIssueUid>1152921504606875462</com:ProjectIssueUid>       <web:SaveProjectIssues>
        </com:PwsProjectIssueRef>       <web:PwsProjectIssueDetail>
     </web:DeleteProjectIssues>             <web:ProjectIdentity><com:ReferenceId>#1</com:ReferenceId>
                  <com:ProjectCode>P001053-WS2</com:ProjectCode><web:Attachments>
              <    </web:ProjectIdentity>Attachments>
                  <web:SaveProjectIssues>CategoryIdentity>
                     <<com:ProjectIssueCategoryUid>1152921504607339490</web:SaveProjectIssues>com:ProjectIssueCategoryUid>
                  </pwsweb:serviceRequest>CategoryIdentity>
       </pws:PwsSaveProjectIssues>    </soapenv:Body>
</soapenv:Envelope>
Code Block
languagexml
titleExample 02 - create
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:PwsSaveProjectIssues>       <web:Description>This is a new issue</web:Description>
                  <web:DueDate>2018-10-31z</web:DueDate>
                  <web:DueDateClearFlag>false</web:DueDateClearFlag>
           <pws:serviceRequest>       <web:EmailIssueOwnerFlag>false</web:EmailIssueOwnerFlag>
     <req:SessionTicket>ASA2SxZGgEWiNl525Vyqzw==</req:SessionTicket>             <web:ProjectIdentity>:EmailPmTeamFlag>false</web:EmailPmTeamFlag>
                  <com<web:ProjectCode>P001053-WS2<IssueNumber>10</comweb:ProjectCode>IssueNumber>
            </web:ProjectIdentity>      <web:OwnerIdentity>
      <web:SaveProjectIssues>                <web:PwsProjectIssueDetail><com:UserDisplayName>krakauer, larry</com:UserDisplayName>
                  <com:ReferenceId>#1<</comweb:ReferenceId>OwnerIdentity>
                  <web:AttachmentClearFlag>true<Priority>M</web:AttachmentClearFlag>Priority>
                  <web:Attachments>Resolution>pending</web:Resolution>
                  <<web:ResolutionClearFlag>false</web:Attachments>ResolutionClearFlag>
                  <web:CategoryIdentity>StatusIdentity>
                     <com:ProjectIssueCategoryUid>1152921504606992779<ProjectIssueStatusUid>1152921504608004811</com:ProjectIssueCategoryUid>ProjectIssueStatusUid>
                  </web:CategoryIdentity>StatusIdentity>
                  <web:Description>Created via web service #5<</web:Description>PwsProjectIssueDetail>
                  <web:DueDate>2018-02-28z<</web:DueDate>SaveProjectIssues>
         </pws:serviceRequest>
      </pws:PwsSaveProjectIssues>
 <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>
             </soapenv:Body>
</soapenv:Envelope>
Code Block
languagexml
titleExample 02 - delete
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>
      </web:OwnerIdentity><pws:PwsSaveProjectIssues>
         <pws:serviceRequest>
            <web:Priority>M</web:Priority><req:SessionTicket>Ade8vXDjCIr0kcDpdVTbCw==</req:SessionTicket>
            <web:DeleteProjectIssues>
     <web:Resolution>pending</web:Resolution>          <com:PwsProjectIssueRef>
        <web:ResolutionClearFlag>false</web:ResolutionClearFlag>          <com:ProjectIssueUid>1152921504606877025</com:ProjectIssueUid>
        <web:StatusIdentity>       </com:PwsProjectIssueRef>
            </web:DeleteProjectIssues>
   <com:ProjectIssueStatusUid>1152921504607253230</com:ProjectIssueStatusUid>         <web:ProjectIdentity>
         </web:StatusIdentity>      <com:ProjectCode>P001125-001</com:ProjectCode>
            </web:PwsProjectIssueDetail>ProjectIdentity>
            <web:SaveProjectIssues>
            </web:SaveProjectIssues>
         </pws:serviceRequest>
      </pws:PwsSaveProjectIssues>
   </soapenv:Body>
</soapenv:Envelope>

...

<s:Envelope xmlns:s
Code Block
languagexml
titleExample 01 - deletecreate
collapsetrue
true
<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://schemaswww.xmlsoapw3.org/soap/envelope/2001/XMLSchema-instance">
    <s:Body>        <PwsSaveProjectIssuesResponse<Messages xmlns="http://projectorpsa.com/PwsProjectorServicesCommonServices/">
         <PwsSaveProjectIssuesResult xmlns:ab="http://projectorpsa.com/DataContracts/Shared/Web/" xmlns:i/Common/"/>
            <ResponseId xmlns="http://wwwprojectorpsa.w3.orgcom/2001CommonServices/XMLSchema-instance">">0</ResponseId>
            <Messages<Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
            <ServerTimestampUtc xmlns:b="http://projectorpsa.com/DataContracts/SharedCommonServices/Common/"/>">2018-11-12T20:26:44.0483182Z</ServerTimestampUtc>
            <a:ProjectIssueResults>
<ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId>             <Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status><a:PwsSaveProjectIssueResult>
                   <ServerTimestampUtc xmlns<a:ErrorDetail i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/CommonServicesCommon/">2018-02-06T14:14:21.9169814Z</ServerTimestampUtc>/>
                  <a:ProjectIssueResults/>ProjectIssue>
          </PwsSaveProjectIssuesResult>       </PwsSaveProjectIssuesResponse>    </s:Body>
</s:Envelope>
Code Block
languagexml
titleExample 02 - create
collapsetrue
<s:Envelope xmlns:s<ProjectIssueId i:nil="true" xmlns="http://schemas.xmlsoap.org/soap/envelope/">projectorpsa.com/DataContracts/Shared/Common/"/>
              <s:Body>       <PwsSaveProjectIssuesResponse<ProjectIssueUid xmlns="http://projectorpsa.com/PwsProjectorServices/">/DataContracts/Shared/Common/">1152921504606877025</ProjectIssueUid>
                     <PwsSaveProjectIssuesResult<ReferenceId xmlns:a="http://projectorpsa.com/DataContracts/Shared/WebCommon/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">>#1</ReferenceId>
                     <Messages<ExternalSystemIdentifier xmlnsi:nil="http://projectorpsa.com/CommonServices/true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                    <ResponseId xmlns="http<a://projectorpsa.com/CommonServices/">0</ResponseId>AttachmentClearFlag>false</a:AttachmentClearFlag>
                    <Status xmlns="http<a://projectorpsa.com/CommonServices/">Ok</Status>Attachments/>
                     <ServerTimestampUtc<a:CategoryIdentity xmlns:b="http://projectorpsa.com/DataContracts/CommonServices/">2018-02-06T14:17:47.2506943Z</ServerTimestampUtc>Shared/Common/">
             <a:ProjectIssueResults>           <b:ProjectIssueCategoryId i:nil="true"/>
   <a:PwsSaveProjectIssueResult>                   <a:ErrorDetail i:nil="true" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/> <b:ProjectIssueCategoryUid>1152921504607339490</b:ProjectIssueCategoryUid>
                     <a:ProjectIssue></a:CategoryIdentity>
                     <a:Description>This is a <ProjectIssueId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">28487</ProjectIssueId>new issue</a:Description>
                     <ProjectIssueUid xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">1152921504606875463</ProjectIssueUid><a:DueDate>2018-10-31T00:00:00Z</a:DueDate>
                     <ReferenceId xmlns="http://projectorpsa.com/DataContracts/Shared/Common/">#1</ReferenceId><a:DueDateClearFlag>false</a:DueDateClearFlag>
                     <a:AttachmentClearFlag>false<EmailIssueOwnerFlag>false</a:AttachmentClearFlag>EmailIssueOwnerFlag>
                     <a:AttachmentsEmailPmTeamFlag>false</>a:EmailPmTeamFlag>
                     <a:CategoryIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">IssueNumber>2</a:IssueNumber>
                        <b:ProjectIssueCategoryId>351612</b:ProjectIssueCategoryId><a:OwnerIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:ProjectIssueCategoryUid>1152921504606992779<UserDisplayName>Krakauer, Larry</b:ProjectIssueCategoryUid>UserDisplayName>
                        </a<b:CategoryIdentity>
UserId i:nil="true"/>
                    <a:Description>Created via web service #5<<b:UserReferenceSystemId>097</a:Description>b:UserReferenceSystemId>
                        <a:DueDate>2018-02-28T00:00:00Z</a:DueDate><b:UserUid>1152921504606944254</b:UserUid>
                     <a:DueDateClearFlag>false<</a:DueDateClearFlag>OwnerIdentity>
                     <a:EmailIssueOwnerFlag>false<Priority>M</a:EmailIssueOwnerFlag>Priority>
                     <a:EmailPmTeamFlag>false<Resolution>pending</a:EmailPmTeamFlag>Resolution>
                     <a:IssueNumber>9<ResolutionClearFlag>false</a:IssueNumber>ResolutionClearFlag>
                     <a:OwnerIdentityStatusIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">
                        <b:UserDisplayName>LarryProjectIssueStatusId Krakauer</b:UserDisplayName>
                        <b:UserId>217832</b:UserId>i:nil="true"/>
                        <b:UserReferenceSystemId>097<ProjectIssueStatusUid>1152921504608004811</b:UserReferenceSystemId>ProjectIssueStatusUid>
                        <b:UserUid>1152921504606944254</b:UserUid></a:StatusIdentity>
                     <a:Timestamp>AAAAABFDKdg=</a:OwnerIdentity>Timestamp>
                     <a:Priority>M</a:Priority>:NewExternalSystemIdentifier i:nil="true"/>
                     <a:Resolution>pending</a:Resolution>:UserDefinedFields xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                     <a:ResolutionClearFlag>false<</a:ResolutionClearFlag>ProjectIssue>
                  <a:ReferenceId>#1</a:ReferenceId>
  <a:StatusIdentity xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/">            </a:PwsSaveProjectIssueResult>
            <b:ProjectIssueStatusId>851626</b:ProjectIssueStatusId></a:ProjectIssueResults>
         </PwsSaveProjectIssuesResult>
      </PwsSaveProjectIssuesResponse>
   </s:Body>
</s:Envelope>
Code Block
languagexml
titleExample 02 - delete
collapsetrue
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <b:ProjectIssueStatusUid>1152921504607253230</b:ProjectIssueStatusUid><s:Body>
      <PwsSaveProjectIssuesResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsSaveProjectIssuesResult    </a:StatusIdentity>xmlns:a="http://projectorpsa.com/DataContracts/Shared/Web/" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <Messages         <a:Timestamp>AAAAAA+RGxA=</a:Timestamp>
 xmlns="http://projectorpsa.com/CommonServices/" xmlns:b="http://projectorpsa.com/DataContracts/Shared/Common/"/>
                </a:ProjectIssue><ResponseId xmlns="http://projectorpsa.com/CommonServices/">0</ResponseId>
                  <a:ReferenceId>#1</a:ReferenceId><Status xmlns="http://projectorpsa.com/CommonServices/">Ok</Status>
               </a:PwsSaveProjectIssueResult><ServerTimestampUtc xmlns="http://projectorpsa.com/CommonServices/">2018-11-12T20:32:01.0306358Z</ServerTimestampUtc>
            </a:ProjectIssueResults><a:ProjectIssueResults/>
         </PwsSaveProjectIssuesResult>
      </PwsSaveProjectIssuesResponse>
   </s:Body>
</s:Envelope>

...

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.
84019SpecifiedIssueDoesNotBelongToSpecifiedProjectProject mismatch.
84057IssueExternalSystemIdentifierAlreadyInUseThe specified project issue external system identifier is already in use. External system identifiers must be globally unique.