badboy. manual de usuario v1.2

Badboy:Manual de usuario

Fecha:

Referencia:

EJIE S.A. Mediterrneo, 3 Tel. 945 01 73 00* Fax. 945 01 73 01 01010 Vitoria-Gasteiz Posta-kutxatila / Apartado: 809 01080 Vitoria-Gasteiz www.ejie.es

Este documento es propiedad de EJIE, S.A. y su contenido es confidencial. Este documento no puede ser reproducido, en su totalidad o parcialmente, ni mostrado a otros, ni utilizado para otros propsitos que los que han originado su entrega, sin el previo permiso escrito de EJIE, S.A.. En el caso de ser entregado en virtud de un contrato, su utilizacin estar limitada a lo expresamente autorizado en dicho contrato. EJIE, S.A. no podr ser considerada responsable de eventuales errores u omisiones en la edicin del documento.

Control de documentacinTtulo de documento: BADBOY

Histrico de versionesCdigo: Versin: 1.1 1.2 Fecha: 20/05/2009 16/10/2009 Resumen cambios: Primera Versin. Actualizacin a la versin 2.0.7 del BadBoy

Cambios producidos desde la ltima versinActualizacin a la versin 2.0.7 del BadBoy

Control de difusinResponsable: Ander Martnez Aprobado por: Ander Martnez Firma: Distribucin: Fecha:

Referencias de archivoAutor: Consultora de reas de conocimiento Nombre archivo: Localizacin: Badboy. Manual de usuario v1.2.doc

Badboy. Manual de usuario

2/27

ContenidoCaptulo/seccin Pgina

1 2 3 3.1 3.2 3.3 3.4 4 4.1

Introduccin Conceptos bsicos Funciones elementales Identificacin de las diferentes reas de trabajo Crear un nuevo proyecto de navegacin Cmo grabar una navegacin Exportar una grabacin a JMeter Funciones avanzadas Automatizacin de scripts

4 4 6 6 8 9 11 13 13 13 14 14 15 15 16 16 19 19 20 22 24 24

4.1.1. Editar parmetros y hosts 4.1.2. Buscar y Reemplazar 4.1.3. Variables 4.1.4. Variables con un valor nico 4.2 4.3 Resultados Generar Informes

4.3.1. Informes HTML 5 5.1 5.2 5.3 6 6.1 Parametrizacin: Integracin BadBoy - XLNets Apertura de script Personalizacin de parmetros Script con Txartela Anexo 1: Ejemplo grabacin Resolucin


3/27

1

Introduccin

El presente documento describe cules son las tareas que se pueden ejecutar en la explotacin de la herramienta Badboy. El contenido del documento integra, tanto los aspectos de uso en el entorno de EJIE como las caractersticas principales de funcionamiento de la aplicacin.

2

Conceptos bsicos

Badboy es una herramienta de gran alcance diseada para ayudar en la prueba y en el desarrollo de aplicaciones. Permite efectuar el testeo de la Web, con docenas de caractersticas incluyendo una interfaz simple, fcil e intuitiva, mediante los mtodos de captura y repeticin, siendo una gran ayuda para la prueba de carga de gran alcance, informes detallados, grficos, etc. Badboy trae embebido el navegador Internet Explorer de Microsoft, monitorizando y controlando las acciones que se producen. Esto permite: Realizar capturas de los parmetros del CGI, las pginas y los framesets peticionados. Modificar dichas capturas y volver a ejecutarlas en cualquier momento automticamente. Grabar las capturas como scripts y compartirlos dentro del entorno de trabajo. Recoger las estadsticas del funcionamiento mientras se ejecuta una prueba. Realizar pruebas de regresin de reas completas de sitios Web complejos con un solo clic.

