Configuration Scope: Environment-Specific
This setting is environment-specific and must be configured separately in each environment (dev, test, prod). Changes here will not be included in configuration exports.
Controlling How Records Open from the Dashboard
Overview
When a user clicks a record on the Brief Connect dashboard, the system decides whether that record opens in the current browser tab or in a new tab.
This behaviour is governed by one environment variable on the server.
By default records open in the current tab. Administrators can enable the "open in new tab" experience by changing the variable described below.
Configuration
| Environment Variable | Accepted Values | Default |
|---|---|---|
OpenDashboardRecordsInNewTab |
true or false |
false |
How to Change the Setting
- Go to the Function App / Web App that hosts your Brief Connect server.
- Navigate to Settings → Configuration → Application settings (may also be called Environment Variables).
- Add (or edit) a key named
OpenDashboardRecordsInNewTab. - Set its value:
true– records open in a new tab.false– records open in the current tab.- Save and restart the app to apply the change.
Expected Results
false(default): Clicking a record replaces the dashboard in the same browser tab.true: Clicking a record opens it in a brand-new tab, leaving the dashboard visible in the original tab.
Troubleshooting
| Issue | Resolution |
|---|---|
| Setting has no effect | Confirm the key is spelled exactly OpenDashboardRecordsInNewTab, restart the app, then hard-refresh the browser (Ctrl + F5). |
| Still seeing old behaviour after restart | Check you edited the correct deployment slot (e.g., Production vs. Staging) and that the value isn’t being overridden by a deployment pipeline. |