Skip to main content
Version: Angophra

Configuring the State Model

Overview​

In this article, you can find information on how to create and configure a state model in Apporetum. This includes creating a draft, adding states, configuring transitions, and publishing the model.

tip

We recommend running a simulation before publishing your state model. See Simulating the State Model for guidance.

State Model Versions​

Apporetum maintains two versions of the state model at any time.

Published State Model — the active model currently governing your identity landscape. Select Open to view the model, then use Track to follow account progression through states and Results to inspect the detail for each state. You can also run simulations against the published model by selecting Simulate next to Track.

Draft State Model — a working copy that can be edited freely without affecting the published model or production data. Select Open to continue editing an existing draft.

Creating a Draft State Model​

If you do not yet have a draft, follow these steps to create one.

  1. In the Apporetum navigation menu, select Identity, then select State Model.
  2. Select Create on the right-hand side of Model Versions.
  3. Enter a name for the draft and select Save Changes.
info

You can only have one draft at a time. Creating a new draft will remove the previous draft. The new draft uses the current published model as its starting template.

Adding States​

  1. In your draft state model, select Add State in the upper right corner.
  2. Enter a name for the state. Description and Icon are optional — the icon picker provides both colour and icon options.
  3. Select Save Changes.
note

Apporetum provides two built-in Model Entry Points: one for accounts found during the sync process, and one for newly added accounts. These entry point states cannot be removed, and accounts cannot be manually moved into them.

New states appear at the bottom of the state order after they are saved.

Viewing State Details​

When you select a state, Apporetum displays the following information:

  • From this state — transitions that move accounts from the current state to another state.
  • To this state — transitions from other states into the current state.
  • Self connected — transitions that return an account to the same state.

You can also Add transition and Reorder transitions from the state detail view.

Adding a Transition​

  1. Select a state, then select Add Transition.
  2. Complete the General tab:
    • Select the destination state from the To (Destination) field.
    • Apporetum sets the transition status to Disabled by default. Select the status toggle to enable it. Transitions left in a disabled state will remain disabled when the model is published.
    • Enter a name for the transition. A description is optional.
  3. Configure the Triggers tab to define the rules that will activate this transition. See Configuring Transition Rules for details.
  4. Configure the Actions tab to define the automated tasks that will run when the transition fires. See Configuring Actions for details.
  5. Select Save Changes.

Publishing the State Model​

Once you have completed your draft and validated it with a simulation, you are ready to publish.

  1. Select Publish Model in the upper right corner of the draft state model.
  2. Apporetum will prompt you to confirm that you have run simulations before proceeding. If you are confident with the configuration, select Publish Model.
warning

Once a state model is published, it cannot be edited. The published model becomes the active configuration governing your identity landscape. We strongly recommend running a simulation before publishing.

tip

Build a break-glass state model as early as possible. Accounts that do not match any transition rule will not move between states, and a break-glass state positioned near the front of the order provides a safe fallback for edge cases.