Badboy incluye una potente funcionalidad para permitir crear scripts, de una manera sencilla, con las navegaciones realizadas por sitios Web complejos sin la intervencin del usuario. Una vez que estn creados los scripts, stos se pueden compartir para conseguir un mayor aumento de la productividad. Se debern tener en consideracin los siguientes apartados: JScript no puede exportarse: Debido a que JMeter no dispone de una ventana de navegacin de Internet embebida, todos aquellos elementos que estn bajo JScript no se exportarn. Las fuentes de datos no se exportan: JMeter tiene su propio concepto para sustituir fuentes de datos. Cuando se exporta un archivo, todas sus variables sern creadas en JMeter como "parmetros del usuario". Por lo que, si se desea, se puede proporcionar un archivo para JMeter para leer los valores de dichas variables. Para ver cmo se efecta esta operacin, en la ayuda de JMeter, en el apartado de "HTTP User Parameter Modifier" se explica con detalle como efectuar estas operaciones. Los incrementos no se exportan: JMeter no utiliza incrementos para modificar variables. Las variables son modificadas automticamente por la iteracin de un bucle y la presencia de un parmetro del usuario.


4/27

Las navegaciones no se exportan: Las navegaciones necesitan tener una ventana de navegador y no son soportadas directamente bajo JMeter. Pueden simularse con las propias caractersticas de JMeter. Las aserciones son exportadas: Como nueva funcionalidad de la versin 2.0.7, las aserciones sern exportadas a jMeter, pero hay pequeas diferencias entre como manejan estas aserciones BadBoy y Jometer, siendo posible que no siempre trabajen de la misma manera. Badboy automticamente escanea estos problemas y alertar con un mensaje detallando los ajustes necesarios.

An disponiendo de de una gran funcionalidad, el objetivo y prioridades de uso desde EJIE es el exportar las grabaciones Web efectuadas por Badboy, al lenguaje de scripting interpretado por JMeter. Como estas grabaciones son compatibles mediante el scripting con las pruebas bajo JMeter, ser ste el uso principal y prioritario con el que Badboy ser utilizado. Para obtener informacin adicional sobre el producto acceder a su pgina Web: http://www.badboy.com.au/


5/27

3

Funciones elementales

La herramienta permite realizar mltiples operaciones que se irn reflejando en posteriores apartados. El presente apartado se va a centrar principalmente en la creacin de las diferentes navegaciones por los diferentes casos de uso de una aplicacin para, a continuacin, exportarlas a JMeter. Nota: El presente manual est orientado principalmente al uso de Badboy como herramienta de creacin de navegaciones para su exportacin a JMeter. 3.1 Identificacin de las diferentes reas de trabajo Al acceder a Badboy, nos encontramos con la siguiente interfaz grfica:

El rea de trabajo est dividida en diferentes secciones: Seccin de Mens y Accesos Rpidos: En esta seccin se encuentran todas las acciones que es posible realizar por la herramienta.

Seccin de Pasos: Aqu se podrn ver las peticiones, las repuestas, los parmetros CGI y las distintas acciones que se hayan considerado durante la navegacin.


6/27

Seccin de Resumen, Variables, Grficos, Herramientas y Checks: Esta seccin dispone de pestaas para poder visualizar los datos correspondientes a las diferentes acciones realizadas en el transcurso de la navegacin.

Seccin de Navegacin: Aqu se ver el contenido de la Web y es la seccin desde donde se ejecutarn las diferentes acciones para la grabacin de las mismas bajo la herramienta.


7/27

3.2

Crear un nuevo proyecto de navegacin Una vez hemos accedido a la aplicacin, nos encontramos con la siguiente interfaz grfica:

Podremos crear un nuevo entorno de navegacin pulsando el icono o bien a travs del men File > New:

existente en la seccin de Mens,

Una vez hemos creado el nuevo proyecto, introduciremos en el campo URL


8/27

la direccin en donde tenemos la aplicacin y sobre el cual se desea crear la grabacin de la navegacin. Una vez se haya introducido, pulsaremos sobre el botn 3.3 Cmo grabar una navegacin , o bien pulsaremos la tecla Intro o Enter.

Siempre por defecto disponemos del botn de grabacin activado, por lo que desde el primer momento en el que se accede al aplicativo se est grabando la navegacin.

