This page last changed on Nov 11, 2008 by smaddox.
The Office Connector in Confluence allows you to import an Office document into Confluence, so that the document's content is copied onto one or more Confluence pages.
This is just one of the ways Confluence can interact with Office documents. For an overview of all Office Connector features, please refer to Working with the Office Connector.
Your System Administrator can enable or disable the Office Connector or parts of it. The Office Connector options can appear in different places on your Confluence page, depending on the themes and configuration of your Confluence site. Please refer to Configuring the Office Connector in the Confluence Administration Guide and discuss any configuration problems with your administrator.
On this page:
Prerequisites for the Document Import Feature
- Document import can import documents of the file type .doc. These must be valid binary Word 97-2003 documents.
Above are the prerequisites for the Office Connector's Document Import feature. For a full list of Office Connector prerequisites and limitations, please refer to:
Importing an Office Document into Confluence
The simplest way to import an Office document is to import the entire content of the document into a single wiki page. By default, the content of the document will replace any existing content on the wiki page.
More advanced options allow you to import the content into a new page, to split a single document into more than one wiki page, and to resolve conflicts in the titles of your pages.
These options are described below.
Importing an Office Document onto a Single Wiki Page
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,
- Create a page in Confluence (see Creating a New Page) or go to an existing page whose content you want replaced.
Open the 'Tools' menu and select 'Doc Import'. The Office Connector import screen will appear.
- Click the 'Browse' button and find the Office document on your local drive or network.
- 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.
- Click the 'Import' button on the Office Connector import screen.
- 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: Importing an Office document
Screenshot: Page after import

Splitting an Office Document into Multiple Wiki Pages
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,
- Create a page in Confluence (see Creating a New Page) or go to an existing page whose content you want replaced.
Open the 'Tools' menu and select 'Doc Import'. The Office Connector import screen will appear.
- Click the 'Browse' button and find the Office document on your local drive or network.
- 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.
- Click the 'Advanced' button on the Office Connector import screen. The Advanced options screen appears.
- Choose a 'Root Page Title'. This will be the name of the top-most page created.
- Under 'Title Conflicts', select one of the following options:
- 'Imported pages become new versions of existing pages with 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.
- 'Imported pages should be auto-renamed if their titles conflict with existing pages' — Confluence will assign new names to any new page which would otherwise have a duplicate name. The content of existing pages will remain unchanged.
- 'Delete 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.
- In the dropdown list next to the 'Split' option, select the required heading level. Confluence will create a new wiki page for each occurrence of this heading level in your Office document. For example, if you choose 'Level 1' and your Office document has 5 level-1 headings then Confluence will create 5 pages, with titles equal to the text of the headings.
- Check the 'Document Outline', which shows the structure of your document based on its heading styles. Each bullet point in the 'Document Outline' represents a new page after import into Confluence.
- Click the 'Import' button.
- When the upload has finished, the content of the Office document will have been transformed into Confluence page(s). You can now view and edit the page(s) in the normal way, using the Confluence Rich Text Editor or Wiki Markup. There is no connection between the original Office document and the wiki page(s) derived from it.
Screenshot: Splitting a single Office document into multiple wiki pages

Creating a New Wiki Page on Import
When you import a document into an existing wiki page, the content of the document will replace any existing content on the wiki page. You can use the advanced import options to create a new page instead.
The new page will become a child of the space's home page.
To import an Office document into a new wiki page,
- Go to any existing page in the Confluence space where you want to import content.
Open the 'Tools' menu and select 'Doc Import'. The Office Connector import screen will appear.
- Click the 'Browse' button and find the Office document on your local drive or network.
- 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.
- Click the 'Advanced' button on the Office Connector import screen. The Advanced options screen appears.
- For 'Root Page Title', enter a title for your new page.
- For the 'Where to Import' option, choose 'Import as new page in current space'.
- Click the 'Import' button.
- When the upload has finished, the content of the Office document will have been transformed into a new Confluence page, as a child of the space's home page. You can now view and edit the page in the normal way, using the Confluence Rich Text Editor or Wiki Markup. There is no connection between the original Office document and the wiki page derived from it.
Screenshot: Importing an Office document into a new wiki page

RELATED TOPICS
Working with the Office Connector
Configuring the Office Connector in the Confluence Administration Guide
Take me back to Confluence User Guide
|