Difference between revisions of "Documentation/Administration Guide/Restricting functionality"
(→To Apply a Command Configuration File) |
|||
Line 8: | Line 8: | ||
}} | }} | ||
− | You can restrict the functionality of {{OOo}} program modules for individual users, groups, or across a network. | + | You can restrict the functionality of {{OOo}} 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 {{OOo}} program. |
== Creating a Command Configuration File == | == Creating a Command Configuration File == | ||
Line 14: | Line 14: | ||
The creation of a command configuration file is a three-step process: | The creation of a command configuration file is a three-step process: | ||
− | * Determine the command names of the features that you want to restrict | + | * Determine the command names of the features that you want to restrict. |
− | * Create an XML configuration file | + | * Create an XML configuration file. |
− | * Copy the configuration file to the appropriate location in the {{OOo}} installation directory | + | * Copy the configuration file to the appropriate location in the {{OOo}} installation directory. |
====To Create a Command Configuration File==== | ====To Create a Command Configuration File==== | ||
<ol class="task"> | <ol class="task"> | ||
− | <li> Determine the [http://wiki.services.openoffice.org/wiki/Framework/Article/OpenOffice.org_2.x_Commands UNO Command Names] for the feature | + | <li> Determine the [http://wiki.services.openoffice.org/wiki/Framework/Article/OpenOffice.org_2.x_Commands UNO Command Names] for the feature that you want to restrict. |
</li> | </li> | ||
<li> In a text editor, create an XML configuration file.</li> | <li> In a text editor, create an XML configuration file.</li> | ||
<ol class="task" type="a"> | <ol class="task" type="a"> | ||
− | <li> | + | <li>Use the following file structure.</li> |
<source lang="xml"> | <source lang="xml"> | ||
Line 69: | Line 69: | ||
<li>In each node, replace the term <tt>CommandName</tt> with the command name of the feature.</li> | <li>In each node, replace the term <tt>CommandName</tt> with the command name of the feature.</li> | ||
</ol> | </ol> | ||
− | <li>Save the file | + | <li>Save the file with the file name <tt>Commands.xcu</tt>.</li> |
</ol> | </ol> | ||
− | The following <tt>Commands.xcu</tt> file disables the ability to customize menus in {{OOo}}. To apply this restriction to all users, copy the file to the <tt> | + | The following <tt>Commands.xcu</tt> file disables the ability to customize menus in {{OOo}}. To apply this restriction to all users, copy the file to the <tt>''network-install-dir''/share/registry/data/org/openoffice/Office</tt> directory. |
− | + | ||
<source lang="xml"> | <source lang="xml"> | ||
Line 99: | Line 98: | ||
</source> | </source> | ||
− | For a list | + | For a list of command names and their descriptions, see [[Framework/OpenOffice.org_2.0_Command_Reference|Index of UNO Command Names for {{OOo}}]]. |
====To Apply a Command Configuration File==== | ====To Apply a Command Configuration File==== | ||
− | You can apply a command configuration file to {{OOo}} on Solaris, Linux, and Windows. | + | You can apply a command configuration file to {{OOo}} on the Solaris, Linux, and Windows platforms. |
# Exit all {{OOo}} applications.<br> On Windows, ensure that you exit the {{OOo}} Quickstarter in the system tray. | # Exit all {{OOo}} applications.<br> On Windows, ensure that you exit the {{OOo}} Quickstarter in the system tray. | ||
# Copy the <tt>Commands.xcu</tt> file to the appropriate directory. | # Copy the <tt>Commands.xcu</tt> file to the appropriate directory. | ||
− | #* To apply the configuration to all users on the network, copy the <tt> Commands.xcu</tt> file to the following directory:<br> <tt> | + | #* To apply the configuration to all users on the network, copy the <tt> Commands.xcu</tt> file to the following directory:<br> <tt>''network-install-dir''/share/registry/data/org/openoffice/Office</tt> |
− | #* To apply the configuration to a specific user on the network, copy the <tt> Commands.xcu</tt> file to the following directory:<br> <tt> | + | #* To apply the configuration to a specific user on the network, copy the <tt> Commands.xcu</tt> file to the following directory:<br> <tt>''workstat-dir''/user/registry/data/org/openoffice/Office</tt> |
The configuration is applied when you restart {{OOo}} | The configuration is applied when you restart {{OOo}} | ||
{{PDL1}} | {{PDL1}} |
Revision as of 08:39, 13 June 2008
- 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
You can restrict the functionality of Apache OpenOffice 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 Apache OpenOffice 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 that you want to restrict.
- Create an XML configuration file.
- Copy the configuration file to the appropriate location in the Apache OpenOffice installation directory.
To Create a Command Configuration File
- Determine the UNO Command Names for the feature that you want to restrict.
- In a text editor, create an XML configuration file.
- Use the following file structure.
- Create a separate node for each feature that you want to restrict.
- In each node, replace the term CommandName with the command name of the feature.
- Save the file with the file name Commands.xcu.
<?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>
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 network-install-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>
For a list of command names and their descriptions, 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 the Solaris, Linux, and Windows platforms.
- Exit all Apache OpenOffice applications.
On Windows, ensure that you exit the Apache OpenOffice Quickstarter in the system tray. - 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
- To apply the configuration to all users on the network, copy the Commands.xcu file to the following directory:
The configuration is applied when you restart Apache OpenOffice
Content on this page is licensed under the Public Documentation License (PDL). |