This page last changed on Nov 24, 2010 by jlargman.

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:

Requirements

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

SharePoint Configuration

Step 1. Configure the Federated Search Location

  1. Log in to your SharePoint Central Administration site as a SharePoint farm administrator.
  2. Click 'Manage service applications' under the 'Application Management' heading.
  3. Click 'Search Service Application'.
  4. Click 'Federated Locations' under the 'Queries and Results' heading in the left-hand navigation panel.
  5. Click 'New Location'.
  6. Fill in the information for the new federated location, and then click 'OK'. Here are some guidelines on the mandatory fields:
Field Name
Meaning
Example Value
Location Name
The name of this location. We suggest 'Confluence'.
Confluence
Display Name
The name of the location which will be displayed to users.
Development Confluence Wiki
Description
A description of this locatio.n
 
Location Type
The type of search to perform. We need OpenSearch.
OpenSearch 1.0/1.1
Query Template
This is the URL which will be used to perform the actual search. This URL depends on the authentication used by Confluence:
* Standard (forms) authentication: http://<CONFLUENCE_SERVER>/plugins/servlet/opensearch?query={searchTerms}&format=rss_1.0&os_authType=basic
* NTLM: http://<CONFLUENCE_SERVER>/plugins/servlet/opensearch?query={searchTerms}&format=rss_1.0
http://confluence:8080/plugins/servlet/opensearch?query={searchTerms}&format=rss_1.0&os_authType=basic
"More Results" Link Template
The link which users will go to if they click the "More Results" link:
http://<CONFLUENCE_SERVER>/dosearchsite.action?queryString={userQuery}
http://confluence:8080/dosearchsite.action?queryString={userQuery}
Specify Credentials
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:
* Standard (forms) authentication: choose "Basic Authentication"
* NTLM: choose "NTLM Authentication"

If you use the Secure Store Service (see the corresponding configuration guide), select the Use SSS option and enter the name of the Confluence application in the Target Application ID field.

If you do not use the Secure Store Service, then leave the Use SSS option unselected.

 
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

  1. Go to your SharePoint Search Site and execute a search, which will take you to the search results screen.

  2. Click 'Site Actions', then 'Edit Page':


  3. Click 'Add a Web Part'. You can add the web part anywhere on the page. This is where the Confluence results will appear:
  4. 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'.

  5. Click the 'Add' button.

  6. Open the 'Edit' menu for the web part which you have just added and select 'Edit Web Part'.
  7. The panel at the side opens up. Select 'Confluence' (or whatever you named the federated location) from the dropdown menu:

  8. Click 'OK', then 'Stop Editing'. Setup is complete.

Troubleshooting

Please refer to our knowledge base, in particular the following:

RELATED TOPICS

Installing and Configuring the SharePoint Feature on SP 2010
Installing the SharePoint Connector


Test_Search.png (image/png)
Edit_Page.png (image/png)
Edit_WebPart.png (image/png)
Document generated by Confluence on Feb 20, 2011 21:50