Start of Content Area

Procedure documentation Working with the Variables Screen  Locate the document in its SAP Library structure

Use

Using the variable screen, you can fill variables (parameters of a query) with values when the Web application is displayed in the Web browser; you therefore do not have to fill them beforehand. You can assign values to the following variable types on the Variables screen:

      Variable types for characteristic values

A characteristic value variable is the placeholder for a single value, an interval, or a set of selection options.

      Variables for hierarchy nodes

You can only enter hierarchy nodes as single values.

For more information, see Variables.

You can personalize the values for individual components or for the entire Web application. This means that you assign a specific value to a variable; the variable has this value until you remove the personalization. More information: Personalizing Variables in Web Applications.

Once you have filled the variables as required, you can create a variant for a query. More information: Creating Query Variants.

You can use the Set Variable Values command (SET_VARIABLES_STATE) to set variable values or a variant at the runtime for a Web application or using a URL. For more information, see Set Variable Values or Using Parameters to Call Web Applications.

Prerequisites

At least one of the queries on which the Web application is based must contain variables.

Procedure

Entering Values for Variables

You can specify the required values for the variables either manually or by using the input help. The input options for the variables depend on the variable type:

Entering Characteristic Value Variables
Manually

      To enter a single value, enter the value directly in the input field beside the characteristic ID. To enter multiple single values, enter the values separated by semicolons in the input field.

      To enter an interval, in the input field beside the characteristic ID, enter the upper and lower limits for the interval, separated by a delimiter.

      When you enter a selection option, you can assign values to a variable in the following ways:

       Define a single value

       Define a value range

       Exclude single values and value ranges

Note

        Mandatory variables are marked with (*).

        When you manually enter values, ensure that you use valid syntax.

Using Input Help

As an alternative to manually entering values directly, you can also select values from the input help. To do this, choose This graphic is explained in the accompanying text in the input field for the characteristic. More information: Selecting Filter Values.

You can also use the input help to search for values. For more information about searching for values, see Searching for Values.

Background documentation

Your system administrator can restrict the input help according to different criteria by using the Business Add-In (BAdI) RSR_VARIABLE_F4_RESTRICT_BADI (transaction code SE18, enhancement spot RSR_VARIABLE_F4_RESTRICT). Depending on the chosen settings, the BAdl provides you with a restricted number of values.

Entering Variables for Hierarchy Nodes:

      To assign values to the variables for hierarchy nodes, you can enter the values directly or select them from the input help. In the Input Help dialog box, select a hierarchy node. Note that a specific syntax is required when directly entering values for hierarchy nodes.

Background documentation

If Key, Text and Key, or Key and Text is set as the display type in InfoObject maintenance on the Business Explorer tab page, hierarchy nodes are provided in the input help function by text and key. Otherwise, only hierarchy node texts are displayed.

Display Variable Values

      To check that values that were entered manually exist, choose Check on the Variables screen.

      To display the Web application with the entered variable values, choose OK on the Variables screen.

      By choosing Show Personalization of Variables and Hide Personalization of Variables, you can switch between displaying all variables (general variables and personalized variables) and displaying non-personalized general variables.

 

End of Content Area