Difference between revisions of "GXtest Generator User Manual"

From GXtest Wiki
Jump to: navigation, search
(→‎Configuration Options)
Line 2: Line 2:
 
{{Idiomas|Manual de Usuario de GXtest Generator|GXtest Generator User Manual|GXtest Generator User Manual}}
 
{{Idiomas|Manual de Usuario de GXtest Generator|GXtest Generator User Manual|GXtest Generator User Manual}}
  
−
GXtest Generator es una herramienta que nos ayuda a comenzar a automatizar pruebas con GXtest, a partir de la generación automática de casos de prueba. La extensión GXtest Generator que se instala en GeneXus.
+
GXtest Generator is a tool designed to help us with the startup of a new test project in GXtest, in an automated fashion. GXtest Generator is a GeneXus extension, and can be installed along with GXtest or as a standalone tool. Using this extension, we can automatically generate test cases and test data with only one click.
  
−
Antes de comenzar se debe tener instalado y activado GXtest en algún PC, de modo de poder ejecutar las pruebas (Ver [[Installation guide]] de GXtest).
+
Before we begin, we must have an installed and authorized GXtest copy somewhere in our local network (may be on anothe computer), where the test cases will be run (See GXtest [[Installation guide]]).
  
−
== Generación Automática de Casos de Prueba ==
+
== Automated test case generation ==
  
−
Gracias a la abstracción que provee GeneXus a través de las transacciones y patrones, se pueden generar casos de prueba para GXtest de manera automática, a partir de la información que existe de dichos objetos en la base de conocimiento.
+
This tool takes advantage of GeneXus abstraction levels trough transactions and work with patterns information (available in the Knowledge Base), to generate GXtest test cases and datapools in an automated fashion.
  
−
* ¿Qué testean los casos de prueba automáticos?
 
−
Se genera un caso de prueba para cada entidad de la aplicación, el cual probará el Alta, Baja, Modificación, Visualización y Búsqueda de una instancia de dicha entidad. Por ejemplo, para la transacción Client, se dará de alta un cliente, se lo buscará en el "Trabajar Con" asociado, se lo modificará, y finalmente se lo dará de baja.
 
  
−
* ¿Para qué me sirven estos casos de prueba?
+
* Which functionalities are tested by the automatically generated test cases?
−
Si bien sirven para probar el ABM (Alta, Baja y Modificación) de todas las entidades de la KB, la principal finalidad de dichos casos de prueba es utilizarlos como base para comenzar la automatización de pruebas sobre una aplicación.
+
For each transaction in the Knowledge Base, a test case is generated to test the CRUD operations over the entity represented by the transaction: Create (insert), Retrieve (search), Update, and Delete.
−
Dependiendo del tipo de aplicación, los ABM de datos pueden significar un 80% de la totalidad de las funcionalidades de la aplicación. Por ello, generar estas pruebas de forma automática implica reducir los tiempos de automatización de gran forma, pudiendo utilizar ese tiempo en extender las pruebas generadas, o realizar nuevos casos de prueba, utilizando incluso los ya generados.
+
  
−
* ¿Cómo genera GXtest los casos de prueba?
+
For example, if we have the Client transaction in the KB, GXtest Generator will create a test case that inserts a new Client, then it searchs the new client in the "Work With" page, then updates some data about the client, and finally it will delete de created Client.
−
** Se examinan todas las transacciones y por cada una se determina si es posible generar el caso de prueba, y el flujo que tendrá el ABM dependiendo si tiene aplicado algún pattern WorkWith.
+
−
** Durante la generación de cada objeto, se analizan todos sus atributos, y para cada uno se determinan si es necesario generar datos (si son editables, no son calculados, etc.), y cómo se van a generar los mismos. Algunas de las estrategias son:
+
−
*** Si es una FK, se extraen de la base de datos de la aplicación, consultando la tabla asociada a la FK, incluyendo valores para atributos inferidos por éste (por ejemplo, si en la transacción está como FK el ClienteId,pero en realidad en la pantalla se ingresa el ClienteNombre).
+
−
*** Si el control tiene valores predefinidos (por ejemplo con combobox con opciones estáticas) se toma uno aleatorio.
+
−
*** En otro caso, se genera de forma aleatoria un valor asociado al tipo del atributo, y que cumpla con las máscaras definidas en el control o atributo.
+
  
