# Installation Guide

# AquaLogic Interaction and the WSRP Consumer

This chapter describes how to use the AquaLogic Interaction WSRP Consumer with AquaLogic Interaction. It is divided into the following sections:

- Creating a WSRP Portlet on AquaLogic Interaction
- Passing User Properties from AquaLogic Interaction to the WSRP Producer
- Enabling Proxy Support in the WSRP Consumer

## Creating a WSRP Portlet on AquaLogic Interaction

To create a WSRP portlet in your AquaLogic Interaction Portal:

1. In the AquaLogic Interaction Portal, go to Administration.
2. Click on an Administrative Folder. For example, the WSRP folder.
3. From the Create Object drop-down, select Portlet.
4. Choose the WSRP Consumer web service.
5. Suppress the ALI generated portlet title bar. The WSRP Consumer portlet will render its own portlet title bar. On the Main Settings page, check the box next to Suppress Portlet's title bar.
6. To configure the portlet, click Edit.
7. On the Administrative Preferences Setup page, type the URL to your WSRP Producer WSDL in the box under Enter Service WSDL URL. The following are publicly available sample WSRP Producers:

- BEA WebLogic Portal 9

`http://wsrp.bea.com:7001/producer/producer?WSDL`

- BEA WebLogic Portal 8

`http://wsrp.bea.com/portal/producer?WSDL`

Caution: | BEA Systems, Inc. provides no warranty regarding the viability of the following 3rd-party interoperability test services.

- NetUnity (3rd-party)

`http://wsrp.netunitysoftware.com/WSRPTestService/WSRPTestService.asmx?Operation=WSDL`

- Oracle (3rd-party)

`http://portalstandards.oracle.com/portletapp/portlets?WSDL`

8. Click Import Service WSDL.
9. Click Next.
10. If the WSRP Producer requires you to register, an editor page for registration properties is displayed. If the WSRP Producer does not require you to register, this page is not displayed.

If you are required to register, edit the registration properties and then click Register.

11. On the Choose a Portlet page, select a portlet and click Finish.
12. On the portlet Main Settings page, click Finish.

For details on creating and using a portlet in ALI, see the online help for AquaLogic Interaction.

## Passing User Properties from AquaLogic Interaction to the WSRP Producer

User properties from the AquaLogic Interaction Portal are mapped to fields to WSRP Producers

You can map user profile properties from the ALI Portal to fields passed to WSRP Producers by editing the UserProfile.properties file. The UserProfile.properties file can be found in your WSRP Consumer install directory:

    install_dir\ptwsrp\1.1\settings\config\UserProfile.properties

The WSRP Consumer service must be restarted before changes made to the UserProfile.properties file take effect. Details on how to implement property mapping is found in the comments in the UserProfile.properties file.

## Enabling Proxy Support in the WSRP Consumer

If the WSRP SOAP messages between the WSRP producer and the WSRP Consumer go through a specified HTTP proxy, the WSRP Consumer wrapper.conf must be edited to enable HTTP proxy support. The wrapper.conf file can be found here:

    install_dir\ptwsrp\1.1\settings\config\wrapper.conf

Follow the instructions in the wrapper.conf file to edit the proxy settings.