Using Substitution Variables in an Allocation Rule Driver

You can use substitution variables in an allocation rule driver. This is useful when driver data needs to be retrieved from a POV other than the current calculation POV. Using a substitution variable instead of selecting a value in the driver definition, makes it so you do not need to update the driver definition each month.

Note:

You can only use substitution variables in the POV dimensions (Year, Period, Scenario, and Version).

For example, assume you are creating a driver for a Rent and Utilities Ressignment rule. In this example, you are allocating rent and need to know the value for occupancy square feet.

Driver tab with Occupancy Square Feet selected as the driver in the Account dimension

Assume that the occupancy square feet value never changes. As a result, you don't need to import the value every month. In this case, you can create a substitution varible for occupancy square feet and use the substitution variable in the allocation rule driver. To do this, we will add a substitution variable to the Period dimension as follows:

  1. Click Same As Destination next to the Period dimension, and then click Invoke Member Selector icon to open the Member Selector.

    Edit Allocation Rule page with the Period dimension selected to add a member

  2. Click Members at the bottom of the Member Selector, and select Substitution Variables.

    Member Selection with Substitution Variables selected in the Member drop-down

    The substitution variables that have been defined for Period are displayed. In this example, one substitution variable, $CurrMonth, has been defined. Select the substitution variable, and click OK.

    Member Selector with the $CurrMonth substitution variable selected

    After you select the $CurrMonth substitution variable, it is displayed as the value for the Period dimension in the allocation rule Driver tab.

    $CurrMonth displayed as the substitution variable to be used in the Period dimension

Note:

To define substitution variables:

  1. From the Home screen, select Tools and then Variables.

  2. On the Variables page, click Substitution Variables.

    Substitution Variables tab