Difference between revisions of "Analizador de KB java"

From GXtest Wiki
Jump to: navigation, search
(AnalizadorKBJava.exe.config)
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
El analizador de KB java es un utilitario específico para KBs generadas en java con GeneXus 9, el cual genera la metadata (archivo gxt) de las pantallas web de la aplicación para que GXtest utilice como KB.  
+
[[Category:GXtest4Bantotal]]
 +
El analizador de KB java es un utilitario específico para KBs generadas en java con GeneXus 9, el cual genera la metadata (archivo .gxt) de las pantallas web de la aplicación para que GXtest utilice como KB.  
  
 
Este utilitario sirve cuando el usuario de GXtest no tiene acceso a la KB o los fuentes de la aplicación, pero sí a los archivos binarios de la app java web (archivos .class).
 
Este utilitario sirve cuando el usuario de GXtest no tiene acceso a la KB o los fuentes de la aplicación, pero sí a los archivos binarios de la app java web (archivos .class).
  
Además del archivo gxt, el Analizador extraerá información sobre las referencias entre objetos de la KB (cross-reference), los atributos y tablas utilizadas, y las sentencias SQL definidas en cada objeto.
+
Además del archivo .gxt, el Analizador extraerá información sobre las referencias entre objetos de la KB (cross-reference), los atributos y tablas utilizadas, y las sentencias SQL definidas en cada objeto.
  
 
En las siguientes secciones se detalla cómo configurar/utilizar la herramienta, y cómo ver los resultados.
 
En las siguientes secciones se detalla cómo configurar/utilizar la herramienta, y cómo ver los resultados.
Line 10: Line 11:
 
La herramienta requiere:
 
La herramienta requiere:
 
* .Net framework 4.5.2
 
* .Net framework 4.5.2
* Java JRE 7 o mayor
+
* Java JRE 7 o superior
 
* SQLServer para guardar la información sobre los objetos. Puede ser local o un equipo remoto, en cualquiera de sus versiones (Express, Enterprise, Developer), 2005 o superior.
 
* SQLServer para guardar la información sobre los objetos. Puede ser local o un equipo remoto, en cualquiera de sus versiones (Express, Enterprise, Developer), 2005 o superior.
 +
* En el SQLServer seleccionado se deberá crear una base de datos vacía (se sugiere utilizar el nombre KBInfo)
 +
* Ejecutar el script "inicializar_bd.sql" incluido en el archivo zip descargado. Si no se utilizó el nombre KBInfo para la base de datos del paso anterior, se deberá reemplazar en la línea "use [KBInfo];" por el nombre de la base de datos creada.
  
 
== Configuración ==
 
== Configuración ==
La herramienta necesita ciertas configuraciones para ejecutar ya que no tiene UI, de forma de poder ejecutarla en un proceso automatizado.
+
Para la configuración de la herramienta es necesario:
=== config.xml ===
+
<pre>
+
<configuration>
+
<appSettings>
+
<add key="KBName" value="SabadellPruebas"/>
+
<add key="KBDescription" value="KB de prueba"/>
+
<add key="JREPath" value="C:\Program Files\Java\jre7\bin\java.exe"/>
+
<add key="SourcePath" value="D:\temp\sabadell-binarios"/>
+
<add key="OutputPath" value="D:\temp\sabadell-binarios\sabadell.gxt"/>
+
</appSettings>
+
</configuration>
+
</pre>
+
  
*KBName: nombre de la KB. Se utiliza luego para hacer seguimiento a diferentes versiones de la misma KB y realizar comparaciones de impacto.
+
* Indicar la dirección del archivo java.exe.
*KBDescription: descripción de la KB (opcional)
+
*JREPath: Ubicación del archivo java.exe dentro de la instalación de el JRE o JDK de Java 7 o superior.
+
*SourcePath: Directorio donde están ubicado los binarios .class de la aplicación que serán analizados.
+
*OutputPath: Nombre y ubicación del archivo gxt que será generado luego del análisis.
+
  
=== AnalizadorKBJava.exe.config ===
+
* Debe proporcionar los datos de configuración de las bases de datos KBInfo y GXtest:
En este archivo se configura la conexión a la base de datos donde se guardará la información obtenida de los objetos.
+
** Nombre o IP del servidor.
<pre>
+
** Nombre de la base de datos.
<configuration>
+
** Datos de autenticación (Puede ser Integrada o SQL).
...
+
<connectionStrings>
+
    <add name="KBInfoEntities" connectionString="...;provider connection string=&quot;data source=localhost;initial catalog=KBInfo;integrated security=True;... />
+
</connectionStrings>
+
...
+
</configuration>
+
</pre>
+
Debe ubicar la sección connectionStrings, y allí modificar:
+
*data source: nombre de red o IP del equipo donde está el SQLServer donde se guardará la información
+
*initial catalog: nombre de la base de datos. Si se dejó el nombre de base de datos por defecto (KBInfo) en el script de inicialización no será necesario cambiar nada.
+
*integrated security: True si se desea utilizar el usuario de Windows para conectarse al SQLServer. En caso de poner False, deberá agregar los campos user y password al string de conexión (por ejemplo: "Integrated Security=False;User Id=myUsername;Password=myPassword").
+
  
== Versiones ==
+
'''Nota:''' En caso de ser Autenticación SQL debe proporcionar usuario y contraseña. En ambos casos puede comprobar la conexión.
  
* 1.0 (2016-02-22) - Descargar
+
[[Image: Configuracion.png|650 px|center ]]
 +
 
 +
== Analizador de archivos .class ==
 +
 
 +
En la pestaña "Analizar .class" deberá indicar la carpeta que contiene los archivos .class, indicar el nombre de la KB y describir el o los cambios efectuados.
 +
 
 +
