This function allows you to predefine parameter symbols for reports with data: the default parameter values. If a report is displayed or printed out from the preview, 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 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 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 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
.
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 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 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:
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, a
nd 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
.
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
).
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 selects the default parameter values that are actually required for report generation and transfers them to the return table.
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.
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 |
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.
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.
Using indicators you can specify which of the following are necessary for a default parameter value, for example:
Whether it can 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.
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
|
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. On 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 is supported for the default parameter values. Any conversion required for language-dependent values is performed.
For each symbol, the language and validity area can be transferred from the determination function module to report generation. In the dialog box, 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.
Using parameter hierarchies you can define structural interdependencies between parameter objects .
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 are displayed for each value, and, if relevant, the validity area and language.
See also: