Crear un repositorio de objetos

Importante: el repositorio de objetos funciona con las versiones 20.10 y superiores del paquete UiPath.UIAutomation.Activities y en proyectos con la experiencia de diseño moderna habilitada.

Un repositorio de objetos es una colección de los elementos agrupados por las aplicaciones, versiones y pantallas que pueden proceder de:

• un proyecto local, p. ej., el repositorio local.
• una biblioteca, p. ej., dependencias de la biblioteca de IU con el proyecto actual.

Puede crearse un repositorio local de los siguientes modos:

• mediante la grabadora Capturar elementos que permite capturar los descriptores de la IU.
• manualmente, creando las aplicaciones, las pantallas y los elementos directamente en el panel Repositorio de objetos.

Puede crearse una biblioteca de IU de alguno de los siguientes modos:

• extrayendo el repositorio local de cualquier proyecto en un proyecto de biblioteca y publicándolo como un paquete NuGet.

• empezando por una biblioteca nueva, creando el repositorio allí y publicándolo como paquete NuGet.

  A continuación, puedes utilizar los paquetes NuGet de la biblioteca de IU y añadirlos como dependencias a tus procesos.

  Importante: El grabador de Capturar elementos solo registra objetos para reutilizar en proyectos, la grabadora no genera ningún flujo de trabajo en el panel Diseñador.

Crear un repositorio al capturar elementos

En una biblioteca o un proceso, haz clic en el botón Capturar elementos del repositorio de objetos para iniciar el registro de objetos.

El grabador Capturar elementos utiliza la tecnología Destino unificado desde la versión 20.10 y posteriores del paquete UIAutomation.Activities para capturar los destinos y anclar con un cierto grado de precisión para cada selector, imagen o anclaje.

Los elementos de la IU se capturan junto con un selector, un selector difuso y una imagen, cada uno con un grado de precisión. Puedes elegir que mantenga solo uno o todos los elementos de destino. Lo mismo se aplica a los elementos de anclaje asociados a cada elemento de la IU.

Propiedades del descriptor

Las aplicaciones, las pantallas y los elementos deben recibir nombres descriptivos desde la grabadora Captura elementos para que sean fácilmente reconocibles en el Repositorio de objetos.

Tipos de elementos

Un selector de una aplicación puede representar un botón, una casilla de verificación, un cuadro de texto, un botón de alternancia, un cuadro de lista, y cualquier tipo de elemento que pueda interactuar con UiPath Robot. El elemento capturado se puede definir desde la grabadora Capturar elementos.

En la lista desplegable Tipo, busca y selecciona el tipo adecuado para cada elemento. En el Repositorio de objetos, el elemento recibe un icono específico para su tipo, lo que facilita la distinción entre objetos.

Tras capturar los elementos, haz clic en el botón Guardar objetos en la biblioteca y los objetos se añaden al Repositorio de objetos.

Nota:

• Para añadir elementos adicionales, haz clic con el botón secundario en una pantalla o un elemento del repositorio y selecciona Crear elemento. Para añadir pantallas adicionales, haz clic con el botón derecho en la aplicación y selecciona Crear pantalla.
• Para registrar los objetos directamente en una aplicación o en una pantalla, haz clic con el botón derecho en cualquier aplicación o pantalla y selecciona Capturar elementos.

Crear un repositorio desde el panel Repositorio de objetos

Puedes crear tu propio repositorio desde el panel Repositorio de objetos, definiendo manualmente la aplicación, cada pantalla y el elemento.

Crea una aplicación de IU

En el panel Repositorio de objetos, haz clic en el signo más de la pestaña Descriptores, o haz clic en Descriptores de proyectos en la misma pestaña y selecciona Crear aplicación. Se abre la ventana Crear aplicación:

Añade un nombre exclusivo para la aplicación, una versión y una descripción. Haz clic en Crear aplicación. La aplicación es visible en la pestaña Descriptores, en Descriptores de IU del proyecto.

Crea una pantalla

En la pestaña Descriptores, selecciona la aplicación, haz clic en el signo más o haz clic en la aplicación y selecciona Crear pantalla. Se abre la ventana Añadir pantalla:

Añade un nombre único para la pantalla y una descripción. Indica la pantalla que quieres automatizar y edita el elemento capturado con el destino unificado:

• cambia la ruta de la aplicación si es necesario.

