Documentation Center

Controlling access to a control

You can control access to a UI control object using the <access> attribute of its corresponding control element in the controls.xml file.

About this task

For example, you can restrict access to a UI object such as an icon or button to a specific security group or device by adding or editing the <groupname> and <device> sub-elements of the <access> attribute of the element in the controls.xml file corresponding to the object. For example, you may want to restrict access to the Print control icon to desktop users. To do so, add or edit the <groupname> sub-element in the <access> attribute for the icon as follows.

Procedure

  1. Open the controls.xml file in a text editor.
  2. In the controls.xml file, locate the control element corresponding to the desired UI object.
    For example, to control access to the Print icon, locate the <control id="CVCtrl_print" type="icon" child="true"> tag.
  3. To specify a device that will be able to access the control, between the element's opening and closing tags, add or edit the <device> sub-element of the <access> attribute to include the applicable device.
    <access>
    				<device>DESKTOP</device>
    </access>
    In this example, access to the icon is restricted only to users on desktop devices.
  4. To specify a security group that will be able to access the control, between the element's opening and closing tags, add or edit the <groupname> sub-element of the <access> attribute to include the applicable security group.
    <access>
    				<groupname>ADMINISTRATOR</groupname>
    </access>
    In this example, access to the icon is restricted only to users assigned the ADMINISTRATOR security group.
  5. Save and close the controls.xml file.