Simulating the State Model
Overview
In this article, you can find information on how to run a simulation of your state model in Apporetum. Simulations allow you to test your draft state model and validate the behaviour of your states, transitions, and rules in a safe environment before publishing.
We strongly recommend running a simulation before publishing your state model. Once a state model is published, it cannot be edited and will immediately govern your identity landscape.
Running a Simulation
- In the Apporetum navigation menu, select Identity, then select State Model.
- Select Open on the right-hand side of the state model you want to simulate.
- Select Simulate next to Configure.
- Select Simulate to begin configuring the simulation run.
Simulation Options
Apporetum provides three options for configuring a simulation run.
Single run — the default mode. Apporetum runs a single iteration of the state model against your current identity data.
Multi — select Multi, then choose an iteration count between 2 and 10. Apporetum runs the state model the specified number of times in sequence, allowing you to observe how accounts progress through multiple transitions over time.
Point In Time — select Point In Time, then select a date and time. Apporetum simulates the state model as if it were executing at the specified date and time. Use this option to test time-based transitions or to prepare for known future workforce events such as end of financial year or a planned organisational restructure.
Once you have configured your options, select Start. The simulation will begin running, and you can select the arrow to step through each stage of the results.
Interpreting Simulation Results
Apporetum uses colour coding on state indicators to show account movement during the simulation.
| Colour | Meaning |
|---|---|
| Blue | The number of accounts in this state has not changed. |
| Green | The number of accounts in this state has increased. |
| Red | The number of accounts in this state has decreased. |
Reviewing State Results
When you select a state in the simulation results view, Apporetum displays the following information.
Accounts — all accounts currently in the selected state following the simulation run.
States — detail for each state in the run. Selecting Actions from this view shows which transitions move accounts to or from the state, and any self-connected transitions.
Transitions — the triggers and actions configured for each transition within the selected state.
Selecting a state in the results view directs you back to the state detail in the model configuration. This allows you to quickly review and adjust your configuration if the simulation reveals unexpected behaviour.
Simulating the Published Model
Simulations can also be run against the published state model. To do so, select Open on the published model and then select Simulate next to Track. This is useful for validating expected outcomes before scheduling a production run.