Home
Widgets and Live Text
Widgets and Live Text enables end users to see and act on Live Text in a document, including mail, using widgets (.XML files) created for their use. Power users and administrators can create and edit widgets, and deploy them to users to engage a Notes® form, view, XPage, document or Composite Application, or third party services such as Web page, feed, or Google Gadget™, or automatically install or update a client plug-in for specific Notes users.
Advanced Widgets and Live Text topics - Power users or application developers
You can create and edit Notes® and Web-based XML extensions (widgets) and make those widgets available from a central catalog.
How do I create a new widget using the wizards?
You can create a new widget by clicking the Getting Started with Widgets or Configure a Widget from Current Context toolbar options, or their corresponding My Widgets menu options, to open the applicable wizard sequence. For each widget type, wizard text instructs you what to do next.
How do I create a Composite Applications widget?
You can create a widget using the active composite application as the current context.

Widgets and Live Text
Widgets and Live Text enables end users to see and act on Live Text in a document, including mail, using widgets (.XML files) created for their use. Power users and administrators can create and edit widgets, and deploy them to users to engage a Notes® form, view, XPage, document or Composite Application, or third party services such as Web page, feed, or Google Gadget™, or automatically install or update a client plug-in for specific Notes users.
- Getting started with Widgets and Live Text
  Widgets and Live Text is designed for three main user types -- end user, power user and application developer, and administrator. Policy and preferences control various access levels. Roles often overlap. For example, a power user may create and deploy widgets to end users while end users may use widgets that have been created for them, rather than create their own.
- Working with Widgets and Live Text - End users
  If you are a Widgets and Live Text end user who does not have widget creation or catalog access rights, you can act on Live Text in your active document or double-click an installed widget to start an action. Depending on your policy or preference settings, you may also be able to do other tasks, such as add a new widget to your client sidebar or My Widgets sidebar panel.
