Entering content frameProcedure documentation Creating SAPforms Form Task Locate the document in its SAP Library structure

Use

You need a SAPforms Form Task to be able to use a SAPforms form for the execution of a workflow step.

Note

The task definition of a SAPforms form task contains the following information:

Prerequisites

You are familiar with the procedure for defining tasks .

Procedure

Defining SAPforms Form Task

  1. Create a task for the SAPforms form that you want to execute from a workflow. You can specify any name you want for this task.
  2. Enter the object type FORM .
  3. Enter the Process method.
  4. Choose YES to confirm that elements that do not exist in the task container are to be copied from the method container of the object method.

The following container elements are automatically created by the system in the task container:

A binding definition between the task container and the method container is generated for this element.

Caution

The three method parameters cannot be completely copied automatically to the task container. For this reason, make sure that you carry out the following steps:
  1. Choose This graphic is explained in the accompanying text Container to display the definition of the task container.
  2. Delete the Workitem element and exit the screen.
  3. Choose This graphic is explained in the accompanying text.

    4. The binding editor for the definition of the binding between the task container and the method container is displayed.

  4. Enter the following binding:

Workitem <== &_Workitem&

Extend the container definition

You can add other container elements to a container as form-specific extensions. The contents of these elements can then be displayed and edited in the fields on the SAPforms form. All of the data that is to be displayed to the form user must exist as container elements in the task container.

  1. To edit the task container, choose This graphic is explained in the accompanying text Container.
  2. To add elements to the task container, choose This graphic is explained in the accompanying text and follow the standard procedure.

    3. Note

    Only elements that reference fields can be transferred to the form application. Identify the individual elements as the import or export element (or both), depending on how they are to be used.

  3. Create a suitable container element for all of the fields you want to display or change in the form.
  4. Exit the Container Editor.

Agent Assignment

When you define a task, you must specify its possible agents.

  1. To do so, choose Tools ® Agent assignment ® Maintain.
  2. Save the task definition in the package that you have also used for the Namespace maintenance.

Assigning Initial Values

The object method used in the task needs the name of the form that is to be executed. Therefore assign form type and form to the corresponding container elements as the initial values.

  1. To assign initial values, choose This graphic is explained in the accompanying text Initial values.
  2. Assign appropriate values to the R3FFormTyp ( form type) and R3FForm ( form name) container elements.

Example

If you are using the Microsoft Visual Basic form APPROVE.EXE enter EXE as the form type and APPROVE as the form name.

If you are using the Microsoft Outlook form template WFAPPROV2.OFT enter OFT as the form type and WFAPPROV2 as the form name.

Further Information

You can also enter a task description for your task to inform the mail recipient that he or she can start the form application by executing the attachment.

If you do not enter a task description, a standard text will be displayed.

 Leaving content frame