Description: Calculate the project score of a project specified by the ProjectObjectId based on a selected set of ProjectCodeTypeObjectId's. The Project Score feature helps you evaluate projects by using project codes to identify and quantify characteristics that can be used to determine project rankings. P6 EPPM Web Services uses the weighted project code and code values assigned to a project to calculate its score. To use project scoring features, you create weighted project codes that represent project criteria you want to evaluate, for example, projected sales and risk. You further express the possible attributes associated with these evaluation criteria as weighted project code values, for example, projected sales might be described as either high, medium, or low potential. Finally, you assign the appropriate weighted codes and code values to the projects you want to score. Typically, project code and code value weights are set up by a project controls or system administrator.
Service: Project Service
Style: Document/literal wrapped
Input:
Message: CalculateProjectScore
Elements:
Field | Type | Description |
|---|---|---|
ProjectObjectId | int | The unique identifier of the project to be evaluated. |
ProjectCodeTypeObjectId | int | The unique identifier of the ProjectCodeType. You can specify one to many ProjectCodeTypeObjectIds. |
Output:
Message: CalculateProjectScoreResponse
Elements:
Field | Type | Description |
|---|---|---|
Score | int | The calculated project score. |
Example: Suppose you want to evaluate a portfolio of projects based on two criteria: projected sales in a target market and potential income. You create two codes, one called "Projected Sales" and one called "Potential Income". The relative importance of each criteria in your decision making process can be represented by the Project Code Weight. If Projected Sales is more important to you, you might assign that code a weight of 15 and Potential Income a weight of 5. In turn, each of these criteria (project codes) can be assigned various values which can also be assigned weights. Projected Sales might have values of low (with a weight of 1), medium (with a weight of 3) and high (with a weight of 5). Similarly Potential Income might have four values: low (weight 2), medium (weight 4), high (weight 6), very high (weight 10). The table below summarizes the Codes with their weights and values.
Code | Value | Weight |
|---|---|---|
Projected Sales |
| 15 |
| Low | 1 |
| Medium | 3 |
| High | 5 |
Potential Income |
| 5 |
| Low | 2 |
| Medium | 4 |
| High | 6 |
| Very High | 10 |
The project score is calculated in three steps. To illustrate the process, suppose Project A has a Projected Sales value of Medium and a Potential Income value of High.
- Determine the maximum possible project score by summing the weight of each code multiplied by the maximum code value weight.
In the example:
- The Projected Sales code has a weight of 15 and the highest possible Code Value is High with a weight of 5.
- The Potential Income code has a weight of 5 and the highest possible Code Value is Very High with a weight of 10.
So the Maximum Project score for Project A is:
Sum(Project Code Weight * maximum Project Code Value Weight)
(Projected Sales weight * High value weight) + (Potential Income code weight * Very High value weight)
(15 * 5) + (5 * 10) = (75) + (50) = 125
- Calculate the score for the project based on the Code Values assigned
In the example:
- The Projected Sales code has a weight of 15 and the project is assigned a Code Value of Medium with a weight of 3.
- The Potential Income code has a weight of 5 and the project is assigned a Code Value of High with a weight of 6.
So the Project Score for Project A is:
Sum(Project Code Weight * assigned Project Code Value Weight)
(Projected Sales Weight * Medium value weight) + (Potential Income code weight * High value weight)
(15 * 3) + (5 * 6) = (45) + (30) = 75
- Calculate the percentage of the total possible score that is represented by the project's score:
In the example:
( Project score / maximum possible project score ) * 100
(75 / 125) * 100 = 60