Indirect Connection Using SAP Smart Forms
Use
If your application outputs forms using SAP Smart Forms, you can connect indirectly to the Business Communication Interface (BCI).
Activities
Applications output forms using a generated function module with SAP Smart Forms. This function module provides the interface with standard parameters to control form output:
-
A structure CONTROL_PARAMETERS to determine the output type
-
The parameters MAIL_SENDER, MAIL_RECIPIENT ,and MAIL_APPL_OBJ, which are passed to the BCI
To access the BCI using SAP Smart Forms, you have to set the DEVICE field of the structure CONTROL_PARAMETERS to ' MAIL'. The formatted document is then automatically transferred to the BCI and sent from there.
The recipient is determined by the import parameter MAIL_RECIPIENT. This is (analogous to direct access to the BCI) a recipient object.
Restrictions
Only individual recipients can be specified as recipient objects for the connection using SAP Smart Forms. Therefore, distribution lists, organizational units and so on, cannot be specified. The reason for this is that the formatting of documents by SAP Smart Forms is generally recipient-specific.
Therefore, before calling the form, expand the recipient object using the expand method, and call the form for each recipient individually.
Features
If you connect your application to the BCI using SAP Smart Forms, not all of the BCI functions are available. You can use the following functions:
-
Link the application object with the document sent
Activities
Transfer the ID of the application BOR object in the parameter MAIL_APPL_OBJECT of the generated function module.
-
Activities
Status confirmation by mail is set using the SetStatusInfoByMail method.
-
Status Confirmation by Events in the Application Object
Activities
Transfer the ID of the application BOR object in the parameter MAIL_APPL_OBJECT of the generated function module.
The application object must support the interface for the event triggered by the status confirmation.
-
Activities
Specify the sender in the import parameter MAIL_SENDER of the generated function module. The ID of a BOR object is expected.
Example Report
The example report RSSOKIF2 can be used for the indirect connection of SAPscript documents to the BCI. It shows, in a simple example, which calls are necessary to send a fax to any fax number with the connection using SAPscript and the BCI. This includes the creation of a recipient object as a recipient, the expansion of the recipient object into individual recipients using the Expand method, and the specification of a sender as well as an application object ID. The connection of SAP Smart Forms documents occurs analogously.