This documentation relates to SharePoint Connector 1.8
If you are using an earlier version, please view the previous versions of the SharePoint Connector documentation and select the relevant version.

Skip to end of metadata
Go to start of metadata

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

Icon
  • 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:

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

Icon

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

Icon

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

  • No labels

11 Comments

  1. Anonymous

    Once we upgraded the connector to 1.3 the autocomplete/autosuggest in the search bar is no longer working. Is this a configuration issue or a bug?

    1. Hi,

      The autocomplete in the search bar should work if you have "Confluence Only" selected. Unfortunately we have not yet been able to implement a similar implementation for the SharePoint search... I hope that we will be able to investigate this in a future release.

      Cheers,

      Joe.

  2. With this plug-in, is there a macro available to list all the documents within a document library from SharePoint?

      1. Thanks for that. I incorrectly assumed since the parameter in the macro was 'list' it could only read from lists in SharePoint.

        1. No problem! I can understand your confusion. We rely on the fact that in SharePoint, a Document Library is just a specialised kind of list.  I will update the wording on the page to do a better job of explaining that it definitely works with document libraries,

  3. Anonymous

    Handy web-part to publish user profiles on SharePoint pages: HarePoint Business Cards —
    http://www.harepoint.com/Products/HarePointBusinessCards/Default.aspx

  4. Hi,

    Is there a way to determine the file size of Confluence Spaces? If so, how can i do it? We are currently using Atlassian Confluence 3.5.3.
    Our administrators want to determine the file size of our Confluence Spaces before we "migrate" to SharePoint 2010.

    Thanks for the help!


     

    1. Hi Ryan,

      "File size" is a bit misleading since most Confluence content is stored in the database. Depending on your configuration, the file attachments in the space will be stored on the file system.  

      A good way to estimate the size of a particular space is to perform an XML Space Export of the space in question (see Exporting Confluence Pages and Spaces to XML). The size of the XML Export file created by Confluence will give you a good relative indication of the space. Please note that the XML Export is not an efficient method of storing the space information, so the export file size will actually be a bit larger than the "real" size of the space in Confluence.

      Hope this helps,

      Joe.

  5. I have a few questions regarding this connector...

    1. How do you determine where the list / library is pulled from? Can we pull across different sites? 
    2. Can we customize the shared library view in Confluence? 
    3. Can we upload documents from Confluence into SP through the connector? 

     

    1. Hi Carter,

      How do you determine where the list / library is pulled from? Can we pull across different sites? 

      Yes, the Confluence administrator can configure connections to multiple SharePoint sites, allowing users to choose the site to connect to when inserting the macros onto the page.

      Can we customize the shared library view in Confluence? 

      Yes, to some extent. You can create new views on a library in SharePoint and then configure the macro to display the specific view. 

      Can we upload documents from Confluence into SP through the connector? 

      No, this is not supported. Users would have to click-through to SharePoint in order to upload a new document. Editing existing documents is supported when using Internet Explorer.