Show TOC

Bundling Form Templates in a CallLocate this document in the navigation structure

Use

The form processing framework transfers the form templates called by the applications to Adobe Document Services (ADS) for processing. You can optimize communication with ADS by bundling forms in a single call.

In a double stack system (ABAP and Java), the global directory is used to exchange data for bundling. If AS ABAP and AS Java are installed on different systems, you can also use the HTTP connection to ADS for bundling.

You can bundle form templates regardless of the form design, language, or contained data.

For more information, see SAP Note 1134660 Information published on SAP site.

If form bundling is activated, the form runtime environment decides whether bundling is performed or whether the forms are processed in individual calls. It is only worth bundling if there is a large number of small documents.

Availability

Form bundling is possible for the following scenarios:

  • Print

  • Print and archive

  • Archive only

  • Create a PDF ("PDF Return")

    Read the prerequisites in the application program for bundling when creating a PDF.

In all other cases (such as print previews and output in XFP format), bundling of form templates is deactivated by the system. Note that bundling is also deactivated if device type PDF1 is used.

Prerequisites

If AS ABAP and AS Java are installed on different servers, the user ADS_AGENT must be assigned to the role SAP_BC_FPADS_ICF.

More information: Creating the Service User for Communication with ADS (only available in English)

Procedure

Activating Form Bundling

You set the bundling of PDF-based forms in the table FPCONNECT.

To do this, use the view maintenance transaction (SM31).

Field in Table FPCONNECT

Required Settings

DESTINATION

Connection to ADS

DIR_GLOBAL

X for bundling in an ABAP+Java system

space for bundling in distributed systems

BATCHING

space (no longer used)

MBATCHING

X to activate bundling

CACHING

Not required for bundling. See Caching Forms.

Note

To deactivate a field, specify - ; to use the system setting, specify space.

Activating and Deactivating Form Bundling Using the Application Program

You can also use the calling application program to control form bundling. This means you can decide whether you want to perform form bundling depending on your application. Set the field BUMODE in the parameter of the function module FP_JOB_OPEN to one of the values described below:

More information: Preparing Form Template Call in Application Program

Caution

The fields DESTINATION and DIR_GLOBAL in FPCONNECT must be set to the appropriate values.

Values for BUMODE

Description

X

Obsolete

M

Bundling

space

Setting taken from field MBATCHING in FPCONNECT

-

No bundling

Recommendation

Form bundling is particularly effective at improving performance for small forms. Any gains in performance are also system-dependent. If bundling has been activated in the system (using the entry in table FPCONNECT), it may be a good idea to deactivate it occasionally for very large forms.