GBC
The GBC
element specifies a customization directory for the Genero
Browser Client (GBC) front-end.
In versions of the GAS before 3.10, the GBC
element was known as
GWC-JS
. Both names continue to be supported.
Syntax
<GBC>dir-file-name</GBC>
- The dir-file-name can be either the name of a directory or a file.
Child elements
There are no child elements.
Usage
You use this element to specify a customization directory for the GBC. This directory contains a collection of HTML, CSS, JavaScript files, and all the resources required for rendering web applications.
GBC_LOOKUP_PATH
paths. If found, it is processed as determined by these
conditions:- If it is a directory, it is expected to have a compiled GBC customization or an unzipped GBC runtime package downloaded from the Four Js website.
- If it is a file, then the file is expected to contain one line of text, giving the name of a directory located in the same directory as the file. This directory is expected to have a compiled GBC customization or an unzipped GBC runtime package downloaded from the Four Js website.
Usage example: default application
$(res.gbc)
resource. The
GBC
element in the defaultwa
abstract application configuration
references this
resource:
<APPLICATION Id="defaultwa" Abstract="TRUE">
<!-- This is the "default" application.
It is not used directly: it is used for defining a "root" application. -->
<EXECUTION Using="cpn.wa.execution.local"/>
<UA_OUTPUT>
<PROXY>$(res.uaproxy.cmd)</PROXY>
<PUBLIC_IMAGEPATH>$(res.public.resources)</PUBLIC_IMAGEPATH>
<TIMEOUT Using="cpn.wa.timeout"/>
<GBC>$(res.gbc)</GBC>
</UA_OUTPUT>
</APPLICATION>
$(res.gbc)
is set by $(res.gwc-js)
in the
as.xcf file to reference the "_default" file. This file is
located in the $(res.fgldir)/web_utilities/gbc directory,
which refers to the $FGLDIR/web_utilities/gbc/gbc directory.
<RESOURCE Id="res.gwc-js" Source="INTERNAL">_default</RESOURCE>
<RESOURCE Id="res.gbc" Source="INTERNAL">$(res.gwc-js)</RESOURCE>
If the _default file content is changed, the next application started
referencing the $(res.gwc-js)
resource uses this new value.
Usage example: customization project directory
<GBC>gbc-custom</GBC>
In this example, you create a new set of files to customize the look and feel of a Web
application. You place these files in a separate directory to the default bootstrap. In this
example, that file is $(res.path.as)/gbc-custom. The
GAS searches for the GBC directory at
paths defined by the
GBC_LOOKUP_PATH
.
Usage example: customization file
<GBC>customization_file</GBC>
The text file (customization_file in the example) is expected to contain one line of text, giving the name of a directory located in the same directory as the file. This directory is expected to have a compiled GBC customization or an unzipped GBC runtime package downloaded from the Four Js website.
Paths defined by the GBC_LOOKUP_PATH
element, are searched to locate the
customization_file.
URI gbc query string parameter
gbc
query string parameter. If the URI contains a gbc
query string
and value, this takes precedence over the configuration for the GBC
element in the
application configuration file (xcf). In the Genero web client prior to version 3.00, the query string key gwc-js
was
used. Starting with version 3.10, it is renamed gbc
. Use of gwc-js
is deprecated but remains for compatibility.
Parent elements
This element is a child of UA_OUTPUT