Start of Content Area

Object documentation Collection  Locate the document in its SAP Library structure

Definition

A collection is an application form of the form type collection.

Use

You use collections to group application forms so that you can process them together. In a collection, you can group both application forms from the same form class, and also application forms from different form classes. You can define your own parameters for the technical components of a collection, for example, a specific printer. You can classify the individual application forms so that they are issued sequentially or bundled. You can process collections using transaction EFRM (SAP menu: Print Workbench ® Application Form ® Process), as for application forms.

Structure

Each collection is assigned to exactly one form class. As for each application form, a collection’s assignment to a form class defines how it belongs to an application. Using the indicator Cross-Form Class, you can control how application forms from other form classes can be included in a collection.
In the user exit include and the user top include, you can define the form routines of the user exit or your own data definitions, just as for an application form. These includes are automatically included in the generated module. They are processed at runtime.
For each collection the system generates a local module that contains the complete process flow for the collection. This module also contains the calls of the module EFG_PRINT for printing the application forms to be processed. During printing, the collection transfers the selection data to the included application form via the interface EFG_PRINT. This means that wherever you can specify an application form in Customizing, you can also define a collection. If you make changes to the collection, the form class, or the user includes, the module is regenerated.

Caution A collection is not suitable for combining different components of the same document if there are direct dependencies or references between the individual parts, for example, a sequential page numbering or a connection at the end of the last page. Collections must not contain collections or links.

Example

Grouping of technically separated documents, such as an invoice and the attached payment form, or an e-mail with an electronic document attached.

 

End of Content Area