Comandos de GXtest

link= {{{3}}}

A continuación se describen los comandos de GXtest. Puede consultar también la Lista de Comandos disponibles.

Comandos

Los comandos permiten expresar tanto las interacciones que el usuario puede realizar con la aplicación como las validaciones, o estado esperado de la aplicación luego de cada una de estas interacciones. Los comandos pueden ser acciones, validaciones y eventos. Cada uno puede recibir parámetros que les indican qué deben ejecutar sobre la aplicación.

Las acciones son las cosas que hace el usuario sobre una página Web sin que eso lo haga ir a otra página. Algunos ejemplos de acciones son FillInput (para ingresar un valor en un campo de la página) y Check (para hacer un check en un checkbox).

Por otro lado tenemos los eventos, que son aquellas interacciones que hacen pasar de una página a otra. Algunos ejemplos de eventos son Go (equivale a escribir una dirección Web en el navegador), ClickLink (se utiliza para hacer clic en un link dentro de la página) y ClickButton (se utiliza para hacer clic en un botón determinado).

Por último, tenemos las validaciones, las cuales se utilizan para validar que el estado de la aplicación sea el que nosotros esperamos. Algunos ejemplos de validaciones son AppearText (valida si un texto se encuentra o no en la pantalla) o VerifyControlText (compara un valor de un control determinado en la pantalla con otro valor de referencia). Todas las validaciones tienen siempre además de los parámetros propios de cada validación, dos parámetros obligatorios:

• Parámetro de Descripción del error: es una descripción que se mostrará en caso de que la misma falle, de esa manera cuando se ejecuta un caso de prueba y el mismo falla en una validación se puede tener un mensaje claro de por qué falló esa validación.
• Parámetro de Negación de la validación: sirve para indicar que el resultado esperado es la negación de la validación. Por ejemplo si negamos la validación AppearText, lo que se expresa es que no se quiere que aparezca un texto determinado.

Parámetros

Cada comando recibe una lista de parámetros. Los tipos de parámetros que pueden recibir los comandos se enumeran a continuación:

Parámetro Control

Este tipo de parámetro indica un control dentro de un objeto GeneXus. Los objetos de tipo Transacción y WebPanel en GeneXus tienen asociado un WebForm, dicho WebForm tiene asociado un conjunto de controles que especifican la información a mostrar y la interacción que el usuario podrá tener con dicho objeto. Por ejemplo, un botón o un campo en donde se pueden ingresar valores, son controles dentro de un WebForm de un objeto.

Parámetro Valor

Un parámetro de tipo Valor, se refiere a un valor fijo ya sea texto o número que se desea utilizar en el comando.

Parámetro Variable

GXtest permite capturar valores devueltos por la aplicación y almacenarlos en variables. Estas variables luego son utilizadas en otros comandos.(Véase Crear un Caso de Prueba con Variables para más información) Por otro lado existe una variable estándar llamada urlHome, la cual toma el valor definido en la propiedad url del proyecto en el caso de que se ejecute el caso de prueba desde GXtest Designer o el valor de la propiedad url asociada a la tarea en caso de ejecutarse desde GXtest Manager.

Parámetro DataPool

Los Data Pools permiten tomar datos externos para ser usados en el caso de prueba. El parámetro de tipo DataPool permite entonces indicar a un comando que se tome un valor de una fuente de datos específica.

Parámetro SelectionByRow

Los comandos que ejecutan acciones sobre tablas reciben parámetros que les indican en qué fila de la tabla se debe ejecutar dicho comando. Ese parámetro llamado de forma genérica regla de selección (SelectionRule) puede ser actualmente de dos tipos SelectionByRow o SelectionByControl. El tipo SelectionByRow sirve para especificar la fila en la cual se va a actuar, en base al número de fila. De esta manera se puede modelar en GXtest acciones como "Hacer clic en la primera fila de la grilla". Por ese motivo este parámetro recibe un subparámetro de tipo DataPool, Valor o Variable. Dicho valor puede contener un número indicando el número de fila (empezando con el número 1 para la primera). Este valor también puede tener la palabra Last para indicar que seleccione la última fila de la grilla.

Parámetro SelectionByControl

El tipo de parámetro SelectionByControl sirve para indicar una fila en una grilla en base al valor en una de sus columnas. Por ejemplo, se puede indicar a GXtest que seleccione la fila cuyo número de empleado sea 59. GXtest recorrerá todas las filas de la grilla y la primera que coincida con el criterio establecido será la seleccionada. Para esto el parámetro recibe dos subparámetros:

• Parámetro del Tipo Control: indica la columna en la grilla sobre la cual se va a analizar la condición
• Tipo de Comparación y comparador: se indica si se va comparar un texto o un número y el comparador que se va a utilizar (igual, mayor, menor, contiene, etc.)
• Parámetro del tipo Variable, DataPool o Valor: es el valor con el cual se va a comparar.

Custom Commands

Hay veces que se desarrollan funcionalidades extra de la interfaz gráfica, ya sean javascripts desarrollados a mano o simplemente HTML desarrollado a mano. En esos casos GXtest no reconocerá comandos sobre los mismos y es necesario que el usuario programe sus propios comandos. Para esto se pueden utilizar los llamados Custom Command. Por información más específica puede leer Crear un Custom Command.

Utilizar un comando para Invocar un WebService o Procedimiento GX

Muchas veces es útil utilizar un procedimiento Genexus para realizar manipulación de datos o validaciones de los mismos. Para más información ver como Crear un Comando para invocación a un Procedimiento GeneXus.