Table of Contents
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.
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.
- doubleClick: hace doble click del ratón en el elemento que coincide o concuerda con la imagen que se ha pasado en la entrada.
- doubleClickCoordinates: hace doble click del ratón en el punto concreto definido por las coordenadas X e Y recibidas como parámetros de entrada.
- getTextFromImage: obtiene el texto de la imagen indicada en el parámetro de entrada, usando el idioma del texto recibido también como entrada. De forma opcional, se puede usar una región de la imagen. Si se han informado los parámetros opcionales de la región entonces guarda como evidencia la captura de pantalla de la región.
- getTextFromRegion: obtiene el texto de la región especificada por los parámetros de entrada, usando el idioma del texto recibido también como entrada. Guarda como evidencia la captura de pantalla de la región.
- 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.
- pasteCoordinates: pega el texto recibido en entrada en el punto concreto definido por las coordenadas X e Y recibidas también como parámetros de entrada.
- rightClick: hace click con el botón derecho del ratón en el elemento que coincide o concuerda con la imagen que se ha pasado en la entrada.
- rightClickCoordinates: hace click con el botón derecho del ratón en el punto concreto definido por las coordenadas X e Y recibidas como parámetros de entrada.
- 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 a 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.
- takeScreenshotRegion: realiza una captura de pantalla de la región especificada por los parámetros de entrada.
- 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/
Para conocer el valor correspondiente de cada tecla en el teclado, se ha utilizado Keyboard State View, un programa que se puede descargar en: https://www.nirsoft.net/utils/keyboard_state_view.html”
Para utilizar las funciones de gestión de textos del Adaptador de Escritorio se necesitan diccionarios, (según el idioma del texto), que se pueden descargar desde la página:
https://github.com/tesseract-ocr/tessdata
Estos archivos (extensión TRAINEDDATA) deben estar en la ruta: C:\AppTast\tessdata
Para alemán, inglés y español existirían los siguientes archivos:
