El punto de ampliación ReportActiont

ReportAction habilita las interacciones directamente en la pantalla de los informes, así como en la vista Ejecuciones de pruebas de rendimiento. Utilice este punto de ampliación para habilitar elementos de los menús y menús de los informes en el árbol y para ampliar el asistente del contador para el protocolo. Los implementadores de ReportActions genéricos deben ampliar la clase abstracta com.ibm.rational.test.lt.execution.results.actions.ReportAction, mientras que los implementadores de AddCounterAction deben especificar datos relevantes únicamente en plugin.xml.

En la tabla siguiente se describen los elementos y atributos del punto de ampliación ReportAction.

Elementos y atributos Descripción
ReportActionGroup Proporciona agrupaciones de menús para ReportActions que definen la ubicación de las acciones de los informes dentro de los menús de los informes.
     menuPos Posición de un grupo de menús en un menú de informes. Valores válidos: "start" (arriba) "mid1," "mid2," y "end" (abajo).
ReportAction Proporciona interactividad en los informes de las pruebas de rendimiento y en la vista Ejecuciones de pruebas de rendimiento. Define el comportamiento de las acciones en los informes.
     groupID ID de ReportActionGroup (agrupación de menús) que contiene este elemento de menú ReportAction.
     actionprovider Proveedor de comportamiento que amplía com.ibm.rational.test.lt.execution.results.ReportAction.
     Menutext Texto para este elemento de menú.
     Icon La vía de acceso relativa al proyecto para este elemento de menú.
     Tooltip Ayuda contextual para elemento de menú.
AddCounterAction Proporciona un asistente para añadir y eliminar descriptores estadísticos especificados (contadores).
     groupID ID de ReportActionGroup que contiene esta acción del asistente.
     Menutext Texto del menú para un agente.
     Icon La vía de acceso relacionada con el proyecto al icono del asistente para esta acción.
     Tooltip Ayuda contextual para esta acción.
     allowAllAvailable Cuando el valor es "true", se muestra un recuadro de selección en la parte inferior del asistente en el que se puede leer "Añadir contadores localizedCounterCategoryName automáticamente al gráfico a medida que aparezcan en el resultado". Si el usuario selecciona este recuadro de selección, cualquier contador que aparezca en el modelo estadístico que cumpla las especificaciones de la acción AddCounter se añadirá automáticamente al gráfico en cuestión. Para ver un ejemplo del uso de esta función, consulte el asistente Añadir/eliminar contadores de recursos del producto de pruebas de rendimiento.
     agentID Devuelve el ID de TRCAgent al que se aplica esta acción de añadir del asistente. Los ID de agente se puede declarar como "not" para especificar sistemas que se están probando, por ejemplo, !com.ibm.rational.test.lt.execution.results.XMLStatisticalDataProcessor. La declaración de un ID "!" hace que se incluyan todos los demás agentes. Si este atributo está en blanco, el agente Estadístico de las pruebas de rendimiento,com.ibm.rational.test.lt.execution.dataprocessor.XMLStatisticalDataProcessor, se establece de forma predeterminada.
     wizardIcon La vía de acceso relacionada con el proyecto al icono que se muestra en la página del asistente.
     modelBasePath Especifica la vía de acceso raíz del modelo estadístico desde el cual AddCounterAction debería extraer contadores para la acción de añadir/eliminar.
     cshelpID El ID de ayuda según contexto ID para este asistente.
     localizedCounterCategoryName La descripción localizada del tipo de contadores que procesa este asistente. Esta serie se sustituye en el asistente para describir qué está añadiendo el usuario al informe. Por ejemplo, en la serie "Asistente para añadir/eliminar contadores de recursos", "contadores de recursos" es el localizedCounterCategoryName. Este nombre debería estar en plural tal como se indica arriba.
     showScale Permite que los datos se puedan leer en el espacio facilitado para ello en la interfaz de usuario. Si showScale tiene el valor "true", el asistente habilita al usuario para que ajuste la escala de los contadores relacionados entre sí. Asimismo, habilita una escala recomendada para que se calcule cuando los datos se añadan a un informe desde el asistente. Para ver un ejemplo del uso de esta función, consulte el asistente Añadir/eliminar contadores de recursos del producto de pruebas de rendimiento.
     showScope "Scope" hace referencia a los nodos de los que se extraen los datos en el modelo estadístico. Si el valor es "true", se proporcionará un control al usuario para que especifique el ámbito de un contador. Los ámbitos válidos son:
  • Todas las ubicaciones: Los datos se extraen de cualquier nodo del modelo en el que haya datos que cumplan las especificaciones de una AddCounterAction.
  • Sistema en pruebas: Los datos se extraen de cualquier nodo que no contenga un "RPT Statistical Agent". Esto significa que el nodo es un "nodo controlador".
  • Ubicación seleccionada los datos sólo se extraen del nodo en el que se centra el informe.
Para ver un ejemplo del uso de esta función, consulte el asistente Añadir/eliminar contadores de recursos del producto de pruebas de rendimiento.
     showAgents Si el valor es "true", el asistente muestra agentes en la jerarquía de árbol. Si no se incluye o si el valor es "false", los descriptores se muestran como objetos raíz.
     defaultScope Especifica el ámbito predeterminado que va a utilizar el asistente. "Scope" hace referencia a los nodos del asistente desde los que se extraen los datos del asistente. Se puede utilizar con o son el atributo showScope. Las entradas válidas son: "CURRENT", "SUT", y "ALL."
Enablement Controla cuándo son visibles y seleccionables las acciones.
type Especifica los tipos de objeto seleccionados para los que esta acción debería estar habilitada. Cualquier objeto que se pueda identificar en un informe o en la vista Ejecuciones de Pruebas de Rendimiento (EPR) se puede especificar como tipo válido, por ejemplo, una gráfica o una tabla tal como se muestra en la vista EPR o en un informe.
path Controla la visibilidad. Si no hay ninguna vía de acceso especificada, el elemento está visible en cualquier selección en la que "type" sea válido. La vía de acceso también especifica la vía de acceso de modelo a los datos a los que se va a hacer referencia dentro del objeto seleccionado para la visibilidad del elemento de menú. Las vías de acceso pueden contener comodines y se puede especificar más de una vía de acceso. A continuación, se muestra un ejemplo de especificación de vía de acceso:
<path value="Pages,Response Time,*,Average Cumulative"/>
runstate Controla la habilitación (no visibilidad) por estado de ejecución. Si el valor es "true", el elemento de menú sólo se habilita si hay una ejecución en curso.
Filterstate Controla la habilitación (no visibilidad) por estado de filtro. Si el valor es "true", el elemento de menú sólo se habilita si el objeto seleccionado está filtrado.
A continuación, se muestra un ejemplo de punto de ampliación 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>

Comentarios