User's Guide (v 1.4)

Owned by Almuth Boehme [Communardo]
Aug 19, 2016
1 min read

The SharePoint Connector User's Guide tells you how to search Confluence and SharePoint content, display SharePoint content in Confluence and display Confluence content in SharePoint.

On this page:

Embedding Confluence Content into a SharePoint Page

Using the Confluence SharePoint Connector, you can display Confluence pages, blog posts and page/blog trees on your SharePoint pages.

Quick guide to adding Confluence content on SharePoint pages

  • Go to a web part page in SharePoint and edit the page.
  • Click 'Add a Web Part' in the zone where you want to put your Confluence web part.
  • Scroll down to find the Confluence web parts:
    • Select the 'Confluence Page' web part if you want to embed a single Confluence page.
    • Select the 'Confluence Pages Tree View' web part if you want to embed a hierarchical tree of pages from a Confluence space.
  • The web part is now part of your SharePoint page. Click the web part's dropdown menu and select 'Modify Shared Web Part' or 'Edit Web Part'.
  • The web part editor appears. Select the required space, and the page if relevant.
  • Click 'OK'.

Want more?

Please refer to the guide for SharePoint 2007 web parts and for SharePoint 2010 web parts.

Embedding SharePoint Content on a Confluence Page

Displaying SharePoint Lists on a Confluence Page

Add the SharePoint List macro to a Confluence page, to embed SharePoint content into the page.

Quick guide to the SharePoint List macro

Using the simplest form of the macro, all you need to enter is the name of your SharePoint list. The macro will display default columns, based on the list's default view.

  • Enter the following text onto the Confluence page:

    {sp-list:List=LIST NAME}
  • Replace the text 'LIST NAME' with your own value.

Linking to a SharePoint List or Document from a Confluence Page

Add the SharePoint Link macro to a Confluence page, to link to a SharePoint list or document from the Confluence page.

Quick guide to the SharePoint Link macro

Using the simplest form of the macro, all you need to enter is the name of your SharePoint list or document library, and optionally the path to a document. The SharePoint Link macro will create a hyperlink on your page, pointing to the SharePoint location or file specified.

  • Enter the following text onto the Confluence page to link to a list:

    {sp-link:LIST-NAME}my hyperlinked text{sp-link}

    Or enter the following text to link to a specific document:

    {sp-link:LIBRARY-NAME/DOCUMENT-NAME}my hyperlinked text{sp-link}
  • Replace the text 'LIST-NAME' with your own values for your SharePoint list name, or replace the text 'LIBRARY-NAME/DOCUMENT-NAME' with your SharePoint document library and file name.
  • Replace the text 'my hyperlinked text' with the words that you want displayed as a hyperlink on the Confluence page.

Want more?

Please refer to the details of the parameters and options for the {sp-list} macro and the {sp-link} macro.

Searching Confluence and Sharepoint Content

Searching in SharePoint

When you perform a search in SharePoint:

  • By default, all searches will return content from both Confluence and Sharepoint.
  • The results will be ordered by relevance, regardless of which system they are from.

To search for Confluence and SharePoint content from a SharePoint page,

In SharePoint 2007 and SharePoint 2010:

  1. Select 'All Sites' in the search scope option. Note that your search scope cannot be 'This Site' or 'This List'.
  2. Enter your search words and click the 'Go Search' icon. Here is an example of the SharePoint search box:
  3. The search results page will open, showing the Confluence federated search results web part.

In SharePoint 2013 enter your search terms in the Search field and click the Search icon.


Searching in Confluence

There are two options when searching from a Confluence screen:

  • Searching Confluence only
  • Searching SharePoint and Confluence.

To search for Confluence and SharePoint content from a Confluence page,

  1. Select 'SharePoint & Confluence' in the search scope option. Here is an example of the Confluence search box: 
  2. Enter your search words and click the 'Search' button.
  3. The search will open in SharePoint and the results will be the same as when you perform the search from SharePoint.


Want more?

Please refer to the detailed guide to searching.

RELATED TOPICS