Create an application group

Use groups to define aliases for directories where application configuration files can be stored.

A group consists of an alias (Id) and a directory (path). A GROUP (for an application) element can be added to the APPLICATION_LIST component within the GAS configuration file.

When a front-end requests an application whose configuration information is stored in an external application configuration file, it provides the group alias, which directs the GAS to the directory where the application configuration file sits. The application name identifies which application configuration file to read (as the application and the configuration file share the same name).

Organize your applications

You can use application groups to organize your applications into logical groups or a hierarchy. For example, consider this URL:

http://<server>/gas/ua/r/accounting/app1

In this URL, both a group (accounting) and an application name (app1) are specified. The GAS, on receiving this application request, uses the accounting group alias to identify the directory holding the external application configuration file:
<GROUP Id="accounting">/path/config/accounting</GROUP>

In this directory, the GAS expects to find a file whose name matches the name of the application with an xcf suffix. For this example, the GAS looks for a file named app1.xcf.

The default group

The GAS configuration file provides a default group, defined using the name _default. When an application configuration file is added to this group, the application URL can omit using a group name and simply reference the application. For example, consider this URL:

http://server/gas/ua/r/Edit
The application URL does not specify a group, and the Edit application is not defined internally. It must therefore be defined in an external application configuration file, located in the directory defined for the _default alias.
<GROUP Id="_default">$(res.path.app)</GROUP>

The resource $(res.path.app) resolves to appdata/app. The appdata directory is described in GAS installation and application data directories. In this directory, you would expect to find Edit.xcf, the Edit application's application configuration file.

Example 1: "myapp" group defined by path to directory

<GROUP Id="_default">$(res.path.app)</GROUP>
<GROUP Id="myapp">$(res.path.app)/myapp</GROUP>

Example 2: "demo" group defined by resource

<GROUP Id="demo">$(res.path.demo.app)</GROUP>

This example assigns the alias demo to the directory containing the external application configuration files for demo applications. The path is defined using the resource $(res.path.demo.app). By wisely using a resource, a change to the directory structure only requires a change to a single RESOURCE element in the configuration file.

To access an application that has its configuration file stored in the group directory, enter an application URL that includes the group alias in its path: http://server/gas/ua/r/demo/CardStep1

Based on this URL, the GAS would expect to find the configuration file CardStep1.xcf within the directory specified for the demo group.