This quick start guides you through the steps to create a widget.
You use IBM® WebSphere® Portlet Factory to run, test, and publish the widget on a locally-installed IBM Lotus® Mashups server.
If you are unable to install a Lotus Mashups server on your local development machine, you can establish access to a remote installation of a Lotus Mashups server.
Setting up a Mashup Server Configuration
Follow these steps to setup a Mashup server.
- Click on Windows -> Preferences
- Select WebSphere Portlet Factory Designer -> Server Configurations from the tree
- Click the Add button.
- Enter a name for your Server Configuration
- In the Server type drop down select WebSphere Application Server and IBM Mashup Center 2.0
- Enter the hostname of your server. If your Mashup server is local, http://localhost. If you are running Mashup Center remotely enter a full DNS host name. In most cases the SOAP Connector Port can remain 8880.
Note: If the soap connector port is not correct you can check the SOAP port of your server by accessing the Admin Console. In the admin console select Servers/Server Types/WebSphere Application Servers. Select server1 from the list then select Ports. You will see your Soap connector Address listed here.
- Enter a User Name and Password that has administrative access to Mashup Center.
- Click the Test Connection button to validate your entries.
- Click OK to save the Server Configuration
If you are deploying to a remote Mashup Center you will want to map a drive to the InstalledApps folder on the server to take advantage of the Auto Synchronize feature. If you do not setup a mapped drive you will need to Publish your project for running it to see your changes.
Create, test and publish a WebSphere Portlet Factory widget
Follow these steps to create a widget with WebSphere Portlet Factory to use with Lotus Mashups.
- Create a WebSphere Portlet Factory project.
- Go to File -> New -> WebSphere Portlet Factory Project.
- Enter a name for the widget in the Project name field and click Next.
- Under Integration Extensions, select Widget Extension and Spreadsheet Extension and click Next.
- Select the Server Configuration to use when you publish the project and click Finish.
- Click Yes when asked to publish the project.
- In the project, create a model.
- Click File -> New -> WebSphere Portlet Factory Model.
- Select the project for which you want to create the model and click Next.
- Select the model type. In this case, select Spreadsheet View & Form and click Next.
- Select Deploy this model as a widget and leave Deploy this model as a portlet unselected and click Next.
- Enter the widget title and, in Widget Category, select the Lotus Mashups Toolbox category under which you want the widget to appear and click Next.
- In Spreadsheet settings, specify the spreadsheet to import and the method to find the content. Click Next.
If you do not have a spreadsheet available, a default one is provided. The default file is available if your project includes the Tutorials And Samples feature set.
- In Paging settings, specify whether to have the data display paged. Paging improves performance. Click Next.
- Optionally, enter the column settings and click Next.
- Optionally, enter the Details Page settings and click Next.
- Enter the model name and click Finish.
- Go to Run -> Run....
- From the Run dialog box, click WebSphere Portlet Factory model -> Active Model.
- Click Run.
- The widget appears in your default browser.
- Modify and run the widget locally until you are satisfied.
- From the Active Project, publish the widget to the Lotus Mashups Palette. Right-click on the project name. Go to Widget -> Publish Widgets to Palette to publish the widget. Select the widgets you want to publish and click OK.
Parent topic: Tutorials for IBM WebSphere Portlet Factory