View source for Comando ClickBy

{{Idiomas|Comando ClickBy|ClickBy Command | ClickBy コマンド}}
[[category:Comandos GXtest]]

== ClickBy ==

El comando ClickBy sirve para simular un click sobre un elemento de la página. Funciona de manera análoga al comando Click, con la diferencia que el control que será clickeado puede ser un control no-nativo de GeneXus (un control externo a la KB). Esto permite a GXtest poder interactuar con controles "externos", por ejemplo un botón que aparece dentro de un frame de una aplicación que no fue generada con GeneXus. 


=== Parámetros del comando ===
*Target control: un criterio de identificación del control (por ejemplo "id=btnEnter")


=== Criterios de identificación del control ===
Los criterios que se pueden utilizar para identificar un control en la página son:
* id: Identificador único del control, corresponde al atributo id del elemento HTML. Ejemplo: id=btnEnter
* name: Nombre del control, corresponde al atributo name del elemento HTML. Ejemplo: name=Confirm
* class: Clase del control, corresponde al atributo class del elemento HTML. Ejemplo: class=BotonesGrandes
* xpath: Xpath que identifica el control en el DOM del HTML. 


=== Consideraciones ===
* Las búsquedas por name y (sobretodo por) class pueden dar múltiples resultados, ya que no son atributos que puedan identificar en forma inequívoca al control. En caso de tener múltiples controles que cumplan el criterio, se seleccionará el primero.
* La búsqueda utilizando xpath es la menos recomendada de las 4, ya que pueden "romperse" con cambios en la interfaz de la aplicación (quizás incluso por cambios no visibles, como una nueva versión del generador GeneXus), debido a cambios en el HTML o DOM generado y la ubicación del control.
* Debido a los dos puntos anteriores, se recomienda utilizar en el siguiente orden de preferencia los criterios de identificación: id, name, class, y si ninguno de los tres anteriores pudiera ser utilizado, entonces usar xpath.


=== Ejemplo ===
ClickBy("name=BtnConfirm")