Using the SharePoint Link Macro (v 1.1)

Owned by Almuth Boehme [Communardo]
Aug 18, 2016
3 min read

You can use the SharePoint Link macro {sp-link} to put a link on a Confluence wiki page, pointing to a SharePoint list, document or list item. When someone clicks the link, the SharePoint list or document will open. The macro supports most SharePoint list types.

On this page:

Usage with the Macro Browser

The 'Macro Browser' is a graphical menu that allows you to view the list of available Confluence macros and add them to the current page or blog post.

To insert the SharePoint Link macro into a page using the Macro Browser,

  1. Go to the Confluence page or blog post where you want to display the SharePoint link.
  2. Click the 'Edit' button. The page or blog post opens in edit mode.
  3. Click the Macro Browser icon on the toolbar.
  4. The macro browser window opens. Find the 'SharePoint Link' macro:
    • Scroll through the list of macros, or
    • Start typing the macro name into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  5. Click the macro to access its parameters and preview the macro output.
  6. Enter the macro parameters. See the parameter descriptions below.
  7. If you would like to preview your changes, click 'Refresh'.
  8. Click 'Insert' to add the macro to the page.

Usage with the Wiki Markup Editor

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

Note: Unlike the SharePoint List macro, this macro does not allow you to specify a SharePoint site. The SharePoint Link macro will use the default SharePoint site, as specified in the SharePoint Admin settings. See the Confluence SharePoint plugin configuration guide.

Parameters

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

Parameter

Default

Description

listname
(listName)

No default

The first parameter ('listName') can contain the name of a SharePoint list, the name of a SharePoint document library, or the path to a document within a document library. The text 'listName' is optional.

The following example creates a link to the SharePoint document library called 'documents'. The linked text is 'my link text'. When someone clicks this link, their browser will open the SharePoint document library in the SharePoint web interface:

{sp-link:documents}my link text{sp-link}

Here is another example, where the parameter name 'listName' is explicitly specified. The results are the same as the previous example:

{sp-link:listName=documents}my link text{sp-link}


In the following example, we link to a specific document 'checklist.docx' within the library:

{sp-link:documents/checklist.docx}my link text{sp-link}


Specifying the full path to your list

You must give the full path to the list (or library). In the above example, we have assumed that the list is located at the root (top-level) SharePoint site. However, if the list is in a SharePoint site called 'mySubSite' that is a child of the root site collection, you might specify the following:

{sp-link:/SiteDirectory/mySubSite/documents/checklist.docx}my link text{sp-link}
Linking to a document folder

To link to a folder 'my folder' within a document library, add a double forward slash(//):

{sp-link:documents//my folder}my link text{sp-link}

Office Integration

If you are using Microsoft Office integrated with SharePoint, the {sp-link} macro will make use of this integration. When someone clicks on the link created by the macro, it integrates with MS Office in the same way as SharePoint. You can check documents in and out of SharePoint and edit the document from within the Office application.

Requirements for the Office integration to work:

  • Your Confluence site or space must be using the SharePoint Decorators theme. See the instructions on configuring Confluence to use the SharePoint Decorators theme. If you are not using the theme, the link will still work but you will not be able to edit the document or check it in or out.
  • You must be using Internet Explorer as the browser when accessing the Confluence page.

Diagram: Office integration with the SharePoint Link macro

Examples of List Types

Below are some examples of the list types supported by the SharePoint Link macro.

Document Libraries

See the examples given above.

Linking to a list of links:

{sp-link:lists/sample links}my link text{sp-link}

Calendars

Linking to a calendar:

{sp-link:lists/sample calendar}my link text{sp-link}

Tasks

Linking to a list of tasks:

{sp-link:lists/sample tasks}my link text{sp-link}

Issues

Linking to a list of SharePoint issues:

{sp-link:lists/sample issues}my link text{sp-link}

Discussions

Linking to a list of SharePoint discussions:

{sp-link:lists/sample discussions}my link text{sp-link}

Custom Lists

Linking to a custom SharePoint list:

{sp-link:lists/my custom list}my link text{sp-link}
RELATED TOPICS

Using the sp-list Macro
Working with Macros
SharePoint Connector User's Guide