Boomi

Introduction

Couchdrop's Boomi connection allows you to send files to Boomi process via a webhook, and trigger the process execution

Requirements

To set up a Boomi connection, you will need the following:

• Access to Couchdrop, with the appropriate user rights. Talk to your admin to get these.

• Access to Boomi, with the ability to configure Standalone flows with a webhook trigger.

Configuration Steps in Boomi

To transfer a file from Couchdrop to Boomi to be used in a process you need to:

1. Create a new process

2. Create a new connector within that process

3. Package up the process and connector

4. Deploy to an environment

Creating a new Process

1. Click on the Integration Tile on the Boomi Home (or click the blue plus icon and click on Application & Data Integration), this will take you to the Integrations Home.

2. Click on the Home icon, and click Build an Integration (Create a New Process)

3. Enter a name for your new process e.g. Couchdrop File Processor and choose Web Services Server as the Connector Type

Creating a new Connector

1. Click the green plus icon next to the Operation field in your new Process

2. This will open a new tab to configure the connection the new Process will use for a new connection and change the operation type to CREATE

3. Name the Object as something relevant e.g. incoming-file-from-couchdrop

4. The Simple URL path is the Endpoint that you need to enter into the Couchdrop Boomi connection

5. Once you have created your Process and connector for Couchdrop you need to package it up and deploy it.

Packaging Components (Process, Connector etc)

1. Click on Packaged Components under Deploy click on Create Packaged Component

2. Select your new Process and click Next: Add Details and click Create Packaged Component

Deployment

1. This will then prompt you to deploy the newly packaged componenet to an environment

2. Choose the Environment and click Next: Select Versions, followed by Next: Review and Deploy you should get a Deployment Successful message

3. Next click on Manage>Runtime Management and click on the Environment you deployed the components to

4. Under Information click on Shared Web Server, this will provide you with the following which you need to enter into Couchdrop:

   1. Base URL for API Requests (Environment API URL in Couchdrop)

   2. Username and Token (Please Note: If you use the API Type: Basic, the username will be the account ID associated with the Boomi admin email address, otherwise you'll need to use one of the existing users or create a new user under the User Management tab of the Shared Web server settings in the Environment you are deploying to.

Please Note: The max file size is less than 5MB

Configuration Steps in Couchdrop

Once you have created your process in Boomi, you need to configure it as an outbound storage integration in Couchdrop.

To do this:

1. Login to Couchdrop

2. Click on Connections under Outbound, choose Boomi and complete the following fields

3. Enter a name for the integration you will use to find and manage this integration

4. Enter a name for the folder (This will create a new Couchdrop storage folder that will send files to your Boomi process when a new file is uploaded into it).

5. Enter the information from your Boomi process:

   1. Environment API URL: This is found under Manage>Runtime Management>Environment>Shared Web Server>General

   2. Endpoint: This is the endpoint that Couchdrop will send the file, and can be found under the Web Services Server Connector>Options specified in the Boomi Process Operator

   3. Username: This is username that Couchdrop will use to authenticate and pass the file to the Boomi process. It can be found under the environment settings where the Process is deployed to: Manage>Runtime Management>Environment>Shared Web Server>User Management.

   4. Token: This is also found under Manage>Runtime Management>Environment>Shared Web Server>User Management