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.

Format

PwsSaveProjectRq

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

Elements

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

Example(s)

Example 01 - simple update

<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>true</sch:CloseDateClearFlag>
            <sch:CostGlccOverrideClearFlag>false</sch:CostGlccOverrideClearFlag>
            <sch:DescriptionClearFlag>false</sch:DescriptionClearFlag>
            <sch:FullDetailFlag>false</sch:FullDetailFlag>
            <sch:Mode>R</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:NewProjectCode>P001053-WS1</com:NewProjectCode>
               <com:ContractLineItemIdentity>
                  <com:ContractLineItemCode>P001053-CL1</com:ContractLineItemCode>
               </com:ContractLineItemIdentity>
            </sch:Project>
            <sch:StealLockFlag>true</sch:StealLockFlag>
         </pws:serviceRequest>
      </pws:PwsSaveProject>
   </soapenv:Body>
</soapenv:Envelope>

Example 02 - simple 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: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>

Example 03 - complex case of create/update

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