Dell Boomi - Web Service Integration with Mapping

1                    Introduction

This document details steps required to perform web service integration using Dell Boomi Atomsphere platform. It will cover various steps including connector, mapping, deployment, testing etc.

2                    Use Case

This PoC is for simulation of synchronous web service integration. Components of PoC :

1.     Web Service Client

2.     Dell Boomi Integration layer.

3.     Web Service Provider

3                    Design-Time Configuration

.1                Creating the process

1.     Login to Dell Boomi account.

2.     Create New Process. Provide name of the Process. In the connector field, Select ‘Web Service Server’.

3.     Click on + icon against the operation field to create a new Operation. New Tab opens like below –

i.       Provide Operation Name, Choose Operation type.

ii.      Choose the ‘Input Type’ as Single XML Object, then Click on + icon against the ‘Request Profile’ to Create a new profile.

iii.     Same steps needs to be repeated for the Response.

Provide name to your New Profile, then click on the ‘Import’ button on Right side to browse through the sample XML file from your machine or build the XML format by using editor on screen.

4.     Save all tabs, These above steps had created client interaction layer for process which will interface with Client applications e.g. SOAPUI

Process now looks like below –

5.     Now drag a web service client connector from shapes window. Provide name to it.

6.     Click on + icon against Connection to create a new connection. Provide URLs of service provider, choose security type & ssl as applicable.

7.     Click + icon against the Operation to create new operation. Provide name, then click on ‘Import’ button to import details from connection which was created in previous step.

This will connect to Provider and browse the objects from it. Choose the object the click Next.

It will load the details and create new profiles for the Request and Response based on provider format. Click on Finish to Close window. Save all changes.

8.     Now process looks like below

9.     Now from Shapes window, Drag a Map shape. We need to create mapping from Input payload to Provider payload. Provide name to Map shape 

10.     Click on the + icon against Map tab to create new map. Provide name to mapping file.

 Then Choose Source and Destination profiles which were already created. Then click Ok 

11.     Map the fields as necessary or use the functions if needed. Once completed click Save.

12.     Repeat step 9 to 11 for the Response mapping.

13.     Now the process looks like below

14.     Now connect the shapes in order of message flow. Notice the Red arrow marks will turn to green.

15.     Drag a ‘Return Document’ shape from pallet connect the Response map wire to it. This will send response back to Client application.

16.     Save all changes, go to ‘View Deployments’ and deploy it to Atom. Now it is ready for testing.

4                    Run-Time Configurations

1.1                Testing the Service

1.     Export service wsdl file from https://test.connect.boomi.com/ws/soap?wsdl

It would ask for credentials. Provide the Boomi InstanceId as Username and Token as Password. Details can be accessed via ATOM management page.

Once WSDL opens, Save it to machine.

2.     Create SOAPUI Project, Browse WSDL which is saved earlier.

3.     Open request, go Auth Tab, Add basic Authentication using same credentials which were used earlier. Execute the request.

1.12               Instance Tracking in Boomi

1.     Go to Process Reporting under Manage tab, to see the recent instances

2.     Click on the timestamp to check the details

3.     Choose the connectors to check the information in fine details

Thats all for it.