SAPforms - Administration (SAP Library - SAP Business Workflow (BC-BMT-WFM))

SAPforms - Administration

Use

You use the functions for the administration of SAPforms, in particular, when you want to communicate via the Internet with electronic forms.

A trace function and a diagnosis tool are also available.

Features

Default Settings for Starting a Workflow

Check Customizing for Workflow

The Customizing settings for the workflow system must be complete.

Customizing for Workflow is largely automated. For further information, see Customizing.

Check System Administration

The R/3 System must be configured in such a way that Internet mails can be sent and received. Unlike the same functions via RFC, a greater number of components is involved here: mail client, mail server, gateway to SAP R/3, SAPconnect, inbound distribution, and the R3F inbound processing functions (workflow).

Entry in the inbound distribution function (transaction SO28)

Communication between the R/3 System and the external mail system requires one user on the R/3 side that functions as a sender and receiver of the Internet mails.

The user who is also the user for the logical destination WORKFLOW_LOCAL_<Mdt.> is used here. (<Mdt.> = R/3 System client) is entered. If auto-customizing was carried out without any manual intervention, this user is WF-BATCH .

You can view the settings by calling transaction SO28 Inbound Distribution: settings for recipient determination.

The standard user WF-BATCH forwards inbound R3F messages to the "handler for messages to work items" as an attachment to an Internet mail. The handler then calls a function module to forward the transferred data to the container.

WF-BATCH , therefore, must be assigned an Internet mail address and the entry "handler for messages to work items" must be entered in the New recipient field. Use the possible entries pushbutton for this purpose (F4).

Configuring Automatic Forwarding

The automatic forwarding function must be set up for every user who

wants to start a workflow with a form,

wants to process a work item as a form in an external mail system

via Internet mail.

The Internet mail address that is entered for automatic forwarding is used as the receiver address of the Internet mail for processing the form.

When an Internet mail is received, the function ensures that the workflow (work item) is started (processed) by a certain agent who is known in the organizational plan.

Default Settings for Processing a Work Item

The following settings must be defined in addition to the default settings for starting a workflow.

Scheduling a Report for Periodic Transmission

The Internet mail address that is maintained for automatic forwarding is used as the recipient address for the Internet mails that are created for processing forms externally. In addition, a report must be scheduled to search the system at regular intervals for work items that fulfill the following criteria:

The work items represent a single-step task that executes the Process method for the FORM object type.

The work items have been created since the last time this report was run. The time at which the report was last run is entered in the table SWU_WLSCAN for this purpose.

The work items are "ready".

If a work item that fulfills the above criteria is found and if one of the selected agents of this work item has activated the automatic forwarding function, an Internet mail is sent for the work item to this Internet mail address.

Scheduling a report for transmitting R3F messages is an activity in Workflow Customizing. You must define these steps if you want to process a work item as a form in an external mail system.

You can also define this setting in normal operation using the transaction SWUX (SAPforms Administration).

Diagnosis Tool and Trace Function

The diagnosis tool provides various reports for error analysis. Documentation can be viewed for the individual functions via .

In particular, the results of the SAPforms trace can also be analyzed here. The trace must have been activated previously.

Activities

Choose Tools ® Business Workflow ® Development ® Administration ® SAPforms ®

What?	Where?
Entry in the inbound distribution	® Mail enabling ® Periodic. The Scheduling Report for Sending SAPforms Messages screen is then displayed. Here you choose Environment ® Enter inbound processing. The entry is then made in inbound distribution.
(De-)activate SAPforms trace	® Trace on/off
Diagnosis tool	® Diagnosis
Schedule reports (periodically)	® Schedule batch job periodically
Schedule report (once, test)	® Start batch job once
Workflow Customizing	Tools ® Business Workflow ® Development ® Utilities ® Customizing