Show TOC

DetailsLocate this document in the navigation 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 (also known as buckets) )that are stored either in a database table or in an index on the SAP TREX search engine.  The available values are ones that have been precalculated for the characteristic of the variable (0SOLD_TO Sold-To Party for example) or its basic characteristic (0CUSTOMER Customer for example). A variable like this can also be input-ready. At runtime, you can then add, change or remove values from the value set in the variable screen. More information:Using Precalculated Value Sets (Buckets).

    Note

    Note that for technical reasons you can only use variables that represent a precalculated value set in the filter for a query.

Variable Value Is

  • Optional

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

    Note

    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.

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 ( icon).

Caution

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

Tip

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 Variable "Customer1" 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.