The Office Connector is a Confluence plugin that allows Confluence users to interact with Microsoft Office and Open Office in various ways. You can display content from Office documents on a wiki page, import content from an Office document into Confluence, and edit a Confluence page in Microsoft Word. Please refer to the User Guide for details of these interactions.

A System Administrator can enable or disable parts of the Office Connector and can configure options as described below.

On this page:

Enabling and Disabling the Office Connector and its Modules

A System Administrator can install, enable or disable plugins and plugin modules. You can read a general overview in Installing Plugins and Macros.

The Office Connector is bundled with Confluence 2.10 and later, so you should not need to install it. But you may wish to enable or disable some of its modules.

To enable or disable the Office Connector and its modules,

  1. Select 'Plugins' in the left-hand panel of the Confluence Administration Console.
  2. Search the page for 'Office Connector plugin' and select the link.
  3. The 'Office Connector plugin' panel will appear near the top centre of the page, as shown in the screenshot below.
  4. Now you can do one of the following:
    • Configure plugin — This will take you to the separate plugin configuration screen described below.
    • Disable plugin — Click this link if you want to disable all modules of the plugin, but leave the plugin installed on your Confluence site.
    • Uninstall plugin — Click this link if you want to remove the Office Connector permanently from your Confluence site. To restore it at a later date, you will need to re-install it from the Confluence Plugin Repository.
    • You can also enable or disable one or more of the Office Connector modules, as described in the table below.


Screenshot: Enabling the Office Connector plugin and its modules




The following modules are available for the Office Connector plugin:

Module

説明

Office Connector administration link

This module supplies the 'Office Connector Configuration' link in the left-hand panel of the Confluence Administration Console. The link gives access to the plugin configuration screen described below.

Link for previewing a search result

This modules supplies the 'View' link which appears next to attachments displayed in search results, where the attachment is an Office document.

Link for previewing an attachment

This modules supplies the 'View' link which appears next to attachments displayed on the 'Attachments' view of a page, where the attachment is an Office document.

Edit in Word UI on page actions

This module supplies an 'Edit in Word' icon which appears in older versions of Confluence, at the top right of the page with other icons such as the 'Browse Space' and 'Add Page' icons. Not relevant to Confluence 2.10 or later, except for custom themes. You can configure the location of this option on the Office Connector configuration screen, as described below.

Edit in Word UI on drop down menu

This modules supplies the 'Edit in Word' link which appears in the Confluence 'Tools' dropdown menu.

editinwordlink

This modules supplies the {editinwordlink} macro. See Edit in Word Link Macro.

viewfile

This modules supplies the {viewfile} macro. See View File Macro.

Edit in Word UI on page tabs

This module supplies an 'Edit in Word' tab which appears in older versions of Confluence, next to the 'View', 'Edit', 'Attachments' and 'Info' tabs. Not relevant to Confluence 2.10 or later, except for custom themes. You can configure the location of this option on the Office Connector configuration screen, as described below.

Import Word UI on page tabs

This module supplies a 'Doc Import' tab which appears in older versions of Confluence, next to the 'View', 'Edit', 'Attachments' and 'Info' tabs. Not relevant to Confluence 2.10 or later, except for custom themes.

Import Word UI on drop down menu

This modules supplies the 'Doc Import' link which appears in the Confluence 'Tools' dropdown menu.

Office Connector Servlet

This module allows Confluence users to edit their Confluence pages in Microsoft Word. It performs the conversion to and from Word.

PPT slide web service

This module allows Confluence users to view a PowerPoint presentation on a wiki page. It provides the slide images to the Flash control which displays the slides on the wiki page.

DOC and XLS image cache web service

This module is required if Confluence users want to view a Word document or an Excel spreadsheet on a wiki page. It allows images to be stored in a cache on the server, so that they can be retrieved when the browser renders the HTML page.

Office Connector Actions

This module must be enabled if the Office Connector is used.

Office コネクタ オプションを設定する

A Confluence administrator can set the options described below, to determine the behaviour of the Office Connector on your Confluence site.

To set the configuration options for the Office Connector,

  1. Select 'Office Connector Configuration' in the left-hand panel of the Confluence Administration Console.
  2. The 'Configure Office Connector plugin' screen will appear. Set the configuration options as described in the table below.

Screenshot: Configuring the Office Connector options




The configuration options are described in the table below:

オプション

既定値

説明

Word で編集ボタンの位置

'Tools' menu.

This setting determines the location of the 'Edit in Word' option on the Confluence menus or screens. You may want to change the location if you are using a theme which does not support the default location. Note that you must ensure that the relevant plugin modules are enabled, as described above. Available settings are:

  • Page action icon — An icon at the top right of the page with other icons such as the 'Browse Space' and 'Add Page' icons.
  • View page tab — A page tab, next to the 'View', 'Edit', 'Attachments' and 'Info' tabs.

Warnings: Show a warning before allowing a user to perform an import

無効

このオプションが有効の場合、ユーザーが Word ドキュメントをインポートする際に警告が表示されます。この警告は、ユーザーが既存のコンテンツを上書きする際に通知されます。

Advanced Formatting Options: Use the footnote macro for Word footnotes

無効

If this option is enabled, a Confluence page created from an imported Word document will use the {footnote} macro from Adaptavist to render any footnotes contained in the document. Note that you will need to install the Footnotes Plugin onto your Confluence site. For more information about this plugin and macro, please refer to the Footnotes Plugin.

Temporary storage for viewfile macro

Confluence ホーム ディレクトリ

The {viewfile} macro will cache data temporarily. This option allows you to set the location of the cache. If you are running in a clustered environment, we recommend that you use the Cache in-memory setting.

Number of Conversion Queues

6

This is the maximum number of threads used to convert PowerPoint or PDF slide shows. You can use this setting to manage Confluence performance, by limiting the number of threads so that the Office Connector does not consume too many resources.

関連トピック

Office Connector Prerequisites
Office Connector Limitations and Known Issues
Working with the Office Connector
Installing Plugins and Macros

  • ラベルなし

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.