IAP Update Configuration

Overview

Updating an adapter using the IapUpdateAdapterConfiguration call allows users to update their adapter configuration from within IAP rather than having to make changes in the file system of the adapter.

The IapUpdateAdapterConfiguration call can be used to update connection settings, credentials, or other configuration parameters of an adapter from within IAP. This includes updating crucial data such as the Endpoint Configuration (action.json, schema.json) and Mock Data. Additionally, we can update the package.json of the adapter.

This is a generic method and has the capability to be performed in most Itential adapters.

Note: There are issues with this call that affect certain Cloud customers. We are working to resolve this issue.

How to Run IAP Update Configuration in Adapters

The IapUpdateAdapterConfiguration is a task we can use in a workflow. Within the IAP application, navigate to Automation Studio and then select workflow builder. Then, under the adapter you are trying to update, add the IapUpdateAdapterConfiguration task.

The example below demonstrates using the call to update a mock data file in an adapter.

Figure 1: SwaggerPetstore IAPUpdateAdapterConfiguration Task

Figure 2. Input Definitions

An action is the task / call that has mock data that is being updated. The inputs to the task are what is needed to identify what file you want to change and what those changes will be.

In Figure 1, the IapUpdateAdapterConfiguration task would run an update in the mock data file that is specified in the first variable (configFile) - with the data placed in changes. Because we selected true for the replace variable, the previous mock data is updated with the desired changes. Otherwise, the data would be combined with the existing file. The replace variable is only used when the type is mock.

The result leaves you with the desired changes in the adapter without having to make changes in the file system.