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.
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 · 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 |
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).
Whether 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.