Getting Started with Amplify Integration – Services

In this blog post, we’ll look at Services. A service is similar to an integration, but without the capability of a trigger. You can use a service as a reusable component in an integration, service, or iMap.

We’ll use the Getting Started with Amplify Integration – OpenAPI Connection to REST APIs as a starting point and we’ll use a Service to determine an Array’s size as we did in the Getting Started with Amplify Integration – Variables and Map Functions blog post. If you have not reviewed those blog posts, please do so now.

This blog post is the ninth in the “Getting Started with Amplify Integration” blog post series and builds on the knowledge gained prior. As such not all steps will be explicitly called out since they are already covered in prior posts.

You can view the technical online documentation for Amplify Integration here and you can register for a free Introduction to Amplify Integration online course at Axway University here.

In order to follow this blog post, you will need access to Amplify Integration.

Create an integration

Let’s retrieve some data from the Petstore API.

Use the integration from Getting Started with Amplify Integration – OpenAPI Connection to REST APIs as a starting point.

Test your integration to see that we are receiving data.

Array size calculation

In the Getting Started with Amplify Integration – Variables and Map Functions blog post we added a Map component and use the SizeOfList function to determine the array size. In this blog post, we’ll use a Service to do the same thing.

• Click on the OpenAPI Client component and expand the bottom panel
• Expand findPetsByStatusOutput in the Pipe-out (right hand side) and right click on response and select Copy Node. Note that response is the array of pets. We did a Copy Node so that we can paste the node as an input to our Service since we will pass the pet array to the service.

• Add a Service component to the integration and expand it’s bottom panel

• Click the Add button near Service to add a new Service and provide a name and description (e.g. ArraySize)

• Click the Service Input/Output button so that we can declare the inputs and outputs and expand the bottom panel

• Right click on ArraySizeInput and select Paste to paste in the response node that we copied above
• Right click on ArraySizeOutput and select Add Variable -> Integer -> Add Inside and provide a name (e.g. arraysize)

• Click Save and close the bottom panel

• Add a Map component and expand the bottom panel
• Click the +fx button and select SizeOfList
• Expand ArraySizeInput in the Pipe-in and ArraySizeOutput in the Pipe-out
• Drag a line from ArraySizeInput->response to SizeOfList->list and drag another line from SizeOfList->size to ArraySizeOutput->arraysizedocs and click Save

• Return to the integration and open the service component, expand the bottom panel and refresh the Service picker and select the service we just created
• Drag a line from findPetsByStatusOutput/response in the Pipe-in to ArraySizeInput/response in the Action Properties and click Save

Click the Test button to test your integration and check the transaction and click on Service – invoke and expand the ArraySizeOutput to see the result.

We now have Service that calculates the size of the pet array returned. This service can be used in multiple locations in the integration or other integrations and services in your project and tenant.

Summary

In this blog post we looked at how to create a Service and use it in a Service. The Service we created calculates the size of the Petstore response array.

In future blog posts, we’ll build on our knowledge and explore more of the features of Amplify Integration to create no code integrations.