Configuring toolbar and context menu items

You configure the toolbar and context menu functionality that is available to users by editing attributes in the BIRT Studio configuration file, erni_config.xml. This file is located in:

<context root>\WEB-INF

Customizations you make to erni_config.xml apply at the application level. If you want different sets of functionality available to different groups of users, you need to create multiple instances of the web application, then customize the functionality of each BIRT Studio instance.

In erni_config.xml, the <actionSets> element defines all the user actions that can be enabled or disabled. The actions are organized by category, for example, file operations, calculations, and formatting. The <actionSet> element defines the category, and the <action> element defines a specific action. Listing 15-1 shows the hierarchy of elements.

Listing 15-1

An example of an <actionSet> element in erni_config.xml

<actionSets>

  <actionSet>

    <name>FileOperations</name>

    <visible>true</visible>

    <action>

      <name>New</name>

      <enabled>true</enabled>

    </action>

    <action>

      <name>Open</name>

      <enabled>true</enabled>

    </action>

    <action>

      <name>Save</name>

      <enabled>true</enabled>

    </action>

    <action>

      <name>SaveAs</name>

      <enabled>true</enabled>

    </action>

  </actionSet>

By default, all actions are enabled. You can disable actions in the following ways:

To disable a particular action, change the action’s <enabled> attribute from true to false.

To disable all actions within a category in one step, change the action set’s <visible> attribute from true to false.

For the changes to take effect, restart the appropriate Windows service. When you relaunch BIRT Studio, the toolbar displays different buttons and the context menus display different items, depending on which action or actions you disabled.

© Copyright OpenText Corp. All rights reserved. Privacy Policy | Cookie Policy

BIRT iHub 2