- Advanced Widgets and Live Text topics - Power users or application developers
  You can create and edit Notes® and Web-based XML extensions (widgets) and make those widgets available from a central catalog.
  - How do I create and share widgets?
    When you first open the My Widgets sidebar panel, and if there are no widgets in the panel, introductory text appears in the My Widgets sidebar panel to guide you through the process of creating your first widget. Otherwise, you can begin creating widgets by clicking either the Getting Started with Widgets or Configure a Widget from Current Context toolbar buttons.
  - How can I set authentication controls for widgets I create?
    When you create a Web-based widget, you can optionally specify that users authenticate in order to access the website 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.
  - How do I wire a widget action?
    When building a widget using a wizard, many provided wizards use the Configure a Widget and Wire an action to configure a widget wizard pages. On the Configure a Widget wizard page, if you choose to Wire as an action, the next wizard page is the Wire an action to configure a widget wizard page. This page enables you to create a new widget action and, within that action, wire a new or existing content type to a widget property.
  - How do I create a new widget using the wizards?
    You can create a new widget by clicking the Getting Started with Widgets or Configure a Widget from Current Context toolbar options, or their corresponding My Widgets menu options, to open the applicable wizard sequence. For each widget type, wizard text instructs you what to do next.
    - How do I create a Notes widget from a form or document?
      You can create a widget that opens an HCL Notes® document or that fills out a Notes form using a default value, selected Live Text, or typed values.
    - How do I create an XPages widget?
      You can create a widget to search HCL Notes® XPages using a default value, selected Live Text, or other selected text. You can also use this wizard to open the target XPage.
    - How do I create a Notes widget from a view or frameset?
      You can create a widget to search an HCL Notes® view using a default value, selected Live Text, or other selected text. You can also use this wizard to open the target Notes view or frameset.
    - How do I create a Web page widget?
      You can create a widget that acts on a default value, selected Live Text, or other selected text 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.
    - How do I create a Google Gadget widget?
      You can create a Google Gadget™ widget to extend your application and simplify certain tasks.
    - How do I create a Feeds widget?
      You can create a widget to stay connected to your favorite feeds subscriptions using a widget. You can configure the feeds-based widget to be linked to a default value, selected Live Text, or other selected text.
    - How do I create a Features and Plugins deployment widget?
      You can create a widget for deploying features and plug-ins to client users.
    - How do I create a Composite Applications widget?
      You can create a widget using the active composite application as the current context.
  - What is the widget catalog and what can I do with it?
    The widgets catalog is a server-based application that contains all centrally managed widgets and their underlying XML extension definitions, including content types and recognizers. The catalog is based on the HCL Domino® server-supplied Widget Catalog template (toolbox.ntf) and its access is controlled by a combination of application ACLs and Domino policies or Eclipse™ preferences (plugin_customization.ini file), as well as widget catalog categories.
  - How do I browse the widgets catalog?
    You can browse the catalog to view and optionally add widgets to your My Widgets sidebar panel.
  - How do I create a new widgets catalog category?
    You can add one or more category names to a widget when you publish to the central widget catalog. You can also open an existing widget in the catalog and add or remove its category names.
  - How do I add or update widgets from the catalog?
    You can add or update widgets from the catalog. Updates can reflect any new, updated, or deleted widgets in the catalog. If your My Widgets sidebar panel is visible, the new, updated, or deleted widgets are reflected in your My Widgets sidebar panel.
  - How do I configure a widget action?
    Configure a widget action to act on a recognized Live Text pattern.
  - How do I create or configure a content type?
    When you configure a new action with the Widgets and Live Text wizards, you can configure new or existing content types, and optionally wire them to new or existing recognizers, within a widget action. You can also configure and publish content types independently of their inclusion in a widget.
  - How do I create or configure a recognizer?
    When you create a new action with the Widgets and Live Text wizards, you can optionally configure new or existing recognizers within a wizard action. You can also configure and publish recognizers independently of their inclusion in a widget. Users can click on Live Text to initiate an action that has been pre-wired to act in a specific manner on that text pattern. For example, if email addresses are recognized as Live Text, you could click on a Live Text email address to open a new mail message addressed to that email recipient.
  - Can I use a widget property to filter a current user name or date?
    You can create a widget property to filter information by the current user's name or the current date.
  - What is the Widget Management view and how do I use it?
    The Widget Management view enables you to see and act on all your available widget actions, content types, and recognizers in a single view.
  - How do I import a widget's XML information?
  - How do I export a widget's XML information?
  - How do I display all available recognizers?
    Use the Recognize All Content option, to determine if all Live Text is highlighted for the active session or if only content that has an associated action is highlighted. Use this option if you are creating recognizers and want to test them without also having to create an action.
  - What can I do with widgets in the My Widgets sidebar panel?
    You can open and act on widgets in the My Widgets sidebar panel.
  - How do I publish a widget to the catalog?
    Publish your widgets to a central widgets catalog to make them available and deployable to others. You can publish widgets, content types, and recognizers to the catalog on the server. The published result is a widget document in the catalog application. The document name is the widget, content type, or recognizer name. The document contains description information and an XML extension attachment.
  - Why assign a widget category?
    You can assign one or more categories to a widget when you publish the widget to the catalog. You can also add, remove, or change a widget's categories while working in the catalog. Widget categories allow you to control installation of widgets for users based on category name.
  - How do I change a published widget and update the catalog?
    You can change a widget in your My Widgets sidebar panel that you had previously published to the catalog.
  - How do I remove a widget?
    You can remove a widget using the Remove option or by removing yourself from a widget category.
  - How do I set or change widget properties?
    You can set or change default widget properties. For example, properties available for a local weather widget could include a ZIP code.
  - How do I share widgets using email?
    You can send and receive widgets using email.
  - How do I select and open a widget?
    You can open a widget, for example a local weather display, using one of several options. You can also double-click a widget in the My Widgets sidebar panel to open the widget in a new window. .
  - How do I open more than one widget in a dashboard?
    You can select two or more widgets in the My Widgets sidebar panel and open them in a single-view dashboard.
  - What additional deployment tasks can I perform?
    You can perform several advanced tasks to configure the Widgets and Live Text functionality to take advantage of flexible deployment options.

How do I create a Composite Applications widget?

You can create a widget using the active composite application as the current context.

About this task

You can create a widget that opens a composite application in a new tab or one that is wired to act on Live Text or selected text in a particular manner.

The following sequence configures the widget such that a zip code from Live Text in a Notes document is sent to the Filter View by Category action in the composite application.

Procedure

In Notes, open a composite application and click the Configure a widget from the current context toolbar option to open the Create a new widget for this application wizard. For example, open a composite application that contains the Notes Mail and Contacts views.
Specify a new widget name, for example ZipCodeContactFilter.
To wire the widget to act on Live Text or selected text in a particular way, click Wire as an action.

Note: To create a widget that simply opens the composite application in a new tab, click Just configure a widget for now and Finish.
Enter a descriptive action name to appear in the Live Text hover menu, for example ZipCodeCollect.
Select the content type property for the action. For example, select Address and then select the address.zip child property.

Note: You should be familiar with the composite application itself before attempting to wire a content property to an action.
Select one or more component actions to execute with Live Text or selected text. For example, select the All Contact – Filter View by Category action.

Note: Only component actions that accept a string value as input are listed; other value types are not available.
Click Finish and the new widget appears in the My Widgets sidebar panel.
Test the widget. You can optionally add the widget to the widgets catalog to share with others.