====== Adaptador 5250/AS400 ===== ===== Introducción ===== Este adaptador es utilizado para ejecutar pruebas en el Adaptador 5250. Este adaptador nos permite por un lado hacer pruebas en pantallas mainframe AS/400 y también generar macros que permiten automatizar pruebas en sistemas "transformados a HTML". ===== Configuración ===== En el proceso de inicio es necesario suministrar la información para conectarse al servidor As400 5250. Esa es la información del objeto Adaptador.   Hay que tener descargado este ejecutor : {{:en:java.png?100|}} ===== Parámetros de inicialización ===== 5250 - Vamos a cumplimentar los parámetros necesarios del adaptador.\\ \\ **Adaptador** = 5250\\ **Session Name ** = Nombre que queremos dar.\\ \\ **Host:**\\ - VPS = PUB400.COM\\ - TAST1 = descfvkr.de.scf.corp\\ \\ **Port:**\\ - VPS = 23\\ - TAST1 = 23\\ \\ **Proxy Port**\\ - 1080 para los 2 entornos\\ \\ **tnEnhanced**\\ - Marcado para los 2 entornos\\ \\ **Screen Size**\\ - 24 * para los dos entornos.\\ \\ **SSL**\\ - NONE para los 2 entornos.\\ \\ ** Codepage**\\ - INTERNAL - Built-in EBCDIC conversión (CP037).\\ Para los 2 entornos. ===== Funciones ===== * **clearAndWriteField**: Limpia y escribe un texto en el campo indicado. Parámetros: * Parámetro Field: Número de campo empezando por 1. * Parámetro Offset: Offset en el campo empezando por 1. * Parámetro Value: Texto. * **clearField**: Limpia el campo con número de campo introducido en el parámetro. * **containsText(Text):** Esta función evalúa si dentro de una pantalla host, existe un texto en concreto que definimos en dicha función.\\ 1.- En el mapeo del mensaje se añade en el campo **Value** el texto que queremos encontrar. * **getLenghField**: Obtiene la longitud del campo con número de campo introducido en el parámetro. * **nextScreen:** Esta función directamente avanza a la pantalla siguiente de navegación (previamente habrás tenido que pasar por ella para que la encuentre).\\ No requiere parámetros en su codificación. (No activada esta función por el momento).\\ * **previusScreen:** Esta función directamente avanza a la pantalla anterior de navegación.\\ No requiere parámetros en la codificación. (Función no activada por el momento).\\ * **readField(Field,Offset,Length):** Esta función lee un campo que definimos en los parámetros de la misma:\\ *Parameter Field: Posición (numérica) en que está situado el campo, se cuenta visualmente en la pantalla, ya que no se indica en ningún sitio.\\ *Parameter Offset: Por defecto el valor siempre es 0, que indica la primera posición del campo.\\ *Parameter Length: Longitud del campo que vamos a leer. * **readRow(Row):** Esta función lee una línea determinada de la pantalla. Toda la línea.\\ *Parameter Row: Posición(numérica) en que esta situado la línea.\\ \\ Estos datos se pueden ver en la parte inferior derecha de la pantalla:\\ \\ {{ :es:as400sipsa.png?&400 |}}\\ * **readScreen:** Esta función lee la pantalla en la que estas posicionado. Función sin parámetros.\\ * **rowContaintsText(Text,Row):** Esta función comprueba si existe un determinado texto en una línea de pantalla. \\ *Parameter Text: Introducimos el texto a buscar.\\ *Parameter Row: Posición (numérica) de la línea.\\ \\ Estos datos se pueden ver en la parte inferior derecha de la pantalla:\\ \\ {{ :es:as400sipsa.png?&400 |}}\\ * **waitFor**: Espera a que transcurra el tiempo en segundos recibido en el parámetro. * **waitForCursor:** Esta función espera a que aparezca el cursor en la pantalla que queremos ver a continuación.\\ *Parameter timeinSeconds: Value -> Tiempo de espera hasta que aparece el cursor.\\ * **writeAfterLabel(Label, Text):** Esta función escribe en la pantalla cualquier texto, **después** de que se haya mostrado (en la pantalla) la etiqueta que hemos definido en el parámetro Label.\\ *Parameter Label: Value-> Texto que debe aparecer.\\ *Parameter Text: Texto que vamos a escribir.\\ * **writeBeforeLabel(Label, Text):** Esta función escribe en la pantalla cualquier texto **antes** de que se haya mostrado (en la pantalla) la etiqueta que hemos definido en el parámetro Label.\\ *Parameter Label: Value-> Texto que debe aparecer.\\ *Parameter Text: Texto que vamos a escribir.\\ * **writeField(Text, Field, Offset):** Esta función escribe en un determinado campo el valor que definimos en el parámetro Texto.\\ *Parameter Text: Value-> Texto que debe aparecer.\\ *Parameter Field: Campo que vamos a escribir.\\ *Parameter Offset: Posición del campo (Posición 0).\\ * **writeKey(Key):** Esta función ejecuta una tecla predefinida de la pantalla. (ENTER, F8, F4, etc...).\\ *Parameter Key: Value-> Tecla de función.\\ * **writeText(Text, Row, Column):** Esta función escribe un texto en una posición definida. (línea y columna).\\ *Parameter Text: Value-> Texto a escribir.\\ *Parameter Row: Value-> Número de línea.\\ *Parameter Column: Value-> Número de columna.\\ \\ Estos datos se obtienen de la pantalla, abajo a la derecha:\\ \\ {{ :es:as400sipsa.png?&400 |}}\\ \\ =====Generación de macros===== Como ya se ha mencionado en la Introducción, con este adaptador, se pueden generar macros que permiten automatizar pruebas en sistemas “transformados a HTML”. Vamos a explicar, como se realiza la grabación de una serie de acciones de teclado, para después poder ejecutarlas. Nos conectamos al emulador: {{ :es:as4001.png?&400 |}}\\ Con el botón derecho accedemos a la Macro de grabación y a la pestaña de Grabar. {{ :es:as4002.png?&400 |}} Damos el nombre al archivo que vamos a grabar y aceptamos. La grabación se iniciara. {{ :es:as4003.png?&400 |}} Cuando acabemos y demos por finalizada la grabación, accederemos de nuevo con el botón derecho a la Macro de grabación y a la pestaña de Terminar de Grabar. {{ :es:as4004.png?&400 |}}\\ El archivo, una vez finalizada la prueba de grabación se guarda en: **C:\Users\xxxxx\OneDrive\Documentos\5250** donde **xxxxx** variará en función del nombre de cada usuario. Más tarde necesitaremos buscar este archivo para importarlo. {{ :es:emulador52506.png?&450 |}}\\ Seguidamente, accedemos a la herramienta TAST. * Marcamos la casilla de nuevo diagrama y accedemos a Dominio, Proyecto, Carpeta, Nombre del diagrama y Descripción del diagrama, cómo hacemos siempre que diseñamos uno nuevo. Después aparece el Canvas o lienzo en blanco. * Accedemos a la barra de herramientas y nos posicionamos en la casilla de Asistentes. * Nos aparecerá un desplegable con diferentes opciones. Las opciones a elegir son:\\ - Importación de 5250 a 5250.\\ - Importación de 5250 a HTML.\\ * Importamos desde Asistentes el archivo que hemos grabado y se ha guardado en la Unidad **C:**\\ * En cualquiera de las dos opciones que nos proporciona la casilla Asistentes, se generará automáticamente un diagrama, que reflejará paso a paso, todo el proceso de grabación de las diferentes acciones realizadas y en el que figurarán dos adaptadores, el adaptador Objeto de Usuario y el adaptador 5250. * Guardamos y validamos el diagrama. * Y por último, lo llevaremos al cliente TAST para ejecutarlo.