Determination of Default Parameters

Use

This function enables you to enter the default parameter values for parameter symbols for reports. If a report is displayed or is printed out from the preview, you do not need to enter the values manually. The parameter symbols are divided in Customizing into report symbol groups that group the symbols according to application areas. For the report symbol groups, standard function modules are delivered that are used to determine the default parameter values and that you can change as required.

You can edit data that was selected by default parameter value determination in report management and in the report information system before generating reports. The edited data is stored temporarily and is then available in the current transaction.

The key values from the corresponding SAP objects must be known for default parameter value determination. The availability of the key values depends on at what point in time or from which SAP component default parameter value determination is called. The default parameter values must be completed at the latest for report shipping .

Example Example

In the following example, default parameter values are determined step by step:

  • A report is first opened in the report information system for display. At the same time, default parameter value determination is carried out. The user has the option of editing the default parameter values in the dialog. The changed default parameter values (such as sales organization data) are retained for the duration of the current transaction.

  • Then the user starts report shipping from the report information system. Default parameter value determination is called again. The system adds the default parameter value for the report recipient for whose selection the key value was not yet known when the report was displayed in the report information system .

End of the example.

Prerequisites

To set up default parameter value determination for a new symbol group, you proceed as follows:

  • Create a report symbol group

    In the IMG activity Specify Report Symbol Groups you create a new report symbol group.

  • Create report symbols for the report symbol group

    The report symbols that are to belong to the new report symbol group can relate to table fields or class characteristics.

    1. Define table fields and class characteristics

      Define table fields: In the IMG activity Specify Tables for Report Symbol Generation enter the required tables. If necessary you can also specify which fields symbol generation should be restricted to.

      Define class characteristics: For more information on creating class characteristics, see Creating Characteristic Fields in EH&S.

    2. Generating Symbols

      The master data matchup function offers an automatic symbol generation function for report symbols of the report symbol group 02 (see also the IMG activity Create Report Symbols ). The parameter symbols in other report symbol groups are delivered with their symbol definition. If you create your own symbol groups you must create the symbols for them manually.

    3. Check and Specify Report Symbols

      In the IMG activity Check and Specify Report Symbols , you check the report symbols and their assignment to the report symbol group.

  • Define parameter hierarchies

    If you want to output structural interdependencies between parameter objects on the report, proceed as follows:

    1. In the Customizing activity Specify Parameter Objects define the required parameter objects.

    2. In the Customizing activity Specify Parameter Hierarchies define the required parameter hierarchy for the parameter objects, and assign the required report symbol group to the parameter hierarchy. By means of this assignment you specify which determination function module is used to select the data for the parameter hierarchy.

  • Create a determination function module and enter it for the report symbol group

    Program the function module that is to determine the default parameter values for the report symbol group, and enter the key of your determination function module in the Customizing activity Specify Report Symbol Groups for the report symbol group (see Default Parameter Value Table for the Structure CVDDP and Interface for Determining Default Parameter Values ).

    If the report symbol group contains symbols for a particular report application, assign the key for the report application to the report symbol group .

Result

The determined default parameter values can be edited on the dialog screen in report management, in the report information system, and in the screen for the Report from Template function (see Editing Default Parameter Values ).

Features

Main Program for Determining Default Parameter Values

  • The parameter symbols and repeating groups are determined from the structure file (table ESTLS). The symbol definitions are added to the parameter symbols and the hierarchy definitions are added to the repeating groups, and the respective report symbol groups are determined in each case.

  • The system checks for which report symbol groups the default parameter values were already determined and for which report symbol groups the default parameter values must be newly determined or determined again (see also Indicators for Default Parameter Values ).

  • The system calls the relevant determination function modules for the report symbol groups and selects the default parameter values using the key values and the values from the relevant SAP applications (see Process Diagrams for Report Creation ).

  • The system flags the default parameter values that are actually required for report generation and transfers them to the return table.

Assignment of the Determination Function Modules to Report Symbol Groups

The report symbol groups group symbols according to their area of application. The default parameter values are determined differently depending on the report symbol group:

  • Directly in an SAP component

  • Using default parameter value determination

    For default parameter value determination, a standard function module is assigned to the relevant report symbol groups.

Identification of the Key Values

The key values that the function module requires for determining the default parameter values are predefined by the OBJECT and ATTRIB fields of a table in the structure CVDDP. The default parameter values determined are also transferred to report generation in the table in the structure CVDDP.

Example Example

