Entering content frameFunction documentation Submit Control Locate the document in its SAP Library structure

Use

The SAPforms Submit control allows you to use the SAPforms Designer in all development environments for forms that support ActiveX controls. You can also use the control in Microsoft Visual Basic.

It also makes it easier for you to edit and generate SAPforms forms.

Integration

Using the Submit control is only one way to utilize the functions of the SAPforms Designer. You can also start the SAPforms Designer as an add-in from Microsoft Visual Basic or as a stand-alone version.

This graphic is explained in the accompanying text

The Submit control in relation to the various plug-in types.

Prerequisites

You have a development environment for the SAPforms form (Microsoft Visual Basic, Microsoft Outlook, Microsoft Word, or Microsoft Excel) and SAPforms has to be installed.

Features

The SAPforms Submit control contains all of the information required for communication between the SAPforms form and the SAP System. Unlike working with the SAPforms Designer normally, the TAG property of the form is no longer used to store this information in the form. Furthermore, no source text is inserted in the form’s load method.

Classification

Like every ActiveX control, the Submit control contains properties, methods, and results that can be used to design a SAPforms form. In addition to the typical properties for this control type ("pushbutton"), the following properties and methods can be maintained:

Element

Function

Remark

AfterSubmit (Method)

Inserts an action that takes place directly after the Submit event.

  

BeforeSubmit (Method)

Inserts an action that takes place directly before the Submit event.

For example, for programming an Error Handling.

Custom (Property)

Calls the context menu of the Submit control, which can be used to launch the SAPforms Designer.

When using the Submit control, you will usually launch the SAPforms Designer by choosing the context menu Define.

For more information, see Designing Forms with Microsoft Outlook and Designing Forms with Microsoft Word and Microsoft Excel.

Error Message (Property)

Error message text that can be used in a Message box.

For text that appears when there is an incorrect transfer of form data to an SAP System.

SuccessMessage (Property)

Text that can be used in a message box.

For text that appears when there is a successful transfer of form data to an SAP System.

Activities

Working with the Submit control entails the following steps:

Activate submit control

To work in Microsoft Visual Basic, you must activate the corresponding ActiveX component. To do so, choose Project ® Components and set the SAPforms Submit Control indicator on the Controls tab.

To work in Microsoft Outlook, you must activate the corresponding ActiveX component. Start the Toolbox in the form design environment of Microsoft Outlook. Call the Additional Controls dialog box by choosing Custom Controls... from the context menu of the Toolbox. Set the indicator SAPforms Submit Control.

Start SAPforms Designer

  1. Create your SAPforms form.
  2. Insert the submit control into your form.
  3. Choose the Properties entry in the context menu of the control.
  4. Now choose SAPforms Designer from the dialog box.

    5. The SAPforms Designer is launched.

  5. Open the interface structure (Menu File) and maintain the Plug-Ins (Tools ® Options).

Generate Binding

There are two ways of defining the binding between the controls on the SAPforms form and the data fields.

Note

This procedure is suitable if you want to define a large number of bindings and therefore want to make this definition in the development environment for forms and not in the SAPforms Designer.

You can then create the form in Microsoft Visual Basic as an executable file or publish it in a folder in Microsoft Outlook.

Caution

See SAPNet note 416515.

 Leaving content frame