Podemos observar que en la seccin de Pasos, nos aparece uno, que se corresponde con el primer acceso al aplicativo. Si seguimos navegando por el aplicativo, se irn aumentando los elementos para un paso dado:


9/27

A su vez, en la seccin de Pasos, podemos ver los tipos de respuesta e incluso los valores existentes en cada ejecucin:

Un paso no es ms que un agrupador de navegaciones. Se pueden crear tantos pasos como se necesiten. Para ello, se pulsar sobre el icono .

Una vez hemos terminado la navegacin, procederemos a guardarla en disco, bien para poder ejecutarla en otra ocasin, modificarla o compartirla con otros miembros del equipo de proyecto. Para ello pulsaremos sobre el botn o bien accederemos al men desde donde ejecutaremos la accin de grabar.


10/27

Nos pedir una ubicacin y un nombre de archivo a la hora de salvar:

3.4

Exportar una grabacin a JMeter

Una vez disponemos de una grabacin de una navegacin efectuada en el aplicativo Badboy, podremos proceder a exportarla a JMeter. Para ello, accederemos al men File > Export to JMeter.

Nos pedir una ubicacin y un nombre de archivo a la hora de salvar:


11/27

Con ello se proceder a crear un archivo que es capaz de ser interpretado por la herramienta JMeter para su posterior procesado.


12/27

44.1

Funciones avanzadasAutomatizacin de scripts

Ser capaz de reproducir repetidamente una secuencia de actividades de navegacin puede resultar un mecanismo muy til para depurar y probar un sitio Web. Lamentablemente, repetir peticiones ya lanzadas anteriormente puede no satisfacer los requisitos de sitios Web complejos. Situaciones en los que esto puede ser as: Un identificador introducido debe ser nico. Introducir algunos valores dos veces genera un error. Se ha grabado el script en un servidor (por ejemplo, la mquina de desarrollo local) pero se desea reproducirlo bajo uno diferente (se necesitar una manera de modificar el nombre de la mquina sobre la que lanzar las peticiones).

Badboy permite resolver estos problemas de diferentes maneras: 4.1.1. Editar los parmetros. Utilizar variables en los scripts. Usar una gran variedad de herramientas tales como Buscar y Reemplazar.

Editar parmetros y hosts Badboy permite editar los valores de los parmetros y los nombres de hosts en el script considerado. Simplemente hay que hacer doble clic: En una peticin para editar el host o su path. En el parmetro al cual se desea cambiar su valor.


13/27

sta es la manera ms simple de cambiar los valores necesarios antes de ejecutar el script.

4.1.2.

Buscar y Reemplazar

Si se desea cambiar un valor varias veces a lo largo del script la caracterstica Edit > Search/Replace facilita esta tarea.

4.1.3.

Variables

Si se tienen valores que cambian con frecuencia puede resultar tedioso usar la opcin Search/Replace. Para facilitar esta operacion Badboy proporciona una caracterstica denominada "script variables". Estas variables se muestran en la pestaa Variables de la seccin correspondiente y contienen los valores de las variables que pueden ser referenciadas a travs de su nombre en el script usando la notacin ${nombre de variable}

De esta manera se pueden crear scripts que incluyan un mismo lugar en mltiples lugares pero mantenidos en un nico sitio.


14/27

4.1.4.

Variables con un valor nico

A veces, como ya se ha comentado, es necesario garantizar que una variable tenga un valor nico cada vez que se ejecuta el script. Para ello Badboy incluye el elemento Increment, al que se puede acceder a travs de la pestaa Herramientas, que proporciona mltiples posibilidades a la hora de asignar valores nicos a las variables.

4.2

Resultados

Tras lanzar un script es importante mantener un registro de lo ocurrido. Por ejemplo, es interesante conocer el tiempo medio transcurrido entre peticin y respuesta, etc. Badboy captura toda esta informacin y hace posible acceder a ella de manera rpida a travs de la vista Resumen.

