Versions Compared

Version Old Version 27 New Version 28
Changes made by

Min Zeng

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

...

Panel
titlePwsSaveProjectRq
  • PwsSaveProjectRq
    • RequestId: Int32
    • SessionTicket: String
    • CloseDateClearFlag: Boolean
    • CostGlccOverrideClearFlag: Boolean **deprecated**
    • DescriptionClearFlag: Boolean
    • FullDetailFlag: Boolean
    • Mode: String (1)
    • PercentLikelihoodClearFlag: Boolean
    • Project: PwsProjectDetail
    • StealLockFlag: Boolean
    • TimeGlccOverrideClearFlag: Boolean **deprecated**
    • WorkspaceMessagesClearFlag: Boolean
    • ForceAdvancedSetupChangeFlag: Boolean
    • EngagementTimestamp: String
    • ManagementTeamClearFlag: Boolean
    • BdDashboardClearFlag: Boolean
    • ExpenseTypeConfigurationClearFlag: Boolean

...

Element

Data Type

Required?

Default

Description

Sample Data

RequestId

Int32

No


Click here for more information.

1

SessionTicket

String

Yes


Click here for more information.

Ad0gaqAh34T3anLQ/dUmpQ==

CloseDateClearFlag

Boolean

No

false

If set to "true", the end date of the project will be cleared.

false

CostGlccOverrideClearFlag

Boolean

deprecated




DescriptionClearFlag

Boolean

No

false

If set to "true", project description will be cleared.

false

FullDetailFlag

Boolean

No

false

If set to "true", full project element will be included in response.

false

Mode

String (1)

Yes


Applies if FullDetailFlag is set to true:

A to retrieve booked data for roles

R to retrieve requested data for roles

A/R

PercentLikelihoodClearFlag

Boolean

No

false

If set to "true", project percent likelihood will be cleared.

false

Project

PwsProjectDetail

Yes


Structure that contains the complete information of the project. Please click here for more information. If PwsProjectDetail contains an existing project, this request updates this project; otherwise, this request creates a new project.


StealLockFlag

Boolean

No

false

True to steal lock if it is currently locked (otherwise, service will fail if engagement is locked) 

false

TimeGlccOverrideClearFlag

Boolean

deprecated




WorkspaceMessagesClearFlag

Boolean

No

false

If set to "true", project workspace message will be cleared.

false

ForceAdvancedSetupChangeFlag

Boolean

No

false

???

false

EngagementTimestamp

String

No


This is a Base64 encoded timestamp utilized for engagement locking. To protect against overwriting other changes, you may optionally echo back the timestamp returned by a call to PwsSaveEngagement(or a prior call to PwsSaveEngagement). This will cause the request to fail if any change has been made between invocations of PwsGetEngagement and PwsSaveEngagement.


ManagementTeamClearFlag

Boolean

No

false

If set to "true", clear the non-PM member of the project management team.

false

BdDashboardClearFlag

Boolean

No

false

If set to "true", clear the Belladati (advance analytics) dashboard configuration of this project.

false

ExpenseTypeConfigurationClearFlag

Boolean

No

false

if set to "true", clear the expenes type configuration of this project.

false

...

Code Block
languagexml
titleExample 02 - simple 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:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProject>
         <pws:serviceRequest>
            <req:SessionTicket>Af3sL0FGHhwhM4iKAOvIew==</req:SessionTicket>
            <sch:Mode>R</sch:Mode>
            <sch:Project>
               <com:ProjectCode>P001053-002</com:ProjectCode>
               <com:EngagementIdentity>
                  <com:EngagementCode>P001052</com:EngagementCode>
               </com:EngagementIdentity>
               <com:ProjectName>Created via PwsSaveProject</com:ProjectName>
                <com:LocationIdentity>
                  <com:LocationName>Boston</com:LocationName>
               </com:LocationIdentity>
               <com:ManagerIdentity>
                  <com:UserDisplayName>Larry Krakauer</com:UserDisplayName>
               </com:ManagerIdentity>
            </sch:Project>
         </pws:serviceRequest>
      </pws:PwsSaveProject>
   </soapenv:Body>
