Activity Support



This extension point is used by product plug-ins to configure the behaviour of the Help system when activities are used. It provides for configuring the following aspects:

This extension point is experimental and is likely to change in the future releases as the activity support evolves.

Configuration Markup:

<!ELEMENT extension (support+)>

<!ATTLIST extension




<!ELEMENT support (localScopeCheckbox? , documentMessage , showAllMessage)>

<!ATTLIST support


<!ELEMENT showAllMessage (#PCDATA)>

a plain text message that will be shown in the dialog when activity filtering is turned off. The intent of the message is to warn that without the filter some documents may be referring to user interface elements that are not visible.

The localScopeCheckbox element is deprecated

<!ELEMENT localScopeCheckbox (#PCDATA)>

a label of the checkbox in the local search scope preference page. When the checkbox is selected, search hits in documents that belong to disabled activites will be included in the search results. As of 3.6, this element is no longer used.

<!ELEMENT documentMessage EMPTY>

<!ATTLIST documentMessage



an HTML snippet that will be injected at the top of the help topic that belongs to the disabled activity. The intent of the message is to notify the user that the topic may contain references to the UI elements that are not visible. Since the message text is inside an XML file, HTML tags must be escaped using standard XML entities for special characters.

The message may contain a hyperlink that takes the user to the activity editor that provides for changing activity enablement state. Attribute class must be used in this case.

The following is a sample usage of the activity support extension point:

 <extension point="">
  <support productId="com.example.xyzProduct">
        This actions will reveal all topics in the table of contents.
     <documentMessage class="">
        This topic belongs to the role that is currently disabled.
        To enable the role, open &lt;a href="ACTIVITY_EDITOR"&gt;Role Preference Page.&lt;/a&gt;

API Information:
Attribute class of the element documentMessage must implement interface.

Supplied Implementation:
Eclipse SDK provides the default activity support that uses the term 'capability' and and opens the Capabilities preference page from the hyperlink in disabled topics. When overriding, make sure that the changes and the terminology match those in the platform UI.

Copyright (c) 2005, 2013 IBM Corporation and others.
This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which accompanies this distribution, and is available at SPDX-License-Identifier: EPL-2.0