2.2. Plugin for OpenOffice.org/LibreOffice

2.2.1. Build and Installation

2.2.1.1. Get the sources

This plugin is available on the svn in the directory trunk/plugins/openoffice.

2.2.1.2. Dependances

Of course, you need OpenOffice or LibreOffice, this plugin has been test with the version 3.2. On Linux, you also need to have a valid Python environment (version 2.6) with the library Poster (available here).

2.2.1.3. Build

Note

You can skip this step, download this file (Windows) ot this file (Other). Note that this file may not be up to date.

You just have to made an archive (a zip file) of 3 files, the archive must have the extension .oxt:

• if you have a valid poster installation:

  zip openplm.oxt Addons.xcu META-INF/manifest.xml openplm.py

• else (this should work on Windows for example):

  zip openplm.oxt Addons.xcu META-INF/manifest.xml openplm.py pythonpath/*/*

This will create a file called openplm.oxt that you can install.

2.2.1.4. Installation

There are two ways to install this plugin:

• the command line
• the tool include OpenOffice

2.2.1.4.1. With the command line

You just have to install the plugin with the following command:

unopkg add -f -v openplm.oxt

Warning

This command installs the plugin for the current user, see the documentation of unopkg to make a system installation.

2.2.1.4.2. With the extensions manager

1. Launch OpenOffice

2. Launch the extension manager: menu Tools ‣ Extension Manager.... A dialog should appear:

   

3. Then click on the Add... button and select the file openplm.oxt

4. Now, the plugin is installed, close the dialog and restart openoffice. If the plugin is installed, a new menu called OpenPLM should be present.

2.2.2. Usage

2.2.2.1. Configuration

First, you should specify where the server is located. Open the configuration dialog (menu OpenPLM ‣ Configure). This dialog should appear:

Enter your server’s location and click on Configure.

2.2.2.2. Login

Before checking-out a file, you sould login. Open the configuration dialog (menu OpenPLM ‣ Login). This dialog should appear:

Enter your username and your password and click on Login.

2.2.2.3. Check-out a file

To check-out a file, click on OpenPLM ‣ Check-out. This dialog should appear:

Enter your query and click on the Search button, then expand the item called Results. You can browse the documents to see which files are available by expanding the items:

Then select your file and click on the Check-out button. This should open your file, now you can work as usual.

Once you have finished your work, you can revise the document or check-in it.

2.2.2.4. Download a file

If you just want to visualize a file without modifying it, click on OpenPLM ‣ Download from OpenPLM. Enter your query, select your file and click on the Download button.

2.2.2.5. Check-in a file

To save your work on the server, click on OpenPLM ‣ Check-in. This dialog should appear:

Check the Unlock? button if you want to unlock your file, this will also close your file in OpenOffice.

Click on the Check-in button.

2.2.2.6. Revise a document

To create a new revision of the document link to your file, click on OpenPLM ‣ Revise. This dialog should appear:

Check the Unlock? button if you want to unlock your file, this will also close your file in OpenOffice.

Note

The old revision file is automatically unlock.

Click on the Revise button.

2.2.2.7. Create a new document

You can create a new document from a file which was not checked-out nor downloaded. Click on OpenPLM ‣ Create a document. This dialog should appear:

Fill the form (do not forget the filename with its extension) and click on Create to validate the creation.

Like for a revision or a check-in, check the Unlock? button if you want to unlock your file, this will also close your file in OpenOffice.

2.2.2.8. Forget a file

All checked-out/downloaded files are opened when you launch OpenOffice, you can forget a file by clickin on OpenPLM ‣ Forget current file.

2.2.2.9. Attach a document to a part

You can link the current document to a part by clicking on OpenPLM ‣ Attach to part. This will display a dialog to choose the part. Select one and click on the Attach button.