Child pages
  • Importing an Office Document into Confluence

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

...

Prerequisites for the Office Connector's document import feature:

Include Page
DOC:_Office Connector Prerequisites for Import
nopanelDOC:true
_Office Connector Prerequisites for Importnopaneltrue

For a full list of Office Connector prerequisites and limitations, please refer to:

...

Section
Column
width1%

 

Column
width99%

The simplest way to import an Office document is to import the entire content of the document into a single wiki page.

This method will replace any existing content on the wiki page.

To import an Office document onto a single wiki page,

Panel
borderColor#ccc
bgColor#D5EFFF
titleBGColor#F7D6C1
borderStyledashed
  1. Create a page in Confluence (see Creating a New Page) or go to an existing page whose content you want replaced.
  2. Excerpt Include
    DOC:Navigating to the Doc Import Option
    nopanelDOC:true
    Navigating to the Doc Import Option
    nopaneltrue
  3. Click the 'Browse' button and find the Office document on your local drive or network.
  4. Click the 'Open' or 'Upload' button provided by your browser. The path and file name of the document will now appear in the text box on the Office Connector import screen.
  5. Click the 'Next' button on the Office Connector import screen. The import document options screen will display.
  6. Enter the following for your import document options:
    • 'Root page title' — The title of the wiki page that will contain the information from your imported document.
    • Choose whether to import your document as a new wiki page or to replace and existing page, by selecting one of the following options:
      • 'Import as a new page in the current space' — A new wiki page will be created with the page title specified above.
      • 'Replace <pagename>' — The contents of the existing page will be replaced. The page will be renamed to the page title specified above.
        • 'Delete existing children of <pagename>' — This checkbox will enable if you have selected 'Replace <pagename>'. Tick this checkbox to delete the existing child pages of the page you are replacing.
    • Choose what you want the importer to do if there are page title conflicts, by selecting one of the following options:
      • 'Rename imported pages if page name already exists' — Confluence will assign new names to any new page which would otherwise have a duplicate name. The content of existing pages will remain unchanged.
      • 'Replace existing pages with imported pages of the same title' — If a page already exists in Confluence with a title equal to the new page, then the content of the Office document will overwrite the content on the existing page. Page history will be preserved.
      • 'Remove existing pages with the same title as imported pages' — Before creating the new page, Confluence will remove any existing page which has the same title. This will remove the page history as well as the content.
    • 'Split by heading' — Use this field to split your document into multiple wiki pages. If you don't want to split your document into multiple wiki pages, leave the default 'Don't split' option selected. For more information on splitting your document, please see below.
  7. Click 'Import' to import your document.
  8. When the upload has finished, the content of the Office document will have been transformed into Confluence page content. You can now view and edit this page in the normal way, using the Confluence Rich Text Editor or Wiki Markup. There is no connection between the original Office document and this wiki page.

Screenshot: Empty page ready for import


Screenshot: Selecting Office document to import


Screenshot: Importing an Office document

Screenshot: Page after import

...

Section
Column
width1%

 

Column
width99%

When importing an Office document, you can split a single document into more than one wiki page, based on the heading styles in the document.

By default, the page names will be the same as the heading text. This may result in a conflict, if a page already exists with the same title. You can instruct the importer how to handle such conflicts.

To import an Office document into multiple wiki pages,

Panel
borderColor#ccc
bgColor#D5EFFF
titleBGColor#F7D6C1
borderStyledashed
  1. Import an Office document as described above. On the import document options screen, choose how to split your document in the 'Split by heading' field:
    • 'Split by heading' — If you want to split the content under each heading in your document into separate child pages, select the desired heading level to split by. A preview of the page hierarchy that will be created by the split will be displayed under 'Document Outline'. Each bullet point in the 'Document Outline' represents a new page after import into Confluence.
  2. Click 'Import' to import your document.
  3. When the upload has finished, the content of the Office document will have been transformed into Confluence page content. You can now view and edit this page in the normal way, using the Confluence Rich Text Editor or Wiki Markup. There is no connection between the original Office document and this wiki page.


Screenshot: Splitting a single Office document into multiple wiki pages

...

Children Display
depth1
pageDOC:Working with the Office Connector

...