Customize Enterprise Browser

Enterprise Browser 1.7

Overview

Enterprise Browser 1.7 (and higher) for Android includes ButtonBar APIs, which can deliver custom features and functions through on-screen buttons or keys. Functions can include simple actions such as launching an app or activity, sending an intent or virtually any action that can be executed using JavaScript.

Customization Guides:

img
The 10 new ButtonBar APIs can be used to:

  • Deliver a rich GUI more like native Android apps
  • Access enterprise features through JavaScript APIs
  • Implement key-press features missing after Windows Mobile/CE migration
  • Enhance existing keyboards with additional app functions
  • Customize a key layout based on screen size
  • Reduce or enlarge key size based on the app or screen
  • Eliminate least-used keys and/or emphasize most-used ones
  • Optimize keyboard orientation (portrait/landscape) based on app, page and/or device
  • Change the opacity of the keyboard
  • Add functions to existing apps without changing the server-side source code
  • Add data capture and/or keyboard features to SAP apps without changes to source

This feature applies only to devices running Android KitKat and higher.


How it Works

The settings, parameters, actions and attributes of the desired on-screen button(s) are stored in an XML container called Button.xml. If any of those buttons are to execute JavaScript, the JavaScript code is contained in a second file called CustomScript.xml. Both files are stored on the device, and their paths specified in corresponding tags in the app's Config.xml file.

ButtonBars can be shown and hidden programmatically as required by an app's pages through methods implemented in one of 10 ButtonBar APIs currently supported. Enterprise Browser can send API calls by any of the means listed below, which can be used in any combination.

Call EB APIs using:


Button.xml Path

The <buttonxmlfile> tag specifies the location of button.xml in an app's Config.xml file, which contains the majority of its runtime settings. Note: This tag is not included in the default Config.xml file and must be added as shown below. Enterprise Browser will read the button.xml file if present in the specified folder each time the app launches. For more information, see the <buttonxmlfile> path tag in Config.xml reference.

Possible Values:

  • Fully qualified path and file name
  • Substitution variable representing the fully qualified path
  • Supports any valid internal or external storage device
  • Default path: "file://%INSTALLDIR%/button.xml" (Enterprise Browser installation folder)

Example


<Configuration>
    ...
    <FileLocations>
          <buttonxmlfile value="file://%INSTALLDIR%/button.xml"/>
    </FileLocations>
    ...
</Configuration>

CustomScript.xml Path

The <customxmlfile> tag specifies the location of CustomScript.xml in an app's Config.xml file, which contains the majority of its runtime settings. Note: This tag is not included in the default Config.xml file and must be added as shown below. Enterprise Browser will read the CustomScript.xml file if present in the specified folder each time the app launches. For more information, see the <customxmlfile> path tag in Config.xml reference.

Possible Values:

  • Fully qualified path and file name
  • Substitution variable representing the fully qualified path
  • Supports any valid internal or external storage device
  • Default path: "file://%INSTALLDIR%/CustomScript.xml" (Enterprise Browser installation folder)

Example


<Configuration>
    ...
    <FileLocations>
          <customxmlfile value="file://%INSTALLDIR%/CustomScript.xml"/>
    </FileLocations>
    ...
</Configuration>

Sample Button Layouts

The image below shows F2, F3, F4 and ENTER functions depicted as custom buttons (top) and as custom keys (bottom), along with a custom scan button.


Adding to the layout above, this image replaces the scan button with additional custom keys and a numbered list of buttons that could execute JavaScript, send intents, launch apps or perform other tasks.


As seen in the sample below, buttons also can be used to display and hide other layouts, and can be configured to automatically align with the top, bottom or sides of the screen. Here are seen vertically-oriented buttons and keys on a device with landscape screen orientation.


See the Button Parameter Guide and Bar Orientation for more information.


Related Guides: