The Agiloft connector makes it easy to exchange data between  and applications on the Boomi platform. When you've connected the two systems, you can configure your connector to do any or all of the following:

If multiple users need to work with the connector on the Boomi platform, or if one user needs to connect to multiple KBs, configure a connector for each user-KB combination.

To install and configure this connector, you need:

  • The name, domain URL, and login credentials for the KB
  • Web services enabled in , with the user's group listed in the "Groups allowed for REST" field in Setup > System > Manage Web Services
  • Familiarity with the REST Interface documentation

Set Up the Connector

First, set up the connector in Boomi.

  1. Log in to the Boomi platform and open the integration Atom Sphere. If you haven't configured one yet, go to Manage > Atom Management, click New, select "In the Cloud," and create a new atom.
  2. Under the Component header on the Welcome tab, click Connection.
  3. Click Create.
  4. In the Settings tab that opens, complete the fields with your REST API details (Where do you find this?):
  5. Click Test Connection to make sure your settings are correct, valid, and functioning. 
    1. If the test is successful, click Save.
    2. If the test isn't successful, check the information you entered in step 3 and then test the connection again.
  6. Click Save to return to the connector setup.

Now, you are ready to configure one or more operations. You can configure operations for the connector by clicking the plus icon next to the Operation field, or you can use other options in Boomi to add operations in other contexts, such as Process Calls.

Configure Operations

The operations you set up in the connector determine what actions can be taken to retrieve, exchange, and update data.

  1. If you haven't already, log in to the Boomi platform and open the integration Atom Sphere.
  2. Under the Component header on the Welcome tab, click Connector Operation.
  3. Click Create.
  4. Configure the settings according to the operation you want to configure. For details, see the sections below for specific operators.

After you create a Connector Operation, place it in a Boomi process to put it to use. Each operation listed below includes an example process you can use as a model.

Get Operation

Follow these steps to configure a Connector Operation to use the GET operation:

  1. In the Connector Action field, select GET.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Response Profile field, select the GET response profile for the appropriate object.
  4. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we use a Message shape to build a GET operation request to find the ID of a requested record, set as a parameter. That request is passed using the Agiloft Connector GET operation. The ID result is returned in JSON format. The Notify shape outputs the result response code and message.

For reference, the Message shape uses these parameters in this example:


GetChoiceListId Operation

Follow these steps to configure a Connector Operation to use the GETCHOICELIST operation:

  1. In the Connector Action field, select GETCHOICELIST.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the GETCHOICELIST request profile for the appropriate object.
  4. In the Response Profile field, select the GETCHOICELIST response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.


In this example process, we use the GETCHOICELISTID operation to retrieve the ID of the Choice list item "On Vacation" used in the "Working Status" field of the Employee table. First, we use a Message shape to construct the request using the JSON GetChoiceListId Request Profile. Then, we use the Agiloft Connector operation to send the request and receive the ID in the JSON GetChoiceListId Response Profile format.

For reference, the Message shape uses these parameters in this example:


Query Operation

Follow these steps to configure a Connector Operation to use the QUERY operation:

  1. In the Connector Action field, select QUERY.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Response Profile field, select the QUERY response profile for the appropriate object.
  4. In the Error Behavior field, you can choose whether to return error responses when running the operation.
  5. In the Saved Search field, select the saved search used for the query.

In this example process, we query all Employee records in the KB for records where the "email" field contains "gmail" in the value. This filter is set in the Parameters tab. The returned value is presented in JSON Query Response Profile.

For reference, the Start shape uses these parameters in this example:


Retrieve Attachment Operation

Follow these steps to configure a Connector Operation to use the ATTACH_RETRIEVE operation:

  1. In the Connector Action field, select ATTACH_RETRIEVE.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the ATTACH_RETRIEVE request profile for the appropriate object.
  4. In the Response Profile field, select the ATTACH_RETRIEVE response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we first use a Message shape to create the input data for the ATTACH_RETRIEVE operation. Then, we use the Agiloft Connector shape to use the ATTACH_RETRIEVE operation to get the attachment in the form of a JSON Retrieve Attach Response Profile. We then use another Message shape to extract the file data. The attachment is received in Base64, so we have to decode the value. Finally, in this example, we save the file locally using a Disk Connector.

For reference, the first Message shape uses these parameters to create the operation's input data:

The second Message shape uses these parameters to extract the file data:


Create Operation

Follow these steps to configure a Connector Operation to use the CREATE operation:

  1. In the Connector Action field, select CREATE.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the CREATE request profile for the appropriate object.
  4. In the Response Profile field, select the CREATE response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we first use a Message shape to describe the record we want to create, using the JSON Create Request Profile. This data is passed using the Agiloft Connector CREATE operation, and the operation produces a JSON Create Response Profile when the process completes.

For reference, the Message shape uses these parameters in this example:


Update Operation

Follow these steps to configure a Connector Operation to use the UPDATE operation:

  1. In the Connector Action field, select UPDATE.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the UPDATE request profile for the appropriate object.
  4. In the Response Profile field, select the UPDATE response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we first use a Message shape to create a sample record and update, compatible with the JSON Update Request Profile. This is sent using the UPDATE operation to the KB, which returns a JSON Update Response Profile.

For reference, the Message shape uses these parameters in this example, with a placeholder record ID:


Delete Operation

Follow these steps to configure a Connector Operation to use the DELETE_RECORD operation:

  1. In the Connector Action field, select DELETE_RECORD.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the DELETE_RECORD request profile for the appropriate object.
  4. In the Response Profile field, select the DELETE_RECORD response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we use a Message shape to construct the request, compatible with the JSON Delete Request Profile. We then pass the request into the DELETE operation


Attach Operation

Follow these steps to configure a Connector Operation to use the ATTACH operation:

  1. In the Connector Action field, select ATTACH.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the ATTACH request profile for the appropriate object.
  4. In the Response Profile field, select the ATTACH response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we first retrieve a sample logo.png image from a Google website and then encode it in Base64 format as a string. In the Message shape, we build a JSON Attach Request to send to the KB. The Agiloft Connector shape uses the ATTACH operation to attach the encoded file to the specified record in the Employee table. Afterward, it returns the JSON Attach Response Profile.

For reference, the Message shape uses these parameters in this example:


Remove Attachment Operation

Follow these steps to configure a Connector Operation to use the ATTACH_REMOVE operation:

  1. In the Connector Action field, select ATTACH_REMOVE.
  2. On the right-hand side, click Import.
    1. Select your KB connection.
    2. If you want to import only some of the available objects, enter a keyword in the Filter field. For example, to import only Contract table objects, enter "contract" in the Filter field.
    3. Click Next.
  3. In the Request Profile field, select the ATTACH_REMOVE request profile for the appropriate object.
  4. In the Response Profile field, select the ATTACH_REMOVE response profile for the appropriate object.
  5. In the Error Behavior field, you can choose whether to return error responses when running the operation.

In this example process, we create the JSON Remove Attach Request Profile in a Message shape and send it using the ATTACH_REMOVE operation. Afterward, it returns the JSON Remove Attach Response Profile.

For reference, the Message shape uses these parameters in this example, leaving placeholders for the values: