This shows you the differences between two versions of the page.
es:desktop_adapter [2023/11/28 09:36] montse [Parámetros de inicialización] |
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. | + | * **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.\\ \\ |
- | 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.\\ \\ |
- | • 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. | + | * **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.\\ \\ |
- | Recibe un parámetro de entrada opcional que es la demora en milisegundos entre teclas. | + | * **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.\\ \\ |
- | • click: Hace click en el elemento que coincide o concuerda con la imagen que se ha pasado en la entrada. | + | * **clickCoordinates**: hace click en el punto concreto definido por las coordenadas X e Y recibidas como parámetros de entrada.\\ \\ |
- | Las imágenes donde queremos hacer click, las habremos capturado previamente y guardado e indicado la ruta donde están guardadas. | + | * **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.\\ \\ |
- | • clickNElement: busca por ejemplo imágenes similares, pero haga click en la tercera, por ejemplo. | + | * **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.\\ \\ |
- | • clickCoordinates: Hace click en el punto concreto definido por las coordenadas X e Y recibidas como parámetros de entrada. | + | * **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.\\ \\ |
- | • 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. | + | * **openApp**: abre una aplicación ejecutando el ejecutable que se ha pasado en el parámetro de entrada.\\ \\ |
- | • 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. | + | * **paste**: pega el texto recibido en entrada en la posición en la que esté el cursor en ese momento.\\ \\ |
- | • 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. | + | * **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: |
- | • openApp: Abre una aplicación ejecutando el ejecutable que se ha pasado en el parámetro de entrada. | + | * parámetro “Key+Key”: es obligatorio y son las teclas que enviar |
- | • paste: Pega el texto recibido en entrada en la posición en la que esté el cursor en ese momento. | + | * parámetro “Delay milliseconds”: es opcional y es la demora en milisegundos entre teclas |
- | • 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. | + | * 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.\\ \\ |
- | 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. | + | * **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.\\ \\ |
- | • 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.\\ \\ |
- | • 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/ |
- | • 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/ | + | |