</soapenv:Envelope>
Code Block
languagexml
titleExample 03 - complex case of create/update
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:sch="http://projectorpsa.com/DataContracts/Shared/Scheduling/" xmlns:com="http://projectorpsa.com/DataContracts/Shared/Common/">
   <soapenv:Header/>
   <soapenv:Body>
      <pws:PwsSaveProject>
         <pws:serviceRequest>
            <req:SessionTicket>Af3sL0FGHhwhM4iKAOvIew==</req:SessionTicket>
            <sch:CloseDateClearFlag>false</sch:CloseDateClearFlag>
            <sch:DescriptionClearFlag>false</sch:DescriptionClearFlag>
            <sch:FullDetailFlag>true</sch:FullDetailFlag>
            <sch:Mode>A</sch:Mode>
            <sch:PercentLikelihoodClearFlag>false</sch:PercentLikelihoodClearFlag>
            <sch:Project>
               <com:ProjectCode>P001053-001</com:ProjectCode>
               <com:EngagementIdentity>
                  <com:EngagementCode>P001053</com:EngagementCode>
               </com:EngagementIdentity>
               <com:ProjectName>Updated using PwsSaveProject</com:ProjectName>
               <com:CloseDate>2019-07-27z</com:CloseDate>
               <com:DefaultSchedulingMode>D</com:DefaultSchedulingMode>
               <com:Description>Updated scription from web service</com:Description>
               <com:EmEmailFlag>true</com:EmEmailFlag>
               <com:ExpenseApprovalUserIdentity>
                  <com:UserDisplayName>Larry Krakauer</com:UserDisplayName>
                  <com:UserReferenceSystemId>097</com:UserReferenceSystemId>
               </com:ExpenseApprovalUserIdentity>
               <com:ExpenseApproverType>U</com:ExpenseApproverType>
                <com:LocationIdentity>
                  <com:LocationName>London</com:LocationName>
               </com:LocationIdentity>
               <com:ManagerIdentity>
                  <com:UserDisplayName>Larry Krakauer</com:UserDisplayName>
               </com:ManagerIdentity>
               <com:MinutesPerDay>420</com:MinutesPerDay>
               <com:NarrativeRequiredFlag>true</com:NarrativeRequiredFlag>
               <com:NewProjectCode>P001053-WS1</com:NewProjectCode>
               <com:OpenDate>2011-01-01z</com:OpenDate>
               <com:OpenForCostFlag>false</com:OpenForCostFlag>
               <com:OpenForCostTransferFlag>false</com:OpenForCostTransferFlag>
               <com:OpenForTimeFlag>false</com:OpenForTimeFlag>
               <com:OpenForTimeTransferFlag>false</com:OpenForTimeTransferFlag>
               <com:PercentLikelihood>0</com:PercentLikelihood>
               <com:PmModuleEnabledFlag>true</com:PmModuleEnabledFlag>
               <com:ProjectStageIdentity>
                  <com:ProjectStageName>delivery</com:ProjectStageName>
               </com:ProjectStageIdentity>
               <com:ProjectWorkspaceEnabledFlag>true</com:ProjectWorkspaceEnabledFlag>
               <com:Rates>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectRate>
                     <com:BillingAdjustedDiscountPercent>3</com:BillingAdjustedDiscountPercent>
                     <com:ContractDiscountPercent>1</com:ContractDiscountPercent>
                     <com:EndDate>2018-05-31z</com:EndDate>
                     <com:RateCardIdentity>
                        <com:RateCardName>Standard Public Sector Rates (USD)</com:RateCardName>
                        <com:RateCardType>R</com:RateCardType>
                     </com:RateCardIdentity>
                  </com:PwsProjectRate>
                  <com:PwsProjectRate>
                     <com:BeginDate>2018-06-01z</com:BeginDate>
                     <com:BillingAdjustedDiscountPercent>10</com:BillingAdjustedDiscountPercent>
                     <com:ContractDiscountPercent>5</com:ContractDiscountPercent>
                     <com:RateCardIdentity>
                        <com:RateCardName>Standard Financial Services Rates (USD)</com:RateCardName>
                        <com:RateCardType>R</com:RateCardType>
                     </com:RateCardIdentity>
                  </com:PwsProjectRate>
               </com:Rates>
               <com:TimeApprovalUserIdentity>
                  <com:UserDisplayName>Ronni Skerker </com:UserDisplayName>
                  <com:UserReferenceSystemId>030</com:UserReferenceSystemId>
               </com:TimeApprovalUserIdentity>
               <com:TimeApproverType>U</com:TimeApproverType>
                <com:TimeEntryRestrictedToRolesAssignedToTasksFlag>false</com:TimeEntryRestrictedToRolesAssignedToTasksFlag>
               <com:UserDefinedFields>
                  <!--Zero or more repetitions:-->
                  <com:PwsUserDefinedFieldDetail>
                     <com:UdfName>Tentative start date</com:UdfName>
                     <com:DateValue>2018-01-01z</com:DateValue>
                  </com:PwsUserDefinedFieldDetail>
               </com:UserDefinedFields>
               <com:WorkspaceMessages>This project is created to manage the set and costume production for Met Opera's Don Carlo production </com:WorkspaceMessages>
               <com:BookExpenseResourceCostCenterIdentity>
                  <com:CostCenterName>Revcorp CA</com:CostCenterName>
               </com:BookExpenseResourceCostCenterIdentity>
               <com:BookExpenseResourcesAllowCode>C</com:BookExpenseResourcesAllowCode>
               <com:BookTimeResourcesAllowCode>A</com:BookTimeResourcesAllowCode>
               <com:PlccMappings>
                  <!--TR: #1 of 5 repetitions -->
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.15</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>US</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:GlccOverride>CC-ABC</com:GlccOverride>
                     <com:MappingType>TR</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.85</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>CA</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>TR</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                 <!--OR: #2 of 5 repetitions -->
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.25</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>US</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>OR</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.75</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>CA</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>OR</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
             <!--OE: #3 of 5 repetitions -->
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.35</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>US</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>OE</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.65</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>CA</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>OE</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
			<!--RDC: #4 of 5 repetitions -->
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.45</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>US</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>RDC</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.55</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>CA</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>RDC</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
			<!--SRDC: #5 of 5 repetitions -->
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.47</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>US</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>SRDC</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
                  <com:PwsProjectPlccMappingCostCenter>
                     <com:AllocationFraction>0.53</com:AllocationFraction>
                     <com:CostCenterIdentity>
                        <com:CostCenterNumber>CA</com:CostCenterNumber>
                     </com:CostCenterIdentity>
                     <com:CostCenterType>S</com:CostCenterType>
                     <com:MappingType>SRDC</com:MappingType>
                  </com:PwsProjectPlccMappingCostCenter>
               </com:PlccMappings>
               <com:ContractLineItemIdentity>
                  <com:ContractLineItemCode>P001053-CL1</com:ContractLineItemCode>
               </com:ContractLineItemIdentity>
               <com:ManagementTeam>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectManagementTeamMember>
                     <com:EmailFlag>true</com:EmailFlag>
                     <com:UpdateFlag>true</com:UpdateFlag>
                     <com:UserIdentity>
                        <com:UserDisplayName>Bruce Wayne</com:UserDisplayName>
                     </com:UserIdentity>
                  </com:PwsProjectManagementTeamMember>
               </com:ManagementTeam>
               <com:BdDashboards>
                  <!--Zero or more repetitions:-->
                  <com:PwsProjectBdDashboard>
                     <com:BookedResourcesAllowedFlag>true</com:BookedResourcesAllowedFlag>
                     <com:ClientsAllowedFlag>true</com:ClientsAllowedFlag>
                     <com:DashboardAlias>actual hours</com:DashboardAlias>
                     <com:DashboardName>Actual Hours</com:DashboardName>
                     <com:DashboardParameters>{0}</com:DashboardParameters>
                     <com:EmAllowedFlag>true</com:EmAllowedFlag>
                     <com:LtdBookedResourcesAllowedFlag>false</com:LtdBookedResourcesAllowedFlag>
                     <com:LtdOtherResourcesAllowedFlag>false</com:LtdOtherResourcesAllowedFlag>
                     <com:OtherResourcesAllowedFlag>false</com:OtherResourcesAllowedFlag>
                     <com:PmAllowedFlag>true</com:PmAllowedFlag>
                  </com:PwsProjectBdDashboard>
               </com:BdDashboards>
               <!--com:ExpenseTypeConfigurationIdentity-->
                  <!--com:ExpenseTypeConfigurationName>?</com:ExpenseTypeConfigurationName-->
               <!--/com:ExpenseTypeConfigurationIdentity-->
               <com:InheritPurchaseOrderNumberFlag>false</com:InheritPurchaseOrderNumberFlag>
               <com:PurchaseOrderNumber>Met-Don-Carlo</com:PurchaseOrderNumber>
            </sch:Project>
            <sch:StealLockFlag>true</sch:StealLockFlag>
            <sch:WorkspaceMessagesClearFlag>false</sch:WorkspaceMessagesClearFlag>
            <sch:ForceAdvancedSetupChangeFlag>true</sch:ForceAdvancedSetupChangeFlag>
            <sch:ManagementTeamClearFlag>true</sch:ManagementTeamClearFlag>
            <sch:BdDashboardClearFlag>true</sch:BdDashboardClearFlag>
            <sch:ExpenseTypeConfigurationClearFlag>true</sch:ExpenseTypeConfigurationClearFlag>
         </pws:serviceRequest>
      </pws:PwsSaveProject>
   </soapenv:Body>
</soapenv:Envelope>

...