Overview

PwsAdvanceDelayProject can be used to shift a specified project in time. Advancing the project (by specifying a NewProjectOpenDate prior to the existing begin date) causes all dates to be shifted earlier (project is starting ahead of schedule); delaying the project (by specifying a NewProjectOpenDate after the existing begin date) causes all dates to be shifted later (project is starting behind schedule).

Some dates are shifted on a daily granularity, others on a weekly granularity, and yet others are shifted at varying granularities.

• For daily granularity, dates are simply shifted by the number of days difference between the original and new project begin dates.
• For weekly granularity, the number of weeks shifted is determined by calculating the number of weeks difference between the start of the week containing the original begin date and the start of the week containing the new begin date.
• For half-month, month, quarter and year granularities (time and cost budgets, cost plans), the number of time units shifted is calculated in a similar manner (for example, the number of quarters between the quarter containing the original begin date and the quarter containing the new begin date).

When a project is advanced or delayed:

• The project begin date is shifted to the newly specified begin date
• The project end date is shifted as follows:
  • If NewProjectCloseDateClearFlag is set to true, it is cleared.
  • If NewProjectCloseDate is not specified, and the existing end date is not set, it is left as is.
  • If NewProjectCloseDate is not specified, and the existing end date is set, the existing end date is shifted at a weekly granularity relative to the project begin date (for example, if the new project begin date is shifted 2 weeks after the original begin date, the original end date is shifted by the same two weeks.
  • If any of the above results in a project end date prior to any role end date or scheduling activity on the project, the end date is automatically stretched so as to not have role end dates or activity outside the project dates.
• Project rate begin and end dates are shifted on a weekly granularity.
• Project role start and end dates are shifted on a weekly granularity.
• Project role rate exceptions and RDC exceptions are shifted on a weekly granularity.
• Allocations are shifted on a weekly granularity.
• Time and cost budgets are shifted on a granularity depending upon the time phasing of the individual baselines (non-time phases budgets are not shifted at all).
• Cost plans are shifted on a granularity depending upon the time phasing of the individual baselines (non-time phases budgets are not shifted at all).
• Task plan earliest start dates and task baseline role start and end dates are shifted on a daily granularity.

Request Format

Request Elements

Request Usage Example(s)

<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:PwsAdvanceDelayProject>
         <!--Optional:-->
         <pws:serviceRequest>
            <req:SessionTicket>AWXKNmZlvR5xkqVh6PAXqQ==</req:SessionTicket>
            <sch:NewProjectCloseDate>2023-12-31z</sch:NewProjectCloseDate>
            <!--Optional:-->
            <!--sch:NewProjectCloseDateClearFlag>?</sch:NewProjectCloseDateClearFlag-->
            <sch:NewProjectOpenDate>2022-01-01z</sch:NewProjectOpenDate>
            <sch:ProjectIdentity>
               <!--Optional:-->
               <com:ProjectCode>LUCIA-001</com:ProjectCode>
            </sch:ProjectIdentity>
            <sch:AllowProjectDatesToStretchFlag>true</sch:AllowProjectDatesToStretchFlag>
         </pws:serviceRequest>
      </pws:PwsAdvanceDelayProject>
   </soapenv:Body>
</soapenv:Envelope>

Response Format

Response Elements

Response Usage Example(s)

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
      <PwsAdvanceDelayProjectResponse xmlns="http://projectorpsa.com/PwsProjectorServices/">
         <PwsAdvanceDelayProjectResult xmlns:a="http://projectorpsa.com/DataContracts/Shared/Scheduling/" 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/">2023-10-11T19:29:06.3237023Z</ServerTimestampUtc>
            <a:NewProjectCloseDate>2022-10-29T00:00:00</a:NewProjectCloseDate>
            <a:NewProjectOpenDate>2022-01-01T00:00:00</a:NewProjectOpenDate>
            <a:ProjectTimestamp>AAAAADHlsuY=</a:ProjectTimestamp>
         </PwsAdvanceDelayProjectResult>
      </PwsAdvanceDelayProjectResponse>
   </s:Body>
</s:Envelope>

PwsAdvanceDelayProject - Common Errors and Warnings

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