Widgets, Live Text, and OpenSocial Admin Documentation Updates for IBM® iNotes® 9.0

Technote (troubleshooting)


Problem

Some topics in the Widgets, Live Text, and OpenSocial section of the IBM iNotes 9.0 Administrator documentation were not updated for the release and contain information that applies to earlier releases.

In iNotes 9.0, the Widgets folder in the Mail outline is no longer supported. The documentation surrounding this feature remains in the iNotes 9.0 documentation but does not apply to iNotes 9.0.
This documentation that is no longer applicable is found here: Configuring iNotes/Creating mail policy settings for iNotes users/Using widgets in iNotes. The topic "Using policies to control widgets and live text access" is the only topic that does apply to iNotes 9.0.
The policies that controlled the Widgets feature in the Mail outline are not supported in 9.0 clients. These policies are found here and have been marked as obsolete:
iNotes - Configuration tab of the Mail policy settings document:

  • Show the Widgets folder in the Mail outline
  • Allow users to create widgets from XML (optional, for advanced users)
The policies that now control Widgets in iNotes 9.0 are in the Widgets tab in the Desktop Policy settings. Information on these policies can be found here in the iNotes 9.0 admin documentation: Configuring iNotes/Creating mail policy settings for iNotes users/Using widgets in iNotes/Using policies to control widgets and live text access. There are updates to this documentation below.

The Widgets features for iNotes 9.0 consist of a new My Widgets sidebar panel with the ability to push widgets to end user via Widgets Policy.

You can configure Widgets and Live Text for iNotes users without the support and configuration of OpenSocial widgets and Embedded Experiences. In this case, only Web widgets would be supported.
Requirements to enable Widgets and Live Text for iNotes 9.0 users:
1. The Domino OpenSocial component installer needs to be run on the iNotes Server in order to support the Widgets and Live Text features.
2. The Widget Catalog needs to be created and replicated to all iNotes Mail servers (see help topic "Configuring the widget catalog application" below).
3. Session authentication needs to be enabled (see help topic "Configuring server session authentication" below).
4. (optional) Enable automatic updates for end user's widgets (see help topic "Configuring automatic updates for widgets" below).
5. Policies need to applied for the users - mail policy settings document and desktop policy settings document (Gadget Server URL is not needed) (see help topic "Creating policies for Domino Social Edition Open Social component" below).
6. Enable notes.ini settings - iNotes_WA_LiveText and iNotes_WA_Widgets (see help topic "Using notes.ini file settings to enable widgets, embedded experiences, live text and OpenSocial features" below).

If you want to support OpenSocial widgets and Embedded Experiences additional steps need to be taken.
Requirements to enable OpenSocial widgets and embedded Experiences:
1. Enable locked domains (see help topic "Locked domains" below).
2. Create and configure the credential store and configuration settings document for Shindig on Domino (see help topic "Setting up the Domino server to run the Domino Social Edition Open Social component and Shindig" below).
3. Additional Policies needs to be set- Gadget Server URL on the Widgets tab in desktop policy settings document and a security policy settings document (see help topic ""Creating policies for Domino Social Edition Open Social component" below).
4. Additional notes.ini settings need to enabled - iNotes_WA_EnableEE and iNotes_WA_OpenSocial (see help topic "Using notes.ini file settings to enable widgets, embedded experiences, live text and OpenSocial features" below).
5. Widgets approval process needs to take place for use of any OpenSocial widgets and Embedded Experiences (see help topic "Widgets created from an OpenSocial gadget" below).

Note: The Widgets features for iNotes 9.0 are only supported in iNotes Full Mode.

Note: When using Widgets in iNotes, the data for the installed widgets are stored in a hidden document in the end user's mail file. A user could lose widget data if: 1) The user's mail file is a replica that saves space using a custom selection formula rather than the Remove documents not modified in the last N days option; and 2) the user or server's automatic widget update has not performed any data changes for the user in a time period that exceeds the custom selection formula criteria.

All of the documentation surrounding these steps are in the section 'Administering the Domino Social Edition Open Social component' in the iNotes Admin documentation. There are many updates to this set of documentation. See below for the updates...

Administering the Domino Social Edition Open Social component
Note: Domino Admin help with outline can be found here.

Updates for Configuring iNotes/Creating mail policy settings for iNotes users/Using widgets in iNotes/Using policies to control widgets and live text access
Using policies to control widgets and live text access

Control widgets and live text access using the settings on the Widgets tab of the desktop settings policy document.
1. From the IBM Domino Administrator client, open an existing desktop policy settings document or create a new one.
2. From the desktop settings policy document, click Widgets.
3. Complete these settings as needed:
Note: the following Widgets policy settings are the only ones that apply to iNotes deployment.

Setting
Description
Table 7. Widget related desktop policy settings for iNotes
Widget catalog server Specify the catalog server from which to provision.

By default, this value is not set.

Widget catalog application name Specify the Widget catalog application name, for example toolbox.nsf, on the catalog server. Use the Widget Catalog template, toolbox.ntf, to create the catalog application.

The default catalog name is toolbox.nsf.

Widget catalog categories to install Specify the widget categories to install and update for this user. Use this setting to limit user access to specific widget categories. If this field is blank, no default widgets are installed in the user's My Widgets sidebar panel. Categories typically equate to a user grouping, such as a specific project team or job type.

By default, this value is not set.

