By default, Atrium does not prompt when users attempt to navigate away, close, or refresh their browser running an Atrium session. When a user leaves the Atrium page, each Atrium tab containing a Profound UI session is closed and unloaded.
You can setup atrium to prompt a user before leaving a page, and many browsers allow you to customize the prompt.
This configuration option is available as of Profound UI Version 5, Fix Pack 3.3.
There are 4 modes of prompting available for when the user attempts to close or navigate away from Atrium:
- 0: Never prompt.
- 1: Prompt only when Atrium tabs containing Profound UI sessions are open.
- 2: Prompt when any tabs are open.
- 3: Always prompt, even if no tabs are open.
Next, you can decide to prompt the user only when Atrium tabs are running session of Profound UI. For this mode of prompt, add this line to the file:
Atrium.promptCloseBrowser = 1;
Use a value of 0, 1, 2, or 3, depending on how much prompting you want.
The default prompt is "Unsaved changes to the session(s) will be lost". (Firefox does not display a custom message.)
The end developer may override the message by defining these strings in the Atrium Extension file, e.g. /YourInstanceName/userdata/extension/atrium/yourcode.js:
Atrium.closeBrowserMessage= "Are you sure you want to leave Atrium?";
The custom prompt string is available with Profound UI Version 5, Fix Pack 4.0.