Uso de la acción Captura

Utilice la acción Capturar para capturar una sola interacción (clic, pulsación de tecla o movimiento del mouse) con un control de objeto que incluye un cuadro de texto, un botón, una tabla, un menú, un botón de opción, un cuadro combinado, una casilla de verificación, una vista de lista, un vínculo, un árbol o una pestaña de página.

Antes de empezar

  • Configure la visualización del dispositivo y la escala de la fuente al 100 %.

    Si utiliza el paquete de Grabador versión 2.0.6-20200626-193519 o posterior, puede registrar tareas en Google Chrome, Internet Explorer, Java, Microsoft Active Accessibility y aplicaciones de automatización de Microsoft UI en un equipo que tenga una escala de visualización configurada en 100%, 125% o 150%.

  • Si está automatizando una tarea con un navegador, configure el nivel de zoom al 100%.

    Si está utilizando el paquete Grabador versión 2.0.6-20200626-193519 o posterior, puede registrar tareas en un navegador Google Chrome que no tenga una configuración de nivel de zoom del 100%.

  • Si automatiza una tarea con un navegador Google Chrome, asegúrese de que esté habilitado el complemento Automation Anywhere que corresponda con la versión integrada de Automation 360.

    Requisitos del explorador para Automation Workspace

  • Para automatizar las aplicaciones web que se ejecutan en el navegador Chromium Microsoft Edge en modo Internet Explorer utilizando el Grabador universal, asegúrese de que el modo de compatibilidad de Internet Explorer esté activado. Los objetos de las aplicaciones web se capturan con tecnología HTML. Para habilitar este modo, realice los siguientes pasos:
    1. En la página del navegador Chromium Microsoft Edge, haga clic en Configuración.
    2. En el panel izquierdo, haga clic en Navegador predeterminado.
    3. Navegue hasta la opción Permitir la recarga de sitios en el modo Internet Explorer y seleccione Permitir.
    4. Haga clic en Agregar para agregar la URL de la página que desea cargar en el modo Internet Explorer.
      Nota: Las páginas que agrega se abren en modo Internet Explorer durante 30 días a partir de la fecha en que se agrega la página.
Consideraciones al registrar una tarea:
  • Utilice los clics siempre que sea posible en lugar de las teclas de acceso directo.

    Cuando se hace clic en un objeto con el botón Grabador, recupera las propiedades del objeto que permiten al bot identificar el objeto en tiempo de ejecución. Los atajos de teclado son menos confiables, así que utilícelos cuando no sea posible automatizar la tarea haciendo clic en un objeto.

  • Si está automatizando una tarea con un navegador, no utilice el llenado automático para introducir valores en los campos.
  • Registre la tarea a baja velocidad.
  • Evite arrastrar ventanas durante el proceso de grabación.
  • Evite hacer clic en aplicaciones que no forman parte del proceso para la grabación y automatización.
  • Cuando se utiliza Internet Explorer, la acción espera hasta que el navegador se muestre por completo y esté en estado listo antes de ejecutar la acción.

Procedimiento

