SharePoint Connector for Confluence

Limitations and Known Issues

Use this page to troubleshoot any problems you may have with the SharePoint Connector for Confluence. For instructions on installation, configuration and usage, please consult the documentation for the SharePoint Connector for Confluence.

On this page:

Prerequisites

Confluence 3.0.2 or later.

SharePoint MOSS or WSS: Certain features of the SharePoint Connector require Microsoft Office SharePoint Server (MOSS). If your installation has only Windows SharePoint Services (WSS) and not MOSS, you will not be able to use the advanced features:
Unable to render {include} The included page could not be found.

Configuration in Confluence: Your Confluence administrator can enable or disable the SharePoint Connector or parts of it in Confluence. Please refer to Installing and Configuring the Confluence Plugins for SP 2007 in the SharePoint Connector Installation Guide and discuss any configuration problems with your administrator.

Configuration in SharePoint: Your SharePoint administrator needs to configure the SharePoint feature, web part and federated search components. Please refer to Installing and Configuring the SharePoint Feature on SP 2007 in the SharePoint Connector Installation Guide and discuss any configuration problems with your administrator.

Full list of requirements: For more information on each of the above points, please refer to the complete list of requirements in the SharePoint Connector Installation Guide.

Diagnostic Tools

Tracing: To troubleshoot or debug the SharePoint feature you can enable tracing and then view the trace with a tool such as DebugView. See Tracing the SharePoint Feature.

Logging: In addition to enabling the tracing feature, critical errors and warning messages are always output to the SharePoint Log. You can view this information by Analyzing the SharePoint Logs.

Connectivity diagnostics: If you are having trouble connecting to SharePoint from Confluence or to Confluence from SharePoint, you may want to perform some diagnostics to see what the problem is. See Using the CSI Diagnostics Tool to Test Confluence and SharePoint Connectivity.

Checking the Confluence configuration: When the SharePoint Connector configuration is set up properly it just works. However when it does not work it can be tricky to diagnose the problem, given the two different platforms trying to authenticate, authorise, and communicate across different servers. Here are some things to check on the Confluence side: Troubleshooting the SharePoint Configuration in Confluence.

Limitations

Integrated Windows Authentication (IWA): IWA, including LM, NTLM, NTLMv2 and Kerberos, requires complex configuration and may cause problems. See the documentation on Planning your Authentication Configuration. This documentation and configuration process is under review. We are working on a simplified procedure as well as simplified documentation.

SharePoint Forms-based Authentication: The SharePoint Connector is not able to connect to SharePoint sites that use the Forms authentication module.

Crowd: The SP connector does not support Atlassian Crowdfor SSO, when using a Crowd internal directory.
- Crowd internal directory requires Microsoft SSO: If your Confluence instance uses a Crowd internal directory for user management, you must use the Microsoft SSO service. This means that you must have SharePoint MOSS, because SharePoint WSS does not provide Microsoft SSO.
- Crowd LDAP does not require Microsoft SSO: If your Confluence users come from Active Directory via Crowd, there is no need for Microsoft SSO because the Confluence user credentials and the SharePoint user credentials are the same.

Clicking a link in the Confluence Page web part opens the Confluence page in a new browser window: It would be nice if you could click a link and have the new page open within the web part itself. We are tracking this popular feature request as CSI-196.

Some Confluence macros do not work in the Confluence Page web part: Any Confluence macro that performs an Ajax web call will not work in the Confluence Page web part. These are macros that perform a second call do load the macro display data independently of the page. Examples as the Recently Updated macro and the JIRA Issues macro (CSI-423). The problem is caused by security restrictions, because the Ajax call comes from the SharePoint page rather than Confluence.

Including private pages from a public page will result in an error message: It is possible in a Confluence wiki page to include the content of another page using the {include} macro. If a page that is generally available (Page A) includes the content of a page that is not generally available (Page B), this works as expected within Confluence as well as within the 'Confluence Page' web part in SharePoint. When a user authorised to see Page B views Page A, they see the content of Page A and the content of Page B. If the user is not authorised to see Page B, they see the content of Page A and an error similar to this: "Unable to render {include} Couldn't find a page to include called: Page B".
When using sharePoint list macro in Confluence to render a custom SharePoint view of a SharePoint document library: if the custom view of document library in SharePoint does not include the column with name "Name (linked to document with edit menu)" the layout of list macro in Confluence is broken. It's required that all custom views of document library in SharePoint have to include the column "Name (linked to document with edit menu)" in its view.

Known Issues from our Knowledge Base

The following knowledge base articles can help with troubleshooting:

Resolved Knowledge Base Issues

Unable to render {include} The included page could not be found.

Requesting Support

If you have a problem, please take a look at the prerequisites, diagnostic tools, limitations and known issues described above.

If you do not find a solution to your problem, please help us to troubleshoot the issue by providing the following information before submitting a support request on the Atlassian Support System:

Find the base URL of your Confluence server. To see your base URL, open Confluence in your web browser, log in as a Confluence administrator and visit http://<Your Confluence URL>/admin/viewgeneralconfig.action.
Tell us which browser you are using when the problem occurs, and which version of the browser such as Firefox 3.6.2 or Internet Explorer 8.0.
Tell us which operating system you are using when the problem occurs, such as Windows Vista, Windows XP, Linux, Mac OS X.
Capture a Fiddler report for tracking read-only issues.
Run Confluence's generic error page by visiting http://<Your Confluence URL>/500page.jsp and give us the result for review. Please copy the whole page including the list of enabled plugins.
Include your Confluence logs and a copy of the information on your Confluence 'System Information' page. To get this information, go to 'Confluence Admin', 'System Information' and copy the text from the page. We need that information to see what Confluence version and which application server you are using.
Let us know what you are using for Confluence user management: Confluence internal user management, LDAP (Active Directory), Crowd internal directories, Crowd LDAP, JIRA user management, or any other user management scenario.
Tell us whether you have MOSS or WSS installed.
Unable to render {include} The included page could not be found.
Ask your SharePoint administrator which SharePoint service packs you have installed.
Find out which version of the SharePoint Connector you have installed in SharePoint. To find this out, go to the 'Confluence Administrative Settings' page in SharePoint.
- Go to the top level site within the site collection.
- Select 'Site Actions' (at the top-right) -> 'Site Settings' -> 'Modify All Site Settings'.
- On the 'Site Settings' page, choose 'Confluence Settings'.
- On the 'Confluence Administrative Settings' page, copy the value for the 'Connector Version' (in the section labelled 'Confluence Site').

Frequently Asked Questions

Want to know more about the SharePoint Connector for Confluence?

Find the documentation here: SPCON