Using WorkPoint processes with HTTP endpoints

This article is a continuation of a previous article where a configuration for a WorkPoint process was made so that the CVR Number and Title fields in an Entity form could be filled in using the response from a GET request to an Http endpoint.

In this article we will go through the usage of the previous configuration.

We will open the "Create company" process, and in the CVR Number field of the form we will perform a search for "26082668". We expect the system to return a result from the configured Http endpoint providing us a lot of meta data about WorkPoint A/S, among which will be the CVR number and the title of the company. When we select this search result, the CVR Number, as well as the Title fields should be filled in with data from the Http endpoint result.

In our example the previously mentioned "Create company" process is started by clicking a My Tools button of the same name:

1. In the My Tools panel, we click the "Create company" button.

This opens the first step of the process, which is a form where I can input meta data for the new company:

2. In the Entity form, we select the "CVR Number" field which as set up the endpoint data binding to.

3. Before we type a search query into the CVR Number field, we can see the query conditions message, telling us that a CVR number must have 8 digits. Our search query will not be executed until we provide 8 characters in the field, as per our query condition. Let's provide a partial CVR number to show that the query is not yet executed:

As soon as we provide a complete, 8 digit CVR number, the query is executed, and the search is performed:

5. We can confirm our selection by clicking the search result.

This will fill the CVR Number field with the selected company's CVR number, but since we also configured the Title field to be filled using the data from the endpoint, the Title field gets filled with the most recent name of the WorkPoint A/S company:

From here, we can move on to the next step and continue running our process.

Note that if you have multiple parameters set up in your data binding, such as we have here, you can search using multiple queries.

In the following image, in the CVR Number field, we have for WorkPoint A/S using both the CVR number in the default search box and the the company name in the additional filters:

The endpoint returns the expected company for us to use in our process.