Enabling Form Input Validation 

Use

You can validate the output of the composite form. For example, you can use an RFC-enabled function module to check if the form input is consistent with the data required.

The validation of the composite form input is implemented by mapping the parameters of the form to the input parameters of the relevant validation service.

The GP framework provides an error handling mechanism that enables you to automatically send an e-mail message to the step processor if an error occurs.

Prerequisites

To use a service for validation, you must have exposed it as a callable object.

More information: Creating Callable Objects in the GP Design Time

Procedure

The definition of form validation is part of the procedure for exposing the form as a callable object.

To enable form validation:

...

       1.      If you are creating a new form, make sure you are at the Define Validation step of the composite form wizard.

If you want to edit an existing form, in the gallery, select the relevant form object and open its design time. Then switch to edit mode, and open the Validation tab page.

       2.      Follow the predefined procedure to configure the form validation:

                            a.      Choose Add Service. Select the callable object that encapsulates the required service, and choose Select.

                            b.      Repeat the procedure for all services that you want to add. Finally, choose Done.

                            c.      Create the required parameter mappings between the form output parameters and the service input parameters. On the Map Input Parameters tab page, select a service parameter from the table on the left and the form parameter you want to map from the table on the right.

                            d.      You can also set defaults for the service parameters. To do this, select a parameter from the table on the left, and choose Set Default. Enter the required value and choose Done.

                            e.      To attach a template for the e-mail that will be sent to the step processor if the validation fails, select a service, and then choose Add E-Mail Template. Select an appropriate template, and choose Select. If a suitable template is not available, you can create one. More information: Managing E-Mail Templates

       3.      Save your changes.

Once you create the composite form, you can view validation service definitions and mappings on the Validation tab page of the form design time. You can also edit services by toggling edit mode