Erweiterungspunkt "ReportAction"

Über den Erweiterungspunkt ReportAction sind Interaktionen direkt in der Berichtsanzeige sowie in der Anzeige "Leistungstestläufe" möglich. Verwenden Sie diesen Erweiterungspunkt, wenn Sie Berichtsmenüs und -menüpunkte in der Baumstruktur zulassen und den Zählerassistenten für das Protokoll entsprechend erweitern möchten. Über Implementierungselemente für generische ReportAction-Erweiterungspunkte muss die abstrakte Klasse com.ibm.rational.test.lt.execution.results.actions.ReportAction erweitert werden; über Implementierungselemente für AddCounterAction müssen dagegen nur die relevanten Daten in plugin.xml angegeben werden.

In der folgenden Tabelle werden Elemente und Attribute des Erweiterungspunkts ReportAction beschrieben.

Elemente und Attribute Beschreibung
ReportActionGroup Stellt Menügruppierungen für ReportActions bereit, die die Positionen von Berichtaktionen innerhalb von Menüs in Berichten definieren.
     menuPos Position einer Menügruppe in einem Berichtsmenü. Gültige Werte sind: "start" (Anfang), "mid1," "mid2" und "end" (Ende).
ReportAction Stellt Interaktivität für Leistungstestberichte und für die Sicht "Leistungstestläufe" bereit. Definiert das Verhalten von Aktionen in Berichten.
     groupID ID der ReportActionGroup (Menügruppierung), in der dieser Menüpunkt des Typs ReportAction enthalten ist.
     actionprovider Verhaltensprovider, über den com.ibm.rational.test.lt.execution.results.ReportAction erweitert wird.
     Menutext Text für diesen Menüpunkt.
     Icon Der relative Projektpfad zum Symbol für diesen Menüpunkt.
     Tooltip QuickInfo für den Menüpunkt.
AddCounterAction Stellt einen Assistenten zum Hinzufügen und Entfernen spezieller statistischer Deskriptoren (Zähler) bereit.
     groupID ID der ReportActionGroup mit der Assistentenaktion.
     Menutext Menütext für einen Agenten.
     Icon Der relative Projektpfad zu dem Symbol im Assistenten für diese Aktion.
     Tooltip QuickInfo für diese Aktion.
     allowAllAvailable Bei Bedarf wird unten im Assistenten das folgende Markierungsfeld angezeigt: "Zähler für localizedCounterCategoryName bei Vorkommen in Ergebnis automatisch zur Grafik hinzufügen". Wenn der Benutzer dieses Markierungsfeld aktiviert, wird jeder Zähler im statistischen Modell, der den Spezifikationen der Aktion "AddCounter" entspricht, automatisch in die betreffende Grafik eingefügt. Ein Beispiel für die Verwendung dieses Features finden Sie im Assistenten "Ressourcenzähler hinzufügen/entfernen" im Leistungstestprogramm.
     agentID Meldet die ID von TRCAgent zurück, auf den sich diese Aktion zum Hinzufügen eines Assistenten bezieht. Agenten-IDs können als "nicht einzuschließend" deklariert werden, um im Test befindliche Systeme anzugeben (Beispiel: !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor). Die Deklaration der ID "!" bewirkt, dass alle anderen Agenten eingeschlossen werden. Wenn dieses Attribut leer ist, wird der Wert com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor angenommen. Hierbei handelt es sich um den Statistikagenten für die Leistungstests.
     wizardIcon Der relative Projektpfad zu dem Symbol, das auf der Assistentenseite angezeigt wird.
     modelBasePath Gibt den Stammverzeichnispfad zu dem statistischen Modell an, bei dem AddCounterAction Zähler für die Aktion zum Hinzufügen/Entfernen extrahieren soll.
     cshelpID Die ID der Kontexthilfe für diesen Assistenten.
     localizedCounterCategoryName Die lokalisierte Beschreibung der Zählerart, die von diesem Assistenten verarbeitet wird. Diese Zeichenfolge wird in den Assistenten eingesetzt, um die Eingaben des Benutzers in den Bericht zu beschreiben. Beispiel: In der Zeichenfolge "Ressourcenzähler hinzufügen/entfernen" handelt es sich bei "Ressourcenzähler" um localizedCounterCategoryName. Dieser Name muss (wie oben angegeben) im Plural angegeben werden.
     showScale Sorgt für die Lesbarkeit der Daten in dem dafür vorgesehenen Bereich auf der Benutzeroberfläche. Wenn für showScale "true" angegeben ist, kann der Benutzer über den Assistenten die Skala der in Relation zueinander stehenden Zähler anpassen. Außerdem ermöglicht der Assistent die Berechnung einer empfohlenen Skala, sobald über den Assistenten Daten zu einem Bericht hinzugefügt werden. Ein Beispiel für die Verwendung dieses Features finden Sie im Assistenten "Ressourcenzähler hinzufügen/entfernen" im Leistungstestprogramm.
     showScope "Bereich" (Scope) bezieht sich auf die Knoten, über die Daten aus dem statistischen Modell extrahiert werden. Bei Angabe von "true" erhält der Benutzer eine Steuerungsmöglichkeit zur Angabe des Geltungsbereichs eines Zählers. Gültige Geltungsbereiche sind:
  • Alle Speicherpositionen: Es werden Daten aus einem beliebigen Knoten innerhalb des Modells extrahiert, der über Daten verfügt, die den Spezifikationen von "AddCounterAction" entsprechen.
  • Systeme im Test: Es werden Daten aus einem beliebigen Knoten extrahiert, der nicht über einen "RPT-Statistikagenten" verfügt. Damit wird signalisiert, dass es sich bei dem Knoten um einen "Treiberknoten" handelt.
  • Ausgewählte Speicherposition: Daten werden lediglich aus dem Knoten extrahiert, auf den sich der Bericht konzentriert.
