Model Variable rules
A variable rule changes the value that is assigned to a model property. Variable rules must belong to a procedural rule set. Variable rules have General implementation, which means that variable rules are run in-memory.
When a user runs a variable rule, Planning Business Modeler sets the value of the variable to the value specified in the rule.
A variable rule can only be applied to a previously defined model property. For example, to use a variable rule to assign a value to a model property called MyVariableName, the model must include a full-specified model property of the same name.
The following example shows the general form of a variable rule.
&MyVariableName& = Expression
Where MyVariableName is a previously defined model property, and Expression is a valid PerformancePoint Expression Language (PEL) expression that evaluates to the same type as MyVariableName.
Example: Set a property to a literal number
The following example shows how to set the value of the model property BudgetGrowth to 0.10, a literal number that represents a ten percent growth rate. In this example, assume that the model contains a model property called BudgetGrowth of type Decimal.
&BudgetGrowth& = 0.10;
Example: Prompt the user for a value
The next example shows how, by using a parameter, to prompt the user for a value that a Variable rule will use to set the value of a model property. In this example, assume that the model contains a model property called NewScenario of type Member. The parameter, which is also of type Member, is called CurrentScenario.
The following example shows how to set the value of the model property NewScenario to a value that is provided by the user for the CurrentScenario parameter.
&NewScenario& = $CurrentScenario$;
When this rule is run, Planning Business Modeler displays a prompt that asks the user to enter a value for CurrentScenario parameter. Then, Planning Business Modeler assigns the value that the user entered to the NewScenario model property.
Note
Planning Business Modeler supports assigning a value to a model property by using a parameter only when the parameter and variable are both of type Member or type MemberSet.