- 4 minutes to read

Manage Integrations

Integrations are the root of the Repository Model: they document how your systems exchange messages in business flows. Logging creates many of them automatically, so over time the list collects test entries and Integrations nobody uses anymore. This page shows how to keep the list clean and correct.

  • ✅ Add, duplicate, and edit Integrations, and lay them out in the Integration Landscape
  • ✅ Delete Integrations, and restore them if you change your mind
  • ✅ Export Integrations and copy the API URL for custom reports

On this page, an administrator, or a user whose Role may modify Integrations, learns to manage the Integration list. Business users who only look up Integrations start with the Integration Overview instead.

Understanding delete and restore

Delete in Nodinite is a soft delete: the Integration is flagged as deleted and hidden from the list, but it stays in the database, so you can restore it. See Show deleted records for how this works across Nodinite.

flowchart LR Active["fa:fa-puzzle-piece Integration"] Deleted["fa:fa-trash-can Deleted
soft delete"] Active -->|"Delete"| Deleted Deleted -->|"Restore"| Active style Active fill:#93d16d style Deleted fill:#FFD525

An Integration's life after Delete. Green: active. Yellow: deleted, and anyone who may modify Integrations can restore it. See Show deleted records.

Who can do what

Action Who can do it Can you undo it?
Add or duplicate an Integration Create on Integrations in the Role ✅ Yes, delete it
Edit an Integration Modify on Integrations (Permission Set for the Repository Model) ⚠️ No version history; change it back by hand
Delete an Integration Modify on Integrations ✅ Yes, restore it
Restore an Integration Modify on Integrations ✅ Yes, delete it again

Everything also works from the Repository menu for users whose Role allows it; the Administration menu needs the built-in Administrator Role.

Every right is set per Role on its Repository Permissions tab. Users first need the global Access right on Repository (Repository Access), then Access on the Integrations row; Create and Modify sit on the Integrations Permissions for all row. A Deny in any of the user's Roles always wins.

Find the Integrations list

Open Administration > Repository Management > Integrations, or Repository > Integrations. From Administration, clicking an Integration opens it for editing; from Repository, it opens it for viewing.

Integrations list with the filter box, the Include deleted Integrations checkbox, Filter by Custom Metadata, Copy API URL, and Add Integration
Use the filter box, Filter by Custom Metadata, and Include deleted Integrations to narrow the list before you change anything.

Add an Integration

Click Add Integration to open the editor. See Add or manage Integration for every field.
Add Integration button
The Add Integration button opens the Integration editor.

To start from an existing Integration instead, choose Duplicate from its Action menu to clone it.

Tip

You can also manage Integrations from DevOps pipelines with the Nodinite Web API.

Edit an Integration

Click the Integration's Name in the Administration list, or choose Edit from its Action menu. See Add or manage Integration for every field.

Edit the Integration Landscape

Click Integration Landscape to open the graphical editor, where you edit and view Integrations visually. See Working with the Integration Landscape.

The Action menu

Click Action on a row to open the Action menu for that Integration:

  • Show Landscape opens the Integration in the Integration Landscape.
  • Show in Mapify and Show in Mermaid draw the Integration and its relations in Mapify Rendering or as a Mermaid Rendering diagram.
  • Edit opens the Integration in the editor, and Duplicate creates a copy of it.
  • Delete on an active Integration; Restore on a deleted one.
  • Export opens the Export wizard.

Action menu of an Integration with Show Landscape, Edit, Duplicate, Delete, and Export
The Action menu of an active Integration. A deleted Integration offers Restore instead of Delete.

Delete an Integration

Choose Delete from the Integration's Action menu. The Integration disappears from the list, and you can restore it later.

Restore a deleted Integration

  1. Check Include deleted Integrations to list deleted Integrations.
  2. Open the Action menu of the deleted Integration and choose Restore.

The restored Integration is back in the list. See Show deleted records.

Export an Integration

Note

Import/Export is disabled in Nodinite 7.0. Use the Web API to move data between instances for now.

Choose Export from the Integration's Action menu to open the Nodinite generic Export wizard.

Copy API URL

Click Copy API URL to see the underlying REST call to the Web API and copy the query string. Use it in custom Reports, automation scripts, BI dashboards, or DevOps pipelines.

Frequently asked questions / Troubleshooting

I deleted an Integration by mistake. Can I get it back?

Yes. Check Include deleted Integrations, then restore it.

How do I design Integrations using the Integration Landscape?

Follow the steps in Working with the Integration Landscape.

Next Steps

Add or manage Integration
Working with the Integration Landscape
Show deleted records
Manage the Repository

Integrations - What an Integration is
Integration Overview - Find and view Integrations
Permission Set for the Repository Model
Log Audit Search - See who deleted or restored what
Mapify Maps