Versions Compared

Old Version 26

changes.mady.by.user Bettina Borces

Saved on

compared with

New Version Current

changes.mady.by.user Min Zeng

Saved on

Key

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

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

Request Format


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

Response Format

Panel
titlePwsSaveProjectIssuesRs
PwsSaveProjectIssuesRs
  • Messages: PwsMessage[]
  • ResponseId: Int32
    • </soapenv:Body>
</soapenv:Envelope>

    Response Format


    Panel
    titlePwsSaveProjectIssuesRs

    ...

    <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<</ba:ProjectIssueStatusId>ProjectIssueResults>
           </PwsSaveProjectIssuesResult>
      </PwsSaveProjectIssuesResponse>
   </s:Body>
 <b:ProjectIssueStatusUid>1152921504607253230</b:ProjectIssueStatusUid>
 </s:Envelope>
    Code Block
    languagexml
    titleExample 02 - delete
    collapsetrue
    <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <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)84001? missing
    missing (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.
    84019SpecifiedIssueDoesNotBelongToSpecifiedProjectProject mismatch.
    84057IssueExternalSystemIdentifierAlreadyInUseThe specified project issue external system identifier is already in use. External system identifiers must be globally unique.