Creating a New Adapter

You can create new adapters (CSV/JSON/SQL Server only), each with its own unique pages and the same standard features that can be found in all adapters.

The system allows you to create up to 10 customized instances within each CSV/JSON adapter and up to 30 within each SQL Server adapter (50 in total). In the event that more custom adapters are needed, contact Axonius Support.

You can upload your own logo for each custom adapter you create. If you do not upload a logo, each custom adapter is associated with the default logo for the source adapter (for example, the Axonius CSV/JSON/SQL Server adapter logo).

Custom adapters are displayed in the "Custom Adapter" category.

Creating a New Adapter

To create a new adapter, do the following:

1. In the left navigation panel, click the Adapters icon. The Adapters page opens.
2. At the top of the Adapters page, click Create New Adapter.
3. The Create New Adapter drawer opens.

Setting New Adapter Parameters

Configure the required settings for the new adapter.

1. Adapter Name - Enter a name for your adapter. Note that the adapter name must be unique.
2. Source Type - Select the source type from the dropdown, either CSV, JSON, or SQL Server.
3. Adapter Logo - Upload an adapter logo. To add your adapter logo, click Upload File. Note that only SVG files are supported.
   • When the file upload is complete, the logo appears next to Create New Adapter at the top of the drawer.
4. Adapter Description - Enter a description for the adapter.
5. Adapter Categories - Select one or more adapter categories from the dropdown.
6. Asset Types - Select one or more asset types from the dropdown.
7. Click Create Adapter. The adapter is now added to the system.
8. From the Search Categories dropdown at the top of the Adapters page, click Custom Adapter. The new adapter card now appears.

9. You can click on the adapter card to open the Adapter Profile page.

Editing a Custom Adapter

You can open your custom adapter and edit the name, source type, logo, description, categories and asset types.

1. To edit the new adapter, hover over the adapter card. From the 3-dot menu, choose Edit Adapter. You can also click on Edit Adapter at the top of the Adapter Profile page.

   

   [SCREENSHOT TO REFRESH - Creating a New Adapter: adapter profile menu may now include a delete option]

2. The Edit Adapter drawer opens.

3. Edit one or more of the fields and click Save.

Deleting a Custom Adapter

Delete a custom adapter that you no longer use to free its custom adapter slot.

A custom adapter is unused when it has no connections and no assets, and no queries, charts, Enforcement Sets, workflows, or data scopes reference it. Only Admins can delete a custom adapter. You can't delete built-in adapters.

To delete an unused custom adapter, open the options menu of the adapter card (or of the Adapter Profile page) and select the delete option. If the adapter is in use, Axonius doesn't delete it and shows the reasons.