−
* ¿Cómo hace GXtest para obtener los datos de la base de datos de la aplicación?
+
* How good or complex are the generated test cases?
−
Para la consulta de datos a la BD, se aprovecha la abstracción que provee GeneXus para acceder a ésta sin tener que configurar un conector. Esto se logra generando temporalmente en la KB un procedure y un data provider que realizan la consulta sobre cierta tabla, y lo exponen como un servicio REST.
+
Although the test cases are created to test the CRUD operations, the main purpose of this test cases is that the user can start with automated testing quickly, and not start from cero.
  
−
* ¿Cómo accedo a los casos de prueba generados?
+
Also, these test cases can be edited, improved, or reused inside other more complex test cases.
−
Después de generados los casos de prueba y los datapools, se importan de forma automática dentro de GXtest, en un nuevo proyecto que lleva el nombre de la KB y el sufijo "_Auto".
+
  
  
 +
* How can I see the generated test cases?
 +
After the generation project is completed, all test cases and datapools are imported into a GXtest project named the same as the KB, and the suffix "_Auto".
  
−
== GXtest Generator ==
 
−
La herramienta se instala como una extensión de GeneXus Ev1 o Ev2. De esta forma, las funcionalidades estarán accesibles integradas al entorno de desarrollo.
 
  
−
=== Instalación de la Extensión en GeneXus ===
 
−
La funcionalidad se distribuye en un instalador muy simple.
 
  
−
Durante la instalación:
+
=== Starting GXtest Generator in GeneXus ===
−
* Se deberá indicar el path de la instalación de GeneXus donde se quiere instalar la extensión. Puede aplicarla en más de una instalación de GeneXus (si tuviera varias).
+
In GeneXus IDE, we can open GXtest Generator from the "GXtest" menu, by selecting the "Autogenerate TestCases" option.
−
* Se deberá proporcionar una base de datos de GXtest, donde la extensión guardará los casos de prueba generados. La versión de GXtest instalada debe ser 1.2.0 +, y además debe coincidir con la versión de la extensión.
+
  
−
Las versiones soportadas para la base de datos son Microsoft SQLServer 2005 o superior, pudiendo ser una Express Edition.
+
In the window that opens up, we can see the existing project (if we already have one for this KB), or the button that allows us to start the generation process: "Generate tests".
  
 +
If we need to, we may configure some aditional options in the extension configuration page, before we start the process.
  
−
=== Acceso a la GXtest Generator en GeneXus ===
 
−
Al abrir GeneXus, aparecerá un nuevo menú "GXtest" que tendrá el ítem "Autogenerate TestCases".
 
−
Dicha opción de menú abre la ventana de generación automática de GXtest Generator.
 
  
−
Allí se verá información de testing asociada a la KB que está abierta (si es que ya generamos un proyecto en GXtest), y estará disponible el botón para iniciar el proceso: "Generate tests".
 
−
 
−
En caso de ser necesario, antes de comenzar a generar los casos de prueba es posible configurar las opciones de generación que la extensión provee.
 
  
 
=== Configuration Options ===
 
=== Configuration Options ===

Revision as of 16:11, 22 April 2014

Spanish.gif
English.gif
Japan.gif

GXtest Generator is a tool designed to help us with the startup of a new test project in GXtest, in an automated fashion. GXtest Generator is a GeneXus extension, and can be installed along with GXtest or as a standalone tool. Using this extension, we can automatically generate test cases and test data with only one click.

Before we begin, we must have an installed and authorized GXtest copy somewhere in our local network (may be on anothe computer), where the test cases will be run (See GXtest Installation guide).

Contents

Automated test case generation

This tool takes advantage of GeneXus abstraction levels trough transactions and work with patterns information (available in the Knowledge Base), to generate GXtest test cases and datapools in an automated fashion.


  • Which functionalities are tested by the automatically generated test cases?

