---
alias: user-guide-automation-task-core-executeservicecall
tags:
- automation tasks
description: "This task executes MES service calls, managing inputs, outputs, and service configurations for interaction"
---

# Execute Service Call

:iot-apicall-lg:{style="font-size:100px"}

This task executes a MES service call. It enables the connect IoT module to interact with MES Services.

![Execute Service Call task parameters](../images/execute_service_call_box.png)

!!! note
    The image of the task is an example using the MES `DeleteLicense` service. If no service is selected the task will have no inputs or outputs, except for `Activate`, `Success` and `Error`.

## Details

| Fields            | Details                                                                            |
| ----------------- | ---------------------------------------------------------------------------------- |
| Scope             | Connect IoT <br> Data Platform <br> Enterprise Integration <br> Factory Automation |
| Workflow          | Data flow <br> Control flow                                                        |
| `IsProtocol` flag | :material-close:{style="color:#EF5350"}                                       |

## Inputs

| Name            | Data Type  | Description                         |
|-----------------|------------|-------------------------------------|
| `<custom list>` | `<custom>` | Inputs for the service              |
| Activate        | `any`      | Executes the configured MES service |

## Outputs

| Name            | Data Type  | Description                                            |
|-----------------|------------|--------------------------------------------------------|
| `<custom list>` | `<custom>` | Outputs of the service                                 |
| Success         | `Boolean`  | If there was no problem emits a `true`                 |
| Error           | `Error`    | Error that occurred during the processing of this task |

## Settings

On the `General` Tab, the usual settings such as Name, description and color.

{% include-markdown 'includes/pages/iot_tasks_retries_settings.md' %}

![Execute Service Call task settings](../images/execute_service_call_settings.png)

On the `Service Tab`, you have a listing of all the available MES services.

![Screenshot showing settings for executing a service call.](../images/image105.png)

On the `Inputs Tab`, you have the inputs referring to the selected service (automatically loaded):

| Name            | Data Type        | Default                   | Description                              |
| ------          | --------         | ---------                 | ---------                                |
| Name            | `String`         | `<Filled by the Service>` | Name of MES service input.               |
| Friendly Name   | `String`         | `<Filled by the Service>` | Name to be displayed.                    |
| Type | `Long`<br />`Decimal`<br />`DateTime`<br />`Boolean`<br />`String`<br />`Integer` | `<Filled by the Service>` | Type of the MES service input. |
| Collection Type | `None`<br />`Array`<br />`Map` | `<Filled by the Service>` | |
| Default         | `<custom type>` |                           | Default Value for the MES service input  |

On the `Outputs Tab`, you have the outputs referring to the selected service:

| Name            | Data Type          | Default          | Description            |
| --------------- | ------------------ | ---------------- | ---------------------- |
| Name            | `String`                                                     | `<Filled by the Service>` | Name of MES service output. |
| Friendly Name   | ``String                                                     | `<Filled by the Service>` | Name to be displayed.       ||
| Type            | `Long`<br />`Decimal`<br />`DateTime`<br />`Boolean`<br />`String`<br />`Integer` | `<Filled by the Service>` | The type of the output      |
| Collection Type | `None`<br />`Array`<br />`Map`                               | `<Filled by the Service>` |                             |

## Behavior

The task executes a MES service given a set of input values. It instantiates a MES input object, calls the service, and transforms the MES output objects into individual output variables.

## Remarks

Make sure the MES objects linked with the inputs are fully loaded, otherwise, the Service call may fail. If the objects are not loaded and to avoid making multiple calls to MES to get the objects fully loaded, you can add `Pre` actions to the service and load them inside MES system and therefor, make the calls much more efficient.