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 | ||
|---|---|---|
| ||
|
...
Element | Data Type | Required? | Default | Description | Sample Data |
|---|---|---|---|---|---|
Int32 | No | Click here for more information. | 1 | ||
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 | Yes | Structure that contains the complete information of the project. Please click here for more information. | |||
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 PwsGetProject (or a prior call to PwsSaveProject). This will cause the request to fail if any change has been made between invocations of PwsGetProject and PwsSaveProject. | ||
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 |
...
ErrorNumber | ErrorCode | ErrorText |
|---|---|---|
| 13020 | ProjectRateGapOrOverlap | A gap or overlap was detected in the specified project rate date ranges. Project rates must cover all of time with no overlaps. |
| 13023 | RateCardNotSpecifiedForProjectRate | At least one specified project rate is missing a rate card. |
| 13037 | WorkspaceMessagesMayNotBeSpecifiedWhenClearFlagSet | The workspace messages may not be specified when the associated clear flag is set. |
| 54039 | BookedResourceOnlyFlagConflict | Use of obsolete booked resources only flags in conflict with booked resources allowed code. |
| 54059 | EngagementNotSpecified | A specified engagement identity was incomplete. Each engagement identity must specify either an engagement id, and engagement uid or an engagement code. |
| 54061 | EngagementNotFound | The specified engagement does not exist. |
| 54076 | EngagementIsLocked | The engagement is locked by PPSA Support User and may not be updated. |
| 54666 | LocationNotEnabledForProjects | The specified location is not enabled for projects. |
| 54670 | ProjectNameRequired | Project name is required for new projects. |
| 54724 | ProjectsCannotChangeEngagements | Projects may not be moved from one engagement to another. |
| 57540 | LocationNotSpecified | Location is required. |
| 57541 | LocationNotFound | Specified location does not exist. |
57543 | ProjectStageNotFound | The specified project stage does not exist. |
| 57550 | UserNotSpecified | User is required. (Luke, can we be more specific about error text in this case with a missing manager identity for PM?) |
| 57551 | UserNotFound | Specified user does not exist. |
...