Configure Web applications

What do you need to configure a Genero Browser Client application?

To add an application for Genero Browser Client (GBC), you need to specify:

  • An application Id (a unique name for this APPLICATION element)
    Note: Applications defined in the GAS configuration file require an Id attribute. For external configuration files, if the application and the configuration file share the same name, there is no need to specify the Id attribute.
  • The parent application from which to inherit configuration details (defaultwa in this example).
  • The path to the compiled application files.
  • The name of the application to launch.

These examples show well-formed application configurations for the sample Genero BDL demo application.

Example 1: simple application for GBC

This configuration is for a GBC application defined in the GAS configuration file (as.xcf).
<APPLICATION Id="my-gwc-demo" Parent="defaultwa">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)</PATH>
    <MODULE>demo</MODULE>
  </EXECUTION>
</APPLICATION>
  1. The application inherits the configuration settings of its parent ("defaultwa" in this example).
  2. The path used is a RESOURCE defined in the as.xcf; you could also use the absolute path pointing to your application files.
  3. The MODULE contains the name of the application to launch.
Important: When you add an application to the GAS configuration file, you must restart the GAS for the application to be recognized.
To launch your application in the browser, you can use this kind of URL:

http://appserver:6394/ua/r/my-gwc-demo

Example 2 : gwc-demo-external.xcf

The main differences between this example and the example shown in Example 1: simple application for GBC are the lack of the Id attribute and the addition of the reference to the XML schema. 

<APPLICATION Parent="defaultwa"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:noNamespaceSchemaLocation="http://www.4js.com/ns/gas/3.10/cfextwa.xsd">
  <EXECUTION>
    <PATH>$(res.path.fgldir.demo)</PATH>
    <MODULE>demo</MODULE>
  </EXECUTION>
</APPLICATION>

After configuring your application, you can test it to see if it is configured correctly by saving the xcf file in your $(res.appdata.path)/app directory and running it on the GAS.

You can use this kind of URL to launch your application in the browser:

http://appserver:6394/ua/r/gwc-demo-external

See URI Examples.