Configure an IBM Forms Experience Builder task provider instance

This task provider retrieves tasks from IBM Forms Experience Builder and surfaces them in the Unified Task List portlet.

1. Log in to HCL WebSphere Portal as the administrator.

2. Configure single sign-on with LTPA tokens between the HCL WebSphere Portal and Forms Experience Builder servers by logging into the WAS Admin Console before you begin this task.

1. Go to the administration menu in the global menus on the site toolbar, and select Portlet Management > Web Modules.

2. Install the Forms Experience Builder WAR file: ibm.nitro.integrations.portlet-0.1.0.0.

3. Add the Forms Experience Builder portlet to the page.

4. Create wires between the page with the Unified Task List portlet on it and the page with the Forms Experience Builder portlet on it. For more information on creating wires, see Add a wire in the related links.

5. Configure the Forms Experience Builder portlet by specifying the following values:

   1. IBM Forms Experience Builder URL. For example, http://forms.server.instance.domain.ext:port/forms.

   2. Portal Proxy URL. For example, http://portal.server.com:port/wps/proxy.

   3. After we have specified the URLs for the Forms Experience Builder and Portal Proxy, click OK.

6. Configure the Ajax proxy in the file proxy-config.xml to be able to start forms from the Unified Task List in the Forms Experience Builder portlet. To do this, specify the value of the forms server after the last directive in the proxy-config.xml file. For example,

   <policy url="http://your.feb.server.instance.domain.ext:port/forms/*.">
   <actions>
   <method>GET</method>
   <method>HEAD</method>
   <method></method>
   <method></method>
   <method></method>
   </actions>
   <headers>
   <header></header>
   <header>x-lfn-url-callback</header>
   <header>User-Agent</header>
   <header>Accept*</header>
   <header>Vary</header>
   <header>Location</header>
   <header>Content*</header>
   <header>Authorization*</header>
   <header>X-Method-Override</header>
   <header>Set-Cookie</header>
   <header>If-Modified-Since</header>
   <header>If-None-Match</header>
   <header>X-Server</header>
   <header>X-Update-Nonce</header>
   <header>X-Requested-With</header>
   <header>com.ibm.lotus.openajax.virtualhost</header>
   <header>com.ibm.lotus.openajax.virtualport</header>
   </headers>
   <cookie-rule name="feb">
   <cookie>LTPA</cookie>
   <cookie>LTPA2</cookie>
   <cookie>JSESSIONID</cookie>
   <cookie>LtpaToken</cookie>
   <cookie>LtpaToken2</cookie>
   <cookie>SimpleToken</cookie>
   </cookie-rule>
   </policy>

   The directive must be added to the original proxy-config.xml configuration file that can be found in one of these paths:

   • wsp_install_location/portal_instance_name/config/cells/cell/applications/AJAX Proxy Configuration.ear/deployments/AJAX Proxy Configuration/wp.proxy.config.war/WEB-INF/proxy-config.xml

   • portal_install_location/PortalServer/base/wp.proxy.config/installableApps/wp.proxy.config.ear/wp.proxy.config.war/WEB-INF/proxy-config.xml

7. Run the following ConfigEngine command on the portal server: ConfigEngine.bat/sh -DWasPassword=wpsadmin -DPortalAdminPwd=wpsadmin checkin-wp-proxy-config -DProxyConfigFileName=C:\proxy-config.xml.

8. Restart the server.

9. From the Applications menu, select Unified Task List to open the page with the Unified Task List portlet on it.

10. Select Configure from the portlet menu.

11. On the Configure page, select the Task Provider Instances link from the menu.

12. Select Add.

13. Select IBM Forms Experience Builder.

14. Enter a name for the new provider and select Enable.

15. Select Next.

16. Modify the Server Endpoint field to include the host and port number for the Forms Experience Builder server.

17. Select the search button to load the applications and forms.

18. Select wanted application and form.

19. Optional: Select stage of the form.

20. Select Apply.

Parent Create a task provider instance

Related tasks:

Add a wire