For each transaction in the Knowledge Base, a test case is generated to test the CRUD operations over the entity represented by the transaction: Create (insert), Retrieve (search), Update, and Delete.

For example, if we have the Client transaction in the KB, GXtest Generator will create a test case that inserts a new Client, then it searchs the new client in the "Work With" page, then updates some data about the client, and finally it will delete de created Client.

  • How good or complex are the generated test cases?

Although the test cases are created to test the CRUD operations, the main purpose of this test cases is that the user can start with automated testing quickly, and not start from cero.

Also, these test cases can be edited, improved, or reused inside other more complex test cases.


  • How can I see the generated test cases?

After the generation project is completed, all test cases and datapools are imported into a GXtest project named the same as the KB, and the suffix "_Auto".


Starting GXtest Generator in GeneXus

In GeneXus IDE, we can open GXtest Generator from the "GXtest" menu, by selecting the "Autogenerate TestCases" option.

In the window that opens up, we can see the existing project (if we already have one for this KB), or the button that allows us to start the generation process: "Generate tests".

If we need to, we may configure some aditional options in the extension configuration page, before we start the process.


Configuration Options

Inside GeneXus menu, in Tools -> Options, exists a section where all GXtest extensions are configured.

  • In section General you can specify:
    • Data Dictionary Path: The file path where dictionary data is loaded. For more info see GXtest Generator - Dictionaries.
    • Include Unreferences Transactions: Sets whether all transactions and objects may be generated (True), or only transactions or pages called from any GeneXus Main object (False).
    • Language: The lenguage in which the application is generated and tested. This is required in order to check the GeneXus automatic validation messages.
    • Startup Test Case: an initial test case that will be included at the start of every generated test case. This becomes handy when you need to execute a step prior to the execution of all test cases, for example a login test case. Additional info in GXtest Generator - Include Login Test Case.
    • Test depth: Sets the test depth of the generated test cases. See additional info in GXtest Generator - Test depth.
    • Visit Web Pages: When set to True, it generates an additional test cases which visits every web page of the application. This becames usefull in order to check that all pages are correctly deployed in the test environment.


  • Manager section
    • Here you may configure the GXtest Manager schedule information about the generated test cases, in order to start unattended execution of the project tests.


  • Connection section
    • All the GXtest database connection-related data is configured, where the generated test cases and project will be saved.


  • Advanced section:
    • Temp XML path: the temporary folder where the generated test cases are stored, before they get imported into GXtest project. Also, this path is the location where the generation log file is saved.
    • Update KB: It sets the update policy applied if the KB already exists in GXtest. If the KB must be always updated then you should choose Always Update. To update the KB objects only when no conflicts are raised (new objects only) select Update if no conflicts. Choose Never Update if you do not want to impact the KB changes into GXtest.

GXtest Generator Execution

While executing the generation process, details about completed steps will be shown in the grid, and also in the GeneXus output window. All analyzed objects, generated test cases and datapools will be displayed in the output.


Updating the generated test cases while the KB grows

GXtest Generator main purpose is to be executed one time only, in order to initialize and create the test project, to begin working with GXtest Designer, creating new test cases and improving the automatically generated ones.

However, some logic exists in the generator in order to allow us to automatically create new test cases when the KB has new objects, and we already generated the startup project.

For each "Create project" execution, every test case and test data is generated again. If the target project already exists, the test cases and datapools will be overwritten with the new ones, except if the following conditions are met:

  • The test case was manually updated in GXtest Designer, and if the Update Automatically option is disabled (it becomes disabled automatically whenever we edit the automatically generated test case). This option is available in the test case properties window.
TCUpdateAuto.png


  • The Datapool was manually updated in GXtest Designer (its columns or data), and if the Update Automatically option is disabled (it becomes disabled automatically whenever we edit the automatically generated datapool or its data). This option is available in the datapool properties window
Retrieved from "http://gxtest.abstracta.com.uy/wiki/index.php?title=GXtest_Generator_User_Manual&oldid=3901"