Para grabar una sola interacción con un control de objeto, siga estos pasos:

  1. Haga doble clic en Grabador > Capturar o arrastre la opción.
  2. Especifique la ventana en la que se va a capturar un objeto.
    Elija entre la pestaña Aplicación, Navegador o Variable.
    OpciónDescripción
    Aplicación Seleccione de una lista de ventanas actualmente activas. Esta opción muestra una lista de todas las ventanas de aplicaciones y navegadores que están abiertas en el dispositivo de Bot Creator.
    Navegador Seleccione de una lista de pestañas del navegador compatibles.
    Nota: Esta opción es compatible con Google Chrome, Microsoft Edge basado en Chromium y los navegadores Internet Explorer. Para el resto de navegadores, utilice la opción Aplicación.
    Variable Seleccione una variable de ventana existente para especificar el título de la ventana de la aplicación.
  3. Opcional: Inserte un carácter comodín (*) en el Título de la ventana para buscar títulos de ventanas que puedan variar. Puede especificar uno o más comodines (*) al principio, en el medio o al final del valor.
    Por ejemplo, para realizar una operación en cualquier ventana que tenga Microsoft en el título, use un comodín para indicar cualquier cadena y agréguelo antes o después del valor: *Microsoft*. El bot busca primero el título exacto de la ventana (Microsoft) y, si no encuentra una coincidencia, busca las ventanas con el término Microsoft en cualquier parte del título.

    Puede utilizar una expresión común (lo que se suele llamar regex) para identificar el título de una ventana. Seleccione la condición de expresión regular como Cadena o un Patrón y, a continuación, introduzca el valor. De forma predeterminada, el campo Título de la ventana distingue entre mayúsculas y minúsculas.

    Para identificar el título de un navegador, puede habilitar la opción Distinguir mayúsculas para que identifique las mayúsculas y minúsculas, o deshabilitar la opción para identificar un título de la ventana en el que no coincidan las mayúsculas y minúsculas.
    Nota: Asegúrese de que la versión mínima del Agente de bot instalada en su sistema sea la versión publicada con Automation 360 v.26. Si tiene una versión de Agente de bot publicada con Automation 360 v.25 o anterior, el título de la ventana se identificará de forma predeterminada solo con las mayúsculas y minúsculas correspondientes (distinción de mayúsculas).
    Por ejemplo, para hacer coincidir todos los nombres de títulos de ventanas que comienzan con una palabra seguida de - Notepad, puede ingresar el valor Cadena como * -Notepad o utilizar el valor Patrón como ((\w)\s)*document-Notepad solo para aquellos títulos de ventana que coincidan con este patrón.
    Nota:
    • Cuando se utiliza una expresión regular de tipo Cadena con -title como valor de entrada para el título de una ventana en cualquier acción, el bot podría detectar un error del tiempo de ejecución. Para evitar un error de tiempo de ejecución, asegúrese de que cuando agregue la cadena de entrada como *-title, se abra la aplicación con el título específico. El asterisco (*) es solo un carácter y no un carácter comodín.
    • Cuando se utiliza una expresión regular de tipo Patrón con -title como valor de entrada para un título de ventana en cualquier acción, el bot podría detectar un error de tiempo de ejecución, ya que el valor de entrada *-title es incorrecto.

      Asegúrese de utilizar patrones regex válidos.

    Nota: Durante el tiempo de ejecución, verifique que TaskBot identifica la ventana correcta. Si no lo hace, siga los siguientes pasos:
    1. Abra la aplicación o la ventana del navegador.
    2. Arrastre la acción Ventana > Obtener el título de la ventana activa por encima de la acción Grabador > Capturar.
    3. Inserte una variable de cadena en el campo Asignar el título de la ventana a la variable.
    4. Arrastre una acción Ventana > Establecer título debajo de la acción Ventana > Obtener el título de la ventana activa.
    5. En el campo Ventana, ingrese la variable de ventana generada por la acción Grabador > Capturar.
    6. En el campo Título de la nueva ventana, ingrese la variable de cadena de la acción Obtener el título de la ventana activa.
    7. Haga clic en Guardar.
  4. Opcional: Seleccione la opción Cambiar el tamaño de la ventana para especificar las dimensiones de la ventana.
    Esta opción ofrece una mayor confiabilidad del bot. Cambia el tamaño de la ventana a las dimensiones en las que se registró la tarea, lo que mejora la capacidad del bot para identificar el objeto de destino.
    • Si la ventana está maximizada cuando registra la tarea, esta opción no se selecciona.
    • Si la ventana no tiene el tamaño máximo al momento de registrar la tarea, esta opción se selecciona de forma predeterminada, y los campos de anchura y altura se rellenarán automáticamente con las dimensiones de la ventana.
    Nota: Esta opción solo está disponible para las ventanas que se pueden cambiar de tamaño. No está disponible para opciones del Escritorio o la Barra de tareas.
  5. Haga clic en Capturar objeto.
    Aparece la ventana seleccionada.
  6. Mueva el mouse sobre el objeto que desea automatizar; por ejemplo, un botón, un campo de formulario o una tabla.
    Aparecerá una casilla rectangular roja alrededor del objeto.
    Nota: Si la casilla no aparece y está capturando en navegadores Google Chrome, Microsoft Edge o Mozilla Firefox, verifique que haya activado las extensiones de Automation Anywhere para estos navegadores. Consulte Requisitos de la extensión del navegador Google Chrome para el navegador Google Chrome.
  7. Haga clic en el objeto.
  8. Revisar las tablas Propiedades de los objetos.
    A continuación, se muestra la lista de propiedades de objetos que se seleccionan por defecto en función del tipo de tecnología:
    Nota: No tiene la opción de seleccionar de forma directa la tecnología Java o HTML. Cuando captura una aplicación en modo de detección automática, el Grabador detecta la tecnología automáticamente, según la aplicación que se captura. Cuando el Grabador detecta la tecnología específica, el tipo de tecnología se muestra dentro de las Propiedades del objeto.
    Important: La siguiente lista no incluye todas las propiedades, sino que está limitada a las propiedades más utilizadas e importantes según el tipo de tecnología.
    Tipo de tecnología Propiedades del objeto Descripción
    Tecnología HTML Tipo de control Esta es una propiedad de solo lectura que muestra el tipo de objeto capturado; por ejemplo, una caja de texto o un botón.
    DOMXPath Es la ruta que se utiliza para localizar el control u objeto que se captura. DOMXPath puede ser de dos tipos: XPath relativo y XPath absoluto.
    • Xpath absoluto: Contiene la ruta completa desde el elemento raíz hasta el elemento deseado. Por ejemplo, un Xpath absoluto para este tema sería /html/body/div/div[1]/main/​div[2]/div/div/​div[2]/div/div/div[1]/​div/article/main/​article/div/p[1]
    • Xpath relativo: Se trata de una ruta más corta que hace referencia a un elemento que se quiere identificar. Una ruta relativa comienza con el símbolo //. Por ejemplo, el XPath relativo para este tema sería //*[@id="cloud-using-recorder-action"]/div/p[1]
    Por ejemplo, si quiere encontrar el DOMXPath de un elemento concreto en el navegador Google Chrome, realice estos pasos:
    1. Seleccione el elemento al que le desea extraer el XPath.
    2. Haga clic con el botón derecho del ratón en el elemento y seleccione Inspeccionar.
    3. Haga clic con el botón derecho del ratón sobre el elemento resaltado en la pestaña Elemento.
    4. Vaya a Copiar > Copiar Xpath para copiar la ruta relativa y seleccione Copiar > Copiar Xpath completa para copiar la ruta absoluta.
    Ruta Es una representación numérica de la posición de un control concreto en una aplicación. Para las aplicaciones web, la práctica recomendada es utilizar DOMXPath de los criterios de búsqueda cuando se compare con Ruta.
    Nombre e identificación HTML Estas propiedades se utilizan para identificar un objeto HTML
    Texto interno HTML La propiedad DOM innerText se utiliza para establecer o devolver el contenido de texto de un nodo especificado y sus descendientes
    Etiqueta HTML Las etiquetas HTML son similares a palabras clave que definen la forma en que el navegador web formatea y muestra el contenido. Por ejemplo, si el texto capturado tiene un código HTML: <h3 class="search_results-title">Search results for ״string package״</h3>; luego, ingrese h3 en el campo de etiqueta HTML.
    Microsoft Active Accessibility Tipo de control Esta propiedad se utiliza únicamente como referencia para garantizar que se captura el objeto correcto
    Ruta Es una representación numérica de la posición de un control concreto en una aplicación
    Nombre Especifica el nombre de un elemento y funciona como identificador
    ID Especifica el ID de un elemento y funciona como un identificador
    Tecnología Java Tipo de control Esta propiedad se utiliza únicamente como referencia para garantizar que se captura el objeto correcto
    Ruta Es una representación numérica de la posición de un control concreto en una aplicación
    Microsoft UI Automation Tipo de control Esta propiedad se utiliza únicamente como referencia para garantizar que se captura el objeto correcto
    Ruta Es una representación numérica de la posición de un control concreto en una aplicación
    Nombre Especifica el nombre de un elemento y funciona como identificador
    ID Especifica el ID de un elemento y funciona como un identificador
    IsFirst Esta propiedad permite a bot detectar el primer objeto basado en sus criterios de búsqueda en lugar de recorrer todo el árbol. Puede utilizar esta propiedad cuando un objeto no tiene un único ID de Automatización y la jerarquía de objetos cambia en la aplicación.
    Microsoft UI Automation (COM) Tipo de control Esta propiedad se utiliza únicamente como referencia para garantizar que se captura el objeto correcto.
    Ruta Es una representación numérica de la posición de un control concreto en una aplicación.
    Nombre Especifica el nombre de un elemento y funciona como identificador.
    ID Especifica el ID de un elemento y funciona como identificador.
    El bot usa las propiedades seleccionadas para identificar el control de objetos durante el tiempo de ejecución.
    1. Verifique que el Tipo de control coincida con su objeto previsto.
      Por ejemplo, al capturar una tabla de un sitio web, asegúrese de que los valores Tipo de control y Etiqueta HTML sean Tabla.
      Si el Tipo de control no coincide con el objeto deseado, recapture el control de objetos.
    2. Seleccione y asigne valores a las propiedades de objeto que desea incluir en la búsqueda de objetos.
      Para una mayor fiabilidad del bot, le recomendamos que seleccione solo las propiedades que tienen valores estáticos (como Nombre, Clase, Tipo, ID HTML y DOMXPATH), y que desmarque las propiedades que tienen valores dinámicos (como HTML Href, Ruta o Valor), que están sujetos a cambios y causan errores del bot.
      Una práctica recomendada consiste en usar el carácter de comodín (*) o una variable en los valores de propiedad de objetos para buscar objetos cuyas propiedades son dinámicas y cambian con frecuencia.
      Nota: Actualmente, la tecnología SAP no admite la coincidencia de caracteres comodín. Cuando ejecuta un bot con un carácter comodín, coincide con los valores de propiedad exactamente como se especifica en los criterios de búsqueda.
  9. Seleccione la Acción de la lista desplegable.
    Si desea ver una lista completa de acciones posibles por objeto, consulte Acciones realizadas sobre los objetos capturados con Grabador universal.
    • Si graba un clic y pulsaciones de teclas en un cuadro de texto con un Tipo de control de Password text, la Grabadora no captura las pulsaciones de teclas introducidas en el campo. En cambio, la acción selecciona la opción Establecer texto y ofrece opciones para introducir la contraseña de forma segura. Le recomendamos que guarde la contraseña en la Credential Vault y que la introduzca en la acción como credencial.

      Consulte Credenciales y variables de credenciales en el Editor de bots.

      Si navega al cuadro de texto utilizando la tecla TAB en lugar de un clic en una aplicación MSAA o SAP, el Grabador es capaz de identificar los campos con un Tipo de control de Password text.

    • Si la Acción seleccionada admite el procesamiento en segundo plano, aparecerá la opción Ejecutar en segundo plano.

      Consulte Grabador universal para la automatización basada en objetos.

  10. En el campo Establecer tiempo de espera del sistema, seleccione Básico o Avanzado.
    • Básico: En el campo Esperar respuesta del sistema (segundos), especifique el tiempo en segundos que el bot debe esperar para que aparezca el control del objeto en la ventana de la aplicación. Este tiempo de espera incluye el tiempo de espera tanto para la carga de la página como para la búsqueda de objetos.

      Se recomienda establecer un tiempo de demora cuando se utilice la acción Establecer texto para ingresar pulsaciones en un campo de texto.

      Nota: El tiempo de espera especificado para que el bot espere a que el control aparezca en la ventana de la aplicación solo se aplica si existe la ventana en la que se encuentra el control. El Grabador primero busca la ventana de la aplicación y solo después busca el objeto dentro de esa ventana. El tiempo de búsqueda por defecto de la ventana es de 30 segundos. Por lo tanto, aunque se especifique un tiempo de espera de 5 segundos, seguirá esperando 30 segundos por defecto si la ventana no existe.

      Se recomienda utilizar primero la condición Si > Ventana existe, especificar un tiempo de espera de cero segundos y asegurarse de que la ventana de la aplicación exista. Si la ventana existe entonces utilice el Grabador, especifique un tiempo de espera de 5 segundos, y ejecute el bot para detectar el objeto.

    • Avanzado: Utilice esta opción para automatizar sitios web que se cargan y actualizan constantemente con los datos más recientes, como un sitio web de acciones. Técnicamente, estos sitios web nunca se cargan completamente en la pantalla. En tales casos, el bot no necesita esperar a que la página web se cargue por completo y puede proceder de manera directa a automatizar la página web después de un tiempo determinado.

      En el campo Esperar respuesta del navegador (segundos), especifique el tiempo en segundos que el bot debe esperar para que se cargue el navegador. Seleccione una de las siguientes opciones:

      • Detener el bot y mostrar un mensaje de error: Si la página web no se carga completamente dentro del tiempo de espera especificado, seleccione esta opción para detener el bot y mostrar un mensaje de error.
      • Omitir y continuar con el objeto: Seleccione esta opción para continuar directamente con el objeto y capturarlo incluso si la página web no se cargó por completo.

      En el campo Esperar respuesta del objeto (segundos), especifique el tiempo en segundos que el bot debe esperar para que aparezca el control del objeto en la ventana de la aplicación.

  11. Opcional: Asignar la salida a una variable.
    La Control Room sugiere un nombre de variable por defecto descriptivo basado en la acción seleccionada en el paso 8. Por ejemplo, si selecciona Obtener propiedad, la variable de salida sugerida es PropertyValue. Si se crean muchas variables de salida, a los nombres de las variables posteriores se les añade un -1 para evitar la duplicación.
  12. Haga clic en Guardar.
    Las imágenes capturadas no se agregan como dependencias y no se mostrarán en la lista de dependencias cuando verifique su bot.
Vincular un objeto a un anclaje de soporte
Nota: Puede utilizar el anclaje de objetos en Microsoft Active Accessibility, Microsoft UI Automation o aplicaciones Java.
En tiempo de ejecución, si el bot no puede identificar de forma confiable un objeto, vincúlelo a un objeto cercano (como un enlace o un botón) que sea más fácil de encontrar para el bot:
  1. Abra la acción Capturar.
  2. Haga clic en la pestaña Ancla.
  3. Haga clic en Capturar objeto.

    La ventana del navegador o de la aplicación se activa con el objeto principal resaltado (el objeto que ha capturado previamente). Aparecerá un cuadro de diálogo para verificar si la acción ha identificado correctamente el objeto principal.

  4. Si el objeto correcto está resaltado, haga clic en Sí, Seleccionar anclaje.

    De lo contrario, haga clic en No, necesito corregirlo para seleccionar el objeto correcto.

  5. Seleccione un objeto cercano al objeto de destino que sea más fácil de encontrar para el bot.

    El objeto se resalta con un ícono de ancla a la derecha del objeto.

  6. Haga clic en Guardar.