APPLICATION (for an application)

This APPLICATION element defines an application within the Genero Application Server configuration file or in an external application configuration file.

Syntax

<APPLICATION [Id=app-name]  
     Parent=parent-app-name 
     [SinglePageApplications={"TRUE"|"FALSE"}] 
     xmlns:xsi=uri 
     xsi:noNamespaceSchemaLocation=schema
    [Abstract={"TRUE"|"FALSE"}] 
    [mode=mode-name]>
   [<DESCRIPTION>...</DESCRIPTION>]
   [<RESOURCE>...</RESOURCE>] [...]
   [<EXECUTION>...</EXECUTION>]
   [<AUTO_LOGOUT>...</AUTO_LOGOUT>] 
   [<UA_OUTPUT>...</UA_OUTPUT>]
   [<END_URL>...</END_URL>]
</APPLICATION>
  1. The app-name attribute identifies the application. The Id attribute is required for applications defined within the Genero Application Server configuration file. For external configuration files, the Id attribute is ignored. The Id specified is compared to the application name in the request.
  2. The parent-app-name attribute identifies the parent application, or the application from which this application will inherit its default configuration settings.
  3. The SinglePageApplications attribute identifies the applications defined under the APPLICATIONS element of the xcf file as a group of one or more independent applications that can be run in the same HTML page of the Genero Browser Client as the main application.
  4. The uri defines the URL of the XML schema. The default value is "http://www.w3.org/2001/XMLSchema-instance".
  5. The schema attribute defines the XML schema instance. When defining external application files, the valid value for a Web applications is "http://www.4js.com/ns/gas/version/cfextwa.xsd"
  6. The Abstract attribute defines whether this application configuration element is for an abstract application or a real application. Valid values are "TRUE" and "FALSE". An abstract application acts as a template and can not instantiate Virtual Machines.
  7. The mode-name attribute when set to "sticky", defines a Web service as a sticky Web service. See Configure sticky Web services.

Child elements

The APPLICATION element may contain the following elements:

  1. Zero or one DESCRIPTION element.
  2. Zero or more RESOURCE elements.
  3. Zero or one EXECUTION (for an application) elements.
  4. Zero or one AUTO_LOGOUT elements.
  5. Zero or one UA_OUTPUT elements. This element is used for all UI applications.
  6. Zero or one END_URL element.
  7. Zero or one HTTP element.

Usage

You use this element to configure Web applications you wish to make accessible through the GAS.

Example external Web application configuration file

<?xml version="1.0" encoding="UTF-8"?>
  <APPLICATION Parent="defaultgwc"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/4.01/cfextwa.xsd">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)</PATH>
    <MODULE>demo.42r</MODULE>
    <ACCESS_CONTROL>
        <ALLOW_FROM>$(res.access.control)</ALLOW_FROM>
    </ACCESS_CONTROL>
  </EXECUTION>
  <AUTO_LOGOUT Using="cpn.wa.autologout"/>
  <UA_OUTPUT>
     <PROXY>$(res.uaproxy.cmd)</PROXY>
     <PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
     <GBC>gwc-dev</GBC>
     <TIMEOUT> Using="cpn.wa.timeout"</TIMEOUT>
  </UA_OUTPUT>
  <END_URL>http://www.4js.com</END_URL>
</APPLICATION>

For more information, see Configuring applications on GAS.

Parent elements

When used in an application configuration file (.xcf), it is the top-most element.

When used in the GAS configuration file, this element is a child of the APPLICATION_LIST element.