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:
|
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. |
<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>