Applications

When a user logs into the Cúram application they are presented with a view that is specific to their role. This view is known as an application. An application in the Cúram user interface is a collection of user interface elements, predominantly based on UIM pages, combined to create specific content for a particular user or role.

Figure 1. Application User Interface OverviewA picture of the full layout of the Cúram user interface.

In addition to defining the layout of the screen, an application controls the flow between pages available in the application. Within an application, links to other pages are available from a section shortcut panel, the tab navigation bar and page group navigation bar, in addition to links on the page displayed in the content area.

Activating any of these links will result in accessing a new page in the content area, or opening a new page in a modal dialog. For new pages in the content area, the application definition is used to determine what tab the page belongs to and what section the relevant tab belongs to. The page is then opened in the context of the relevant section and tab.

Applications are defined in an XML format using a number of different files. For example, an application is defined using an XML file with the extension .app. Each section referenced in the application is defined using an XML file with the extension .sec and any tabs referenced by the section are defined using an XML file with the extension .tab.

Applications details an example of an application configuration file (.app). The example creates an application containing two sections, in addition to an application banner with a quick search facility.

Figure 2. Sample Application (.app) File
<?xml version="1.0" encoding="UTF-8"?>
<ac:application
   id="SimpleApp"
   title="SimpleApp.title"
   subtitle="SimpleApp.subtitle"
   user-message="SimpleApp.UserMessage">

  <ac:application-menu>
    <ac:preferences title="preferences.title"/>
    <ac:help title="help.title"/>
    <ac:logout title="logout.title"/>
  </ac:application-menu>

  <ac:application-search>
    <ac:search-pages>
      <ac:search-page type="SAS01"
        description="Search.Person.LastName.Description"
        page-id="Person_searchResolver"
        initial-text="Search.Person.LastName.InitialText"
        default="true"/>
      <ac:search-page type="SAS02"
        description="Search.Person.Gender.Description"
        page-id="Person_listByGender"
        initial-text="Search.Person.Gender.InitialText" />
    </ac:search-pages>
    <ac:further-options-link
       description="Search.Further.Options.Link.Description"
       page-id="Person_search" />
  </ac:application-search>

  <ac:section-ref id="SimpleHomeSection"/>
  <ac:section-ref id="SimpleWorkspaceSection"/>

</ac:application>

This separation of configuration into multiple files allows for reuse of different elements across multiple applications. For example, a common Inbox section can be defined and referenced by multiple applications. For more information on application configuration consult Application Configuration.