Details 

Definition

Dialog step in the variable wizard that appears for almost all types of variable. Only those variables with the processing type Replacement Path do not require this dialog step.

Structure

In the Details dialog step, you can set the following options:

The individual options for the settings here vary depending on the variable type and the processing type.  The following section lists all of the settings. The variable wizard automatically displays only those settings that are useful and available.

Variable Represents

This is where you choose the display area that the variable represents.

·        Single Value

The variable represents one value only.

·        Multiple Single Values

The variable represents a number of single values. This setting is useful in hierarchy nodes, for example, to allow you to enter several single nodes.

·        Interval

The variable represents the interval between a specific ‘from’ value and a specific ‘to’ value.

·        Selection Option

The variable represents any combination of single values and intervals. In the variables screen where you select values for variables, you can also work with operators (>,<,=, and so on), search by specific criteria (for example, search for all values that begin with A) and exclude certain values (by specifying which values not to search for).

For more information, see Default Values

·        Precalculated Value Set

The variable represents a set of values that were precalculated with a query by the Reporting Agent. The available values are those values that were precalculated to the characteristic of the variable (for example 0SOLD_TO Sold-to Party) or its basic characteristic (for example 0CUSTOMER Customer). Such a variable can also be ready for input. During runtime you can select various value sets in the variable screen. For more information, see Defining the Value Set Setting.

Please note that variables that represent a precalculated value cannot be used in restricted key figures or in selection structure elements for technical reasons.

Variable Value Is

·        Optional

This setting means that the variable does not have to be filled with a value during runtime.

Variables with the processing type Authorization have the standard setting Variable Value is Optional. Therefore, the variable wizard does not offer you selection options, such as Optional, Obligatory, and Obligatory, Initial Value Not Permitted, for variables that are filled from the authorization.

·        Mandatory

This setting means that at least one value has to be specified for the variable during runtime. The initial value (#) is permitted explicitly. The initial value # means “unassigned”, that is, you can use it to explicitly select all data records in which this characteristic has no characteristic values.

·        Mandatory, Initial Value Not Allowed

This setting means that at least one value has to be specified for the variable during runtime. The initial value (#) is not permitted. This means that you have to enter one or more values in the variable screen to be able to execute the query.

Ready for Input

Here you determine whether or not the variable is set to “ready for input” when you execute the query or the Web application.

If, when you execute the query or the Web application, the Ready for Input option is active (this is the default setting), a dialog box appears (the variables screen).  You either specify the value or values that you want to use, confirm the default values, or change the default values.

You can deactivate the Ready for Input option if you want to fill the variable with a value beforehand. When you execute the query or the Web application, it is filled automatically with a value.

If you set the variable as not ready for input, but have set the variable value as mandatory and have not specified a default value, the system cannot execute the query and an error message is displayed.

The Ready for Input option is available for the following processing types; manual entry / default value, customer exit, SAP exit, and authorizations.

Can Be Changed with Query Navigation

If you choose the Can Be Changed with Query Navigation option, after you have run the query, not only are you able to select the values that you specified in the variables screen, but you are also able to use other values as dynamic filters for the query (see also: Selecting Filter Values).

Note that this function is not possible if you are using the variable as part of a structure in the query definition. The system ignores the setting Can Be Changed with Query Navigation in this case.

You can use this function for variables of characteristic values and hierarchy nodes.

For more information on this topic see Special Features of Variables that can be Changed Dynamically.

Copy Personalization Data from Variable

Each user can personalize the variable values for variables that are ready for input. The personalized values are saved for each variable and each user.

If you want to use the same personalization data in more than one variable, in the input field, specify the names of the variables under which the personalization data is stored.

Note that you have to specify the variable without an ampersand &.

You have defined a “Customer 1” variable that is mandatory and ready for input. You now want to define a “Customer 2” variable that is mandatory (blank value not allowed), ready for input and that can be changed in query navigation. By making the Copy Personalization Data from Variable “Customer 1” setting in the “Customer 2” variable, you give both variables the same personalized value.

Length of Input Field

In the dialog step Details for text variables, there is a setting for Length of Input Field.

Specify a number here. This determines the number of characters of text that the user can specify to represent the variable.