Prerequisites

• Access to the File > Form (FO005) menu.
• Previously created and designed form.
• SOAP data source previously added through the SoftExpert Data integration > Data source management > Data source > SOAP (DI002) menu.

Introduction

When designing forms, the system allows for configuring lists of values and buttons to show data coming from an external-service data source.

Using a SOAP data source improves the accuracy and reliability of the data, as it enables real-time access to it, which is imperative for applications that need constantly updated information.

Moreover, SOAP services are highly scalable, which means that they can handle large volumes of data requests without compromising performance, in addition to being easy to integrate, as they follow well defined communication standards, which facilitates integration with different systems and platforms.

See how to configure the use of external data in form elements:

How to use a Web Service data source

1. Access the File > Form (FO005) menu.

2. Select the form you wish to configure.

3. Click on the arrow next to the button and select Form designer.

4. Select the desired element:

• List of values: in the Properties panel, select the External option and click on the Data source button.
• Button: in the Properties panel, click on the Data source button.

5. On the screen that will open, set the configurations:

Step 1 - Data source

In this step, select the data source that will be used. 

• It is possible to use a data source, a SOAP data source, or a REST data source. The steps described in this article focus on the use of a Web Service data source.

• For a SOAP to be used, the data source must have been previously configured in SoftExpert Data integration. 

 

Use the Filter by type field to find the desired data source more easily.

After selecting the data source, click on the Next button.

 

 

Step 2 - Method

In this step, the enabled SOAP methods, among the available ones, are displayed. 

Expand each method to see the parameters that must be entered and the returns that can be obtained.

Select the desired method and click on the Next button.

 

 

Step 3 - Parameter

In this step, configure the input parameters for the desired method. 

For each presented parameter, specify the field that will receive the data during the execution of the form. 

After inserting all necessary parameters, click on the Next button.

 

 

Step 4 - Return

In this step, configure the fields that will receive the return parameters of the method. 

For each parameter, select the form field that will receive the SOAP return.  

After inserting all necessary parameters, click on the Next button.

 

 

Step 5 - Summary

In this step, the system will display the summary of the data source configuration. 

Click on the Finish button to end the configuration.

 

 

6. In the Form designer, click on the Save button.

Conclusion

When the use of external data is configured, the options shown on the list of values during the completion of the form will originate from the SOAP data source associated during the configuration process.