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
- 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.
- 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.
- Check in the widgets-config.xml file.
- 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.
- 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>
- Check in the revised .tpl file.
- Restart the Communities application using the WebSphere Application Server Integrated
Solutions Console.
- Log in to Lotus Connections
as a community administrator.
- 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.