Skip to content

Manifest Versioning

Negroni maintains a version history for each manifest, recording snapshots of the manifest's content over time. Versioning lets you track how a manifest evolves, review past definitions, and understand which version of a manifest was in use at any point.

How Versioning Works

Each time a manifest is saved after significant changes, Negroni can create a version record capturing the full state of the manifest at that moment. Versions are associated with a version number and a timestamp.

For CDM library manifests sourced from the Microsoft CDM library or the Negroni standard library, Negroni automatically tracks upstream updates when available.

For custom manifests, versions can be created manually.


Viewing Version History

To view all versions of a manifest:

  1. Open a manifest 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 Manifest Content at a Specific Version

  1. Open the manifest 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 manifest to the most recent available version.
  • If the deleted version is the only remaining version, it will be hard deleted (no rollback possible).
  • Otherwise, the version snapshot is simply removed.

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


Version Compatibility with Entity Versioning

When a manifest version is created, the versions of its referenced entities are also recorded, ensuring full consistency across system snapshots.

See Entity Versioning.