Start of Content Area

Object documentation Details  Locate the document in its SAP Library structure

Definition

Tab page from the variable editor, which is required for almost all variable types. All variables apart from ones with processing type Replacement Path require this tab page. If the tab page is not required, the fields on the Details tab page are not input-ready.

Structure

On the Details tab page, you can make the following settings:

Note

The individual options for the settings vary, depending on the variable type and processing type. The following section lists all of the possible settings. The Variables Editor automatically displays only those settings that are appropriate and available.

Variable Represents

You choose the display area that the variable will represent.

      Single Value

The variable represents exactly one value.

      Multiple Single Values

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

      Intervals

The variable represents a specific ‘from’ value and a specific ‘to’ value, i.e. an interval.

      Selection Option

The variable represents any combination of single values and intervals. When selecting values for variables, you can also use operators (>,<,=, and so on), use the contains pattern option (for example, search for all values that begin with A: A*), and exclude certain values (by specifying the values that you do not want to search) for.

Caution

Note that you can only use the selection option variables with the Contains Pattern option in the filter (left area in the Filter screen area). You cannot use them in the default values (right area in the Filter screen area).

The Contains Pattern option is also only supported for characteristics of type CHAR. The option is not supported for numeric characteristics.

More information: Default Values.

      Precalculated Value Set

The variable represents a set of values that were precalculated with a query by the BEx Broadcaster. The available values are those values that were precalculated for the characteristic of the variable (such as 0SOLD_TO Sold-To Party) or its basic characteristic (such as example 0CUSTOMER Customer). A variable like this can also be input-ready. You can select various value sets in the Variables screen at runtime. More information: Precalculating Value Sets

Note

Note that for technical reasons, you cannot use variables that represent a precalculated value set in restricted key figures or in selection structure elements.

Variable Value Is

      Optional

If you select this setting, the variable does not have to be filled with a value at runtime.

Background documentation

Variables with the processing type Authorization have the default setting Variable Value Is Optional. The Variables Editor therefore does not provide selection options, such as Optional, Mandatory, and Mandatory, Initial Value Not Allowed for variables filled from the authorization.

      Mandatory

If you select this setting, at least one value has to be specified for the variable at runtime. The initial value (#) is permitted explicitly. The initial value # means “unassigned”, meaning that you can use it to explicitly select all data records where this characteristic does not have any instances.

      Mandatory, Initial Value not Allowed

If you select this setting, at least one value has to be specified for the variable at runtime. The initial value (#) is not permitted. You must enter one or more concrete values in the variable screen to be able to execute the query.

Variable Is Ready for Input

Using this option, you specify whether the variable is to be input-ready when the query or Web application is executed.

If the Variable Is Ready for Input option is selected (= default setting), a dialog box appears (the variable screen) when you execute the query or Web application. You can either specify the value(s) that you want to use, confirm the default value(s), or change the default values.

Note

Users can also use input help to select the variables in the variable screen. Business Add-In (BAdI) RSR_VARIABLE_F4_RESTRICT_BADI can be used to set various criteria for input help for input-ready variables in the variable screen. For more information, see F1 help for this BAdI (transaction SE18, enhancement spot RSR_VARIABLE_F4_RESTRICT).

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

Caution

If you set the variable as not input-ready, but have set the variable value as mandatory and have not specified a default value, the system cannot execute the query. It will then display an error message when you try to execute the query.

The input-readiness option is available for the processing types Manual Input/Default Value, Customer Exit, SAP Exit, and Authorization.

Variable Is Without Context

If you select the Variable Is Without Context option, you are specifying that the variable can be filled with values independently of an executed query. Examples: Current Day, Current Year

Note

You can only set this flag for exit variables. This flag is generally not set for all other variable types. The field is therefore deactivated, meaning that all other variables are treated as context-specific.

Copy Personalization Data from This Variable

Users can personalize variable values for input-ready variables. The personalized values are saved for each variable and user.

If you want to use the same personalization data in more than one variable, enter the names of the variables that the personalization data is stored under in this input field. Enter the names manually, or select them from input help (This graphic is explained in the accompanying text icon).

Caution

You have to enter the variable without an ampersand (&).

Example

You have defined a variable “Customer1”, which is Mandatory and Ready for Input. You now define a “Customer2” variable, which is Mandatory (Initial Value not Allowed) and Ready for Input. By selecting the Copy Personalization Data from This VariableCustomer1” option for the “Customer2” variable, both variables have the same personalized values.

Length of Input Field

For text variables, the Length of Input Field option also appears on the Details tab page.

Specify a number here. This specifies the number of characters of text the user can enter for the variable.

 

End of Content Area