O Ponto de Extensão ReportAction

ReportAction permite interações diretamente na tela de relatório, bem como na visualização Execuções de Teste de Desempenho. Utilize esse ponto de extensão para ativar menus de relatório e itens de menu na árvore e para estender o assistente do contador para seu protocolo. Os implementadores de ReportActions genéricos devem estender a classe abstrata com.ibm.rational.test.lt.execution.results.actions.ReportAction, enquanto os implementadores de AddCounterAction devem especificar dados relevantes apenas em plugin.xml.

A tabela a seguir descreve os elementos e os atributos do ponto de extensão ReportAction.

Elementos e atributos Descrição
ReportActionGroup Fornece agrupamentos de menu de contexto para ReportActions que definem o local de ações de relatório dentro de menus nos relatórios.
     menuPos Posição de um grupo de menus em um menu de relatório. Valores válidos: "start" (início) "mid1," "mid2" e "end" (fim).
ReportAction Proporciona interatividade em relatórios de teste de desempenho e na visualização Execuções de Teste de Desempenho. Define o comportamento de ações em relatórios.
     groupID ID do ReportActionGroup (agrupamento de menus) que contém o item de menu ReportAction.
     actionprovider O provedor de comportamento que estende com.ibm.rational.test.lt.execution.results.ReportAction.
     Menutext Texto para este item de menu.
     Icon O caminho relativo ao projeto para o ícone referente a esse item do menu.
     Tooltip Dicas de ferramenta para o item de menu.
AddCounterAction Fornece um assistente para incluir e remover os descritores (contadores) estatísticos especificados.
     groupID ID de ReportActionGroup que contém esta ação do assistente.
     Menutext Texto de menu para um agente.
     Icon O caminho relativo ao projeto para o ícone no assistente referente a esta ação.
     Tooltip Dicas de ferramenta para esta ação.
     allowAllAvailable Quando é definido como true, uma caixa de opção é exibida na parte inferior do assistente com a mensagem "Incluir automaticamente contadores localizedCounterCategoryName no gráfico como eles aparecem no resultado". Se o usuário selecionar essa caixa de opções, qualquer contador que apareça no modelo de estatística que atenda às especificações da ação AddCounter será automaticamente incluído no gráfico de foco. Para obter um exemplo deste recurso que está sendo utilizado, consulte o assistente Incluir/Remover Contadores no produto do teste de desempenho.
     agentID Retorna o ID do TRCAgent ao qual esta ação do assistente de inclusão se aplica. Os IDs de agentes podem ser declarados como "not" para especificar sistemas em teste, por exemplo, !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor. A declaração de um ID "!" faz com que os outros agentes sejam incluídos. Se esse atributo estiver em branco, ele será padronizado como com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor, que é o agente estatístico do teste de desempenho.
     wizardIcon O caminho relativo ao projeto para o ícone que é exibido na página do assistente.
     modelBasePath Especifica o caminho raiz do modelo estatístico do qual AddCounterAction deve obter contadores para a ação incluir/remover.
     cshelpID O ID de ajuda sensível ao contexto para este assistente.
     localizedCounterCategoryName A descrição localizada do tipo de contadores que este assistente processa. Esta cadeia é substituída no assistente para descrever o que o usuário está incluindo no relatório. Por exemplo, na cadeia "Assistente para Incluir/Remover Contadores de Recursos", "Contadores de Recursos" é localizedCounterCategoryName. Este nome deve estar no plural, como indicado anteriormente.
     showScale Torna os dados legíveis dentro do espaço fornecido para ele na interface com o usuário. Se showScale for true, o assistente permitirá que o usuário ajuste a escala de contadores relativa uma a outra. Ele também permitirá que uma escala recomendada seja calculada quando os dados forem incluídos em um relatório do assistente. Para obter um exemplo deste recurso que está sendo utilizado, consulte o assistente Incluir/Remover Contadores no produto do teste de desempenho.
     showScope "Scope" refere-se aos nós a partir dos quais os dados são extraídos no modelo estatístico. Se true, o usuário será fornecido com um controle para especificar o escopo de um contador. Os escopos válidos são:
  • Todos os Locais Os dados são extraídos de qualquer nó no modelo em que os dados estão de acordo com as especificações de AddCounterAction.
  • Sistemas em Teste Os dados são extraídos de qualquer nó que não contém um "Agente Estatístico RPT". Isto significa que o nó é um "nó de driver".
  • Local selecionado Os dados são extraídos apenas do nó em que o relatório está focalizado.
Para obter um exemplo deste recurso que está sendo utilizado, consulte o assistente Incluir/Remover Contadores no produto do teste de desempenho.
     showAgents Se for true, o assistente mostrará agentes na hierarquia de árvore. Se não estiver incluído ou for false, os descritores são mostrados como os objetos-raiz.
     defaultScope Especifica o escopo padrão a ser utilizado pelo assistente. "Scope" refere-se aos nós no assistente a partir do qual os dados são extraídos. Ele pode ser utilizado com ou sem o atributo showScope. As entradas válidas são: "CURRENT", "SUT" e "ALL".
Enablement Controla quando as ações são visíveis e selecionáveis.
type Especifica os tipos de objetos selecionados para os quais esta ação deve ser ativada. Qualquer objeto que possa ser identificado em um relatório ou na visualização PTR (Execuções de Teste de Desempenho) pode ser especificado como um tipo válido; por exemplo, um gráfico ou uma tabela, como mostrado na PTR ou em um relatório.
path Controla a visibilidade. Se nenhum caminho for especificado, o item será visível em qualquer seleção em que "type" seja válido. Path também especifica o caminho de modelo para os dados a serem mencionados dentro do objeto selecionado para visibilidade do item de menu. Os caminhos podem conter caracteres curinga e mais de um caminho pode ser especificado. Um exemplo de especificação de path é:
<path value="Pages,Response Time,*,Average Cumulative"/>
runstate Controla a ativação (não a visibilidade) por estado de execução. Se for true, o item de menu será ativado apenas se uma execução estiver em progresso.
Filterstate Controla a ativação (não a visibilidade) por estado de filtro. Se for true, o item de menu será ativado apenas se o objeto selecionado for filtrado.
A seguir está um exemplo de um ponto de extensão 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