In the case of the report symbol group for determining the material name, the key value is the material number. This is specified by the object ID CVDMAT and the attribute ID MATNR. The material name is selected from the material master using the value of the material number. The selected default parameter value is stored in a table in the structure CVDDP as follows:

End of the example.

Field

Value

OBJECT

CVDMAT

ATTRIB

MATNAM

ORD

1

VALUETYPE

1

VALUE

Gold paint
Assignment of the Default Parameter Values to the Report Symbol

By comparing the combination of OBJECT/ATTRIB values with the symbol definition in Customizing, the default parameter value is assigned to the correct report symbol during report generation. As a report symbol of the type Parameter is specified either by a table field or by a class characteristic, the OBJECT/ATTRIB information corresponds to the table/field information or the class/characteristic information from the symbol definition.

Example Example

In the above example, the system finds the table/field information CVDMAT/MATNAM for the report symbol EHS_MATNAM (see the Customizing activity Check and Specify Report Symbols). The selected value is therefore output for the report symbol EHS_MATNAM during report generation.

End of the example.
Indicators of the Structure CVDDP (Parameter Values for Report Shipping)

You can use indicators to define whether a default parameter value, for example,

  • Can be changed

  • Must have values assigned

  • Must be redetermined by the system before generation

If a suitable default parameter value is found, the system checks first whether the value was changed manually. If this is the case, the Parameter Value Is Used in Report indicator is set and the value is transferred to the return table.

If the Parameter Value Was Changed Manually indicator is not set, the system checks whether the Temporary Default Parameter Value indicator is set. If this is the case, the value is determined once again.

If the Temporary Default Parameter Value indicator is not set, the system checks whether the value is initial, depending on the value category. If this is the case, the value is also determined once again. If the value is not initial, the Parameter Value Is Used in Report indicator is set and the value is transferred to the return table.

Division of the Default Parameter Values into Value Categories

The default parameter value can have one of the following value categories:

Value Type

Description of Corresponding Default Parameter Value

1

String (any sequence of characters)

2

SAPscript text key (long text)

3

File Name

4

Document from SAP component Document Management (DMS document)

5

Phrase (logical key of a phrase, made up of library key and phrase key (CATPIN-PHRID))

Note Note

For the value categories 2 (SAPscript text key) and 4 (DMS document), the value comprises a key that is made up of several key fields. On the dialog screen for editing the default parameter values, you can enter these object keys separately using the input help.

An input help also exists for value category 5. The input help for value category 1 depends on whether the underlying DDIC field has an input help. Value category 3 (file) does not have an input help.

Independent of the value category, the ordinal numbers (ORD field) are displayed for the individual values of parameters that can have multiple values assigned. This ordinal number is at the same time also the sort sequence for the output of the individual values in the report (see also Editing Default Parameter Values ).

End of the note.
EH&S Native Language Support

EH&S Native Language Support is supported for the default parameter values. The necessary conversion is carried out for language-dependent values.

Consideration of Language and Validity Area

For each symbol, the language and the validity area can be transferred from the determination function module to report generation. On the dialog screen, the language and validity area are displayed for each parameter. An empty language field means that the value is valid for all languages. An empty validity area field means that the value is valid for all validity areas.

The system considers the dependency between language and validity area as follows:

  1. The system checks whether the requested language (report language) and the validity area requested from the generation variant match the default parameter values. The check takes account of the usage check, which you can define for the generation variant.

  2. The system checks whether the validity area applies for the default parameters that are language-independent (no language is specified).

  3. The system checks whether the language applies for the default parameter values that are independent of the validity area.

  4. The system checks whether there are default parameter values that are independent of language and validity area. A value must be found whose table/field information or class/characteristic information corresponds to the OBJECT/ATTRIB information of the CVDDP table.

Parameter Hierarchies

Using parameter hierarchies you can define structural interdependencies between parameter objects .

Parameter Value Screen

The dialog comprises header information and a variable section where you display and edit the parameter values.

The header information displays the following data:

  • Data on the report if the parameter values are for a report body: specification key, report language, generation variant, report version.

  • Data on the generation variant if the parameter values are for a template or generation variant (report without a specification reference, see Report Shipping with and Without Specification References ): generation variant, report category.

The variable part is created from the default values that were previously determined and transferred to the dialog. In addition to the field text and the default parameter value, the sort sequence and the value category, and possibly also the validity area and language, are output for each value.

See also:

Editing Default Parameter Values