L
Leaphealth - OSDocs

Config history and rollback

See every saved version of your System Settings, read old snapshots, and restore earlier values.

Every time a System Settings tab is saved, LeapHealthOS keeps a numbered copy of the whole tab. The Config History screen lists these versions so you can see when settings changed and what they were before. This page explains how to read the history and how to restore earlier values. It is for administrators.

Rollback does not restore settings yet

Rollback adds a new version to the history, but it does not change the settings in use. To go back to earlier values, re-enter them in System Settings as described under Restore an earlier configuration below.

Open Config History

Open the screen

Administrator

Settings > Platform Configuration > Config History

The screen is titled Configuration History.

Choose the config type

Pick SLOT ENGINE, APPOINTMENT, BILLING, REMINDER or JOURNEY. These match the System Settings tabs.

Choose the scope

Pick TENANT, CENTRE, DEPARTMENT or DOCTOR, then pick the centre, department or doctor in the box that appears.

Expected result: The versions for that tab and level are listed, newest first.

Things to know about the pickers:

  • For DEPARTMENT, the list shows departments of the centre selected in the top bar of LeapHealthOS. Switch centre there to see other departments.
  • If you have not picked a centre, department or doctor yet, you see "Select a centre to view its configuration history." (or department, or doctor).
  • If nothing has been saved for that combination, you see "No version history found".

What each version shows

On the card

Meaning

vN

Version number. It counts up separately for each tab and level

Current

The newest version for this tab and level

ACTIVE

Status of the version

CREATE, UPDATE or ROLLBACK

What produced the version: the first save, a later save, or a rollback

Date and time

When the version was saved

Reason

The reason entered. Saves from System Settings do not ask for one, so they show "No reason provided"

View snapshot

Shows everything saved on the tab in that version. Hide snapshot closes it

The card does not show who made the change or highlight what changed. To compare two versions, open both snapshots side by side.

What appears here and what does not

Appears:

  • Every save on the Slot Engine, Appointments, Billing and Journeys tabs of System Settings, at any level.
  • Every rollback.

Does not appear:

  • Slot settings and follow-up or repeat rules saved during doctor setup and on Doctor Configuration.
  • Changes on the Tenant Registry screen.
  • Changes on the Organisation tab, including escalation policies.

Restore an earlier configuration

Find the version you want

Settings > Platform Configuration > Config History

Choose the config type, scope and centre, department or doctor. Find the version and click View snapshot. Note the values you need.

Open the same tab and level in System Settings

Settings > Platform Configuration > System Settings

Open the matching tab and pick the same Config Level and centre, department or doctor.

Re-enter the values and save

Change each field to the value in the snapshot, then click Save.

Expected result: "Configuration saved successfully". A new UPDATE version appears in Config History and becomes Current. LeapHealthOS now uses these values.

In snapshots of the Journeys tab, durations appear in seconds. Divide by 3,600 for hours or by 86,400 for days before you enter them on the tab.

If someone already clicked Rollback

  • The rollback version shows Current and ROLLBACK, but the settings in use did not change.
  • System Settings always shows the settings in use. Check there, not the Current chip.
  • If the old values are still wanted, follow the steps under Restore an earlier configuration. The Reason on the rollback version tells you why someone wanted to go back.

Who can use this screen

  • Administrators who can open the Settings menu can view Config History.
  • Rollback needs the Configure permission on Settings, and you must enter a Reason for rollback.

See System Settings: a tour of every tab for how settings are saved, and How configuration is inherited for how levels combine.

config historyversionsrollbackchange historysystem settingssnapshot

Was this page helpful?

Last updated on

On this page