The application interface consists of a main container,
sidebars, and a chromebar.
Figure: GBC application page
Main container
The main container displays the application. It may contain topmenus, toolbars,
forms, and action panels.
Figure: GBC main container
Sidebar
The sidebar includes two distinct components: SideBarRail and SideBarDrawer.
SideBarRail: This sidebar is a permanent, thin sidebar that provides quick access to the
application list, featuring either application icons or abbreviations of application names. You can
control the visibility of the SideBarRail using the 4st applicationListVisible
variable. For more information, refer to the User Interface style attributes page in the Genero
Business Development Language User Guide.
SideBarDrawer: This sidebar is designed primarily for the Start Menu but also lists all
open and active applications, providing their full names by default. It can be activated via the App
Grid Icon (the "nine-squares" icon) at the top left of the interface. If an application has a
StartMenu, the start menu list of applications remains visible across all applications and is
not limited to just the application that requires it. If the application that created the
StartMenu is deleted, it disappears everywhere. The SideBarDrawer floats and can be pinned
for easier access.
The APPLICATION and STARTMENU categories can be collapsed or expanded, with
APPLICATION collapsed by default when there is a STARTMENU.
Figure: Sidebars
If only one application is active, the sidebars do not display. The sidebars list all
applications that are open and active. For example, if an application is launched using a
"RUN WITHOUT WAITING" instruction, both the calling and called applications are
simultaneously active, and both appear in the sidebars. You can switch between active applications
by selecting from the application list, and the selected application will display in the main
container.
You can close any application item in both the SideBarRail and the SideBarDrawer by hovering over
it to reveal a small close button. This allows you to execute the close action for the current
dialog, just like the close icon in the ChromeBar.
On mobile devices, the sidebar is not visible by default. It can be accessed from the icon
located next to the window name in the title bar.
Topmenu
If an application has a topmenu, the default rendering is based on the front-end
in use:
In desktop browsers and in desktop front-ends, a topmenu uses classic rendering and
always appears on the top of the window.
In mobile browsers and in mobile front-ends, a topmenu uses the sidebar rendering
and is displayed on the left of the window, when you click the hamburger icon.
You can override these defaults using the Genero presentation style (.4st)
attributes topmenuDesktopRendering and topmenuMobileRendering. For
more information, refer to the Topmenus section in the Genero Business Development Language User Guide.
Toolbars
If an application has a toolbar, the default rendering is based on the front-end
in use:
In desktop browsers and in desktop front-ends, a toolbar typically appears under the topmenu at
the top of the window.
In mobile browsers and in mobile front-ends, the toolbar action views are displayed in the
front-end chromebar.
GBC supports the position Genero presentation style (.4st)
at the toolbar level. This attribute can be used to display toolbars individually at the top or
bottom of the window, in the chromebar, or to hide a toolbar completely. The current support is for
two toolbars (a default or global toolbar and a form toolbar) in a Genero application.
The screenshot below shows the default or global toolbar positioned at the top of the screen and
the form toolbar at the bottom. Figure: Toolbar positions: top and bottom If both toolbars are positioned at the same location, they are ordered according to the AUI
tree reverse order. The screenshot below shows both the default or global toolbar and the form
toolbar positioned at the bottom of the screen.
Figure: Toolbar positions: bottom
The screenshot below shows how to configure styles in the Genero presentation style
(.4st) for windows using the toolBarPosition attribute and
styles for toolbars using the position attribute. The position
attribute has priority and overrides the toolBarPosition attribute set at Window
level if both are set. Figure: Toolbar positions defined with window and toolbar styles
For details about toolbar styles, refer to the ToolBar style attributes page in the
Genero Business Development Language User Guide.
Window list
The windowlist has been temporarily removed from the Chromebar in this release, as it is
undergoing improvements.
Chromebar
The chromebar displays icons for selecting windows, changing
settings, viewing status, debugging the application, and closing the application.
Important:
For applications using GDC-UR, the chromebar does not contain the settings and debug icons, as
settings and debugging are solely controlled by the GDC monitor. Please refer to the Genero Desktop Client User Guide for details
about settings and debugging with the Genero Desktop Client.
The chromebar overflow panel appears when there are more icons or actions than can fit in the
visible chromebar area. Instead of displaying all icons, GBC places the extra ones into a overflow
panel.
Figure: Chromebar default icons
The icons you see on the chromebar will depend on your current mode and
customization. By default:
In normal mode, the chromebar displays the Settings and
Close icons.
If a file is being uploaded, the chromebar also displays the Upload
status icon.
If the GBC is waiting for a response from the server, a progress bar displays
above the chromebar, indicating the Runtime status.
In debug mode, the chromebar also displays the [Debug] AUI
Tree icon. For more information, see Debugging.
You can modify these defaults by customizing the chromebar.
Hovering your mouse over the icons shows text that describe their function.
Settings
Opens the GBC Settings dialog.Figure: Settings dialog in debug mode The settings dialog allows you to specify:
GBC version - displays information about the build and version number of the GBC. When in debug mode , information is given about the runtime (FGL)
version, the GAS (if available), and the platform (browser, GDC, GMA, or GMI).
Interface language - The language for GBC messages. This setting is
independent from (and does not affect) the localization of the
application.
Interface theme - The theme currently used by the existing application.
Changing the theme immediately changes the look-and-feel of the
application.
Stored Settings - settings that save user modifications to the
user interface.
If the Enable Stored Settings checkbox is selected, your modifications
are stored and used the next time you launch the GBC.
If Enable Stored Settings is cleared, the GBC uses the default
values.
If you run processes that clear out the local browser cache, it is not recommended to remove
the information in these Local Storage keys:
history_gwcJS stores a list of apps run recently by the GBC in the current
browser, to include the name, description, URL, and so on of the apps.
storedSettings_gwcJS stores the global settings of GBC such as (but not limited
to) default theme, debug levels, and so on.
storedSettingsLayout_gwcJS stores Genero application settings such as (but not
limited to) table column configuration (order, show/hide, sort order, and so on).
Debug & QA (Only available in debug mode)
The Typeahead duration is used to simulate a slow network
and force the typeahead mechanism to be triggered. The
default is 5ms, meaning the layout request would be delayed
for 5ms. It could be less, but the difference might not be
visible or relevant. Typeahead cannot be disabled.
Log level.
Log types
Upload status
Indicates that a file is being uploaded into your application. This displays
first as an icon and then as a percentage. When all files are uploaded, the upload status disappears
from the chromebar. If the upload is fast, you may never see the upload status. To change the icon,
see Change file loading icon. To center the icon
and percentage on the screen, see Center file loading icon.
Runtime status
Displays a progress bar that indicates the GBC is waiting for a response
from the server.
Tip:
You can see this progress bar in the GWC demo directory. Navigate to User Interface > UI Basics > Widgets and doubleclick the ProgressBar application.
By default, this progress bar displays at the top of the screen. To display
instead a spinning circle in the center of the screen, see Change progress indicator.
Close window
Closes the selected application. Upon closing, you are taken to the next
open application in the sidebar. If there are no more applications in the sidebar, the GBC displays
the application ended page.
Note:
The Close window icon may not be shown while an application is expecting user input or other
action.
Tip:Closing application DVMs
We recommend that you always use the
Close window action to exit applications. Avoid closing the browser tab to
stop applications as application DVMs may stay running on your server until sessions time out. The
close action ensures that application DVMs are properly stopped on the server side.
