- 4 minutes to read

Manage Domains

Domains are the organizational boundaries, such as departments, business units, or teams, that form the swimlanes of your Business Process Models (BPMs). One Domain can be reused across many BPMs, so a wrong or duplicate Domain shows up everywhere. This page shows how to keep the Domain list clean and correct.

  • ✅ Add and edit Domains
  • ✅ Delete Domains you no longer use
  • ✅ Restore deleted Domains if you change your mind

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

Understanding delete and restore

Delete in Nodinite is a soft delete: the Domain is flagged as deleted and hidden from the list, but it stays in the database, so you can restore it. If a deleted Domain is used in a BPM, that swimlane shows as missing until the Domain is restored. See Show deleted records for how this works across Nodinite.

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

A Domain's life after Delete. Green: active. Yellow: deleted, and anyone who may modify Domains can restore it. While a Domain is deleted, the BPM swimlanes that use it show as missing. See Show deleted records.

Who can do what

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

These actions also work 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 Domains row; Create and Modify sit on the Domains Permissions for all row. A Deny in any of the user's Roles always wins.

Find the Domains list

Open Administration > Repository Management > Domains, or Repository > Domains. From Administration, clicking a Domain opens it for editing; from Repository, it opens it for viewing. Type in the filter box to narrow a long list, filter by Custom Metadata New 7.2, and check Include deleted to list deleted Domains too.

Domains list with the filter box and a filtered list of Domains
Use the filters and Include deleted to find the Domain you want to manage.

Add a Domain

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

You can also create Domains inline while you build a BPM in the BPM Designer.

Tip

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

Edit a Domain

Click the Domain's Name in the Administration list, or choose Edit from its Action menu. See Add or manage Domain.
Action menu of a Domain with Edit highlighted
Choose Edit to change an existing Domain.

The Action menu

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

  • View opens the Domain read-only.
  • Edit opens the Domain in the editor.
  • Delete on an active Domain; Restore on a deleted one.

The menu of an active Domain also shows Duplicate.

Action menu of a Domain with View, Edit, Duplicate, and Delete, with Delete highlighted
The Action menu of an active Domain. The items you see depend on your Role and on whether the Domain is deleted.

Delete a Domain

  1. Choose Delete from the Domain's Action menu.
  2. In the confirmation dialog, check the name, then click Yes to proceed.
    Confirm intent to Delete dialog for a Domain
    The dialog shows which Domain you're about to delete.
  3. A success message confirms that the Domain is deleted.
    Success message confirming that the Domain was deleted
    The deleted Domain disappears from the list until you check Include deleted.

Restore deleted Domains

  1. Check Include deleted to list deleted Domains.
  2. Open the Action menu of the deleted Domain and choose Restore.
    Action menu of a deleted Domain with View, Edit, and Restore, with Restore highlighted
    Restore appears only on deleted Domains.
  3. In the confirmation dialog, check the name, then click Yes to proceed.
    Confirm intent to Restore dialog for a Domain
    The dialog shows which Domain you're about to restore.
  4. A success message confirms that the Domain is restored.
    Success message confirming that the Domain was restored
    The restored Domain is back in the list, and its BPM swimlanes show again.

Copy API URI

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

Frequently asked questions / Troubleshooting

I deleted a Domain by mistake. Can I get it back?

Yes. Check Include deleted, then restore it.

A swimlane is missing in a BPM

The Domain behind it is probably deleted. Check Include deleted in the Domain list and restore the Domain.

Next Steps

Add or manage Domain
Manage BPMs
Show deleted records
Manage the Repository

Domains - What a Domain is
Domain Overview - Find and view Domains
Business Process Model (BPM)
Permission Set for the Repository Model
Custom Metadata
Log Audit Search - See who deleted or restored what