Application page

The application interface consists of a main container, a sidebar, and a chromebar.

GBC application page

Main container

The main container displays the application. Expand or contract the panel by moving the divider between it and the sidebar.

Sidebar

The sidebar lists all open applications and windows. You can switch between applications and windows by selecting them from the list. The selected application or window displays in the main container. When you close an application, it is removed from the sidebar list.

Depending on the width of your browser window, you may not see the sidebar. If the sidebar is not displayed, you can access it from an icon (commonly called the "hamburger icon") located next to the window name in the title bar. The hamburger icon consists of three horizontal stripes. Click on the sidebar icon and the sidebar opens, giving you access to all opened applications and windows.

You can change the width that the browser window must reach before the sidebar is visible; see Display or hide the sidebar.

Chromebar

The chromebar displays icons for changing settings, viewing status, debugging the application, and closing the application.

The icons you see 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 About, [Debug] AUI Tree, Proxy logs, and VM logs icons. For further information about debugging, see Debug.

You can modify these defaults by choosing the icons to display in the chromebar; see Customize the chromebar.

Hovering your mouse over the icons shows text that describe their function.

About

Displays information about the GBC version.

Settings

Opens the GBC Settings dialog, which allows you to specify:

  • 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 for the 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.

[Debug] AUI Tree

Opens the AUI tree for the current application. See View the AUI tree.

Run in GDC

Downloads a shortcut allowing you to open the current application with the Genero Desktop Client (GDC).

Proxy logs

Opens the current application session log in a new tab. Use this to view the status of proxies, responses sent, and system error messages. See Log files in the Genero Application Server User Guide.

VM logs

Opens the Dynamic Virtual Machine (DVM) log for DVMs started by the application. The log opens in a new tab.

Upload status

Indicates that a file is being uploaded into your application. When all files are uploaded, the Upload Status icon disappears from the chromebar. If the upload is fast, you may never see the Upload Status icon.

To change the icon, see Change file loading icon. To center the icon on the screen, see Center file loading icon.

Runtime status

Displays a progress bar that indicates when 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 double-click on 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 Center progress indicator icon.

Bookmark

Adds a bookmark for the application to the Bookmarks panel on the GBC home page; see Home Page.

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, GBC displays the application end page.

Note: The Close window icon may not be shown while an application is expecting user input or other action.