es:desktop_adapter [TAST DokuWiki ]

User Tools

Site Tools


Sidebar

Primeros pasos en TAST

Que es UML

Configuración del sistema para el uso de TAST

Preguntas más frecuentes

Problemas reconocidos

Indice de la herramienta TAST

Adaptadores de TAST

Ejemplos de adaptadores

TAST Integraciones

Características de interés

Documentación de administración técnica

Recomendaciones para modelar

Formación en la herramienta TAST

es:desktop_adapter

Adaptador de Escritorio

Introducción

El nuevo adaptador Desktop automatiza el uso de aplicaciones cliente en PC’s Windows y Linux. Es decir, con este adaptador podemos abrir cualquier aplicación que tengamos en nuestro escritorio.

Parámetros de inicialización

  • Default Screen Number: indicará el monitor en el que se ejecutará: tomará el valor 0 como valor predefinido.
  • Images Repository Path: indicará la ruta (o parte de ella) de la carpeta donde estarán todas las imágenes que habremos capturado previamente.

    Aquí faltaría saber que aplicación de escritorio vamos a abrir. Por ejemplo:

    C:\test\Desktop
    C:\appTAST\test\

Funciones predefinidas (PF)

Las PFs desarrolladas son:

  • clearCtrlADel: borra el contenido o valor de un elemento en el que se está posicionado (campo o zona de una aplicación). Hace una selección del contenido con Ctrl+A y luego borra. Esta función es para cuando en la Aplicación que se está usando la selección, se hace con Ctrl+A. Recibe un parámetro de entrada opcional, que es la demora en milisegundos entre teclas.

  • clearCtrlEDel: borra el contenido o valor de un elemento en el que se está posicionado (campo o zona de una aplicación). Hace una selección del contenido con Ctrl+E y luego borra. Esta función es para cuando en la Aplicación que se está usando la selección, se hace con Ctrl+E. Recibe un parámetro de entrada opcional, que es la demora en milisegundos entre teclas.

  • click: hace click en el elemento que coincide o concuerda con la imagen que se ha pasado en la entrada. Las imágenes donde queremos hacer click, las habremos capturado previamente y guardado e indicado la ruta donde están guardadas.

  • clickNElement: busca en la pantalla, que en ese momento se está visualizando, los elementos que coinciden con la imagen que se ha pasado en la entrada y hace click en el elemento que ocupa la posición (1, 2, 3, … N) que se ha pasado como entrada en un campo de tipo entero. Esta función siempre va recorriendo los elementos encontrados de izquierda a derecha y de arriba abajo. Esta función se usa cuando existen varias imágenes iguales alineadas en filas y columnas.

  • clickCoordinates: hace click en el punto concreto definido por las coordenadas X e Y recibidas como parámetros de entrada.

  • countElements: busca en la pantalla que en ese momento se está visualizando los elementos que coinciden con la imagen que se ha pasado en la entrada y devuelve en una variable de tipo entero la cantidad de elementos que ha encontrado.

  • isExist: comprueba si en la pantalla que en ese momento se está visualizando existe algún elemento que coincide con la imagen que se ha pasado en la entrada. Devuelve true si se ha encontrado algún elemento y false si no se ha encontrado ninguno.

  • maxWindow(): maximizará la ventana de la aplicación que tenga el foco en ese momento, no requiere parámetros. Devuelve true o false según consiga o no ejecutar la PF.

  • openApp: abre una aplicación ejecutando el ejecutable que se ha pasado en el parámetro de entrada.

  • paste: pega el texto recibido en entrada en la posición en la que esté el cursor en ese momento.

  • sendKeysCombination: envía una combinación de teclas para ejecutar donde el cursor esté en ese momento. Las teclas a enviar van separadas por +, por ejemplo, 17+69+162. Esta función tiene tres parámetros de entrada:
    • parámetro “Key+Key”: es obligatorio y son las teclas que enviar
    • parámetro “Delay milliseconds”: es opcional y es la demora en milisegundos entre teclas
    • parámetro “Repeat”: que también es opcional, y es el número de veces (número de repeticiones) que se tiene que ejecutar el envío de dichas teclas, si no se pone valor, por defecto considera el valor 1.

  • takeScreenshot: realiza una captura de la pantalla que tiene el foco. La pantalla que tiene el foco es en la que se encuentra el usuario en ese momento.

  • type: escribe el texto recibido en entrada en la posición en la que esté el cursor en ese momento.

  • typeCoordinates: escribe el texto recibido en entrada en el punto concreto definido por las coordenadas X e Y recibidas también como parámetros de entrada.

    Para conocer las coordenadas que corresponden a un punto en pantalla se ha utilizado Cursor Guide, una App que se puede descargar en: https://sourceforge.net/projects/cursorguide/
es/desktop_adapter.txt · Last modified: 2023/11/28 10:56 by montse