Documentation/Administration Guide/Restricting functionality

Apache OpenOffice Administration Guide

{{{parttitle}}}

[[{{{PrevPart}}}|< Previous Section ]]

[[{{{NextPart}}}|Next Section >]]

• Deploy Apache OpenOffice using package managers

• Solaris Sparc/x86
• Linux
• Microsoft Windows
• Mac OS X

• Apache OpenOffice Basic Macros and Libraries
• Apache OpenOffice Extension Manager
• Adding Template Files to an Apache OpenOffice Installation
• Adding AutoText Files to an Apache OpenOffice Network Installation
• Deactivating the Apache OpenOffice Registration Wizard
• Accessing Email Clients
• Customizing the User Interface
• Restricting Functionality in Apache OpenOffice
• Accessing Apache OpenOffice User Profiles on an LDAP Server

[[{{{PrevPage}}}|< Previous Page ]]

[[{{{NextPage}}}|Next Page >]]

Creating a Command Configuration File

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

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

To Create a Command Configuration File

1. Determine the UNO Command Names for the feature(s) that you want to restrict.
2. In a text editor, create an XML configuration file.
1. Ensure that the file has the following structure

<?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>




2. Create a separate node for each feature that you want to restrict.
3. In each node, replace the term CommandName with the command name of the feature.
3. Save the file as Commands.xcu.

The following Commands.xcu file disables the ability to customize menus in Apache OpenOffice. To apply this restriction to all users, copy the file to the <SO network dir>/share/registry/data/org/openoffice/Office directory.

<?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></programlisting>

For a list as well as a description of command names, see [Index of UNO Command Names for Apache OpenOffice]. .

To Apply a Command Configuration File

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

1. Exit all Apache OpenOffice applications.
   On Windows, ensure that you exit the Apache OpenOffice 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:
     <SO network 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:
     <SO workstat dir>/user/registry/data/org/openoffice/Office

The configuration is applied when you restart Apache OpenOffice

Content on this page is licensed under the Public Documentation License (PDL).