Enable Live Text Specify if you want auto-recognized Live Text to appear as dash-underlined text in the user's iNotes document. If a server's notes.ini does not have iNotes_WA_LiveText=1, then Live Text cannot be enabled on that server.

By default, this setting is enabled.

Enable Default Recognizers Specify whether the IBM-supplied, advanced Live Text recognizers such as person (name), place (address), and organization are enabled.

By default, this setting is enabled.

Show the My Widgets panel in the sidebar Specify whether the My Widgets sidebar panel is visible in the iNotes sidebar.

By default, this setting is enabled.

Restrict provider IDs for installation/execution Restrict installation and update of widgets to specific types referred to as provider IDs. If enabled, you can specify which widget types (provider IDs) are available using the Enable provider IDs for installation/execution setting.

By default, this setting is disabled.

Enable provider IDs for installation/execution (only applicable if Restrict provider IDs for installation/execution field is enabled) Specify the widget types available for installation and update. Use a comma to separate types in the list.

These are the available widget type/Provider IDs. They correlate to the available widget types.

    • com.ibm.notes.toolbox.provider.NotesViewPalleteProvider
    • com.ibm.notes.toolbox.provider.NotesFormPalleteProvider
    • com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider
    • com.ibm.rcp.toolbox.feeds.FeedPalleteProvider
    • com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider
    • com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning
    • com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider
    • com.ibm.rcp.toolbox.ca.provider.internal.CAActionPalleteProvider
    • com.ibm.notes.toolbox.provider.XPagesPalleteProvider
    • com.ibm.rcp.toolbox.opensocial.provider.internal.OpenSocialPalleteProvider
Default
com.ibm.rcp.toolbox.google.provider.internal.GooglePalleteProvider,com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider,com.ibm.rcp.toolbox.feeds.FeedPalleteProvider,com.ibm.notes.toolbox.provider.NotesViewPalleteProvider,com.ibm.rcp.toolbox.prov.provider.ToolboxProvisioning,com.ibm.notes.toolbox.provider.NotesFormPalleteProvider,com.ibm.rcp.toolbox.search.provider.SearchPalleteProvider,com.ibm.rcp.toolbox.ca.provider.internal.CAActionPalleteProvider,com.ibm.notes.toolbox.provider.XPagesPalleteProvider,com.ibm.rcp.toolbox.opensocial.provider.internal.OpenSocialPalleteProvider

For example, if the policy setting Restrict provider IDs for installation/execution is set to Enabled and Enable provider IDs for installation/execution is set to this value, the user can only install or provision Web widget types: com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider

Note: iNotes only supports com.ibm.rcp.toolbox.web.provider.WebServicesPalleteProvider and com.ibm.rcp.toolbox.opensocial.provider.internal.OpenSocialPalleteProvider. By default, all other widget types will not be allowed to be installed in iNotes client. If you want to further restrict installing Web widgets or OpenSocial widgets then you can use these policies.

Restrict extension point IDs for installation/execution Restrict the installation of widgets that contain certain extension points. If enabled, you can then specify which extension point IDs are allowed using the Enable extension point IDs for installation/execution setting.
Note: Extension points are an Eclipse feature. They define new function points for the platform that other plug-ins can plug into. Eclipse provides many extension points with the core platform. The Widgets and Live Text feature also provides some extension points.

By default, this setting is disabled.
Enable extension point IDs for installation/execution (only applicable if Restrict extension point IDs for installation/execution field is enabled) You can restrict or add to this list. Use a comma to separate items in the list.

Default:

org.eclipse.ui.popupMenus,com.ibm.rcp.content.contentTypes,
com.ibm.rcp.annotation.regex.regexTypes,com.ibm.rcp.ui.
shelfViews,org.eclipse.ui.views,org.eclipse.ui.viewActions,
com.ibm.rcp.search.engines.searchEngines,com.ibm.rcp.search.
ui.searchBarSets

For example, if Restrict extension point IDs for installation/execution is Enabled and this setting is set to "com.ibm.rcp.content.contentTypes", then widgets can contribute content types but not any other extension point.

Install widgets from catalog Specify whether a user can browse the configured catalog and select widgets to install to the My Widgets sidebar panel or sidebar. If enabled, the user can select a widget from the catalog and drag and drop the widget's XML extension attachment to their My Widgets sidebar panel. If Disabled, the Browse Widget Catalog action will not be available.

By default, this setting is disabled.

Gadget Server URL URL for the Domino server running Shindig, for example, http://shindig.renovations.com

Note: Only applicable if using OpenSocial widgets in iNotes.


Note: the following Widgets policy settings do not apply to iNotes deployments:
"Restrict the creation of widgets to specific types" -> a user cannot create widgets in iNotes
"Create and manage an action" -> a user cannot create widget actions in iNotes.
"Create and manage recognizers and content types" -> a user cannot create recognizers and content types in iNotes.
"Send widgets using e-mail" -> a user cannot send widgets using email in iNotes.
"Install widgets from e-mail or other" -> a user can only install widgets from the corporate widget catalog in iNotes.
"Publish to catalog so others can browse" -> a user cannot publish a widget in iNotes.
"Gadget Cache URL" -> all caching for gadgets is done locally on the shindig server in iNotes deployments.

Rate this page:

(0 users)Average rating

Document information


More support for:

IBM iNotes
OpenSocial

Software version:

9.0

Operating system(s):

Linux, Mac OS X, Windows

Reference #:

1627817

Modified date:

2014-05-12

Translate my page

Machine Translation

Content navigation