An external service call task can be used to call in data from an external source, to be added or utilised within your process, send data to an external source or trigger an action in an external source. In this article we’ll have a look at how you can create one within Atlas Play.

Step 1: Select the ‘create task’ icon from the Toolbox

Or, use ‘append task’ by clicking on an existing element in your process.

Step 2: Select your newly created task and click on the spanner icon. Then, in the drop down menu, click ‘Service Task’. Once you’ve selected this option, the task will turn green:

Step 3: Enter the Url and HTTP Method in the properties panel

Step 5: Data can be added to the request in the below sections

  • Headers

  • Pipeline Headers

  • QuerystringParameters

  • Querystring Parameters(Pipeline)

  • Request Body

  • Request Body (Pipeline)

The ‘Body’ of the response sent by the server should always be a JSON object. Each parameter of the object will create, or update, the values of their respective pipeline variables.

NB: Where ‘pipeline’ is mentioned, the value will be retrieved from the Atlas pipeline. The other options will allow you to enter a fixed name and value

What happens if the server returns an error code?

If the server returns an HTTP Code 4**, the Atlas process will halt. The mapper of this process will need to assess the error and amend the external service call appropriately.

If the server returns an HTTP Code 5**, the Atlas retry mechanism will repeat the request with an exponential backoff. Meaning, Atlas will retry at increasingly infrequent periods before cancelling the request altogether. If this occurs, the user should check for common errors, including incorrect URLs, email addresses or other pieces of data that might return this error.

Did this answer your question?