Adding an iWidget with asset search results to an IBM Lotus Connections community

You can place a widget in Lotus® Connections that shows search results for a community in IBM® Rational® Asset Manager.

Before you begin

You must have configured single sign-on between the Rational Asset Manager server and the Lotus Connections server. See Setting up single sign-on between two servers.

You must be able to edit the Lotus Communities configuration file widgets-config.xml with the IBM WebSphere® Application Server wsadmin client.

You must be a community administrator in Lotus Connections to add a custom widget to a community.

About this task

For more information about custom widgets in Lotus Connections, see the Lotus Connections help topic Administering remote applications.

Procedure

  1. Use the wsadmin client to check out the widgets-config.xml file as described in the Lotus Connections information center topic, Enabling custom widgets for Communities.
  2. Add this code to the widgets-config.xml file, where <Rational_Asset_Manager_server> is the server address for Rational Asset Manager, <port> is the port number for Rational Asset Manager, and <Rational_Asset_Manager_context_root> is the context root for the Rational Asset Manager web client, typically ram:
    <widgetDef
    		defId="Assets"
    		primaryWidget="true" 
    		modes="view edit"
    		description="This iWidget displays assets from a community in a Rational Asset Manager repository "
    		url="{communitiesSvcRef}/ajaxProxy/http/<Rational_Asset_Manager_server>%3A<port>/<Rational_Asset_Manager_context_root>/iwidget/AssetWidget.xml?version={version}" 
    		navBarLink="http://<Rational_Asset_Manager_server>:<port>/<Rational_Asset_Manager_context_root>"
    		loginRequired="true"
    		/>

    Note in the url attribute, there must be only a single slash (/) between http and <Rational_Asset_Manager_server>, and the colon between <Rational_Asset_Manager_server> and <port> must be escaped to %3A.

    To find the path to the AssetWidget.xml file for the url attribute in the web client, click the Help icon and Extensions, and then copy the URL from the Widgets section.

  3. Check in the widgets-config.xml file.
  4. In the list of trusted websites in Lotus Connections, add the URL for Rational Asset Manager. The list of trusted websites is defined in two places:
    • The default policy file: proxy-config.tpl
    • The community-specific version of the policy file: proxy-communities-config.tpl
    You can check out either one of these files to edit by using the wsadmin client as described in the Lotus Connections information center topic, Defining trusted and nontrusted web sites for communities.
  5. Add this proxy policy to the .tpl file:
    <proxy:policy url="https://ramServer:port/ram/" acf="none">
    	<proxy:actions>
    		<proxy:method>GET</proxy:method>
    		<proxy:method>POST</proxy:method>
    	</proxy:actions>
    </proxy:policy>
  6. Check in the revised .tpl file.
  7. Restart the Communities application using the WebSphere Application Server Integrated Solutions Console.
  8. Log in to Lotus Connections as a community administrator.
  9. The Rational Asset Manager widget is available in the Content palette of communities in Lotus Connections. You can add the widget to the palette and enter search keywords to display a list of search results from the Rational Asset Manager repository. After you have added the widget, you can Edit it to display search results for a keyword string (use * as a wildcard) and optionally limit the results to a specific community in Rational Asset Manager.

Feedback