Install the SharePoint widget for Communities 

Install the Microsoft™ SharePoint widget so that Community owners can make it available for members to use.

Before you begin

These instructions are for installing the IBM Connections Widget for Microsoft SharePoint for an English-language deployment. If you want to make the widget available in other languages, follow the installation instructions in the topic Install the non-English version of the SharePoint widget for Communities.

Note: This widget requires that IBM Connections Plug-in for Microsoft SharePoint be installed before you use the widget.

Before you begin, familiarize yourself with how to install widgets for the Communities application. For details, see this topic: Add custom widgets to Communities

About this task

Install the SharePoint widget so that community owners can make the widget available in a community. Community members can then upload and share documents from a SharePoint server.


  1. Follow the steps for checking out the widgets-config.xml, documented here: Enable custom widgets for Communities.

    1. Add the xml definition for the SharePoint widget to the Communities section of the widgets-config.xml:

        <widgetDef defId="SharePoint Documents" description="SharePointFiles" modes="edit view search fullpage" uniqueInstance="true"
        url="/SPWidgets/SPFiles/SPFiles.xml?version={version}" helpLink="Using_the_SharePoint_widget_lc3" iconUrl="/SPWidgets/SPFiles/images/spSite.png"> </widgetDef>

    2. Check in the widgets-config.xml file as documented in the custom widgets topic.

  2. Install the SharePoint widget ear file on the same server as the Communities application, as follows:

    1. Log into the Websphere Application Server console.

    2. Select Install New Application and browse for the name of the SharePoint ear file you downloaded from the IBM Connections catalog web site:


    3. Accept the installation defaults, but select the server or servers where the Communities application is installed. If you are using an IHS server, select that as well or you will not be able to access the SharePoint widget after you install it.

    4. Save the configuration changes.

        A confirmation screen will confirm that the application SharePointContent is installed.

    5. Select Applications -> Enterprise Applications and start the application SharePointContent.

  3. Restart the Communities application.


      If your SharePoint Server and IBM Connections hosting the Communities application are not in the same domain, add the domain of the SharePoint server to the DNS settings of the IBM Connections server. Otherwise, your users will get an error when trying to create a new community on a server with the SharePoint widget deployed.

  4. If IBM Connections is configured to use single sign-on with IBM Tivoli Access Manager, configure a transparent path junction for the Sharepoint widget if you want to get Sharepoint documents in Connections communities under TAM. Follow the steps for configuring a transparent path junction in the topic Enable single sign-on for Tivoli Access Manager. Run this server task to enable the TAM junction:

      'server task <WebSEAL-instance-name> create -t ssl -h <backend-server-name> -x -p <backend-server-port> -i -b ignore -f -A -2 -F <ltpa-token> -Z <ltpa-password> /SPWidgets' 

  5. If IBM Connections is configured to use a reverse proxy that directs all IBM Connections traffic to a single server, add some mapping rules so that the widget will be accessible.

    1. Refer to the topic Configure a reverse caching proxy for instructions on adding mapping rules.

    2. In the Mapping Rules section, add the following reverse pass rules for the SharePoint widget:

        ReversePass http://<httpserver>/SPWidgets* http://<proxyserver>/SPWidgets* 
        ReversePass https://<httpserver>/SPWidgets* https://<proxyserver>/SPWidgets*

        where <httpserver> is the host name of the HTTP server. The HTTP server is usually IBM HTTP Server, but could be a load balancer or another proxy, depending on your deployment. <proxyserver> is the host name of the proxy server.

What to do next

Once the SharePoint widget is available for the Communities application, a community owner can click the Community Actions button for the community and add the SharePoint widget to the community from the widget panel.

Parent topic

IBM Connections Widget for Microsoft SharePoint

August 26, 2011 12:25:27 PM


Aug 26, 2011 12:25:27 PM 1