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 26 Next »

Overview


This web service inserts or updates a single project based on a detailed project structure (PwsProjectDetail). The service returns the identity (PwsProjectRef) of the project that has been inserted or updated. The caller can optionally request that the full project detail (PwsProjectDetail) be included in the response.  Please note, upon creation of a new project, certain attributes may be derived from engagement type defaults or inherited from the engagement.  

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)
84001? missingmissing (see issue #36109)
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