The Free and Open Productivity Suite
Released: Apache OpenOffice 4.1.14

Installation Guide for the Office Scripting Framework


Who Should Read This Document

This document should be read by: Top


The table below shows the JDK and memory requirements for running the Office Scripting Framework.

User IDE JDK required Memory required
Script User - 1.4.0_02 256MB
Script Developer NetBeans 3.4 1.4.0_02 512MB

Downloading the Scripting Framework

The Scripting Framework is available for download in the form of a Jar file which can be obtained from here. The contents of the Jar file are as follows: Top

Installing the Scripting Framework

Before you begin installation, you need to ensure all Office processes have terminated and on Windows and Linux, that the QuickStarter has been closed.

Note: Unlike previous releases, release 0.3 must be installed by the same user who installed, ie. the Administrator in the case of a network installation. This requirement is due to the fact that release 0.3 contains a schema extension to the registry which must be installed under <Office Installation>/share.

Note: Before installing an updated version of the Scripting Framework, the previous version should be removed. (See the Guide for Uninstalling)

To install the Scripting Framework:

This will start the installer GUI, which you can use to select the Office installation to which you want to install the Scripting Framework. The framework is installed in the <Office Installation>/user/uno_packages directory of the Office installation you choose. If the installer detects an installation of either NetBeans 3.4 you will be asked whether you wish to install the IDE Add-ins. These add-ins provide support for developing and deploying Office Scripts.

Note: If you do not wish to use the GUI you can install the Scripting Framework and the IDE Add-in via the command line using the command:

java -jar SFrameworkInstall.jar -office <Office Installation> -netbeans <NetBeans Installation>

Note: The installer detects IDE installations by looking for session related files in the home directory of the user running the install, so in order for your IDE to be detected you will need to have run it at least once.

Installing the Scripting Framework in a Network Installation of

Installing the Scripting Framework into an network installation can only be done via the command line. the installation done as a two-part process.First (after installing the, the setup -net part) install the components and shared scripts, macros etc:

java -jar SFrameworkInstall.jar -office <Shared Office Installation> -net

then as each user, once the user has installed (setup from the shared installation), add the menu bindings to the Scripting Framework dialogs:

java -jar SFrameworkInstall.jar -office <User Office Installation> -bindings

This is currently not working on Linux due to a bug in the Linux release of OpenOffice.org1.1rc. It is expected that this will be fixed by the next release.

Update: The network install in current download is broken, this will be fixed as soon as possible.


Last Modified: Tue Sep 16 18:48:26 BST 2003

Apache Software Foundation

Copyright & License | Privacy | Contact Us | Donate | Thanks

Apache, OpenOffice, and the seagull logo are registered trademarks of The Apache Software Foundation. The Apache feather logo is a trademark of The Apache Software Foundation. Other names appearing on the site may be trademarks of their respective owners.