The Confluence SharePoint Connector provides a federated search, allowing SharePoint to issue search requests to Confluence and display the results it gets back from Confluence. Federated searches use Confluence's own search engine to retrieve up-to-date and relevant results. This guide is for SharePoint 2010
On this page:
- SharePoint Server 2010: Only SharePoint Server 2010 (Standard or Enterprise) supports federated search locations. This functionality is not included in SharePoint Foundation 2010.
- The Confluence OpenSearch plugin and SharePoint search configuration: If you are using the Confluence SharePoint Connector version 1.8.2 or earlier, your Confluence installation must include the OpenSearch plugin and must be configured to share search results with SharePoint. Optionally, you can also configure Confluence to use the SharePoint Decorators theme. See the guide to installing the Confluence SharePoint plugins.
If you are using the Confluence SharePoint Connector version 1.8.3 or later, the OpenSearch plugin is bundled and does not need to be installed separately.
Step 1. Configure the Federated Search Location
- Log in to your SharePoint Central Administration site as a SharePoint farm administrator.
- Click 'Manage service applications' under the 'Application Management' heading.
- Click 'Search Service Application'.
- Click 'Federated Locations' under the 'Queries and Results' heading in the left-hand navigation panel.
- Click 'New Location'.
- Fill in the information for the new federated location, and then click 'OK'. Here are some guidelines on the mandatory fields:
The name of this location. We suggest 'Confluence'.
The name of the location which will be displayed to users.
Development Confluence Wiki
A description of this location.
The type of search to perform. We need OpenSearch.
This is the URL which will be used to perform the actual search. This URL depends on the authentication used by Confluence.
For Confluence SharePoint connector version 1.8.3 and later:
For Confluence SharePoint connector version 1.8.2 or earlier:
Note: For the Confluence SharePoint connector version 1.8.2 and earlier the OpenSearch plugin is installed as described in Installing and Configuring the Confluence Plugins for SP 2010 (section related to OpenSearch).
Confluence SharePoint connector version 1.8.2 and earlier:
"More Results" Link Template
The link which users will go to if they click the "More Results" link:
This specifies how Sharepoint will send the credentials for the searching user to Confluence. Make sure that you set the credentials in the 'User' section, not the 'Common' section. The actual credentials depend on the authentication used by Confluence:
Only choose NTLM option if you have configured your Confluence authentication as the instruction at Access Confluence using Integrated Windows Authentication via IIS
Federated Search Results Display Metadata: XSL
This specifies how to display the results. This can optionally be changed using the example XML to use Confluence icons for Confluence search results.
Step 2. Add Web Part to Search Results
Note that you cannot edit the default search page, you need to create a new search site and alter the site settings so that this site is used for searching.
- Go to your SharePoint Search Site and execute a search, which will take you to the search results screen.
- Click 'Site Actions', then 'Edit Page':
- Click 'Add a Web Part'. You can add the web part anywhere on the page. This is where the Confluence results will appear:
- The 'Add Web Parts' screen appears. Select the web part:
- With SSS: If you are using the Secure Store Service and selected 'Use SSS' when setting up the federated location, then select 'Federated Results'.
- Without SSS: If you are not using the Secure Store Service and did not select 'Use SSS' when setting up the federated location, then select 'Confluence Federated Search Results WebPart'.
- Click the 'Add' button.
- Open the 'Edit' menu for the web part which you have just added and select 'Edit Web Part'.
- The panel at the side opens up. Select 'Confluence' (or whatever you named the federated location) from the dropdown menu:
- Click 'OK', then 'Stop Editing'. Setup is complete.
Please refer to our knowledge base, in particular the following: