Restricting Functionality in OpenOffice.org

From Apache OpenOffice Wiki
Jump to: navigation, search


You can restrict the functionality of OpenOffice.org program modules for individual users, groups, or across a network. You can apply different restrictions to different users. You can also create a command configuration file in XML format to restrict the availability of menu commands in an OpenOffice.org program.

Creating a Command Configuration File

The creation of a command configuration file is a three-step process:

  • Determine the command names of the features you want to restrict.
  • Create an XML configuration file.
  • Copy the configuration file to the appropriate location in the OpenOffice.org installation directory.

To Create a Command Configuration File

  1. Determine the UNO Command Names for the feature that you want to restrict.
  2. In a text editor, create an XML configuration file.
    1. Use the following file structure.
    2.  <?xml version="1.0" encoding="UTF-8" ?>
       <oor:node oor:name="Commands" oor:package="org.openoffice.Office" 
       xmlns:oor="http://openoffice.org/2001/registry" 
       xmlns:xs="http://www.w3.org/2001/XMLSchema" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <node oor:name="Execute">
          <node oor:name="Disabled">
            <node oor:name="CommandName" oor:op="replace">
              <prop oor:name="Command">
                <value>CommandName</value>
              </prop>
            </node>
          </node>
        </node>
       </oor:node>

      The Commands.xcu file uses the following schema:

       <?xml version='1.0' encoding='UTF-8'?>
       <oor:component-schema oor:name="Commands" 
       oor:package="org.openoffice.Office" xml:lang="en-US" 
       xmlns:oor="http://openoffice.org/2001/registry" 
       xmlns:xs="http://www.w3.org/2001/XMLSchema" 
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <templates>
          <group oor:name="CommandType">
            <prop oor:name="Command" oor:type="xs:string"/>
          </group>
        </templates>
        <component>
          <group oor:name="Execute">
            <set oor:name="Disabled" oor:node-type="CommandType"/>
          </group>
        </component>
       </oor:component-schema>
    3. Create a separate node for each feature you want to restrict.
    4. In each node, replace the term CommandName with the command name of the feature.
  3. Save the file with the name Commands.xcu.

The following example Commands.xcu file disables the ability to customize menus in OpenOffice.org.

 <?xml version="1.0" encoding="UTF-8" ?>
 <oor:node oor:name="Commands" 
 oor:package="org.openoffice.Office" 
 xmlns:oor="http://openoffice.org/2001/registry" 
 xmlns:xs="http://www.w3.org/2001/XMLSchema" 
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <node oor:name="Execute">
     <node oor:name="Disabled">
       <node oor:name="ConfigureDialog" oor:op="replace">
         <prop oor:name="Command">
           <value>ConfigureDialog</value>
         </prop>
       </node>
       <node oor:name="ConfigureToolboxVisible" oor:op="replace">;
         <prop oor:name="Command">
           <value>LoadToolBox</value>
         </prop>
       </node> 
     </node>
   </node>
  </oor:node>

To apply this restriction to all users, copy the file to the network-install-dir/share/registry/data/org/openoffice/Office directory.

For a list of command names and their descriptions, see Index of UNO Command Names for OpenOffice.org.

To Apply a Command Configuration File

You can apply a command configuration file to OpenOffice.org on the Solaris, Linux, and Windows platforms.

  1. Exit all OpenOffice.org applications.
    On Windows, ensure that you exit the OpenOffice.org Quickstarter in the system tray.
  2. Copy the Commands.xcu file to the appropriate directory.
    • To apply the configuration to all users on the network, copy the Commands.xcu file to the following directory:
      network-install-dir/share/registry/data/org/openoffice/Office
    • To apply the configuration to a specific user on the network, copy the Commands.xcu file to the following directory:
      workstat-dir/user/registry/data/org/openoffice/Office

The configuration is applied when you restart OpenOffice.org

Content on this page is licensed under the Public Documentation License (PDL).
Personal tools
In other languages