Punto di estensione ReportAction

ReportAction abilita l'interazione direttamente con la finestra del report e nella vista Esecuzioni test prestazioni. Utilizzare questo punto di estensione per abilitare i menu del report e le voci di menu nella struttura e per estendere la procedura guidata dei contatori per il protocollo. I programmi di implementazione di ReportActions generici devono estendere la classe astratta com.ibm.rational.test.lt.execution.results.actions.ReportAction, mentre i programmi di implementazione di AddCounterAction devono specificare i dati rilevanti solo in plugin.xml.

Nella seguente tabella sono descritti gli elementi e gli attributi del punto di estensione ReportAction.

Elementi e attributi Descrizione
ReportActionGroup Fornisce raggruppamenti del menu per ReportActions che definiscono la posizione delle azioni dei report all'interno dei menu nei report.
     menuPos La posizione di un gruppo di menu in un menu di un report. I valori validi sono: "start" (inizio) "mid1", "mid2" e "end" (fine).
ReportAction Fornisce interattività sui report di test delle prestazioni e nella vista Esecuzioni test prestazioni. Definisce il funzionamento delle azioni nei report.
     groupID L'ID di ReportActionGroup (raggruppamento del menu) che contiene questa voce di menu ReportAction.
     actionprovider Il funzionamento del fornitore che estende com.ibm.rational.test.lt.execution.results.ReportAction.
     Menutext Il testo per questa voce di menu.
     Icon Il percorso relativo al progetto all'icona di questa voce di menu.
     Tooltip Il suggerimento per la voce di menu.
AddCounterAction Fornisce una procedura guidata per l'aggiunta e la rimozione dei descrittori statistici specificati (contatori).
     groupID L'ID di ReportActionGroup che contiene questa azione della procedura guidata.
     Menutext Il testo del menu per un agente.
     Icon Il percorso relativo al progetto per l'icona nella procedura guidata per questa azione.
     Tooltip Il suggerimento per questa azione.
     allowAllAvailable Se impostata su true, viene visualizzata una casella di spunta nella parte inferiore della procedura guidata che indica "Aggiungi automaticamente contatori localizedCounterCategoryName al grafico come vengono visualizzati nel risultato". Se l'utente seleziona questa casella di spunta, tutti i contatori visualizzati nel modello statistico che rispondono alle specifiche dell'azione AddCounter sono aggiunti automaticamente al grafico della selezione. Per un esempio di questa funzione in uso, fare riferimento alla procedura guidata Aggiungi/rimuovi contatori di risorse nel prodotto di esecuzione del test delle prestazioni.
     agentID Restituisce l'ID di TRCAgent a cui si applica questa azione della procedura guidata. È possibile dichiarare Agent ID come "not" per specificare i sistemi in fase di test, ad esempio !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor. La dichiarazione di un ID "!" causa l'inclusione di tutti gli altri agenti. Se questo attributo viene lasciato vuoto, allora farà riferimento a com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor che è l'agente statistico dell'esecuzione di test delle prestazioni.
     wizardIcon Il percorso relativo al progetto per l'icona visualizzata sulla pagina della procedura guidata.
     modelBasePath Specifica il percorso root dal modello statistico da cui AddCounterAction emette i contatori per l'azione di aggiunta/rimozione.
     cshelpID L'ID della guida sensibile al contesto per questa procedura guidata.
     localizedCounterCategoryName La descrizione localizzata del tipo di contatori elaborati da questa procedura guidata. Questa stringa viene sostituita nella procedura guidata per descrivere gli elementi che l'utente aggiunge al report. Ad esempio, nella stringa "Aggiungi/rimuovi procedura guidata di contatori di risorse", "Contatori risorse" è localizedCounterCategoryName. Questo nome deve essere al plurale come riportato in precedenza.
     showScale Rende i dati leggibili all'interno dello spazio fornito nell'interfaccia utente. Se showScale è impostato su true, la procedura guidata consente all'utente di regolare la scala dei contatori relativi. Inoltre consente il calcolo di una scala consigliata quando i dati vengono aggiunti a un report dalla procedura guidata. Per un esempio di questa funzione in uso, fare riferimento alla procedura guidata Aggiungi/rimuovi contatori di risorse nel prodotto di esecuzione del test delle prestazioni.
     showScope "Scope" fa riferimento ai nodi da cui i dati vengono estratti nel modello statistico. Se questa opzione è impostata su true, all'utente è fornito un controllo per specificare l'ambito di un contatore. Gli ambiti validi sono:
  • Tutte le posizioni I dati vengono estratti da qualsiasi nodo nel modello in cui sono presenti dati che rispondono alle specifiche di un AddCounterAction.
  • Sistema in fase di test I dati vengono estratti da un qualsiasi nodo che non contiene un "Agente statistico RPT". Ciò significa che il nodo è un "nodo driver".
  • Percorso selezionato I dati vengono estratti solo dal nodo in cui è attivo il report.
Per un esempio di questa funzione in uso, fare riferimento alla procedura guidata Aggiungi/rimuovi contatori di risorse nel prodotto di esecuzione del test delle prestazioni.
     showAgents Se impostato su true, la procedura guidata mostra gli genti nella gerarchia della struttura. Se questa opzione non è inclusa o se è impostata su false, i descrittori sono visualizzati come oggetti root.
     defaultScope Specifica l'ambito predefinito da utilizzare con la procedura guidata. "Scope" fa riferimento ai nodi da cui i dati vengono estratti nella procedura. Esso può essere utilizzato con o senza l'attributo showScope. Le voci valide sono: "CURRENT", "SUT" e "ALL".
Enablement Controlla quando le azioni sono visibili e selezionabili.
type Specifica i tipi di oggetti selezionati per cui va abilitata questa azione. Qualsiasi oggetto che può essere identificato in un report o nella vista PTR (Performance Test Runs) può essere specificato come tipo valido, ad esempio un grafico o una tabella come riportato nel PTR o in un report.
path Controlla la visibilità. Se non viene specificato alcun percorso, l'elemento è visibile su qualsiasi selezione per cui "type" è valido. Il percorso specifica inoltre il percorso del modello ai dati di riferimenti all'interno dell'oggetto selezionato per la visibilità delle voci di menu. I percorsi possono contenere caratteri jolly ed è possibile specificare più di un percorso. Una specifica di percorso di esempio è:
<path value="Pages,Response Time,*,Average Cumulative"/>
runstate Controlla l'abilitazione (non la visibilità) in base allo stato di esecuzione. Se true, la voce di menu è abilitata solo se è in corso una esecuzione.
Filterstate Controlla l'abilitazione (non la visibilità) in base allo stato del filtro. Se true, la voce di menu è abilitata solo se l'oggetto selezionato è filtrato.
Di seguito è riportato un esempio di punto di estensione 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