=======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/