Reference guide for IBM Mashup Center 2.0 widgets on IBM Lotus Greenhouse

This article provides information about the widgets that are currently available with the IBM Greenhouse-hosted version of IBM Mashup Center 2.0, available at https://greenhouse.lotus.com/home/html/index.jsp. After you log in, locate IBM Mashup Center in the right column under Quick Actions.

Understanding the widgets on Greenhouse

Before you start using Mashup Center on Greenhouse, we recommend that you become familiar with the widgets that are provided for you. Widgets that are hosted on Greenhouse fall into the following three categories:

Widgets in the default palette

By default, the mashup builder comes preloaded with a palette of widgets (see Figure 1) that are already installed and ready to drag on to your mashup pages. For more information about these widgets, including how to configure them with data sources and wire them to other widgets, see the Widget help category in the Mashup Center wiki.

Figure 1: Mashup builder with palette of widgets

Widgets that you can add to the default palette

In addition to the default widgets described above, Mashup Center also provides a catalog of additional widgets that you can add to your palette as URLs. In the reference section below, you can link directly to these widgets by clicking the Greenhouse widget links.

For example, take a look at the AccuWeather widget in the Greenhouse catalog. When you open this page in the catalog, notice the Actions section on the right side of the window. You can add this widget to your Greenhouse palette by clicking Add to Mashup Builder and follow the steps provided. When you are finished, return to the mashup builder to confirm that the widget was added successfully to the category that you selected. You may need to refresh your browser to display the widget.

Note: When searching for widgets in the catalog, be sure that you select widgets that are not WAR packages. To avoid confusion, the Greenhouse team usually tags those widgets as WAR files. Also, the widget names often contain the term WAR in the titles themselves. If you attempt to add a WAR package to the Greenhouse palette, you will get an error.

Widget WAR packages available for download

Widget WAR packages are available for several of the widgets listed in the catalog. You can link directly to each of these widgets by clicking the WAR packages links below. These WAR packages are available to install in your own local or on-site version of Mashup Center that is hosted somewhere outside of Greenhouse. These widgets are available for download only. Unlike widget URLs, widget WAR packages cannot be added to the palette in Greenhouse.

Widget reference

The following list provides information about the widgets that are available in the Mashup Center catalog on Lotus Greenhouse. For information about widgets that are already in the default palette, see the Widget help category in the Mashup Center wiki.

Advanced Wiring Dialog widget

Unlike other widgets that you add to your palette and use in mashup pages, the Advanced Wiring Dialog widget is designed to replace the theme-based widget that controls the look and feel of the wiring interface. After you download the widget WAR package from Greenhouse, install the widget package into the WebSphere Application Server Admin Console, and then update the theme to point to the new widget. For detailed steps, see Advanced Wiring Dialog widget in the Mashup Center wiki.
WAR package

Advanced Layout widget

Unlike other widgets that you add to your palette and use in mashup pages, the Advanced Wiring Dialog widget is designed to replace the theme-based widget that controls how columns display when using either a breadcrumb or tabbed column layout. . After you download the widget WAR package from Greenhouse, install the widget package into the WebSphere Application Server Admin Console, and then update the theme to point to the new widget. For detailed steps, see Advanced Layout widget in the Mashup Center wiki.
WAR package

Tab widget

Unlike the Tabview widget, the Tab widget is a true container widget and allows multiple instances on a page. Users must place widgets in the tab widget container on the page.
Greenhouse widget
WAR package

Tabview widget

The Tabview widget allows you to display widgets on a mashup page in multiple tabs. Although this widget is not a true container widget, it provides similar behavior by displaying a tabbed panel that dynamically hides and shows widgets as users click tabs. You can use only one TabView widget on a single page.

To use the Tabview widget, do the following steps:

1. Drag all the widgets that you want to display on the page from the palette. Do not drag any widgets that you want to be hidden on the page yet.
2. Drag the TabView widget on to the page.
3. Click the tab where you want to add your first widget.
4. Drag the widget on to the tab that you just selected. In your mashup, users will be able to click the tab and see this widget inside the tabbed pane.
5. Drag any additional widgets that you want to be hidden on the page from the palette.
6. Configure and wire your widgets as normal.
7. Save your changes.

Greenhouse widget
WAR package

User Input Plus widget

The User Input Plus widget is a version of the default User Input widget in which you can use feeds as labels and values for drop-down lists, radio buttons, and check boxes.
Greenhouse widget
WAR package

Email widget

The e-mail widget allows you to receive and send e-mails using e-mail service providers that support POP3/IMAP and SMTP protocols. After logging in, you can view your inbox, reply to received mail, and compose new mail.
Note: Administrators must configure the e-mail widget with the required information for e-mail service providers before users can access and log in to their accounts. For more information, see Configuring the e-mail widget for users.
Greenhouse widget
WAR package

AccuWeather widget

AccuWeather, established in 1962, is the world's weather authority. AccuWeather provides local forecasts for everywhere in the United States and over two million locations worldwide.
Greenhouse widget
WAR package

IBM Lotus Connections widget

This collection contains the following demo widgets for accessing Lotus Connections: Blogs, Bookmarks, Communities, Profiles, and Tag Cloud. Each widget exposes events that support mashups.