La siguiente tabla describe los datos aportados en esta vista Resumen: Estadstica Played Descripcin El nmero de elementos del script que fueron ejecutados y devolvieron una respuesta. El nmero de elementos del script que fueron ejecutados y devolvieron una respuesta exitosa.

Succeeded


15/27

Failed

El nmero de elementos del script que fueron ejecutados y devolvieron una respuesta fallida. El porcentaje de tiempo (en milisegundos) para los elementos que fueron ejecutaron y que devolvieron una respuesta. El nmero de aserciones fallidas. El nmero de Warnings generados. El nmero de desconexiones que se han producido. El mayor tiempo transcurrido en una nica repuesta.

Avg Time (ms)

Assertions Warnigs Timeouts Max Time (ms)

4.3

Generar Informes Ya se ha visto que la pestaa Resumen muestra la informacin aportada tras la ejecucin del script.

Sin embargo, si se desea obtener una visin ms detallada de los resultados obtenidos y adems sin la necesidad de tener que estar ejecutando Badboy y con la posibilidad de integrar estos resultados con programas externos o documentos, es muy interesante la posibilidad de generacin de informes con los resultados obtenidos.

4.3.1.

Informes HTML

La manera de sencilla de obtener un informe en HTML es seleccionar la pocin de men View > Report. Lo que guardar el informe HTML generado en una archivo temporal y lo mostrar en la seccin de Navegacin de Badboy. Si se desea guardar o enviar el informe generado se puede usar la opcin de men File > Save as > HTML Report... La figura siguiente muestra el aspecto de un informe HTML:


16/27

Guardar un informe HTML como parte del script Se puede realizar la generacin de informes de manera automtica. Para ello, se usar elemento Save Item de la caja de herramientas.

Se deber seleccionar la opcin Script del marco What to Save y elegir la opcin HTML Report como queda reflejado en la imagen siguiente:


17/27


18/27

5

Parametrizacin: Integracin BadBoy - XLNets

Se proporciona un script que automatiza el proceso de validacin contra XLNets y que automticamente redirige a la pgina de inicio de una determinada aplicacin. 5.1 Apertura de script

Iniciado Badboy, el siguiente paso consiste en abrir el fichero a parametrizar con los datos de una determinada aplicacin.

Se mostrara a continuacin la tpica ventana de exploracin en la cual debemos buscar y seleccionar el fichero con el script a abrir. El fichero que integra dicha funcionalidad se denomina Script_XLNets.bb.


19/27

5.2

Personalizacin de parmetros

Una vez abierto podemos observar como el script cuenta con una serie de variables ya declaradas y definidas. Dichas variables son las que deberemos modificar acorde a los datos reales de la aplicacin que deseamos probar.


20/27

A continuacin se describe cada una de las variables creadas: var_host: Se trata del parmetro que indica la direccin URL del host en el cual se encuentra alojada la aplicacin. Se especificar la ruta raz del mismo ya que existe otro parmetro diferente para el alias de aplicacin. var_paramName: Ha de rellenarse en caso de que utilicemos parmetros anexados a la URL para acceder a la aplicacin, aqu se especifica el nombre de dicho parmetro. var_paramValue: Al igual que con var_paramName, se ha de rellenar slo si utilizamos parmetros anexados a la URL, esta variable sirve para especificar el valor que asignamos al parmetro definido en var_paramName. var_path: En esta variable se define el alias de aplicacin. var_protocol: Aqu especificamos el protocolo que emplea el servidor, generalmente tomara el valor http https. var_xlnetsPass: Se trata de la contrasea que se va a utilizar para acceder a XLNETS. var_xlnetsUser: Se trata del nombre de usuario que se va a utilizar para acceder a XLNETS. As pues, si observamos la captura de pantalla, los valores establecidos corresponderan con el siguiente


21/27

caso: 5.3

URL de la aplicacin: http://www.ivap.jakina.ejiedes.net/admeuskud/ Usuario XLNETS : XXXX-1 Contrasea de XLNETS: XXXX Script con Txartela

