Setting user access permissions for the new menu items

Last Updated : Jan 09, 2017 |
The features.xml file specifies which user roles have access to the new menu items.
  1. In an ASCII text editor, open the configuration features.xml file in the TomcatHome/lib/extensions/UniqueDirectoryName/config directory, where TomcatHome is the directory in which the Tomcat servlet engine software is installed and UniqueDirectoryName is the directory defined as described in Defining a unique extensions directory. The default is /opt/Tomcat/tomcat.
  2. Create the basic template for the features.xml by adding the following tags:
    ADDITIONAL INFORMATION:
    <?xml version="1.0" encoding="UTF-8"?>
    <features 
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
             xsi:noNamespaceSchemaLocation="features.xsd">
    </features>
  3. For each menu group to be defined in configuration menu.xml, add the <category> and </category> tags just before the </features> tag.
    ADDITIONAL INFORMATION:
    Note:
    For each new menu group defined in the menu.xml configuration file, you need to define the <category> and </category> tags in the features.xml file.
  4. Specify a </feature> tag for each new menu item after the <category> and before the corresponding </category> tag.
    ADDITIONAL INFORMATION:
    Note:
    For each new menu item defined in the menu.xml configuration file, you need to define a <feature> tag within the corresponding <category> tag in the features.xml file.
  5. For each <feature> tag added, specify the following attributes:
    ADDITIONAL INFORMATION:
    Attributes
    Example
    Description
    name=”itemTag”, where itemTag is the identifier defined for the menu item in the menu.xml configuration file.
    Specify name=”newMenuItemIdentifier”
    The identifier of the menu item defined in the configuration menu.xml file.
    allow=”roles”, where roles is a combination of any of the following roles separated by commas:
    • administration
    • maintenance
    • operations
    • usermanager
    • auditor
    To define that this menu group is accessible only to administrator and user manager, specify allow=”administration, usermanager”
    This attribute defines the roles that have permission to view this menu group.
    Note:
    Make sure that any user role specified for a menu item is also specified for the entire group.
  6. Make sure each of the new <feature> tags have a corresponding</feature> tag.
  7. Save and close the file.
For example, to specify that users with the Administration, Operations, and Reporting user roles can view the menu item menuItemMyCustomreport for the Reports menu group, add the following lines within the category which defines the menuGroupReports:

<?xml version="1.0" encoding="UTF-8"?>
<features
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="features.xsd">
<category name="menuGroupReports">
<feature name="menuItemMyCustomReport"
     allow="administration,operations,maintenance,reporting">
</feature>
</category>
</features>