Page History
...
The following parameters can be set for the service from Encore:
Name | Description | Type | Required | Direction | Select module |
---|---|---|---|---|---|
restService | The name of the REST service along with the module where it is defined. | Module Element | Yes | Input | Yes |
operation | The name of the operation of the REST service that needs to be called. | String | Yes | Input | No |
url | The URL of the REST webservice. | String Expression | No | Input | No |
connectionOverride | The name to use when overriding connection in the Runtime configuration files (more about this in the following section). Not that if the expression returns the value unknown ( ? ) as result, an error is thrown. In this scenario no fallback is used. | String Expression | No | Input | No |
mapping | The name of the data mapping to use along with the module where it can be found. | Data mapping | No | BiDirectional | No |
username | The username to use in the service calling. | String | No | Input | No |
password | The password to use in the service calling. | String | No | Input | No |
Overriding parameters
The parameters url, username and password can be overridden in the Runtime's configuration files.
...
- The exception exit can be used to handle exceptions such as a failing data mapping, or a response body that doesn't match the domain schema.
- Use the exit events to handle timeouts, client errors (http status code 4xx), and server errors (http status code 5xx).
- If there is a need to distinguish on a more specific http status code than the aforemantioned ranges, you can use the header in the REST service to map the status code with the name "Status" to the profile.
Exit events
Name | Description | Type |
---|---|---|
Timeout | When the REST request returns a timeout exception. | Continue |
ClientError (since 16.7) | When the REST request returns a 4xx exception. | Continue |
ServerError (since 16.7) | When the REST request returns a 5xx exception. | Continue |
default exit event | All unmapped events will be redirected to the default exit node of the service call, even errors. Therefore it is recommended to always map all possible expected exit events. | Continue |
Authentication options
There are several authentication options, which are configurable per connection with properties:
...
Overview
Content Tools