Application Configuration Files

The application configuration files for defining application, section and tabs can be added to the <server-dir>\components\<component-name>\clientapps directory, where <component-name> is a custom component. Sub-folders are supported within the clientapps folder. Any artifacts added to this directory will override files of the same name in the <server-dir>\components\<component-name>\tab directory. The tab directory contains files that are shipped with existing components within the Cúram application and these files should not be modified.

Note: The OOTB Cúram application uses fragments of configuration artifacts that are merged into single files at build time, this is not supported for custom application configuration artifacts. (i.e.) you should not have a tab folder in EJBServer\components\custom.

When customizing application configuration files that ship with the Cúram application, the XML configuration file and.properties file should always be customized as a unit. For example, a change to the SimpleApp.properties file, associated with the SimpleApp.app file, should result in adding both SimpleApp.app and SimpleApp.properties to the clientapps folder. These files should be based on the merged version of the files. The inserttabconfiguration target can be used to get a development copy of the merged file. See the Cúram Server Developer Guide for more information.

There are a few general rules and best practices when working with the application configuration files:

The id attribute on the root element of each configuration file must match the name of the file. E.g. SimpleApp.app must have an id of SimpleApp.
The id attributes should not contain the period (.) or underscore (_) characters.
Localizable text should be added to a .properties file which matches the name of the configuration file. E.g. SimpleApp.app will have a corresponding SimpleApp.properties.
Properties files can be re-used across configuration files. E.g. Person.nav and Person.tab can share the same Person.properties file.
Ensure when developing the XML files to add the proper namespace information. This will allow for validation. For example:
```
<ac:application
...
</ac:application>
```