This documentation relates to an old version of the Nuxeo Platform Document Management module (5.5). You may want to check the latest version of the User Guide or of the Administration Guide.

Versions Compared

Old Version 2

changes.mady.by.user Solen Guitter

Saved on

compared with

New Version 3

changes.mady.by.user Laurent Doguin

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Updated links to other 5.5 documentation
Section
Column
width70%

Live Edit works with Microsoft Office and OpenOffice.org. It is available for Internet Explorer and Firefox browsers. The table below summarizes the extensions and packages you need to install for each OS and browser.

The Microsoft Office extension is available in 32- and 64-bit. You need to install the version corresponding to Microsoft Office, not the operating system (if you run MS Office 32-bit on Windows 7 64-bit, you need to install Live Edit for MS Office 32-bit).

 

Internet Explorer

Firefox

Microsoft Office 32-bit

Live Edit MS Office-IE 32-bit (.msi)

Live Edit MS Office-IE 32-bit (.msi)
Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+

Microsoft Office 64-bit

Live Edit MS Office-IE 64-bit (.msi)

Live Edit MS Office-IE 64-bit (.msi)
Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+

OpenOffice.org / LibreOffice

Live Edit MS Office-IE 32-bit (.msi)
Live Edit OOo Distribution (.exe)

Live Edit OpenOffice.org extension (.oxt)
Firefox Protocol Handler for FF <3.6 or Firefox Protocol Handler for FF 4+

All Live Edit extension versions are available from: http://download.nuxeo.org/desktop-integration/live-edit/.

Info
titleLive Edit MS Office requirements

The Live Edit MS Office installers require .Net and the installation of the Microsoft Office Primary Interop Assemblies (PIA) that corresponds to the version of Microsoft Office. These are already installed on a complete default installation of MS Office, so you probably don't need to install them.

For Internet Explorer 9 users
If you are on a 64-bits Windows you have two versions of Internet Explorer 9 (32-bits and 64-bits of course), if you have Office 32-bits and use Internet Explorer 64-bits, you'll need to apply this registry fix to enable Live Edit in Internet Explorer 9 64-bits: liveedit-ie-x64-fix.reg

For Windows XP / MS Office 2003 32 bits users
You need to install the previous version of Live Edit (2.3.0) available from: http://download.nuxeo.org/desktop-integration/live-edit/nuxeo-liveedit-msoffice-ie-2.3.0.msi.
You also need to install the Microsoft Visual Studio 2005 Tools for Office Runtime available from: http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=24263.

Column
Panel
bgColor#FFFFFF
titleOn this page
Table of Contents

For MS Office and Internet Explorer users
Anchor
LiveEdit-MSO-IE

To install Live Edit for MS Office:

  1. Run the Live Edit installer and follow the instructions.
  2. If your are using Internet Explorer, close all windows and restart it.
  3. Go on your Nuxeo application.
    You now have new icons displayed:
    • MS Office icons below the search box
    • an online editing icon in the workspace listing for MS office documents
    • an online editing icon in the Summary tab of MS office documents

      You can now edit documents online.

For MS Office and Firefox users
Anchor
LiveEdit-MSO-FF

Making LiveEdit work for MS Office documents when you use Firefox takes 3 steps:

  1. Install Live Edit for MS Office,
  2. Install the Firefox extension for Live Edit, called protocal handler,
  3. Configure the Firefox protocol handler.

Installing Live Edit for MS Office
Anchor
LiveEdit-MSO-IE-forFF

You need to install Live Edit for Microsoft Office using the same installer as for MS Office and Internet Explorer: just run the installer and follow the instructions displayed.
At the end of this step, you won't see the online editing icons, because you need to install and configure the Firefox protocol handler.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser.
To install it, click on the link to download it and follow the instructions displayed.
At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox protocol handler

To configure Live Edit Firefox Protocol Handler:

  1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
  2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
  3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
  4. Be sure that the checkbox "Use NXWss" is un-checked.
  5. Be sure that the checkbox "Preserve compatibility" is un-checked.
    Note

    Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility.
    This box must be checked when the targeted server is pre 5.2.
    Without checking it, the add-on is forming a different type of headers allowing using of a bunch of new features like WebEngine (but it works only for the server 5.2 +). Simple said:

    • if Live Edit appear not to work (there is no available Edit online link) and the targeted Nuxeo server is not 5.2 or higher, check that the "Preserve compatibility" is marked.
    • if some cool features like WebEngine are not available (throwing exception) and the targeted Nuxeo server is 5.2 or higher, check that the "Preserve compatibility" is not marked.
  6. Click Ok.

MS Office mimetype mapping with MS Office

File extension

Mimetype

Editor command

Editor command arguments

.doc

application/msword

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

.xls

application/vnd.ms-excel

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

.ppt

application/vnd.ms-powerpoint

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

.docx

application/vnd.openxmlformats-officedocument.wordprocessingml.document

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

.xlsx

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

.pptx

application/vnd.openxmlformats-officedocument.presentationml.presentation

C:\Program Files\Nuxeo\Nuxeo Live Edit MsOffice IE\nuxeo-liveedit-msoffice-launcher.exe

%s

For OpenOffice.org and Internet Explorer users
Anchor
LiveEdit-OOo-IE

To make Live Edit work when you use OpenOffice.org and Internet Explorer, you need to:

  1. install the MS Office - IE Live Edit (see Installing Live Edit for MS Office),
  2. install the OpenOffice.org - IE Live Edit extension (see below).