• añade argumentos de la aplicación.

  Una vez finalizado, haz clic en Crear pantalla.

Crea un elemento de la IU

En la pestaña Descriptores, selecciona la pantalla de la aplicación, haz clic en el signo más, o haz clic con el botón derecho en la pantalla y selecciona Crear Elemento. Se abre la ventana Añadir elemento:

En la sección Tipo de descriptor, haz clic en Indicar elemento para usar Destino unificado para indicar y capturar el elemento de la pantalla.

Añade un nombre intuitivo en el campo Nombre del elemento y selecciona el tipo de elemento de la lista desplegable en Tipo. Haz clic en Guardar cuando se haya realizado.

Nota:

• Para editar un elemento del Repositorio de objetos, haz clic con el botón derecho en él y selecciona Editar elemento, o haz doble clic en el elemento del árbol.
• Para editar el descriptor de un elemento, utiliza la opción Editar descriptor en la ventana Editar elemento o selecciona Editar descriptor.

Utilizar el Repositorio de objetos con grabadoras

Si el repositorio de objetos se aplica en tu instancia de Studio (como se indica en las instrucciones de la página Acerca del repositorio de objetos), al utilizar la Grabadora de aplicaciones/web, las actividades generadas no hacen referencia automáticamente a los descriptores del repositorio.

En el ámbito de actividades, el mensaje emergente de la herramienta informativa te indica que debes añadir descriptores al Repositorio de objetos o utilizar los existentes.

Para ello, haz clic en el icono de la actividad y sigue los pasos para añadir o reutilizar descriptores, o selecciona Opciones > Añadir al repositorio de objetos para añadir el elemento al Repositorio de objetos.

Añade elementos de las actividades al repositorio

Una vez que hayas creado un repositorio de objetos, puedes añadir más elementos de la IU directamente desde el panel Diseñador.

En el panel Diseñador, añade una actividad que sea compatible con los selectores, como Clic o Escribir en. Asegúrate de que la actividad añadida se encuentre en una actividad Utilizar Aplicación/Navegador.

En el cuerpo de la actividad, haz clic en el icono del repositorio de objetos para abrir la ventana Opciones de selección. Captura el elemento, selecciona Confirmar y se abre la ventana Añadir elemento al repositorio de objetos. Añade un nombre al elemento y haz clic en Guardar. Ten en cuenta que el elemento se añade al panel Repositorio de objetos.

Utiliza objetos del proyecto actual

Desde el Repositorio de objetos, arrastra y suelta una aplicación, una pantalla o un elemento por encima de una actividad del flujo de trabajo. La imagen del objeto, los argumentos y otros detalles se añaden automáticamente a la actividad.

En el siguiente ejemplo, arrastramos el MyAppScreenobjeto situado junto a la actividad Utilizar Aplicación/Navegador. La ruta de la aplicación se añade automáticamente a la actividad.

Como alternativa, arrastra un objeto por encima del signo más del flujo de trabajo para abrir una lista de actividades compatibles. Selecciona la actividad y el objeto se añade automáticamente. Dentro del proceso, la actividad recibe la siguiente etiqueta: nombre de actividad + nombre de objeto.

Una vez añadido el objeto, la actividad recibe las propiedades del descriptor del repositorio de objetos, visibles en el panel Propiedades de la actividad.

• Para editar el descriptor, haz clic en Mostrar en la parte superior del panel de Propiedades para ir al Repositorio de objetos, donde puedes usar la opción Editar descriptor.

• Para eliminar el enlace entre la actividad y el Repositorio de objetos, haz clic en Desvincular en la parte superior del panel Propiedades. Cuando se aplica el repositorio de objetos, la desvinculación elimina el destino de la actividad.

  
  

  

  
  

Una vez añadidos al flujo de trabajo, la pestaña Actividades de IU del panel Repositorio de objetos, muestra las actividades y los objetos que contienen por orden jerárquico. Si no son visibles, guarda el proyecto y compruébalo de nuevo.

Los flujos de trabajo se marcan:

• con un punto gris, si al menos 1 actividad del flujo de trabajo hace referencia a un descriptor de IU del panel Objetos.
• con un punto azul, si todas las actividades del flujo de trabajo hacen referencia a descriptores de IU desde el panel Objetos.

Las actividades de IU se marcan:

