Create and compare scenarios

At a glance

A scenario is an isolated sandbox that lets you modify your data virtually, without impacting production. Add mutations (property modifications), evaluate the cascading impact on related entities, then compare multiple scenarios side by side to identify the best option.

Before you begin

• Entity types with instances must exist in your Ontologie.
• You need the nodes.write scope to create scenarios.

Steps

Create a scenario

1. Open the Simulation module from the sidebar.
2. Click New scenario.
3. Give the scenario a descriptive name (e.g., "Supplier A price increase +10%").
4. The scenario is created empty, with a virtual copy of your current data as a reference.

Add mutations

A mutation is an individual modification on an instance:

1. In your scenario, click Add a mutation.
2. Select the instance to modify (e.g., Supplier "ACME").
3. Modify the desired property (e.g., unit_price from 100 to 110).
4. The mutation is saved in the scenario.

You can add as many mutations as needed on different instances.

tip

Mutations do not modify your actual data. They are isolated within the scenario and will only be applied if you explicitly decide to do so.

Evaluate impact

After adding your mutations, evaluate the cascading impact:

1. Click Calculate impact.
2. The system analyzes the effects of your modifications on related entities:
   • Which downstream entities are impacted?
   • Which KPIs change?
   • What is the delta compared to the reference?
3. Review the impact summary with before/after indicators.

Compare scenarios

To compare multiple scenarios side by side:

1. Click Compare in the toolbar.
2. Select 2 or more scenarios to compare.
3. The comparison view displays:

Column	Description
KPI	The measured indicator.
Reference	The current value in production.
Scenario A	The value in scenario A.
Scenario B	The value in scenario B.
Delta	The difference in absolute value and percentage.

4. Improvements are shown in green, regressions in red.

Organize into portfolios

Group your scenarios into portfolios for structured management:

1. Click New portfolio.
2. Name it (e.g., "Q2 2026 Evaluation").
3. Add the relevant scenarios to the portfolio.
4. View the portfolio overview to compare all included scenarios.

Apply a scenario

When you have identified the best scenario:

1. Open the validated scenario.
2. Click Apply to production.
3. Confirm the operation.
4. The mutations are executed on your actual data.

caution

Applying a scenario is irreversible. If an approval policy is active, a validation request will be generated automatically.

Discard a scenario

If a scenario is no longer relevant:

1. Open the scenario.
2. Click Discard.
3. The scenario and all its mutations are deleted.

Expected outcome

You have created one or more hypothetical scenarios, evaluated their impact on your KPIs, and compared options side by side. You can apply the chosen scenario to production or discard it without consequences.

Limitations and common errors

Situation	Solution
"No instances available"	First create instances in the Ontologie.
Impact does not propagate	Verify that relationships exist between your entity types.
"Scenario already applied"	A scenario can only be applied once. Create a new one.
KPIs do not change	Verify that your mutations affect properties used in KPI calculations.

Need help?

Contact us: Support and contact.