To install Live Edit for OpenOffice.org and Internet Explorer:

  1. Run the OpenOffice.org - IE Live Edit installer (.exe) and follow the instructions displayed.
  2. Restart Internet Explorer if you have windows open.
  3. Go on your Nuxeo application.
    You now have new icons displayed:
    • MS Office and OpenOffice.org icons below the search box
    • an online editing icon in the workspace listing for MS Office and OpenOffice.org documents
    • an online editing icon in the Summary tab of MS Office and OpenOffice.org documents

      You can now edit documents online.

For OpenOffice.org and Firefox users
Anchor
LiveEdit-OOo-FF

To be able to edit OpenOffice.org documents online using Firefox, you need to:

  1. install the Live Edit OpenOffice.org extension (.otx),
  2. install the Firefox protocol handler,
  3. configure the Firefox protocol handler.

Installing the Live Edit OpenOffice.org extension (.oxt)

The Live Edit extension for OpenOffice.org is a regular OOo extension and gets installed the same way as any other extension: just double-click the .otx file and follow the instructions.

Note

The Live Edit extension for OpenOffice requires Java support in OpenOffice, this is included in most of distributions, but on some Linux distributions you may need to install openoffice-java-common for the extension installation to work.

Then you need to install and configure the Firefox extension.

Installing Firefox Protocol Handler

The Firefox Live Edit extension is a regular Firefox extension and gets installed the same way as any other extension on that browser.
To install it, click on the link to download it and follow the instructions displayed.
At this stage, you still won't see the online editing icons in the application. To see the icons and be able to edit documents, you need ton configure the protocol handler.

Configuring the Firefox protocol handler

To configure Live Edit Firefox Protocol Handler:

  1. In Firefox, go to Tools > Add-ons > Nuxeo Live Edit Protocol Handler > Preferences (or Options).
  2. Change the temp folder : /tmp/ with C:\Temp (or another temp folder like C:\Windows\Temp)
  3. Set the mime-types you want to use Live Edit with and click on Add new mapping (see below for the mimetypes mapping).
  4. Be sure that the checkbox "Use NXWss" is un-checked.
  5. Be sure that the checkbox "Preserve compatibility" is un-checked.
    Note

    Since version 0.4.6 of the protocol handler, there is a checkbox labeled "Preserve compatibility" that allows to preserve the backward compatibility.
    This box must be checked when the targeted server is pre 5.2.
    Without checking it, the addon is forming a different type of headers allowing using of a bunch of new features like WebEngine (but it works only for the server 5.2 +). Simple said:

    • if Live Edit appear not to work (there is no available Edit online link) and the targeted Nuxeo server is not 5.2 or higher, check that the "Preserve compatibility" is marked.
    • if some cool features like WebEngine are not available (throwing exception) and the targeted Nuxeo server is 5.2 or higher, check that the "Preserve compatibility" is not marked.
  6. Click Ok.

OpenOffice.org and MS Office mimetype mapping with OpenOffice.org

File extension

Mimetype

Editor command

Editor command arguments

.doc

application/msword

C:\Program Files\OpenOffice.org 3\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s)

.xls

application/vnd.ms-excel

C:\Program Files\OpenOffice.org 3\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s)

.odt

application/vnd.oasis.opendocument.text

C:\Program Files\OpenOffice.org 3\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s)

.ods

application/vnd.oasis.opendocument.spreadsheet

C:\Program Files\OpenOffice.org 3\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s)

.odp

application/vnd.oasis.opendocument.presentation

C:\Program Files\OpenOffice.org 3\program\soffice.exe

macro:///LiveEditOOo.launcher.load(%s)

Note

Live Edit OpenOffice.org is not compatible with MS Office 2007 documents yet.

For Google Chrome users under MS Windows
Anchor
LiveEdit-Chrome-MSW

For Windows users, Chrome will use Windows registry where NuxeoLiveEdit protocol is declared (LiveEdit for MS IE must be installed). However some steps are needed to configure your computer and the server.

On your machine, you need to force Chrome to handle nxedit protocol:

  1. Close Google Chrome because at shutdown it dumps its properties in the file we'll modify.
  2. Edit the Local State file located under:
    • XP: C:\Documents and Settings\<USERNAME>\Local Settings\Application Data\Google\Chrome\User Data;
    • Vista/7: C:\Users\<USERNAME>\AppData\Local\Google\Chrome\User Data.
  3. Add the protocol nxedit under the protocol_handler section, as such:
    No Format
       "protocol_handler": {
      "excluded_schemes": {
         ...
         "nxedit": false,
         ...
   }

If the section protocol_handler doesn't exist, find a mailto link and follow it, it should initialize this section.

Server side, because we don't have yet a mechanism to detect that LiveEdit is configured, you have to set a property to allow LiveEdit on each document type. As a consequence, you'll have to pay attention when clicking on LiveEdit links.

  1. Edit $NUXEO_HOME/templates/common/config/nuxeo.properties.
  2. Change the value for the property org.nuxeo.ecm.platform.liveedit.config from client to server (uncomment the line if needed).
  3. Restart the Nuxeo server.
Section
Column
width50%
Content by Label
spaces@self
titleMore in this guide
showLabelsfalse
sortcreation
labelslive-edit
showSpacefalse
typepage
Column
Content by Label
spacesNXDOC55 KB
titleIn other documentation
showLabelsfalse
sortcreation
labelslive-edit
showSpacetrue
typepage