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.

Procedure

  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:
    Table 1. Widget related desktop policy settings for iNotes
    Setting Description
    Widget catalog server Specify the catalog server from which to provision at application startup and periodically during replication from the catalog to the user's local replica. By default, replication occurs according to the schedule set for Normal priority applications. Use server/domain format or a fully qualified name. If you use a server/domain format, server failover is supported.

    If this policy's How to apply this setting column is set to Set value and prevent changes, users cannot change the value on the Widgets preferences panel.

    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, from which to provision at client application startup and periodically during replication from the catalog to the user's local replica. By default, replication occurs according to the schedule set for Normal priority applications. Use the Widget Catalog template, toolbox.ntf, to create the catalog application.

    If this policy's How to apply this setting column is set to Set value and prevent changes, the client user cannot change the value on the Widgets preferences panel.

    The default catalog name is toolbox.nsf.
    Widget catalog categories to install Specify the widget categories to install and update for this user. These categories will appear in the Categories to install list box on the Widgets preferences panel. Use this setting to limit user access to specific widget categories. If this field is blank, no 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.

    The categories listed in this policy cause the equivalent category names in the Widgets preferences panel to be selected and disabled; the user cannot deselect them.

    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 Notes® document. Live Text display can be toggled on and off when working in a session.

    If this setting is disabled, the Live Text preference panel is hidden from the user.

    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.

    If this setting is disabled, the user cannot enable it.

    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 Notes sidebar and whether the Widgets menus and toolbar are visible.

    If this setting is enabled and its How to apply this setting field is set to Set value and prevent changes, the end user cannot change the Show Widgets Toolbar and the My Widgets Sidebar panel value on the Widgets preferences panel.

    If this setting is disabled and its How to apply this setting field is set to Set value and prevent changes, the Widgets preferences panel is not visible to the end user.

    By default, this setting is disabled.
    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. Note that if you restrict which widget types are available for installation, also restrict creating those same widget types using the Restrict the addition of widgets to specific types and Enable provider IDs for widget addition settings.

    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

    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 Google Gadget widget types:

    com.ibm.rcp.toolbox.google.provider.internal.
GooglePalleteProvider
    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.
    Notes and Expeditor provide these and many other identifiers:
    • com.ibm.rcp.ui.shelfViews
    • com.ibm.rcp.search.engines.searchEngines
    • com.ibm.rcp.search.ui.searchBarSets
    • com.ibm.rcp.content.contentTypes
    • com.ibm.rcp.annotation.regex.regexTypes
    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, these settings specify that widgets can contribute content types but not any other extension point:

    com.ibm.rcp.toolbox.admin/toolboxdynamicExtPtIDs=com.ibm.rcp.content.contentTypes
    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. They can also select additional categories to be provisioned with (in addition to those listed in the Widget catalog categories to install policy) using their Widgets preferences panel.

    By default, this setting is disabled.
    Gadget server URL
    Specify the URL of the Domino server running Shindig. For example: http://shindig.renovations.com.
    Note: This setting is only applicable if using OpenSocial widgets in iNotes.
Parent topic: Using widgets in iNotes