Step 1 - Main settings

Please create a new profile with a descriptive name, e.g. Lobster_Tutorial_HTTP_simple_calculator.

Select the mapping type Data routing or No mapping, as the GET method has no request body and thus the content of the input document is irrelevant.

Step 2 - Phase 1

Select the event-based Input Agent of type HTTP in phase 1.

In order to send data to a profile via HTTP, you must address a specific URL. The schematic structure of the URL is <protocol>://<server>:<port><URL context>/<URL suffix><query>

• Protocol: http(s)

• Server and port: DNS name or IP address of the Integration Server and optionally the port.

• URL context: For profiles with event-based Input Agent dw/Request or for time-driven profiles /dw/Trigger

• URL suffix: Name that describes the functionality of the profile.

Select simple_calculator as the URL address suffix for this profile. This makes the profile accessible under https://<Server>/dw/Request/simple_calculator

Note: A comprehensive explanation of all settings for the Input Agent HTTP can be found in the context help.

Activate the GET checkbox as shown in the screenshot above.

In order for the caller to receive a dynamic response, please set 'Custom class' or 'Pass back data' in response channel of profile under Send response by.

The response on error is not that important in an exercise and we recommend simply entering a meaningful error message that also clearly identifies the profile, e.g. error@Lobster_Tutorial_HTTP_simple_calculator {--Exception--}.

Step 3 - Setting variables in phase 3

To be able to access the query parameters int_1 and int_2 in phase 3, you must declare the MSG_CALL variables in advance as follows:

• MSG_CALL_INT_1

• MSG_CALL_INT_2

The corresponding MSG_CALL variables will be filled with the passed values when the profile is called, thus the values are available in the mapping.

Step 4 - Creating target structure and calculation in phase 3

A source structure already exists if you have selected the option Data routing in the Main settings. This setting will create dummy data, because the input data has no relevance to you.

Create a target structure node with the name Result and a field result below it. In the result field, we want to display the complete equation. If a user sends the HTTP request

, the following text should be returned in the body of the HTTP response: 24 + 42 = 66

Define the following functions on the target structure field result:

The first function is used to add the values, while the second function is used to generate the string.

Step 5 - Phase 6 and output

In the Input Agent in phase 1, the option 'Custom class' or 'Pass back data' in response channel of profile was deliberately set to generate a dynamic response.

Now, in phase 6, create a new Response of type "Custom class" with class "PassBackDataResponse" to receive a response from this profile. If this Response fails, the whole job is allowed to fail (option is activated by default in the Response).

Select "FixRecord" as the content setting. In practice, this format provides output in which the implementer does not use fixed character lengths or generate specific separators.

Please save the Response and the profile.

Enter the following address via your browser: http://<Server>/dw/Request/simple_calculator?int_1=24&int_2=42

You'll find logs and meta data for the profile in the log overview of the Control Center.