SharePoint 2010–Web Services for Remote Portlets

Web Services for Remote Portlets, also known as WSRP, is a standard defined by an OASIS committee which describes how to use SOAP requests to receive fragments of HTML from a remote service.   The overview on the OASIS site states:

WSRP defines a set of interfaces and related semantics which standardize interactions with components providing user-facing markup, including the processing of user interactions with that markup. This allows applications to consume such components as providing a portion of the overall user application without having to write unique code for interacting with each component.

So what does WSRP really do?  It can allow an organization that has multiple WSRP compatible portal products to reuse portlets across the different platforms.  Portal products such as SharePoint, PeopleSoft and WebSphere provide support for WSRP.  Even products such as Adobe LiveCycle Data Services ES2 provides support for displaying Flex client applications as a portlet.   This could reduce or eliminate the need to create a custom solution to display information across multiple platforms.   WSRP can also be used in an organization with a very heavy focus on SOA where you may already have web services and adding a WSRP producer in front of them would allow multiple portal technologies to render the portlets in the same fashion.

In February 2006 Mike Fitzmaurice from Microsoft wrote an excellent blog post discussing WSRP. In his post he describes the reasons for using WSRP but also cautions that it isn’t “magic” and it shouldn’t be used as a shortcut for good application design.   Although the post is several years old the information is still relevant today; I highly recommend you read it before proceeding with a WSRP implementation.

SharePoint 2010 provides a WSRP 1.1 viewer web part (also known as a WSRP consumer).   This web part allows a user to connect to a trusted WSRP producer and render the portlet within a SharePoint site.   Below I will walk through the process on how to use the WSRP viewer web part.

SharePoint only allows a user to connect a WSRP viewer web part to a trusted producer.  A trusted producer is any producer that has been configured for use in the farm by the SharePoint administrator.  An end user cannot add trusted producers and they cannot override the settings by the SharePoint administrator and connect to untrusted producers.  This restriction was put in place to protect the SharePoint environment and the end user from damages that could be caused by a malicious remote portlet.

To add a trusted producer the SharePoint administrator needs to create a TrustedWSRPProducers.config file in the “program filesMicrosoft Office Server14.0Config” folder on the SharePoint web front ends.   A sample configuration file called TrustedWSRPProducers.xml.sample is available in the config folder and can be used as a guide.   Note that the path is not in the traditional SharePoint “hive”.

Sample contents of a TrustedWSRPProducers.config file:

<Configuration >
  <Producer Name="NetUnity" AllowScripts="true">
    <!-- <SsoApplication Name="NetunityWSRP"/>
 SsoApplication Element is optional. It specifies the SSO application to use when authenticating to the WSRP Producer. -->


After the TrustedWSRPProducers.config file has been created and placed in the “program filesMicrosoft Office Server14.0Config” folder on the SharePoint web front ends a user can configure the WSRP Viewer web part.

Once a WSRP viewer web part has been added to a site the site designer or administrator will need to open up the web parts configuration panel and modify a few settings.   The first setting that needs to be modified is the producer.   This drop down selector will list out each of the producers that have been made available in the TrustedWSRPProducers.config file.   After the producer is selected the portlet drop down selector will populate with the available portlets for the selected producer.    Select the desired portlet, make any additional configuration modifications to the web part and then click the OK button to save these settings.


Some WSRP portlets may include additional configuration settings that are made directly in the portlet and not through the WSRP viewer web part tool pane.  To access these settings the SharePoint site must be switched to edit mode and then the Edit Web Part option needs to be selected from the WSRP viewer web part drop down menu.


This will switch the web part to edit mode which will display the web parts configuration tool pane along with displaying additional portlet configuration information in the location of the web part on the SharePoint site.


WSRP is just one option of many for interoperability between different line of business systems and portals when working with SharePoint 2010.   Before fully committing to using WSRP I would also recommend that you look at SharePoint’s business connectivity services and creating custom data view web parts from webservices  using SharePoint Designer.   As Mike Fitzmaurice said in his blog post “It’s up to you to decide, but please, please,please make that decision an informed one.”

0 thoughts on “SharePoint 2010–Web Services for Remote Portlets”

  1. One follow-up note: The WSRP Viewer web part is located in the Content Rollup category and as mentioned in the post it supports WSRP version 1.1

  2. SharePoint 2010 does not have WSRP producer capabilities. In the SharePoint 2010 administration toolkit there is a solution that adds CMIS (content management interoperability services) producer and consumer functionality. CMIS is a newer specification that describes how content management systems can interop.

    For details on CMIS for SharePoint visit:

    Wikipedia has a page dedicated to CMIS which outlines some of the products that support CMIS:

  3. I Worke primarily on ShharePoint but have worked wit oracle Aqualogic (or whatever it”s called tody). Aqualogic used WSRP almost excluseively in that the webparts always ran on a remote,load-balanced, server. It”s an elegant architecture.
    I can think of many ”Systen-staus” type dashboards that could be created by having a WSRP Producer running on a non-sharepoint server(reporting services, ESX.. or any proprietary system) and exposing system status (or other information) through sharepoint.
    Do you know of any resources that discuss creating a Sharepoint-compliant WSRP 1.1 Producer?

    1. Russel: As I mentioned in the previous comment, CMIS has really replaced WSRP from an interoperability specification. From what I have seen there is very little support for WSRP, however, I have seen some companies that offer WSRP related solutions. One company called NetUnity has a WSRP .NET Framework that helps you create portlets that are plug and play for WSRP compliant portals. Check out:

  4. HI All,

    I have created WSPR from share point, can i integrate with webcenter.
    please give me some guidelines of the same.

  5. Hi Mike,

    I try to do above thing but the TrustedWSRPProducers.xml.sample doesn”t exist at config folder.

    I am using SharePoint Server 2010 enterprise. But still no help can u guide me for this.

    Thanks in Advance

  6. Hi Mike
    I have successfully used you example to add and connect. One question:
    If you have multiple portlets under one producer, is there any way you can have these listed using the same producer name without separate entries:

    Producer 1
    Portlet 2

    rather than

    Producer 1
    Portlet 1
    Producer 2
    Portlet 2


Leave a Reply