Note: By default, these widgets are designed to work with the version of Lotus Connections that is installed on Greenhouse. This version allows anonymous access to all Lotus Connections components except Profiles. If you want to access the Profiles component, you must first connect to a different Lotus Connections server with public access or to your own Lotus Connections server with single sign-on enabled.

To install all five widgets in your own local or on-site version of Mashup Center, download the Lotus Connections widget WAR package,

Blogs widget

The Blogs widget allows you to access Lotus Connections blogs.
Greenhouse widget

Bookmarks widget

The Bookmarks widget allows you to access Lotus Connections bookmarks.
Greenhouse widget

Communities widget

The Communities widget allows you to access Lotus Connections communities.
Greenhouse widget

Profiles widget

The Profiles widget allows you to access Lotus Connections profiles. In order to use this widget, you must first connect to a different Lotus Connections server with public access or to your own Lotus Connections server with single sign-on enabled.
Greenhouse widget

Tag Cloud widget

The Tag Cloud widget displays a tag cloud for all Lotus Connections objects.
Greenhouse widget

Google Gadgets widget

Google Gadgets are small Web applications that you can embed into multiple Web sites. The Google Gadgets widget lets you browse the Google Gadgets catalog, select a gadget, and then add it to your mashup page. You can add multiple gadgets to a page and wire gadgets with other Mashup Center widgets.
Greenhouse widget
WAR package

IBM Lotus iNotes widget

This widget allows you to browse your Lotus iNotes applications.
Greenhouse widget
WAR package

OpenStreetMap widget

OpenStreetMap is a free, editable map of the whole world. Use the OpenStreetMap widget to display maps in your mashup pages.

If you are migrating your local or on-site version of Mashup Center 1.1 to 2.0 and currently have pages that include the OpenStreetMap 1.1 widget, you can either delete and re-add the OpenStreetMap widget, or you can follow these steps:

1. Download the WAR package.
2. Use the WebSphere Administrative Console to install the WAR file. Be sure to use the following context root: openStreetMap .
3. Open the catalog and select to upload a widget.
4. Select to upload the following widget URL: https://myserver.com/mum/openStreetMap/openStreetMap/openStreetMap.xml.
5. After you have uploaded the widget, add it to the palette.

IBM Lotus Quickr libraries widget

The Lotus Quickr widget allows users to access Lotus Quickr libraries.
Greenhouse widget
WAR package

Sametime widget

The Sametime widget allows users to access Lotus Sametime from your mashup page. This widget is only offered as WAR packages. The package that you select depends on whether you are installing the V2.0 widget for the first time or are upgrading the widget from the V1.1 version to the V2.0 version.

Sametime Upgrade WAR package widget

This widget is designed for users who are migrating a local or on-site version of Mashup Center 1.1 to 2.0. If you currently have pages that include the Sametime 1.1 widget and do not want to delete and re-add the Sametime widget in order for the pages to continue to work, then do the following steps:

1. Download the WAR package.
2. Use the WebSphere Administrative Console to install the WAR file. Be sure to use the following context root: SametimeWebApp.
3. Open the catalog and select to upload a widget.
4. Select to upload the following widget URL: http://MyServer/SametimeWidgetApp/sametime.xml.
5. After you have uploaded the widget, add it to the palette.

Sametime WAR package widget

Download this WAR package to use in your local on on-site versions of Mashup Center. This package is designed for new Mashup Center 2.0 users who are not migrating from a previous release.

StrikeIron widget

The StrikeIron widget contains the following widgets: Zip Code Info, Census Information, Phone to Zip Code, Foreign Exchange Rate, and Currency Rate Range. These widgets use Web services supplied by IBM's Business Partner, StrikeIron. To see a demo of how to use and wire the StrikeIron widgets, see this YouTube video.

To install all five widgets in your own local or on-site version of Mashup Center, download the StrikeIron widget WAR package,

Zip Code Info widget

This widget is based on the StrikeIron zip code information service, which returns country, city, and state information for a given zip code.
Greenhouse widget

Census Information widget

This widget is based on a StrikeIron service that retrieves U.S. demographic information from the U.S. Census Bureau's Census 2000. You can enter a U.S. state, the District of Columbia, or Puerto Rico and receive a detailed demographic profile. Each profile consists of four tables that provide demographic, social, economic, and housing characteristics for a given a ZIP code.
Greenhouse widget

Phone to Zip Code widget

This service validates the NPA and the NXX (area code and prefix) of all the North American Dialing Plan range of phone numbers and returns the ZIP code where this NPA/NXX combination exists.
Greenhouse widget

Foreign Exchange Rate widget

This widget provides historical foreign exchange rates for multiple currencies to a single currency. Rates are quoted either in U.S. dollars per foreign currency unit or in foreign currency units per U.S. dollar. Rates are updated monthly.
Greenhouse widget

Currency Rate Range widget

This widget is based on the StrikeIron Foreign Exchange Rates service, which retrieves NOON Exchange Rates from one currency to another provided by the Federal Reserve Bank of New York for a given date beginning from 06/01/1994 to 30 days ago.
Greenhouse widget