User Tools

Site Tools


es:desktop_adapter

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

es:desktop_adapter [2023/11/28 10:01]
montse [Funciones predefinidas (PF)]
es:desktop_adapter [2023/11/28 10:56] (current)
montse
Line 6: Line 6:
 =====Parámetros de inicialización===== =====Parámetros de inicialización=====
  
-En la primera versión subida a VPS el adaptador tiene dos parámetros:​ 
   * **Default Screen Number**: indicará el monitor en el que se ejecutará: tomará el valor 0 como valor predefinido.   * **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\   * **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\
Line 13: Line 12:
 =====Funciones predefinidas (PF)===== =====Funciones predefinidas (PF)=====
 Las PFs desarrolladas son: 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.\\ \\  +  * **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ónse hace con Ctrl+A. Recibe un parámetro de entrada opcionalque 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.\\ \\  +  * **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ónse hace con Ctrl+E. Recibe un parámetro de entrada opcionalque 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.\\ \\ +  * **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.\\ \\    * **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. +  * **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. +  * **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. +  * **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 FALSE según consiga o no ejecutar la PF. +  * **maxWindow()**: maximizará la ventana de la aplicación que tenga el foco en ese momento, no requiere parámetros. Devuelve ​**true** ​**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. +  * **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. +  * **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 ​que enviar van separadas por +, por ejemplo, 17+69+162. ​ +  * **sendKeysCombination**envía ​una combinación de teclas para ejecutar donde el cursor esté en ese momento. Las teclas ​enviar van separadas por **+**, por ejemplo, 17+69+162. Esta función tiene tres parámetros de entrada: 
-Esta función tiene tres parámetros de entrada: ​El parámetro “Key+Key” es obligatorio y son las teclas que enviar, el parámetro “Delay milliseconds” es opcional y es la demora en milisegundos entre teclas ​y el 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. +          * parámetro “Key+Key”es obligatorio y son las teclas que enviar 
-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. +          * parámetro “Delay milliseconds”es opcional y es la demora en milisegundos entre teclas ​ 
-type: Escribe ​el texto recibido en entrada en la posición en la que esté el cursor en ese momento. +          * 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 valorpor defecto considera el valor 1.\\ \\  
-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. +  * **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.\\ \\  
-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/​+  * **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.1701165671.txt.gz · Last modified: 2023/11/28 10:01 by montse