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

PwsSaveProjectIssuesRq
- RequestId: Int32
- SessionTicket: String
- DeleteProjectIssues: PwsProjectIssueRef (Luke, what is the array's limit?)
- ProjectIdentity: PwsProjectRef
- SaveProjectIssues: PwsProjectIssueDetail (Luke, what is the array's limit?)

Request Elements

Element	Data Type	Required?	Description
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

PwsSaveProjectIssuesRs
- Messages: PwsMessage
- ResponseId: Int32
- Status: RequestStatus
- ServerTimestampUtc: DateTime
- ProjectIssueResults: PwsSaveProjectIssueResult

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.
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

For all errors and warnings please refer to the Complete List of Errors and Warnings

ErrorNumber	ErrorCode	ErrorText
57550	UserNotSpecified	User is required. (owner identity is missing)*
84001	? missing	missing (see issue #36109)
84007	WorkspaceProjectIssueNotFound	Project issue not found.
84009	ProjectIssueCategoryRefInvalid	ProjectIssueCategoryRef is required.
84011	ProjectIssueCategoryNotFound	Project issue category not found.
84012	ProjectIssueStatusRefInvalid	ProjectIssueStatusRef is required.
84014	ProjectIssueStatusNotFound	Project issue status not found.
84015	InvalidValueForIssuePriority	Invalid priority value.
84017	PriorityRequiredForSaveProjectIssue	Priority is required.
84018	DescriptionRequiredForSaveProjectIssue	Description is required.