Using the Mail Merge Interface (SAP Library - Desktop Office Integration (BC-CI))

Using the Mail Merge Interface

Purpose

The mail merge interface allows you to control the mail merge function of a desktop application from within the R/3 System. The application must support the interface (see also the documentation for has_mail_merge_interface).

Prerequisites

You must create the instance document for document management before you can use the interface.

Process flow

1. Declare an instance with reference to the interface i_oi_mail_merge:

DATA mail_merge TYPE REF TO i_oi_mail_merge.

2. Use the method get_mail_merge_interface on the document instance for document management to create the instance for the mail merge interface.

3. Use the mail merge interface methods:

Methods of the Mail Merge Interface

Method	Function
set_data_source	Transfers data to the frontend
get_fields	Mail merge fields
merge_one	Merges a single data record.
merge_range	Merges a set of data records.
print	Prints a mail merge document.
view	Displays the document with merged data.
shutdown	Destroys the interface.
view_field_codes	Displays the field functions in the mail merge document.

Note

Remember that you should include error handling after each method call.

Note

Any parameters not contained in the individual method descriptions are listed under Generic Parameters.