Hide User Interface Elements Using the System.xml File

You can edit the applicable system.xml file to hide user interface elements permanently.

Procedure

  1. Stop the IBM® Cognos® service.
  2. Open the system.xml file in one of the following locations:
    • c10_location /templates/ps/portal

      Use the system.xml file in this directory to hide user interface elements in Public Folders or My Folders.

    • c10_location /templates/ps

      Use the system.xml file in this directory to hide user interface elements in pages and dashboards with multiple tabs.

  3. Use the following syntax in the <system> element to hide a user interface element:
    <param name="ui_hide"> 
    	<!--list of user interface elements--> 
    </param>

    For example, the following XML code hides the entire IBM Cognos Connection header and the New Job button in the toolbar:

    <param name="ui_hide">
    	<CC_HEADER/>
    	<CC_TOOLBAR_BUTTONS_newjobDefinition/>
    </param>

    For information about all the user interface elements that you can hide, see Elements You Can Hide. Ensure that you match the case of each user interface element you want to hide.

  4. Specify one or more groups or roles you want to view the hidden element by adding their IDs as values of the show attribute.

    Use the group or role IDs as documented in the topic Referencing the required groups or roles in the system.xml file.

    Separate IDs using spaces.

    Here is an example:

    <param name="ui_hide">
    	<CRN_HEADER show="Administrators g1 g2 RSUsers"/>
    </param>
  5. Repeat steps 3 to 4 for each element that you want to hide.
  6. Save the file.
  7. Start the IBM Cognos service.

    Tip: There can be only one <param name="ui_hide"> element in system.xml. Therefore, all items you want to hide must be placed inside this element..