Start of Content Area

Object documentation The Hierarchy of an Application Form  Locate the document in its SAP Library structure

Definition

The hierarchy of an application form covers all of the information about the relationships of the data belonging to the form levels. The hierarchy also defines a flow logic that is used to process all form levels and 1:1 levels and the data linked to these from top to bottom in the generated print program.

Use

The hierarchy describes the flow logic of an application form. The print program that is called dynamically at runtime by the module EFG_PRINT is generated from the structure of the hierarchy.

Structure

The hierarchy consists of:

·        Root level (= attribute of the application form)

·        Form levels

·        Document level (= first form level)

·        1:1 levels

·        Placeholder for user exits (for example, B‚ D, A, or T)

·        Texts for form type SAPscript (SAPscript standard texts)

The following figure contains the schematic display of the hierarchy:

The Hierarchy of an Application Form

This graphic is explained in the accompanying text

By selecting and activating form levels or 1:1 levels you can define which data is to be read. If you use SAPscript, you can also assign additional SAPscript texts to the hierarchy; these are printed according to their position.
The root level contains logical data (attributes) for the application form, for example, form class and name of the user exit include and the user top include.
The document level is of particular significance to the form levels. The document level is the first form level in the hierarchy and has almost the same attributes as any other form level. In contrast to other form levels however, the number of entries for this form level corresponds to the number of forms created. For this reason, this document level must not be placed equal to another level. If a form level or 1:1 level is not required for printing, you can delete it or deactivate it. If a form level is deactivated, it still appears in the hierarchy but is no longer considered for printing. Please note that when deleting or inactivating a form level, the hierarchically dependent form levels and the affiliated 1:1 levels are also deleted or inactivated.
For each form level and 1:1 level there is a global variable (work area) which you can access both in texts and also in user exits. The name of the work area is formed from the prefix WA_ and the name of the form level or 1:1 level (for example, WA_CUSTOMER).

Integration

The hierarchy of an application form is the basic configuration for the generation of the print program. The hierarchy of an application form is always created following the structure of the underlying form class. You cannot select or add form levels that are not defined in the form class. If the system determines inconsistencies between the hierarchy and form classes, if, for example, a form level was deleted, you have to correct this before you can activate and print the application form.

 

End of Content Area