The following table describes the elements and attributes of the ReportAction extension point.
Elements and attributes | Description |
---|---|
ReportActionGroup | Provides menu groupings for ReportActions that define the location of report actions within menus in reports. |
menuPos | Position of a menu group in a report menu. Valid values: "start" (top) "mid1," "mid2," and "end" (bottom). |
ReportAction | Provides interactivity on performance test reports and in the Performance Test Runs view. Defines the behavior of actions in reports. |
groupID | ID of the ReportActionGroup (menu grouping) that contains this ReportAction menu item. |
actionprovider | Behavior provider that extends com.ibm.rational.test.lt.execution.results.ReportAction. |
Menutext | Text for this menu item. |
Icon | The project-relative path to the icon for this menu item. |
Tooltip | Tooltip for menu item. |
AddCounterAction | Provides a wizard for adding and removing specified statistical descriptors (counters). |
groupID | ID of ReportActionGroup that contains this wizard action. |
Menutext | Menu text for an agent. |
Icon | The project-relative path to the icon in the wizard for this action. |
Tooltip | Tooltip for this action. |
allowAllAvailable | When true, a check box is displayed at the bottom of the wizard that reads "Automatically add localizedCounterCategoryName counters to graphic as they appear in result." If the user selects this check box, any counter that appears in the stat model that meets the specifications of the AddCounter action is automatically added to the graphic of focus. For an example of this feature in use, see the Add/Remove Resource Counters wizard in the performance testing product. |
agentID | Returns the ID of the TRCAgent to which this add wizard action applies. Agent IDs can be declared as "not" to specify systems under test, for example !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor. Declaring a "!" ID causes all other agents to be included. If this attribute is blank, it defaults to com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor which is the performance testing Statistical agent. |
wizardIcon | The project-relative path to the icon that is displayed on the wizard page. |
modelBasePath | Specifies the root path from the statistical model from which AddCounterAction should pull counters for the add/remove action. |
cshelpID | The context-sensitive help ID for this wizard. |
localizedCounterCategoryName | The localized description of the type of counters this wizard processes. This string is substituted into the wizard to describe what the user is adding to the report. For example, in the string "Add/Remove Resource Counters Wizard", "Resource Counters" is the localizedCounterCategoryName. This name should be plural as indicated above. |
showScale | Makes data readable within the space provided for it in the user interface. If showScale is true, the wizard enables the user to adjust the scale of counters relative to each other. It also enables a recommended scale to be calculated when data is added to a report from the wizard. For an example of this feature in use, see the Add/Remove Resource Counters wizard in the performance testing product. |
showScope | "Scope" refers to the nodes from which data is pulled from
in the statistical model. If true, the user is provided with a control
to specify the scope of a counter. Valid scopes are:
|
showAgents | If true, the wizard shows agents in the tree hierarchy. If not included or if false, descriptors are shown as the root objects. |
defaultScope | Specifies the default scope to be used by the wizard. "Scope" refers to the nodes in the wizard from which data is pulled from in the wizard. It can be used with or without the showScope attribute. Valid entries are: "CURRENT", "SUT", and "ALL." |
Enablement | Controls when actions are visible and selectable. |
type | Specifies selected object types for which this action should be enabled. Any object that can be identified in a report or in the Performance Test Runs view (PTR) can be specified as a valid type, for example, a chart or table as shown in the PTR or in a report. |
path | Controls visibility. If no path is specified, the item is
visible on any selection where "type" is valid. Path also specifies
the model path to the data to be referenced within the selected object
for menu-item visibility. Paths can contain wildcards, and more than
one path can be specified. An example path specification is as follows:
|
runstate | Controls enablement (not visibility) by run state. If true, the menu item is enabled only if a run is in progress. |
Filterstate | Controls enablement (not visibility) by filter state. If true, the menu item is enabled only if the selected object is filtered. |
<extension
point="com.ibm.rational.test.lt.execution.results.ReportAction">
<ReportAction
groupId="com.ibm.rational.test.lt.execution.results.ImportGroup"
menutext="%IMPORT_RESMON_COUNTERS"
tooltip="%IMPORT_RESMON_COUNTERS_TOOLTIP"
icon="icons/elcl16/import_resmon_data.gif"
actionprovider="com.ibm.rational.test.lt.execution.rm.actions.ImportResourceCounters"
<Enablement>
<type objecttype="com.ibm.rational.test.lt.execution.results.view.countertree.MonitorTreeObject"/>
<type objecttype="com.ibm.rational.test.lt.execution.results.view.countertree.GraphicTreeObject"/>
<type objecttype="com.ibm.rational.test.lt.execution.results.view.graphics.Graphic"/>
<runstate active="false"/>
</Enablement>
</ReportAction>
<AddCounterAction
agentID="!com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor"
allowAllAvailable="true"
cshelpID="add_resource_wiz"
defaultScope="ALL"
groupId="com.ibm.rational.test.lt.execution.results.addcountersgroup"
icon="icons/elcl16/add_res_ctr.gif"
localizedCounterCategoryName="%RESOURCE_COUNTERS_DESCRIPTION"
menutext="%ADD_RESOURCE_COUNTER"
showAgents="true"
showScale="true"
showScope="true"
tooltip="%ADD_RESOURCE_COUNTER_TOOLTIP"
wizardIcon="icons/wizban/add_res_wiz.gif"
<Enablement>
<type objecttype="com.ibm.rational.test.lt.execution.results.view.graphics.Graphic"/>
<type objecttype="com.ibm.rational.test.lt.execution.results.view.countertree.GraphicTreeObject"/>
</Enablement>
</AddCounterAction>
</extension>