Ein Beispiel für die Verwendung dieses Features finden Sie im Assistenten "Ressourcenzähler hinzufügen/entfernen" im Leistungstestprogramm.
     showAgents Bei Angabe von "true" werden vom Assistenten in der Baumstruktur Agenten angezeigt. Wenn nicht zutreffend oder bei Angabe von "false" werden Deskriptoren als Stammobjekte angezeigt.
     defaultScope Damit wird der vom Assistenten zu verwendende Standardbereich angegeben. "Bereich" bezieht sich auf die Knoten im Assistenten, über die Daten aus dem Assistenten extrahiert werden. Es ist eine Verwendung mit oder ohne Attribut showScope möglich. Gültige Einträge sind "CURRENT", "SUT" und "ALL".
Enablement Hier wird gesteuert, wann Aktionen sichtbar und auswählbar sein sollen.
type Hiermit werden ausgewählte Objekttypen angegeben, für die diese Aktion aktiviert werden soll. Jedes beliebige Objekt, das in einem Bericht oder in der Sicht "Leistungstestläufe" (Performance Test Runs, PTR) identifiziert werden kann, kann entsprechend der Anzeige in der Sicht "Leistungstestläufe" oder in einem Bericht als gültiger Typ (beispielsweise als Diagramm oder als Tabelle) angegeben werden.
path Hiermit wird die Sichtbarkeit gesteuert. Wird kein Pfad angegeben, wird dieser Eintrag immer bei einer Auswahl angezeigt, wenn "type" gültig ist. Über "path" wird auch der Modellpfad zu den Daten angegeben, auf die zwecks Sichtbarkeit von Menüpunkten innerhalb des ausgewählten Objekts Bezug genommen wird. In den Pfaden können Platzhalterzeichen verwendet werden. Außerdem können mehrere Pfade angegeben werden. Es folgt ein Beispiel für eine Pfadspezifikation:
<path value="Pages,Response Time,*,Average Cumulative"/>
runstate Hiermit wird die Aktivierung (nicht Sichtbarkeit) nach Ausführungsstatus gesteuert. Bei Angabe von "true" wird der betreffende Menüpunkt nur dann aktiviert, wenn gerade eine Ausführung stattfindet.
Filterstate Hiermit wird die Aktivierung (nicht Sichtbarkeit) nach Filterstatus gesteuert. Bei Angabe von "true" wird der betreffende Menüpunkt nur dann aktiviert, wenn das ausgewählte Objekt gefiltert wird.
Es folgt ein Beispiel für einen Erweiterungspunkt des Typs ReportAction:
<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>

Feedback