Al dar clic en el botón "Analizar", se descompilarán todos los archivos .class volcando la información en la base de datos indicada en la configuración de la herramienta.
 +
 
 +
[[File: Analizar.png|650px|center]]
 +
 
 +
== Generador de archivos .gxt y tests ==
 +
 
 +
En la pestaña "Generar .gxt y tests" se debe indicar la carpeta en la que queremos se guarde el archivo .gxt que se generará, así como los tests en caso de ser seleccionada esta opción. Una vez seleccionada la KB de la que se desea generar el archivo .gxt se da clic en el botón "Generar", la herramienta actualiza el estado del proceso incluyendo el tiempo transcurrido para la generación del archivo .gxt.
 +
 
 +
 
 +
[[File: Generar.png |650px|center]]
 +
<br>
 +
Si selecciona el checkbox “Generar test”, en la carpeta indicada se creará una carpeta nombrada “Tests” con un archivo .xml que contiene un test para cada webpanel de la KB generada y un archivo .dpd que contiene los Datapools asociados a las pruebas creadas en el documento .xml.
 +
<br>
 +
[[File: Carpeta.png |650px|center]]
 +
<br>
 +
[[File: Tests.png |650px|center]]
 +
 
 +
== Analizador de impacto ==
 +
 
 +
En la pestaña "Analizar impacto" debe seleccionar la KB a analizar y el proyecto de interés. Al dar clic en el botón “Analizar” la herramienta devolverá los casos de pruebas que contienen paneles que han sido modificados, devuelve además casos de pruebas que contienen paneles que hacen referencia a procedimientos Genexus que fueron modificados. Si se da doble clic en algún caso de prueba devuelto se muestran los objetos modificados que impactan en dicho caso de prueba.
 +
 
 +
 
 +
[[File: AnalizadorImpacto.PNG | 650 px |center]]
 +
 
 +
== Examinador de objetos ==
 +
 
 +
En la pestaña "Examinar" debe seleccionar una KB y un objeto para ver la información relacionada a dicho objeto.
 +
 
 +
[[File: Examinar.png |650px|center]]

Latest revision as of 17:17, 28 April 2017

El analizador de KB java es un utilitario específico para KBs generadas en java con GeneXus 9, el cual genera la metadata (archivo .gxt) de las pantallas web de la aplicación para que GXtest utilice como KB.

Este utilitario sirve cuando el usuario de GXtest no tiene acceso a la KB o los fuentes de la aplicación, pero sí a los archivos binarios de la app java web (archivos .class).

Además del archivo .gxt, el Analizador extraerá información sobre las referencias entre objetos de la KB (cross-reference), los atributos y tablas utilizadas, y las sentencias SQL definidas en cada objeto.

En las siguientes secciones se detalla cómo configurar/utilizar la herramienta, y cómo ver los resultados.

Contents

Requerimientos

La herramienta requiere:

  • .Net framework 4.5.2
  • Java JRE 7 o superior
  • SQLServer para guardar la información sobre los objetos. Puede ser local o un equipo remoto, en cualquiera de sus versiones (Express, Enterprise, Developer), 2005 o superior.
  • En el SQLServer seleccionado se deberá crear una base de datos vacía (se sugiere utilizar el nombre KBInfo)
  • Ejecutar el script "inicializar_bd.sql" incluido en el archivo zip descargado. Si no se utilizó el nombre KBInfo para la base de datos del paso anterior, se deberá reemplazar en la línea "use [KBInfo];" por el nombre de la base de datos creada.

Configuración

Para la configuración de la herramienta es necesario:

  • Indicar la dirección del archivo java.exe.
  • Debe proporcionar los datos de configuración de las bases de datos KBInfo y GXtest:
    • Nombre o IP del servidor.
    • Nombre de la base de datos.
    • Datos de autenticación (Puede ser Integrada o SQL).

Nota: En caso de ser Autenticación SQL debe proporcionar usuario y contraseña. En ambos casos puede comprobar la conexión.

Configuracion.png

Analizador de archivos .class

En la pestaña "Analizar .class" deberá indicar la carpeta que contiene los archivos .class, indicar el nombre de la KB y describir el o los cambios efectuados.

Al dar clic en el botón "Analizar", se descompilarán todos los archivos .class volcando la información en la base de datos indicada en la configuración de la herramienta.

Analizar.png

Generador de archivos .gxt y tests

En la pestaña "Generar .gxt y tests" se debe indicar la carpeta en la que queremos se guarde el archivo .gxt que se generará, así como los tests en caso de ser seleccionada esta opción. Una vez seleccionada la KB de la que se desea generar el archivo .gxt se da clic en el botón "Generar", la herramienta actualiza el estado del proceso incluyendo el tiempo transcurrido para la generación del archivo .gxt.


Generar.png


Si selecciona el checkbox “Generar test”, en la carpeta indicada se creará una carpeta nombrada “Tests” con un archivo .xml que contiene un test para cada webpanel de la KB generada y un archivo .dpd que contiene los Datapools asociados a las pruebas creadas en el documento .xml.

Carpeta.png


Tests.png

Analizador de impacto

En la pestaña "Analizar impacto" debe seleccionar la KB a analizar y el proyecto de interés. Al dar clic en el botón “Analizar” la herramienta devolverá los casos de pruebas que contienen paneles que han sido modificados, devuelve además casos de pruebas que contienen paneles que hacen referencia a procedimientos Genexus que fueron modificados. Si se da doble clic en algún caso de prueba devuelto se muestran los objetos modificados que impactan en dicho caso de prueba.


AnalizadorImpacto.PNG

Examinador de objetos

En la pestaña "Examinar" debe seleccionar una KB y un objeto para ver la información relacionada a dicho objeto.

Examinar.png