Associate an Application with User

A user must be mapped to the application and home page to display when they first login. The home page is the initial page, displayed in its associated tab. This is done using the following mapping:

APPLICATIONCODE field on the Users database table

maps to

an entry in the APPLICATION_CODE codetable

maps to

the id attribute of an application

When a user logs in, the value of the APPLICATIONCODE field in the Users database table is used to determine both the application and home page to display.

The value field of the code table entry must match the name of the application (.app) file to use and the description field of the code table entry indicates the name of the UIM page to be displayed as the home page. The following example shows a subset of a code table definition:

Figure 1. CT_APPLICATIONCODE.ctx

<codetable java_identifier="APPLICATION_CODE"
              name="APPLICATION_CODE">
  <code default="false" java_identifier="SIMPLE_HOME"
      status="ENABLED" value="SimpleApp">
    <locale language="en" sort_order="0">
      <description>SimpleHome</description>
      <annotation></annotation>
    </locale>
  </code>
</codetable>

Note: For more information on code tables see the Cúram Server Developers Guide.

In this example, a code table entry SimpleApp has been defined, with a description of SimpleHome. The code SimpleApp, matches the id of the SimpleApp.app example. The description, SimpleHome, indicates the UIM page to be displayed as the home page. This page must be associated with the relevant application. For more details on how to associate pages with an application, see Opening Tabs and Sections.