• con un punto vacío, si la actividad no hace referencia a un descriptor de IU del panel Objetos.
• con un punto azul, si hace referencia a un descriptor de IU del panel Objetos.

Editar descriptores

Los descriptores pueden editarse desde el Repositorio de objetos en dos escenarios que denominaremos "en línea" y "sin conexión":

• Editar en línea: se puede acceder a la aplicación o al navegador en la máquina actual. La aplicación o el navegador se muestra en la pantalla y permite seleccionar los elementos de nuevo o modificarlos.
• Editar sin conexión: no se puede acceder a la aplicación o al navegador en la máquina actual, ya que la aplicación no está instalada o la máquina está sin conexión. Los selectores del elemento se hacen visibles permitiendo los cambios.

Editar en línea

En la pestaña Descriptores, haz clic con el botón derecho en un elemento y selecciona Editar descriptor. La pantalla de selección se abre y permite capturar un elemento diferente, editar selectores y anclajes.

Lo mismo puede lograrse haciendo clic en el botón Editar descriptor desde la ventana Editar elemento.

Nota: En el Runtime, los Descriptores de IU se resuelven desde el panel Repositorio de objetos cuando las actividades hacen referencia a dichos Descriptores de IU.

Editar sin conexión

Los mismos pasos de la edición en línea se aplican aquí también. En la pestaña Descriptores, haz clic con el botón derecho en una pantalla o elemento y selecciona Editar descriptor.

La edición sin conexión ofrece la opción para realizar cambios directamente a la configuración del descriptor del elemento. No obstante, no puedes indicar elementos nuevos. Para ello, asegúrate de que se abre la aplicación o navegador en el estado correcto.

Resolver descriptores de IU

Cada vez que indicas una pantalla o un elemento de IU al que ya se ha hecho referencia en el Repositorio de objetos, ya sea con Descriptores de IU o bibliotecas de IU, la coincidencia se detectará automáticamente y se solicita la ventana siguiente:

Las siguientes opciones están disponibles:

• Reutilizar: añade el descriptor correspondiente del Repositorio de objetos a la actividad actual.
• Crear nuevo: abre la ventana de opciones para crear una pantalla o un elemento nuevo o actualiza uno existente en el Repositorio de objetos.
• Cancelar: mantiene el selector indicado actualmente en la actividad sin realizar cambios en los objetos del repositorio.

Al indicar una pantalla, se busca un descriptor de la interfaz de usuario correspondiente, mientras que al indicar un elemento de destino se busca un descriptor de la interfaz de usuario coincidente. Cuando se usa la Grabadora, se buscan las coincidencias correspondientes para la pantalla y los elementos de la biblioteca de la interfaz de usuario local desde Descriptores de la interfaz de usuario del proyecto o las dependencias importadas desde las bibliotecas de la interfaz de usuario.

Nota: En el Runtime, los Descriptores IU se resuelven desde el panel Explorador de objetos cuando las actividades hacen referencia a dichos Descriptores de IU.

Variables de los descriptores

Para aumentar su grado de reutilización, puedes usar variables en los descriptores.

Puedes editar un destino, añadirle variables y luego añadirlo al repositorio de objetos, o puedes añadir variables a los selectores de las pantallas o los elementos existentes desde el repositorio de objetos. Siempre que agregues un descriptor que contenga una variable a un proceso, asegúrate de crear la variable en el proceso, de lo contrario no se podrá leer la expresión.

Para añadir una variable a un selector de descriptores, haz clic con el botón derecho en el elemento del Repositorio de objetos y, a continuación, selecciona Editar descriptor y añade la variable desde la ventana Opción de selección.

Las variables añadidas a los selectores deben ir entre llaves dobles. Por ejemplo, como se ve en la imagen siguiente, <name='{{VarNumber}}'/> añade el valor de la variable VarNumber al atributo name en el selector.

En el ejemplo siguiente, utilizamos una variable del campo URL del navegador de la actividad Usar Aplicación/Navegador y, a continuación, agregamos el destino al repositorio de objetos como un objeto de pantalla. De esta manera, nos aseguramos de que el descriptor tiene en cuenta los casos en los que la URL cambia.

Elementos destacados

En el panel Repositorio de Objetos, haz clic en el botón derecho en una pantalla o un elemento y selecciona Resaltar para resaltar elementos en la aplicación, siempre que esta se inicie en la máquina o se abra la página web en el navegador.