Page Parameters

The client determines if a new tab is opened based on the page to tab to section association. In addition, existing opens tabs and values of the parameters passed to a tab are taken into consideration.

Two instances of the same tab can be opened, where each instance is identified by the page parameters that have been provided. For example, James Smith and Linda Smith are uniquely identified by their concern role ID. The concern role ID is defined as a page parameter for the Person tab.

When a link to James Smith is selected, a new tab is opened showing the details for James Smith. A subsequent link to Linda Smith is selected and a new instance of the same tab configuration is opened, displaying Linda Smiths details.

When a link is selected, the Cúram client application automatically determines what tab, and section, it is associated with. It then compares this information, along with the page parameters to determine what action to take.

The rules for opening tabs are detailed in Page Parameters.

Note: The parameters passed when a link is selected must match the names of the page parameters defined in the tab configuration file.

Where not all required page parameters are provided, the behavior of those tabs within the application is not guaranteed. Any extra parameters provided will be ignored and not passed to the tab.

Table 1. Tab Opening Rules
Page to Tab Association Page Parameter Values Action
Page maps to current tab Match Page opens in current tab
Page maps to current tab Differ Page opens in new instance of tab
Page maps to existing open tab Differ Page opens in a new instance of existing tab
Page maps to existing open tab Match Page opens in existing tab
Page maps to new, unopened tab N/A Page opens in new tab
Limitations: There are a number of limitations and notes to be aware of when designing UIM pages to open in new tabs.
  • Links in a modal dialog obey dialog rules first and only obey the rules for opening a tab when the dialog is closing.
  • A link defined to open a modal dialog ignores the tab rules.
  • Links in a tab navigation bar and page group navigation bar will always open within the context of the current tab.
  • A submit link within the content area cannot open a new tab, even if the UIM page is configured to be associated with a different tab.
  • If a UIM page is configured to be associated with a tab then the same page cannot be used as INLINE_PAGE in expandable lists.