This is intended for use as a starting point for forms and portal development. This is the an absolutely stripped bare Lotus Forms Webform Server framework portlet. It would be a great starting point for developing a Lotus Forms portlet with some custom functionality. It is also intended as a learning tool if you want to see what is the absolute minimum code required for a Lotus Forms enabled portlet.
This portlet contains an XFDL form in the WEB-INF directory, which is loaded on the translator server located at localhost (same host machine that is running the portal) when the portlet is run.
This sample requires that you have a version of Webform Server and Websphere Portal installed.
- From Eclipse or Rational Application Developer, import the project interchange file (.zip).
- The Webform Server framework libraries are not included, you will need to copy them into the lib directory for the portlet to work (this is done so that the portlet is ready for use with any version you have of WFS and also to avoid any potential licensing/legal issues with distributing the framework libraries on this wiki). Follow these steps to install the libraries:
1. Locate the libraries in the Webform server installation directory. These are located in the webform server installation directory in the redist directory. For example, if you used the default installation path, they would be located at: C:\Program Files\IBM\Lotus Forms\Server\3.5\Webform Server\redist
2. Locate the lib directory of your Base Forms Portlet project. In Eclipse or RAD this will be <
3. Copy the entire contents of the redist directory to the lib directory (you don't actually need the .js files, but they don't do any harm)
4. Rebuild your Eclipse project.
Deploying to Portal
1. In eclipse or RAD, right click on your portlet project and select "Export..."
2. Under the Web category, select "WAR file"
3. Provide a destination directory and note it for later.
4. Click finish to complete the wizard, thereby generating the WAR file.
5. Login to your portal with an administrator account.
6. (This step varies depending on your version of portal) Go to the Administration page and locate the "Web Modules" link.
7. Click the install button.
8. Locate your WAR file on disk and upload it.
- The Lotus Forms API is not used in this example. If you add any code to the portlet which leverages the Lotus Forms API, you need to make sure the API is installed on your application server or put the StreamingAPI.jar in the lib directory of your project.
- If your webform server translator is located on a different host than your portal server, you need to modify the portlet.xml file and change "localhost" to the hostname of your translator server.