System properties allow administrators to configure Mosaic's behaviour without changing code. Properties control features such as authentication mode, file upload limits, autosave intervals, external system integrations, and email settings. Properties are stored in the database and read by the application at startup. Changes take effect after the application is restarted.
⚠️Important: Changes to system properties can significantly affect how Mosaic behaves. Always test changes in a non-production environment before applying them to your live system.
Property types
Mosaic uses two types of system property:
Type | Description |
String properties | Text-based settings such as URLs, mode names, and comma-separated lists. |
Numeric properties | Integer or numeric settings such as limits, intervals, and counts. |
System properties reference
Feature toggles
Property | Default | Description |
Case summary enabled | On | Enables the case summary screen. |
Case chronology (adults) | Off | Enables case chronology for adults. |
Case chronology (children) | Off | Enables case chronology for children. |
Enable case history | Off | Enables the Access Evo integration. |
Cluster team enabled | On | Enables cluster team display in the work view. |
Genogram enabled | — | Enables the genogram relationship diagram on groups. |
Authentication and security
Property | Description |
Authentication mode | Sets the authentication method, for example CAS, LDAP, or OIDC. |
Two-factor authentication supplier | Selects the 2FA provider. |
CAS URL | The URL of the CAS authentication server. |
CAS service URL | This application's CAS service URL. |
CORS filter origin | Controls which origins are allowed for cross-origin requests. Set to NONE to disable. |
Restricted person mode | Controls behaviour when accessing restricted person records. |
External system integrations
Property | Default | Description |
ACG interface enabled | Off | Enables the Access Community Gateway document interface. |
SSAFA RightNow interface enabled | Off | Enables the SSAFA RightNow integration. |
SSAFA Ebis interface enabled | Off | Enables the SSAFA Ebis integration |
SSAFA Salesforce interface enabled | Off | Enables the SSAFA Salesforce integration | Off | Enables the NHS Personal Demographics Service interface. |
Enable PDS interface | Off | Enables the NHS Personal Demographics Service interface. |
CPIS unborn relationships | 10, 26, 176 | Relationship type IDs used for the CP-IS unborn interface. |
Property | Default | Description |
Email protocol | SMTP | The protocol used for sending emails |
Email authentication | Basic | The email authentication method |
Enable TLS connection | Off | Enables TLS encryption for email connections. |
Case note alerts email enabled | On | Sends email alerts when case notes are completed. |
Documents
Property | Description |
Allowed file extensions | A comma-separated list of permitted file types for upload. |
External document storage type | Controls where document files are stored: locally, in Azure, or in an external system. |
Maximum file upload size | The maximum size allowed for uploaded files. |
Performance and limits
Property | Default | Description |
Database row query limit | 1,000,000 | The maximum number of rows returned by database queries. |
Autosave interval | 0 (off) | The interval in milliseconds between autosaves in the step editor. Set to 0 to disable. |
Heartbeat interval | — | How frequently the session heartbeat runs, in minutes. |
Bulk delete screen limit | 1,000 | The maximum number of records shown on the bulk deletion screen. |
Logging
Property | Default | Description |
Client logging level | Off | Controls browser-side logging. Options include Off, Error, Warning, and Debug. |
Enable error logging to database | On | Logs application errors to the database for troubleshooting. |
Enable next actions save logging | Off | Enables additional logging for workflow next action saves. |
Framework properties
A small number of settings are configured at deployment time through a framework properties file rather than through the database. These include:
Database type - identifies whether the deployment uses Oracle or SQL Server.
Case note timeout interval - how long a case note can remain in draft before it is marked as timed out.
Lock reuse strategy - how session locks are managed.
📌Note: Framework properties are fixed at deployment time and cannot be changed through the Mosaic interface. Contact your system administrator if these need to be adjusted.
Welsh language support
Mosaic supports Welsh language throughout the interface. When Welsh language is enabled, labels, messages, and validation text display in Welsh where configured. The localisation settings are managed separately from system properties.
📌Note: For more information on Welsh language support and localisation, contact your system administrator.