Default Parameter Value Determination (SAP Library

Default Parameter Value Determination

Use

This function allows you to predefine parameter symbols for reports with data: the default parameter values. If a report is displayed or printed out, you save time and effort spent on manual data entry. 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 modify 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 saved 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

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 screen. The changed default parameter values (such as sales organization data) are retained during 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.

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.

Define table fields and class characteristics

Define table fields: In the IMG activity Specify R/3 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.

Generate 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 therefore create the symbols for them manually.

Check and specify reports 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:

In the IMG activity Specify Parameter Objects define the required parameter objects.
In the IMG 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 IMG 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 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 Model for Report).

The system selects 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

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:

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 and ATTRIB values with the symbol definition in Customizing, the default parameter value can be 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 and ATTRIB information corresponds to the table and field information or the class and characteristic information from the symbol definition.

This graphic is explained in the accompanying text

Example

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

Indicators in the Structure CVDDP (Parameter Values for Report Shipping)

Using indicators you can specify which of the following are necessary for a default parameter value, for example:

Whether it may be changed
Whether it must have values assigned
Whether it must be determined again 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 Parameter Value is Temporary Default Parameter Value indicator is set. If this is the case, the value is determined once again.

If the Parameter Value is 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 Category	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

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. In the 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 data dictionary 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).

EH&S Native Language Support

EH&S Native Language Support conversion is performed for the language-dependent default parameter values.

Taking Language and Validity Area into Account

For each symbol, the language and validity area can be transferred from the determination function module to report generation. In the dialog, 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 takes the interdependency of language and validity area into account in the following way:

The system checks whether the required language (report language) and the required validity area based on the generation variant apply for the default parameter value. The check also takes into account the usage check that you can specify for the generation variant.
The system checks whether the validity area applies for the default parameter values that are independent of the language (where no language is specified).
The system checks whether the language applies for the default parameter values that are independent of the validity area.
The system checks whether there are default parameter values that are independent of the language and validity area. Here a value must be found whose table/field information or class/characteristic information corresponds to the OBJECT and ATTRIB information in the CVDDP table.

Parameter Hierarchies

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

Parameter Value Screen

The screen comprises header information at the top 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 section contains the default values that have been determined and transferred to the screen. In addition to the field text and the default parameter value, the sort sequence and the value category, and, if relevant, the validity area and language are displayed for each value.