Point d'extension ReportAction

Le point d'extension ReportAction active les interactions directement sur l'écran du rapport, ainsi que dans la vue Exécutions de test de performances. Ce point d'extension permet d'activer les menus et options de menu du rapport dans l'arborescence et d'étendre l'assistant des compteurs pour votre protocole. Les implémenteurs de points d'extension ReportActions génériques doivent étendre la classe abstraite com.ibm.rational.test.lt.execution.results.actions.ReportAction alors que les implémenteurs de l'élément AddCounterAction ne doivent spécifier les données appropriées que dans le fichier plugin.xml.

Le tableau ci-après décrit les éléments et les attributs du point d'extension ReportAction.

Eléments et attributs Description
ReportActionGroup Fournit des regroupements de menus pour l'élément ReportActions qui définissent l'emplacement des actions de rapport dans les menus des rapports.
     menuPos Position d'un groupe de menus dans un menu de rapport. Les valeurs valides sont les suivantes : "start" (top) "mid1," "mid2" et "end" (à la fin).
ReportAction Permet l'interactivité dans les rapports de test de performances et dans la vue Exécutions de test de performances. Définit le comportement des actions dans les rapports.
     groupID ID du groupe ReportActionGroup (regroupement de menus) qui contient cette option de menu ReportAction.
     actionprovider Fournisseur du comportement qui étend com.ibm.rational.test.lt.execution.results.ReportAction.
     Menutext Texte de cette option de menu.
     Icon Chemin d'accès du projet à l'icône de cette option de menu.
     Tooltip Info-bulle de l'option de menu.
AddCounterAction Fournit un assistant permettant d'ajouter et de supprimer les descripteurs statistiques spécifiés (compteurs).
     groupID ID de ReportActionGroup qui contient l'action de cet assistant.
     Menutext Texte de menu d'un agent.
     Icon Chemin d'accès du projet à l'icône de cette action dans l'assistant.
     Tooltip Info-bulle de cette action.
     allowAllAvailable Si la valeur est true, la case à cocher "Ajouter automatiquement localizedCounterCategoryName au graphique lorsqu'ils apparaissent dans le résultat" est affichée dans la partie inférieure de l'assistant. Si l'utilisateur coche cette case, tout compteur qui apparaît dans le modèle statistique et qui satisfait les spécifications de l'action AddCounter est automatiquement ajouté au graphique sélectionné. Pour un exemple d'utilisation de cette fonction, reportez-vous à l'assistant Add/Remove Resource Counters du produit de test des performances.
     agentID Renvoie l'ID de l'élément TRCAgent auquel cette action d'ajout de l'assistant s'applique. Les ID agent peuvent être déclarés de sorte à ne "pas" spécifier les systèmes testés (par exemple, !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor). La déclaration d'un ID "!" provoque l'inclusion de tous les autres agents. Si aucune valeur n'est spécifiée, la valeur par défaut com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor, qui correspond à l'agent statistique des tests de performances, est utilisée.
     wizardIcon Chemin d'accès du projet à l'icône affichée dans la page de l'assistant.
     modelBasePath Spécifie le chemin racine du modèle statistique à partir duquel AddCounterAction doit extraire les compteurs de l'action d'ajout/de suppression.
     cshelpID ID de l'aide contextuelle de cet assistant.
     localizedCounterCategoryName Description localisée du type des compteurs traités par cet assistant. Cette chaîne est remplacée dans l'assistant pour décrire ce que l'utilisateur ajoute au rapport. Par exemple, dans la chaîne "Assistant Ajout/Suppression de Compteurs de ressources", "Compteurs de ressources" correspond à l'élément localizedCounterCategoryName. Ce nom doit être au pluriel comme indiqué ci-avant.
     showScale Rend les données lisibles dans l'espace fourni à cet effet, dans l'interface graphique. Si la valeur de showScale est true, l'assistant permet à l'utilisateur d'ajuster l'échelle des compteurs entre eux. Il permet également de calculer une échelle recommandée lorsque des données sont ajoutées à un rapport à partir de l'assistant. Pour un exemple d'utilisation de cette fonction, reportez-vous à l'assistant Add/Remove Resource Counters du produit de test des performances.
     showScope La "portée" fait référence aux noeuds à partir desquels les données sont extraites, dans le modèle statistique. Si la valeur est true, l'utilisateur reçoit une commande permettant de spécifier la portée d'un compteur. Les portées valides sont les suivantes :
  • Tous les emplacements Les données sont extraites d'un noeud du modèle qui contient des données respectant les spécifications d'un élément AddCounterAction.
  • Systèmes testés Les données sont extraites d'un noeud qui ne contient pas d'"agent RPT statistique". Cela signifies que le noeud est un "noeud pilote".
  • Emplacement sélectionné - Les données ne sont extraites que du noeud sur lequel porte le rapport.
Pour un exemple d'utilisation de cette fonction, reportez-vous à l'assistant Add/Remove Resource Counters du produit de test des performances.
     showAgents Si la valeur est true, l'assistant affiche les agents dans la hiérarchie en arborescence. Si la valeur est false ou qu'elle n'est pas incluse, les descripteurs sont affichés comme objets racine.
     defaultScope Spécifie la portée par défaut à utiliser par l'assistant. La "portée" fait référence aux noeuds de l'assistant à partir desquels les données sont extraites dans l'assistant. Elle peut être utilisée avec ou sans l'attribut showScope. Les entrées valides sont les suivantes : "CURRENT", "SUT" et "ALL."
Enablement Contrôle la visibilité et la sélection des actions.
type Spécifie les types d'objet sélectionnés pour lesquels cette action doit être activée. Tout objet pouvant être identifié dans un rapport ou dans la vue Exécutions de test de performances (PTR) peut être spécifié comme type valide (par exemple, un graphique ou un tableau, comme illustré dans la vue PTR ou dans un rapport).
path Contrôle la visibilité. Si aucun chemin n'est spécifié, l'élément est visible dans toute sélection où "type" est valide. Le chemin spécifie également le chemin d'accès du modèle aux données à référencer dans l'objet sélectionné pour la visibilité des options de menu. Les chemins d'accès peuvent contenir des caractères génériques et il est possible de spécifier plusieurs chemins. Voici un exemple de spécification de chemin :
<path value="Pages,Response Time,*,Average Cumulative"/>
runstate Contrôle l'activation (et non la visibilité) par état d'exécution. Si la valeur est true, l'option de menu n'est activée que si une exécution est en cours.
Filterstate Contrôle l'activation (et non la visibilité) par état de filtrage. Si la valeur est true, l'option de menu n'est activée que si l'objet sélectionné est filtré.
Vous trouverez ci-après un exemple de point d'extension 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>

Commentaires