Replacement Path: Replacement from Variable

Use

Characteristic value variables, hierarchy variables, text variables and formula variables with processing type Replacement Path can be replaced by the value from a different variable. The value is determined either from the key, the external attribute of the key, the description, or the attribute value. You can also define an offset start and offset length.

Replacement time: The variable is replaced on the Variables screen with each data release.

Prerequisites

The following prerequisites apply:

Target Variable (= the variable to be replaced)

  • The target variable must not be input-ready
  • The target variable must represent a single value

Source Variable (= the variable that is to replace the target variable)

  • The source variable must be a characteristic variable, a hierarchy variable, a text variable, or a formula variable. (The source variable must not be a hierarchy node variable).
  • The source variable must be input-ready
  • The source variable must exist in the query
  • The source variable must represent a single value or range

Features

Replacement Rule

You define the source variable here.

Replace Variable With

Select Variable.

Variable

Choose the source variable using the input help dialog . For more information on the using the input help dialog, see Restricting Characteristics.

Variable Represents

Choose where the value of the variable will be determined from.

  • Key

    The variable value is replaced with the characteristic key.

  • External Attribute of the Key

    The variable value is replaced with an external value of the characteristic (external/internal conversion).

  • Name

    The variable value is replaced with the name of the characteristic.

  • Attribute Value

    The variable value is replaced with the value of an attribute. If you choose the Attribute Value, the Attribute dropdown box appears. Select the attribute you want. The system displays all attributes for the characteristic that the source variable is defined on.

Offset Setting

Using the Offset Start and Offset Length, you can establish the start and length of the text output. For more information about the offset setting, see Replacement Path: Replacement from Characteristic Value.

Using Ranges

You have the following selection options:

  • From value
  • To value
  • Difference

If the source variable is a range, you can use this setting to specify whether the lower range limit (from value) or the upper range limit (to value) is used as the replacement value.

For formula variables, you can also choose the interval difference as the replacement value. Using this setting, you can easily calculate the difference of period boundaries. The range difference is the to value minus the from value, plus 1. For example, the period January to March gives a result of 3 (the to value 3, minus the from value 1, plus 1).

Examples

Text Variable

You are using a text variable with automatic replacement in a formula. The formula operands have different selections for the characteristic concerned. In this case, the automatic replacement would not be able to replace the text variable. If you use replacement from variable, the value of the source variable is used for the text variable.

Hierarchy Variable

The data in an InfoProvider is version-dependent. A corresponding hierarchy version (for use with a single hierarchy) exists for every version. With replacement from variable, the variable for the hierarchy version can be filled from the variables for the version.

If the versions do not correspond directly to one another, you can create a Hierarchy Version attribute where the corresponding versions are stored.