Overview
"When you reset the begin and end dates of a project using this web service, the start and end dates of the roles, as well as the allocation dates, are also adjusted accordingly. For instance, if you delay the project end date by 5 days, the following changes will occur:
...
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
Int32 | No | Click here for more information. | 1 | ||
String | Yes | Click here for more information. | AWXKNmZlvR5xkqVh6PAXqQ== | ||
LocksToSteal | No | This structure represents the locked state of a Projector entity such as an engagement or a project | |||
NewProjectCloseDate | DateTime | No | The new end date for the project, if any. | 2023-12-31z | |
NewProjectCloseDateClearFlag | Boolean | No | If set to 'true', the project end date, if currently set, will be cleared. | true | |
NewProjectOpenDate | DateTime | Yes | The new begin date for the project. | 2023-01-01z | |
ProjectIdentity | Yes | This structure represents the unique key fields associated with identifying a projectidentifies the project to be advanced or delayed. | |||
ProjectTimestamp | String | No | *** This field has been deprecated *** | ||
ProjectorLockSetId | Int32 | A projector lock set id is an identifier for a group of one or more locks held as a unit. | |||
AllowProjectDatesToStretchFlag | Boolean | No | false | When either the new begin or end date will date would be in conflict with role start and end dates or allocation dates after the operation is completed, the new date project dates will be adjusted to resolve the conflict if this boolean value is set to 'true'. Otherwise, error 55037 will be thrown. For instance, suppose a role’s end date after the operation is completed is Dec. 12, 2022, and the project end date is currently set to Nov. 30, 2022. If the boolean value is set to ‘true’, Projector will change the project end date to Dec. 12, 2022, to resolve the conflict. However, if the boolean value is set to ‘false’, error 55037 will be thrown. |
Request Usage Example(s)
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
<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> |
...
Element | Data Type | Description |
|---|---|---|
Messages | The web service response status and message. Click here for more information. | |
ResponseId | Int32 | Click here for more information. |
Status | Click here for more information. | |
DateTime | Click here for more information. | |
NewProjectCloseDate | DateTime | The new end date of the project |
NewProjectOpenDate | DateTime | The new begind begin date of the project |
ProjectTimestamp | String | This is an optimistic locking timestamp that, if provided on update request, will cause the request to fail when the timestamp stored in the database does not match the provided value. |
...