Define an Application

An application is a particular view of the Cúram client defined for a specific user or role, refer to Introduction. It is defined using an XML configuration file with the extension .app. The .app files, are located in the EJBServer\components\<component-name>\clientapps directory, where <component-name> is a custom component. Define an Application details a very simple application that contains a single section (will be covered later).

Figure 1. SimpleApp app

<?xml version="1.0" encoding="ISO-8859-1"?>
   id="SimpleApp"
   logo="SimpleApp.logo"
   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:section-ref id="SimpleAppHomeSection"/>

</ac:application>

The SimpleApp.app should have a corresponding SimpleApp.properties file, which details the localizable content for the application. For example:

SimpleApp.logo=CDEJ/themes/v6/images/application-logo.png
SimpleApp.title=C\u00FAram
SimpleApp.subtitle=Simple Application
SimpleApp.UserMessage=Welcome, %user-full-name

preferences.title=User Preference
help.title=Help
logout.title=Logout

SimpleApp.app has configured the following elements in the application banner of the application:

an application name (title), refer to User Interface Element 1 in Introduction;
an application subtitle (subtitle), refer to User Interface Element 2 in Introduction;
a welcome message (user-message), refer to User Interface Element 3 in Introduction;
a application menu (application-menu), refer to User Interface Element 4 in Introduction.