Summary

Within the Administration > System Settings component exists a number of advanced system configurations that are used by features across the application. These configuration settings are implemented by the Foundry Health engineering team and managed by superadmin users.

...

As certain customer environments receive configuration changes or new builds of ClinSpark over time, previously saved system settings are carefully reviewed and updated.

Configurations managed in project source

An incredibly powerful aspect of ClinSpark is the ability to customize reports and dashboard components in both a modular and controlled way.

...

Foundry Health maintains ‘least common denominator’ settings that are automatically pushed to environments upon initial deployment. During customer onboarding these are commonly referred as ‘bootstrapped’ configurations which are provided to all customers by default. In the example of password reset, this would include the default email template used when sending password reset emails, when customers accept that build into an environment.

Synchronization States

A synchronization feature is available to superadmin users through a set of visual cues and descriptors that reflect the known state of a given configuration. These are important to understand as they serve a different purpose and meaning depending on the state of the environment, and, what actions can be taken against the configuration.

Date & Time Last Updated

Each configuration will show a date and time value that’s associated with certain “last updated” context. These date and time values help users know the current state of the configuration, and, if action is necessary to update further.

Database Last Update

This represents the datetime that the setting which is currently saved and active in the system was last updated. If there have not been any manual updates made to this setting, this datetime most likely matches the datetime when the latest build was deployed to that environment.

...

However, if a superadmin user made an update to a configuration (possibly requested in a recent service desk ticket), this datetime would then correspond with the most recent save done against the configuration (same datetime as the ‘save’ audit record).

Configuration Last Update

This represents the datetime when the setting was last updated as it is currently present in the deployed WAR file.

...

Often this datetime corresponds with when the configuration was last changed and updated as part of the project source code. Global configurations that are updated from project source eventually make their way into WAR files that are deployed to environments and made available to customers.

Status messages

Each configuration will display to users a status message indicating if action is required. Each configuration should be looked at carefully with each status message to determine what the appropriate action is.

Configuration Synchronized

...

This status message indicates that no action is required. It confirms that the currently saved and active configuration within the database matches that of the configuration within the deployed WAR file.

The last update datetimes do not need to match or be in ‘sequential’ order for a config to be properly synchronized. What already exists in the database may not be newer than what is currently available in the deployed WAR.

Update Required

...

This status message indicates that there is possible action needed. The currently active configuration setting in the database may need to be updated with a more recent one found in the deployed WAR.

...

Once this action has been completed successfully, users can see now that the setting is synchronized. Old and new script values are maintained in the audit trail, so previous values can be restored if needed.

Component/Setting Not Mapped

...

This status message informs users that a configuration exists in the database, but it’s not mapped to any known configuration within the deployed WAR file. While there may not be any action to be taken for this, the presence of unknown configurations could be addressed with engineering help to determine if any action is required.

...

There may also be customer specific or “one off” requests for things like Dashboard components or Reports that get added to specific environments but not elsewhere. Since these exist as a unique configuration, they may not be mapped to the global configurations maintained within project source.

Save Required

...

This status message alerts superamins to the fact that a configuration setting exists in the deployed WAR, but it’s not yet saved to the database, and therefore is not visible or accessible to customers.

...