Call Web Service

Introduction

The Call web service activity can be used to call one of the imported web service operations. You can specify whether or not to use authentication, what the request should look like and how the response of the web service should be handled.

Properties

An example of call web service properties is represented in the image below:

There are two sets of properties for this activity, those in the dialog box on the left, and those in the properties pane on the right.

The call web service properties pane consists of the following sections:

• Action
• Common

Action Section

The Action section of the properties pane shows the action associated with this activity.

You can open a dialog box to configure this action by clicking the ellipsis (…) next to the action.

You can also open the dialog box by double-clicking the activity in the microflow or right-clicking the activity and selecting Properties.

The properties dialog box consists of five tabs:

• Operation
• HTTP Headers
• SOAP Request Header
• SOAP Request Body
• SOAP Response

Operation Tab

Operation

Operation defines which operation of the web service is called.

Override Location

Override location defines whether to override the location where the web service is called.

Location

Location defines the address of the web service if you override the location. The location needs to be entered using an expression which results in a valid URL string.

Use Timeout on Request

This can be used to throw an exception when the web service takes too long to respond after connecting. After a set amount of time, an exception will be thrown and the microflow will roll back or go into your custom error handler.

Default value: Yes (as of Studio Pro 8.5.0; in earlier versions, the default value was No)

Default: No

Timeout

Timeout specifies the timeout value in seconds.

Default value: 300 (as of Studio Pro 8.5.0; in earlier versions, the default value was 30)

Validate Against WSDL

Validate against wsdl specifies whether the call action should validate the incoming and outgoing XML against the WSDL. Note that Mendix generates correct XML but the application data can cause the XML to become incorrect (for example fields that cannot be empty are empty in the data you’re sending).

Setting this setting to yes can greatly decrease performance!

Schema validation is not supported when you configure the consumed web service to send binary data as attachments.

Default: No

Proxy Configuration

In almost all cases, you can ignore this setting. Use project settings is a good default value.

If desired, you can configure whether to use a proxy for the request. These are the choices:

• Use project settings – use whatever settings are defined at the project level (default)
• Override – override the project-level settings for this action
• No proxy – do not use a proxy for this action, even if there is a proxy configured at the project level

When you select Override, you can configure dynamically whether to use a proxy. You then supply the host, port, username, and password settings for the proxy.

Client certificate

In most cases, the default Use project settings can be used.

However, you can specify a client certificate to use for the request by clicking override. Select from one of the following:

• Use project settings(default) – use the settings that are defined at the project level
• Override – override the project-level settings for this action

When you select Override, you can configure the client certificate that will be used. Click Edit to specify the Client certificate identifier. This identifier can be set in different places, depending on where you deploy the app:

• When you deploy the app to Mendix Cloud, the identifier is set when pinning a client certificate
• When you deploy the app elsewhere, the identifier is set in the custom setting ClientCertificateUsages

When this identifier is not set (either not pinned or not present in ClientCertificateUsages), the default settings will be used (as if Use project settings were selected).

HTTP Headers Tab

Use HTTP Authentication

Use HTTP authentication defines whether the basic authentication should be used.

User Name

User name defines the user name that will be used to authenticate over HTTP. The user name needs to be entered using expressions. The microflow expression should result in a string.

Password

Password defines the password that will be used to authenticate over HTTP. The password needs to be entered using expressions. The microflow expression should result in a string.

Custom HTTP Headers

These custom headers are added to the HTTP request header. Each custom header is a pair of a key and a value (a microflow expression).

SOAP Request Header Tab

For the request header, Studio Pro provides some common XML structures in a drop-down menu.

SOAP Request Body Tab

The XML for the request parts (header and body) can be generated in several ways, chosen through the dropdown at the top of the page, that are described in the following sections.

Export Mapping for Entire Request

Using this option, a single Export Mapping can be used to generate the XML for the request part. You can choose the export mapping to use for the request part and, if applicable, the object or list that you want to use as parameter for the mapping.

Simple Expressions for Each Request Parameter

This option for request parts can be used when all children of the XML element of the request part occur at most once and are primitive values. If that is not the case, this option is disabled and cannot be used.

Using this option you need to supply an argument value for all elements of a primitive type (parameters). Argument values need to be entered using expressions resulting in the same data type as the parameter.

For primitive parameters (both optional and nillable) that do not have an export mapping, you can choose to send empty values by setting Send empty values to Yes, as null.

Export Mappings for Each Request Parameter

This option can be used when all children of the XML element of the request part occur at most once. You need to supply an argument value for all top-level elements of the request (parameters). For simple parameters you can enter a microflow expression, for complex parameters you define a mapping.

Custom Request Template

This option allows you to generate the XML for the request part using a template. The template defines the XML structure of the request part in plain text.

String Template

The template for the XML request can contain parameters that are written as a number between braces (for example, {1}). The first parameter has the number 1, the second 2, etc. You can escape the opening brace ({), by using a double opening brace ({{).

Parameters

For each parameter in the template, you can specify its value using a microflow expression resulting in a string value. This value will be inserted at the position of the parameter.

SOAP Response Tab

If the data type is a complex XML structure it can be mapped to entities using a Import Mapping. If it is primitive data, it can be stored in a variable immediately. The response does not have to be used though; it can also be ignored if you are not interested in it.

Mapping

If you are using complex XML structures you can choose the Import Mapping that will be used to transform the XML into objects.

If No Object Was Found

You can indicate what should happen if not object was found when the import mapping has checked the box decide this at the place where the mapping gets used.

Parameter

If the selected mapping requires a parameter, you can choose it here.

Commit

Indicates whether the resulting objects should be committed to the database, and whether event handlers should be triggered.

Range (If the Mapping Returns a List)

The range determines how many objects are mapped and returned.

Store in Variable

Choose whether to store the result of the operation in a variable, object, or list.

Type

The type of the output.

Name

The name for the output that will hold the result of the operation.

Common Section