Rate matrix Configuration


Article ID: 4679


Updated On:


Clarity PPM On Premise


This KB provides guidance on how to configure the rate matrix which can help avoid issues including the below:

  • Incorrect rates where entered and realized.
  • Incorrect Team > Allocation Cost is being calculated
  • Update Cost Totals values are wrong.


Release: All Supported Releases
Component: Clarity PPM Financial Management


  1. Have the business unit determine how the rate matrix should be configured. The typical rate matrix will use the only one or two of the following fields to determine the rate.
    • Resource Role or
    • Resource

      2.  Up to 10 columns can be used, but it is best practice to keep it to a minimum. This is because as the higher the number of columns are configured, the higher chance that the Rate Matrix Extraction job will experience performance issues as more projects, resources, and tasks are added over time. Available columns below (From Date and To Date are default values for all rate matrixes) 

    • From Date*
    • To Date*
    • Location
    • Department
    • Resource
    • Resource Class
    • Transaction Class
    • WIP Class
    • Resource Role
    • Charge Code
    • Client Class
    • Department
    • Entity
    • Input Type Code
    • Investment
    • Investment Class

     3. The rate is determined by the date range, then proceeds to funnel left to right finding a match in each column. Once the match is found, that rate is assigned in the NBI_PROJ_RES_RATES_AND_COSTS table. That is why it is important to test rates and costs via the project > Financial Plans page to see if the correct rate is being retrieved before running the full Rate Matrix Extraction (with parameters Extract for Schedulers, Update, Prepare)

    4. The rate matrix provides real-time rates to cost plans and the Post Transactions to Financials job, and Create WIP Adjustment.

  • In the rate matrix, the rows entered indicate rates retrieved based on the date range. The order of columns matter as it logically attempts to find a matching rate going from left to right. Once the match is found, that rate is assigned in either:
    • to calculate the actual cost when the Post Transactions to Financials job is processing a financial transaction or
    • get inserted into the NBI_PROJ_RES_RATES_AND_COSTS via the Rate Matrix Extraction job where this snapshot rate table will then be made available to the Post Timesheets job and various Project Earned Value calculations and baselines.

Additional Information

PPM Tech Tip: CA PPM Tech Tip: How should the main PPM jobs be scheduled?

See KB: MSP Rates missing: too many rates in NBI table that seem redundant with same rate different dates
See KB: Rate Matrix Extraction Job Performance - Rate Matrix Job Performance