You can place a widget in IBM® 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 IBM Connections server.
See Setting up single sign-on between two servers.
You
must be able to edit the IBM Connections
configuration file widgets-config.xml with the IBM WebSphere® Application Server wsadmin client.
You
must be a community administrator in IBM Connections
to add a custom widget to a community.
About this task
For more information about custom widgets in IBM Connections, see the IBM Connections help topic
Administering remote applications.
Procedure
- Use the wsadmin client to check out the widgets-config.xml file
as described in the IBM 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 IBM 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 IBM 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 IBM Connections
as a community administrator.
- The Rational Asset
Manager widget is available in the Content palette of communities
in IBM 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.