Skip to content

Entity Versioning

Negroni maintains a version history for each entity, recording snapshots of the entity's definition over time. This allows you to track attribute changes, relationship changes, and structural evolution across releases.

How Versioning Works

Versions are recorded when an entity's content changes. Each version captures the full entity definition — attributes, relationships, and metadata — at a specific point in time.

Both core entities and custom entities are versioned. Core entity versions are tracked automatically when the library is updated.

Viewing Version History

To view all versions of an entity:

  1. Open the entity by clicking it in the Project Navigator.
  2. Click the Manage Versions Manage Versions button in the center view.
  3. A modal will open showing the full version history.

Viewing Entity Content at a Specific Version

  1. Open the entity detail view.
  2. Use the Version dropdown in the right-side Properties panel.
  3. The view automatically switches to the selected version.

Creating a Version

  1. Open the :Manage Versions Manage Versions modal.
  2. Click to create a new version.
  3. Confirm version creation.

Deleting a Version

  1. Open the Manage Versions Manage Versions modal.
  2. Click Trash on the version row.
  3. Confirm deletion.

Deletion Rules

  • If the deleted version is the currently active/live version, Negroni will automatically roll back the entity to the most recent available version.
  • If the deleted version is the only remaining version, it will be hard deleted.
  • Otherwise, the version snapshot is removed normally.

Deleting a version never breaks the entity state — it always remains valid.

Relationship to Manifest Versioning

Entity versions are also captured when a manifest version is created, ensuring full traceability.

See Manifest Versioning.