Wiki source code of Office Importer

Last modified by Eleni Cojocariu on 2026/09/07 20:57

Show last authors
1 The Office Importer turns an office document into wiki content: a text document, a spreadsheet or a presentation becomes a Page you can read, search and edit like any other. It exists so that content already written in an office suite reaches the wiki without being retyped in XWiki syntax.
2
3 There are two ways to import a document, and they differ in what they produce.
4
5 {{plantuml}}
6 @startuml
7 !theme bluegray
8 skinparam componentStyle rectangle
9
10 file "Office document" as DOC
11
12 rectangle "Importing while\ncreating a Page" as CREATE
13 rectangle "Importing while\nediting a Page" as EDIT
14
15 rectangle "A new wiki Page\nseveral, when the document is split" as PAGES
16 rectangle "Content added to the Page\nyou are already editing" as INLINE
17
18 DOC --> CREATE
19 DOC --> EDIT
20 CREATE --> PAGES
21 EDIT --> INLINE
22 @enduml
23 {{/plantuml}}
24
25 [[Importing while creating a Page>>doc:documentation.xs.user.base.page.create.office-importer.import-office-documents.WebHome]] converts the document into a **new** Page: one Page per document, or several when you ask the [[Office Importer Wizard>>doc:documentation.xs.user.base.page.create.office-importer.import-office-documents.office-importer-wizard.WebHome]] to split the document on its heading levels.
26
27 [[Importing while editing a Page>>doc:documentation.xs.user.base.page.edit-page.import-office-documents-wysiwyg-editor.WebHome]] adds the converted content **to the Page you already have open**.
28
29 Both need a running office server, which an administrator [[configures>>doc:documentation.xs.admin.exports.office-server-properties.WebHome]] once for the whole wiki.

Get Connected