Configuring a new Web page widgetAdded by IBM on October 5, 2011 | Version 1 (Original)
|You can configure a new widget that performs an action using a single form on a specific Web page, or you can create a widget that can perform one or more actions based on an overall Web page. You can optionally require that the user authenticate before using the Web page action.
You can configure a new widget that performs an action using a single form on a specific Web page, or you can create a widget that can perform one or more actions based on an overall Web page. You can optionally require that the user authenticate before using the Web page action.
Parent topic: Configuring widgets using the wizards
- Open the target Web page on which you want to base the new widget and with which you want the action to take place. For example, to search the IBM® Lotus Notes® and IBM Lotus® Domino® Forum, go to the Notes/Domino forum page using the http://www.ibm.com/developerworks/lotus/community link.
- Choose one of the following options and click Next to open the Configure a Component dialog.
This web page
You can build a widget from the target Web page. Choose this option if you are displaying a Web page that contains the results of a form submission;, for example "http://www.lotus.com/ldd/nd8forum.nsf/Search?SearchView&Query=widget".From a form on this web page
When choosing this option, you can specify that the widget open in an external browser or in a named embedded browser.
The choices for Embedded browser are "default" or active embedded browser, XLRunner, and Internet Explorer.
You can build a widget that will submit data to a single form on the target Web page. For example, you can choose the search form on the http://www.lotus.com/ldd/nd8forum.nsf Notes/Domino forum page. If there are feeds available from the current Web page, the wizard will provide you with additional options for creating a Feeds-based widget.
- Optionally specify that authentication is required and click Next.
- For this example, click From a form on this web page" and click Next.
- Select a form on the page as prompted in the wizard. For example, click Form 1 on the Select a form on this page wizard panel and the corresponding form; in this case the Search this Forum field highlights in green to indicate it is the corresponding form field. As you give focus to different forms on the page, the form with focus is highlighted in green and the corresponding form number is also highlighted.
- Click Next to open the Configure a Component dialog.
- Specify a short, descriptive widget name or accept the default.
- In the Widget settings area, specify an ID and display name fields and if a default value is required. Depending on your source, there can be several widget setting IDs. For example, search_by, url, where, and field-keywords are common Ids.
This is the field ID name obtained from the source Web site form. When you check items in the ID column, default values may appear in some or all of the remaining widget fields in that row. Display name
Use an optional name to describe the ID. Required
Specify whether this field must be used. For example, a search string should be required, but the number of results returned by the search may not be. Default value
Optionally specify a default value to use with this component. This can equate to an ENUM value from a list of enumerated values allowed for this field in the given web form. For example, this allows you to preset default values such as your home airport if you are booking a flight. Edit
Click edit to add additional default values.
- Specify what you want to do with the component now; the options are as below.
Display as a panel
This adds the component as its own sidebar panel, not as a widget in the My Widgets sidebar panel. If you choose this option, the Test and Publish panel appears describing what you should do next. Read and then click Finish to exit the wizard and add the widget to your sidebar. Just configure a component for now
This adds the component to the My Widgets sidebar panel. If you choose this option, the Test and Publish panel appears describing what you should do next. Read and then click Finish to exit the wizard and add the widget to your sidebar.
- Click Next and Finish to add the widget and close the wizard.
Requiring authentication when creating a Web-based widget
When you create a Web-based widget, you can optionally specify that users authenticate in order to access the Web site that will be used by that widget. To require authentication, you must specify an existing account name, or create a new account, as you create the widget. This account will be used, or created if it does not already exist, on the user's client. Anyone who uses the widget must use their own existing or new account information.