Form Interface Parameters of the Application

In the application that calls a form template, you can use the function module FP_JOB_OPEN to make settings for the form output and spool control with Adobe Document Services (ADS).

You control the output by using the parameters (IE_OUTPUTPARAMS) of the structure SFPOUTPUTPARAMS, which are described in the following table.

Parameters of the Structure SFPOUTPUTPARAMS

(a) Parameters for Controlling Form Output

Parameters for Controlling Form Output	Description
GETPDF	Requests that ADS return the finished form
GETPDL	Requests that ADS return the printer data
GETXML	Requests the business data of the application in an XML file (ADS do not generate a form.)
PREVIEW	Generates a print preview (You can suppress this option by using the relevant parameter for spool control.)
CONNECTION	Option to specify the name of the connection to ADS, if this differs from the standard name `ADS`.
ADSTRLEVEL	Defines the level of detail of the runtime information; values range from `01` to `10`. More information: Setting Runtime Error Analysis in the Application Program
JOB_PROFILE	Specifies additional statements for form processing using ADS. The statements must exist in an XML file and ADS must be configured accordingly. Entry: Name of XML file
BUMODE	Controls form bundling when called by the application program. The values are as follows: `M` Option activated (bundling) `Blank` Uses setting from field `MBATCHING` from table `FPCONNECT` – Option deactivated More information: Bundling Form Templates in a Call
ASSEMBLE	Merges multiple forms into a single PDF file. Values: `Blank` Option deactivated `X` Option activated `S` Option activated, but does not take memory restrictions into account (suitable for merging very large forms into a PDF file) Note Use the feature query to check whether ADS supports this option. More information: SAP Note 1063237 and example program `FP_CHECK_BATCH_PDF_RETURN` End of the note.
PARALLEL	Parallel processing of print requests More information: Reducing Runtime of Print Requests by Parallel Processing
PDFVERSION	Specifies the PDF version of the form. For example, to view a PDF form of PDF version 1.7, enter `1.7`. You only need to make this entry if you want a different PDF version to the default version generated by ADS.
PDFTAGGED	Controls the generation of PDF forms with or without tags, using the following values: `X` PDF form with tags `Blank` User settings for the scenario determine how the PDF form is generated. The way the PDF is displayed in the print preview depends on the GUI settings on the front-end PC (accessibility mode). The PDF is always given tags when archived or returned to the application program. `-` PDF form without tags Caution Using tags to identify the form elements is indispensable for accessible forms. If, however, your legal requirements do not require you to ensure accessibility, you can improve the performance of form processing by not using tags. More information: Optimizing Form Processing Performance End of the caution.
FPCHANGESRESTRICTED	Defines the usage rights for forms with the following values: `Blank` All changes allowed `A` You can add or remove pages in the PDF, create a table of contents, set page numbers `F` Form can be filled out and signed (interactive forms only) `N` Form can be filled out and signed and you can also create comments (interactive forms only) `X` No changes allowed When the program is called, the system creates a PDF form with the specified change options. The form is encrypted with a random password. The usage rights cannot be changed. To create a form with changed usage rights, you must run your application program again with new parameter values.
ARCMODE	Controls the output of forms to be archived. The values are as follows: `1` Print only `2` Archive only `3` Print and archive
XFP	Activates the XFP output. More information: Making Forms Available for External Applications
XFPOUTPUTDEV	Sets the output device for the XFP output.
XFPTYPE	Determines the XFP variant using the following values: `Blank` XML with context resolution `R` XML without context resolution

(b) Parameters for Spool Control

Parameters for spool control	Description
NODIALOG	Hides the spool dialog from users
REQNEW	Generates a new spool request
REQIMM	Specifies that the form is to be output immediately
REQDEL	Deletes the spool request after form output
TITLE	Displays the form name (title) in the spool dialog
NOPREVIEW	Does not allow a print preview (overrides parameter `PREVIEW)`
NOPRINT	Does not allow print output from the print preview
NOARCHIV	Does not allow archiving from the print preview
IMMEXIT	Print preview is closed immediately after output
NOPRIBUTT	Hides the print button to start printing

Note Note

If you want to output a form migrated from Smart Forms or a Smart Forms-compatible form, other spool control parameters apply.

More information: Controlling the Spool Dialog in the Smart Forms documentation

End of the note.