Configuring the Actuate BIRT Viewer toolbar using iv_config.xml
The Actuate BIRT Viewer provides a toolbar and context menus that support many of the formatting, sorting, and grouping tasks you perform on data. The toolbar and menus also support adding or deleting columns or groups, and working with fonts and text alignment. You also can print reports and export content or data. Enable or disable each of these features using the configuration file iv_config.xml. Its location is:
<context root>\WEB-INF\iv_config.xml
The iv_config.xml file contains lists of features that are enabled or disabled based on security roles as defined in Actuate iServer. The default roles included for iv_config.xml are:
*
*
*
*
The Active Portal roles are created when iServer is installed or, if you are using the Java Component Actuate BIRT Viewer, set in the web.xml DEFAULT_WORKGROUP_FUNCTIONALITY_ROLE parameter. You can add additional iServer roles as needed. Each set of features for a role is called a feature control. Each feature control contains the user role being described, and the set of features that are marked individually as available or not available. The following section of iv_config.xml shows the default feature control for the Active Portal Advanced role:
<FeatureControl>
  <Role>Active Portal Advanced</Role>
  <Features>
    <Feature>
      <FeatureName>SaveDesign</FeatureName>
      <Availablity>false</Availablity>
    </Feature>
    <Feature>
      <FeatureName>SaveDocument</FeatureName>
      <Availablity>true</Availablity>
    </Feature>
    …
  </Features>
</FeatureControl>
All <FeatureControl> tags are placed within the <FeatureConfiguration> element. Each feature is described by the <Feature> tag, and its availability is described with the <Availability> tag. If a particular feature is available to a role, availability is set to true. If the feature is not available, it is set to false.
Exception stack trace display is also controlled in the iv_config.xml file. When an exception occurs, the viewer can display a stack trace can be displayed in the exception dialog. The trace is used for support purposes, and is set to false by default. This value is not associated with user roles and is placed outside the <FeatureControl> tag. The format of the iv_config.xml file appears as shown in the following code:
<IVConfig>
  <!-- Disable stack trace on exception dialog -->
  <ExceptionStackTrace>false</ExceptionStackTrace>
  
  <!-- Config features -->
  <FeatureConfiguration>
    <!-- All -->
    <FeatureControl>
      …
    </FeatureControl>
    <FeatureControl>
      …
    </FeatureControl>
      …
  </FeatureConfiguration>
</IVConfig>
Table 13-1 lists the features that can be set, and how the availability tag affects them.
Shows or hides the New Computed Column and Edit Computed Column items in the context menu
Shows or hides the Hide Column, Show Columns, and Delete Column items in the context menu
Shows or hides the Format, Change Font, and Alignment items in the context menu
Shows or hides the Move To Group, Add Group, and Delete Group items in the context menu

Additional Links:

Copyright Actuate Corporation 2012