Introduction

There is a maximum limit on the number of tabs that can be opened per section of an application. The system administrator can configure this limit by updating the curam.environment.max.open.tabs property in the system administration application. The default value for the maximum limit of open tabs per section of an application is set to fifteen.

If a user requests to open a tab and the number of open tabs reaches the maximum limit within the current section then an informational modal dialog will be displayed immediately after the tab is initially opened (before content in the tab is displayed). As instructed in this modal dialog, existing open tabs within the current section should be closed before any new tabs can be opened in an application. If the information displayed in the informational dialog is ignored and the user attempts to open more tabs within the current section of an application, the requested tabs will not be opened and an error modal dialog will be displayed instructing that new tabs can only be opened after existing open tabs within the current section of the current application are closed. An error modal dialog can simply be dismissed by clicking on the button on the bottom of the dialog.

The message and title of both the dialog can be customized by customizing by adding the GenericModalError.js.properties file within the custom component. For more information on localizing JavaScript property files, consult Java properties files.

The text on the button can be customized by changing the value of the Text.Ok property in CDEJResources.properties. For more information on localizing CDEJResources.properties, please see CDEJResources.properties.

The current set of open tabs for a particular user is restored each time the user logs out of the application and logs back in. In addition, if the browser is refreshed (e.g. using the F5 button), the currently open tabs are also restored. The only exception to this is if the the system administrator has decreased the maximum limit of tabs that can be opened within a section of an application since the termination of the last session then only the new maximum number of tabs within each section will be restored. An error dialog will be displayed for each tab that now exceeds the maximum limit of open tabs and could not be restored.

The browser session plays an important role in the expected behavior when restoring tabs, and this chapter will detail how browser sessions interact with the restoration of tabs. In addition, a number of configuration options for the tab restoration feature are detailed.