Se trata de una situacin especial debido a que XLNETS en el caso de validarte con Txartela utiliza un Activex. Esto implica que pasa a interactuarse desde el explorador a una aplicacin del sistema al uso, por lo que debemos emplear las funcionalidades de Badboy para simular clicks y pulsaciones del teclado en posiciones concretas. Los pasos a seguir en este caso son los mismos que para un script de usuario y contrasea normal, es decir, hay que cargar el script ya definido y personalizar los parmetros. Los parmetros ha personalizar en este caso son: var_host: Se trata del parmetro que indica la direccin URL del host en el cual se encuentra alojada la aplicacin. Se especificar la ruta raz del mismo ya que existe otro parmetro diferente para el alias de aplicacin. var_paramName: Ha de rellenarse en caso de que utilicemos parmetros anexados a la URL para acceder a la aplicacin, aqu se especifica el nombre de dicho parmetro. var_paramValue: Al igual que con var_paramName, se ha de rellenar slo si utilizamos parmetros anexados a la URL, esta variable sirve para especificar el valor que asignamos al parmetro definido en var_paramName. var_path: En esta variable se define el alias de aplicacin. var_protocol: Aqu especificamos el protocolo que emplea el servidor, generalmente tomara el valor http https. var_xlnetsPass: Se trata de la contrasea de la txartela que se va a utilizar para acceder a XLNETS.

En la siguiente captura se pueden apreciar los componentes especiales que incorpora este script. Se trata de dos pulsaciones de ratn, y una pulsacin de teclado. Con esto tratamos de simular dichas acciones y logramos evitar la necesidad de interactuar manualmente con cada ejecucin del script.

Debido a la naturaleza de estas acciones, es necesario comprobar la primera vez que estamos haciendo clic donde realmente nos interesa. Esto es debido a que el pop-up sobre el que debemos hacer clic puede variar su posicin de aparicin en funcin de la resolucin a la que est configurada nuestra pantalla, entre otros factores. As pues, tras ejecutar por primera vez y comprobar en que posicin deberamos hacer clic, procedemos a cambiar las coordenadas de dichas pulsaciones. La manera de hacerlo es muy sencilla, seleccionamos el


22/27

evento Clic, y pulsamos con el ratn el botn derecho para acceder a sus propiedades.

Una vez dentro, debemos pulsar sobre el botn Capture. Tras esto, desaparecer la ventana de propiedades y haremos clic en la zona de la pantalla donde debe simular el script la pulsacin de ratn. Cuando hayamos hecho clic, nos volver a aparecer la pantalla de propiedades del evento clic, pero con las coordenadas X,Y actualizadas a donde hayamos decidido nosotros.


23/27

6

Anexo 1: Ejemplo grabacin

La intencin es grabar una secuencia dentro de la aplicacin, para despus reproducirla y ver los resultados. 6.1 Resolucin

Comenzamos abriendo Badboy y lo primero que haremos ser introducir la siguiente direccin en la barra de direcciones. http://www.sygel.com/petstore/jsp/shop/main.jsp Aparecer la siguiente ventana.

Ahora procederemos a realizar una compra de algn artculo como ejemplo. Seguiremos los pasos que se explicaran a continuacin, para probarlo. En este ejemplo, presionaremos sobre Dogs y nos enviara a la pgina donde se encuentran las razas. Aqu elegiremos la raza bulldog, como se puede apreciar en la imagen.


24/27

A continuacin aparecer otra seleccin para elegir el sexo del animal. Aadiremos en este caso, la opcin Male Adult Bulldog.


25/27

Una vez presionado, aparecer otra pantalla mostrando que el animal se ha aadido al carrito.


26/27

Ahora procederemos a presionar Proceed to checkout para que valide la compra. Una vez realizado esto, detendremos Badboy y reproduciremos el proceso para asegurarnos de que la grabacin se ha realizado correctamente.


27/27

badboy. manual de usuario v1.2

Documents