Start of Content Area

Function documentation Form Bundling   Locate the document in its SAP Library structure

Use

Forms are sent to Adobe Document Services (ADS) for processing. The function described here enables you to optimize communication with ADS by bundling forms in a single call. In an ABAP + Java system (double stack), the global directory is used to exchange data for bundling. From SAP NetWeaver 7.0 SPS 12 you can use the HTTP connection to ADS for bundling if AS ABAP and AS Java are installed on different systems.

Prerequisites

The user ADS_AGENT must have the role SAP_BC_FPADS_ICF to use bundling if AS ABAP and AS Java are installed on different systems. More information is available in the Adobe Document Services Configuration Guide under Creating the Service User ADS_AGENT in the ABAP Environment (in English only).

Features

Forms with different form designs and different languages are bundled together. The data in the forms can be different.

Form bundling is supported for the following scenarios:

      Print

      Print and archive

      Archive only

      Create a PDF ("PDF Return")

Also 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 is deactivated automatically by the system.

Activities

Enabling Form Bundling

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

You edit this table in the view maintenance transaction (SM31):

Table FPCONNECT

Field

Required Setting

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 complex bundling

CACHING

Not required for bundling. See Caching Forms.

Note

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

Using the Application Program to Enable or Disable Form Bundling

You can also use the application program that calls the form to define form bundling. This has the advantage that you can link the bundling of forms to your application. To do this, set the field BUMODE in the parameter of the function module FP_JOB_OPEN to one of the following values:

Caution

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

Permitted Values for BUMODE

Value

Meaning

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 enabled in the system (using the entry in table FPCONNECT), it may be a good idea to disable it occasionally for very large forms.

 

 

End of Content Area