Office Importer Application

The Office Importer application is bundled with XWiki Enterprise and it allows you to import Office documents into wiki pages. This application uses an Office server in order to convert Office documents into HTML and then into XWiki syntax.

Requirements

In order to use the Office Importer application, you need to:

  • have a properly configured XWiki Enterprise instance
  • install OpenOffice or LibreOffice
  • start the OpenOffice/LibreOffice server on the machine hosting your XWiki Enterprise instance

To learn how to configure the Office server, follow the dedicated documentation page.

There are 2 ways of importing an Office file into a wiki page:

  • using the "Create Page" form
  • using the "Wysiwyg" editor

Import an Office Page Using the "Create Page" Form

If you have configured an Office server and XWiki is connected to it, go to any wiki page and click the "+" button.

CreatePageButton.png

To learn how to fill in the "Title" and "Location" fields, please refer to this link. You will also notice a "Page from Office" option in the "Type" section.

CreatePageOffice.png

After clicking on "Create", you will be redirected to the new Office Importer UI which has been reworked in order to honor nested pages. The "Target" field represents the location in the page hierarchy where the new page will be created.

OfficeImporterApplicationUI.png

By checking the "Filter styles" option, any unnecessary styles will be removed from the result. Also, you may choose to create multiple wiki pages from the source page which will be split before each heading.

If the operation is successful, you will then see the XWiki.OfficeImporterResults page which contains 2 links:

  • the result link leading you to the recently imported page
  • the Go back link which redirects you to the Office Importer main page

ResultsPage.png

In case the imported file has embedded images, they are now saved as attachments to the target wiki page. This used to be the default behavior until recent versions of LibreOffice / OpenOffice have started to embed the images in the generated HTML, which ended up in the wiki syntax. Starting with version 8.3, the initial behavior has been restored.

Import an Office Page Using the WYSIWYG Editor

Edit an existing wiki page or a new one in "Wysiwyg" mode then follow the steps described in the dedicated documentation page.

   

Search this space