Previous Topic

Next Topic

Book Contents

CalculateProjectScore Operation

Description: Calculate the project score of this project 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 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.

Service: Project Service

Style: Document/literal wrapped

Input:

Message: CalculateProjectScore

Elements:

Field

Type

Description

ProjectObjectId

int

The unique identifier of the project.

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: Typically, project code and code value weights are set up by a project controls or system administrator. For example, suppose you want to evaluate a portfolio of projects based on three criteria: projected sales in a target market, risk, and strength of competition. You would create three project codes to represent these evaluation criteria. Each of these criteria has a certain level of importance in your decision making, which you can represent using a numerical scale, or weight, as a way of ranking them. For example, on a 1 to 10 scale, if projected sales is more important than perceived risk, you might weight it at 10 and weight risk at 7. In turn, each of these criteria (project codes) can be represented by varying attributes and rankings. Projected sales might have three possible attributes, such as low, moderate, and high potential. You would create three project code values to represent these attributes and assign each code value a weight that represents its rank in evaluating a project. The table below shows an example of how project codes, code values, and weights can be mapped to project evaluation criteria.

Project Code

A project code is used to represent project evaluation criteria

Project Code weight

The weight of the project code reflects the importance of the criteria to decision making

Project Code Value

A project code value is used to represent an attribute of the corresponding project code

Project code Value weight

The weight of the project code value reflects the ranking of the attribute with respect to the evaluation criteria (project code)

Example:

Projected Sales

10

Low potential

1

Moderate potential

3

High potential

5

If the Projected Sales project code is assigned to Project A with a project code value of High Potential, the non-normalized score for Project A = 50. If the Projected Sales project code is assigned to Project A with a project code value of Low Potential, the non-normalized score for Project A = 10. Project score is calculated in three steps:

  1. Determine the maximum possible project score.

    Calculated as: Sum(Project Code weight * maximum Project Code Value weight)

    For example, Project A has 3 project codes assigned, each code has a weight of 2. The maximum project code value weight for these project codes is 3, 5, and 6, respectively.

    Maximum project score = 28 (2*3) + (2 *5) + (2*6)

  2. Calculate the score for the project.

    Sum(Project Code weight * weight of the assigned Project Code value)

    The Project Code value weights assigned to Project A are 3, 5, and 3.

    Score for Project A = 22 (2*3) + (2*5) + (2*3)

  3. Normalize the project score, based on the maximum possible project score. Calculated as: (Project score before normalizing/maximum possible project score) * 100

    Normalized Project A score = 79 (22/28) * 100


Copyright information