GBC

The GBC element specifies a customization directory for the Genero Browser Client (GBC) front-end.

Syntax

<GBC>dir-file-name</GBC>
  1. 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.

The JGAS searches for the dir-file-name in 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: 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 JGAS 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

The customization directory can also be provided in the application URL using the 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).
Note:

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