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 anId
attribute. For external configuration files, theId
attribute is ignored. - 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>
- The application inherits the configuration settings of its parent
("
defaultwa
" in this example). - The path used is a
RESOURCE
defined in the as.xcf; you could also use the absolute path pointing to your application files. - 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.21/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.