Entering content frame

Object documentationPrint Parameter Structure EPRINTPARAMS Locate the document in its SAP Library structure

Definition

In all programming interfaces of the print workbench a structure of the type EPRINTPARAMS is used. It contains all relevant control fields that are relevant for the Print Workbench itself or for SAPscript or Smart Forms.

Structure

The structure EPRINTPARAMS consists of two parts:

·        Structure EFG_PRINTPARAMS of the Print Workbench

·        The structure ITCPO relevant for the form tool (SAPscript/Smart Forms/PDF-based forms)

Structure of EFG_PRINTPARAMS

DEVICE

Device type for SAPscript/Smart Forms/PDF-based forms

·        PRINTER for normal print output (default)

·        MAIL for other send types (e-mail, fax)

RDI

RDI indicator for output via SAPscript

·        <space> = Normal output (OTF)

·        X = Output al RDI (via spool)

·        X = Output as simple RDI (via spool)

·        I  = output as RDI-IDoc

·        * = Specification in SAPscript form applies

FORMKEY

Name of application form

FORMKEY_RDI

(Used externally: Name of application form for RDI)

DELAYED_PRINT

Indicator: Creation of print request, no direct print

LANGU

Language of form

TEST_MODE

Indicator: Test mode

DEBUG

Indicator: Debugging mode when calling the generated module

SENDTYPE

Send type:

·        PRINTER = Correspondence as printed letter

·        EMAIL

·        TELEFAX

·        RMAIL = SAP internal mail

REC_ADDR

(Internal use: ID of addressee from central address management)

REC_STRING

(Internal use: Address as string)

SEND_ADDR

(Internal use: Sender address as string)

COPYFLAG

Indicator: Is a copy

REC_PERSNUMBER

(Internal use: ID of person number from central address management)

LAST_DOC

Last document in mass case
(obsolete, should no longer be used)

LAST_DOC_ACT

Output of spool request at the end of the print process

OCL_ACTIVE

Open/close control is active

SENDTYPE_EXT

External send type

NO_ACTIVATION

Indicator: Suppress activation

XSF

XSF indicator for output via Smart Forms:

·        <space> = Normal output (OTF)

·        X   = Output in XSF format

·        D   = Output in XDF format

·        * = Specification in Smart Form applies

GET_XSF

Indicator: Return XSF/XDF data to calling application

NO_OPEN_FORM

Is obsolete and should no longer be used.

NO_CLOSE_FORM

Is obsolete and should no longer be used.

ADDITIONAL_PARAM   

Custom parameters for controlling the print process

XFP     

Indicator for the output format for PDF-based forms (raw data)

·        <space> = Normal output (PDF)

·        X   = Output in XFP format with context evaluation

·        X   = Output in XFP format without context evaluation

The most important ITCPO print parameters for the Print Workbench print processes

TDDEST

Output device (printer)

TDNEWID

Force new output request

TDIMMED

Output output request

TDFINAL

Close output request

TDTITLE

Name of output request

TDSUFFIX1

ID 1

TDSUFFIX2

ID 2

These print parameters are modified, in particular for mass printing, such that, for example, there is only one output request per run or per defined subunit of run. If the parameter LAST_DOC_ACT (Output after Last Document) is set, this prevents output requests that arise during a run being closed or printed (TDIMMED = TDFINAL = <space>). Instead, the individual documents are inserted sequentially in one or a few output requests and output in a closing event (EFG_PRINT_CLOSE).

This graphic is explained in the accompanying textWhether an existing output request is added or a new request opened depends on the different parameters.  An output request is only added if:

§         The parameters TDDEST, TDTITLE, TDSUFFIX1, TDSUFFIX2 agree

§         The output request to be added has not been output or closed

§         The parameter TDNEWID is not set

§         The user creating the output request is the same

If one of the conditions listed above is not fulfilled, the system creates a new output request.

Although the related program interfaces use other structures, structure ITCPO is also used for Smart Forms and PDF-based forms. Since the fields are mostly identical, in the print transaction, the Print Workbench maps the fields of structure ITCPO appropriately.

 

Leaving content frame