- Notas relacionadas
- Primeros pasos
- Instalación y configuración
- Proyectos de automatización
- Acerca de la publicación de proyectos de automatización
- Diseñar automatizaciones
- Gestionar paquetes de actividades
- Configuración de los Ajustes del Proyecto de Actividades
- Firma de paquetes
- Control
- Importar entidades
- Experiencia de diseño moderna
- Vincular un proyecto a una idea en Automation Hub
- Usar Data Manager
- Dependencias
- Tipos de flujos de trabajo
- Comparación de archivos
- Mejores prácticas de automatización
- Integración del control de código fuente
- Depuración
- Analizador de flujo de trabajo
- Acerca del analizador de flujo de trabajo
- ST-NMG-001: convención sobre nombres de variables
- ST-NMG-002: convención de nombres de argumentos
- ST-NMG-004: duplicación de nombres de visualización
- ST-NMG-005: anulación de variables
- ST-NMG-006: argumentos de anulación de variables
- ST-NMG-008: longitud variable excedida
- ST-NMG-009: variables de datos prefijados
- ST-NMG-011: argumentos de prefijo Datatable
- ST-NMG-012: valores predeterminados de los argumentos
- ST-NMG-016: longitud del argumento excedida
- ST-DBP-002: recuento de Argumentos elevado
- ST-DBP-003: bloque de Catch vacío
- ST-DBP-007: múltiples capas de diagramas de flujo
- ST-DBP-020: propiedades de salida no definidas
- ST-DBP-023: flujo de trabajo vacío
- ST-DBP-024: comprobación de actividad de persistencia
- ST-DBP-025: requisito previo para la serialización de variables
- ST-DBP-026: retraso en el uso de la actividad
- ST-DBP-027: mejor práctica de persistencia
- ST-DBP-028: requisito de serialización de argumentos
- ST-USG-005: argumentos de actividad codificados
- ST-USG-009: variables no utilizadas
- ST-USG-010: dependencias sin utilizar
- ST-USG-014: restricciones de los paquetes
- ST-USG-020: mensajes de registro mínimos
- ST-USG-024: guardado sin usar para más adelante
- ST-USG-025: uso incorrecto de los valores guardados
- ST-USG-026: restricciones de actividad
- ST-USG-027: paquetes necesarios
- ST-USG-028: Restringir la invocación de plantillas de archivo
- ST-USG-032 - Etiquetas obligatorias
- ST-USG-034 - URL Automation Hub
- Variables
- Argumentos
- Espacios de nombres importados
- Automatización atendida basada en desencadenadores
- Grabación
- Elementos de la IU
- Flujo de control
- Selectores
- Repo. de objetos
- Extracción de datos
- Automatización de imágenes y texto
- Acerca de la automatización de imágenes y texto
- Actividades con el ratón y el teclado
- Ejemplo de uso de la automatización de ratón y teclado
- Actividades de texto
- Ejemplo de uso de la automatización de texto
- Actividades de OCR
- Actividades de imagen
- Ejemplo de uso de la automatización de OCR y la automatización de imágenes
- Automatización de Citrix Technologies
- Automatización RDP
- Automatización de Salesforce
- Automatización SAP
- Automatización de VMware Horizon
- Registro
- La herramienta ScreenScrapeJavaSupport
- El protocolo WebDriver
- Conjunto de pruebas - Estudio
- Extensiones
- Solución de problemas
- Acerca de la resolución de problemas
- Compatibilidad y limitaciones de Microsoft App-V
- Solución de problemas de Internet Explorer x64
- Problemas de Microsoft Office
- Identificación de elementos de la interfaz de usuario en PDF con opciones de accesibilidad
- Reparar Soporte Active Accessibility
- Automatizar aplicaciones que se ejecutan en un usuario de Windows diferente
- Validation of large Windows-legacy projects takes longer than expected
Acerca de las bibliotecas
Una biblioteca es un proyecto que contiene uno o varios flujos de trabajo que pueden reutilizarse como actividades en otros proyectos. Las bibliotecas se guardan como archivos NUPKG cuando se publican y pueden instalarse como dependencias desde Gestionar paquetes.
Por ejemplo, podrías crear una biblioteca que recoja los datos de una hoja de cálculo Excel y la adjunte a otra, como se explica en la página Crear una biblioteca básica. A continuación, la biblioteca se puede empaquetar y usar en otros procesos como una actividad.
Puedes extraer cualquier proceso o proyecto de automatización de pruebas como una biblioteca para ser reutilizado en otros proyectos. Por ejemplo, puedes convertir un proyecto de probar automatización para utilizar sus plantillas en otros proyectos de automatización.
Los argumentos que defines en la biblioteca se convierten en propiedades de actividades en los proyectos en los que la biblioteca está instalada como una dependencia.
Para configurar el aspecto y el comportamiento de una actividad cuando se use en un proyecto, haz clic derecho en el archivo del flujo de trabajo en el panel Proyecto de la biblioteca, y luego selecciona Diseño de la actividad. La ventana de propiedades de la actividad se muestra con distintas opciones en función de la compatibilidad de la biblioteca (Windows [heredado], Windows o multiplataforma).
Selecciona Propiedades de la actividad en el menú a la izquierda e introduce lo siguiente:
- Nombre para mostrar: nombre de la actividad que se muestra en el panel Actividades.
- Descripción emergente: la información sobre herramientas visible cuando mantienes el puntero por encima de la actividad en los paneles Actividades y Diseñador, en proyectos donde se ha instalado la biblioteca.
- Enlace de ayuda: el enlace de ayuda que se abre cuando seleccionas la actividad en el panel Diseñador y presionas F1 en tu teclado.
- Icono SVG: el icono SVG a mostrar junto al nombre de la actividad.
- Color: El color de resalte que se muestra para la actividad en el Diseñador.
Los argumentos, definidos en el archivo del flujo de trabajo, se enumeran en Propiedades de la actividad en el menú a la izquierda.
-
Para personalizar la propiedad generada, selecciónala y configura lo siguiente:
- Nombre para mostrar: la etiqueta para la propiedad que aparece en la actividad.
- Descripción emergente: información sobre la herramienta visible cuando mantienes el puntero sobre la propiedad de la actividad.
-
Tipo de entrada: El tipo de entrada para la propiedad. Puedes utilizar la entrada predeterminada para el tipo de propiedad o seleccionar una opción de entrada en función del tipo:
- Booleano: usar por defecto, alternar (por defecto), generador de condiciones, botón de radio.
- Numérica (int, double, decimal, long, short, sbyte, byte, ulong, ushort, unit, float): usarpor defecto, editor de números, desplegable. Para el menú desplegable, en el campo Valores, introduce cada valor por separado pulsando Intro en tu teclado.
- String: usar por defecto, compositor de texto (por defecto), compositor de texto enriquecido, desplegable, autocompletar, botón de radio. Para acceder al menú desplegable, autocompletar y el botón de radio, en el campo Valores, introduce cada valor por separado pulsando Intro en tu teclado.
- String[]: usar por defecto, matriz de string.
- Fecha y hora: usar por defecto, fecha y hora.
- Periodo de tiempo: usar por defecto, periodo de tiempo.
- Diccionario: usar por defecto, diccionario.
- Todos los demás tipos: usar por defecto, entrada.
- Marcador de posición: el texto del marcador de posición a mostrar como entrada cuando no se ha seleccionado un valor.
- Requisito: si la propiedad es obligatoria.
- Solo avanzado: si la propiedad solo debe mostrarse en la sección opciones avanzadas de la actividad. Las propiedades de la sección opciones avanzadas también pueden organizarse en categorías.
- Para añadir una categoría en la que agrupar varias propiedades relacionadas, selecciona Nueva categoría en el lado inferior izquierdo de la ventana. Las categorías solo están disponibles en la sección opciones avanzadas de la actividad generada y pueden expandirse o contraerse. Si una categoría está vacía, se elimina cuando haces clic en Guardar para cerrar la ventana.
-
Para cambiar el orden de las propiedades y categorías, o añadir propiedades a las categorías, arrastra y suelta los elementos en la lista.
Selecciona Propiedades de la actividad en el menú a la izquierda e introduce lo siguiente:
- Descripción emergente: la información sobre herramientas visible cuando mantienes el puntero por encima de la actividad en los paneles Actividades y Diseñador, en proyectos donde se ha instalado la biblioteca.
- Enlace de ayuda: el enlace de ayuda que se abre cuando seleccionas la actividad en el panel Diseñador y presionas F1 en tu teclado.
Los argumentos, definidos en el archivo del flujo de trabajo, se muestran en Propiedades de la actividad en el menú a la izquierda.
-
Para personalizar la propiedad generada, selecciónala y configura lo siguiente:
- Nombre para mostrar: la etiqueta para la propiedad que aparece en la actividad.
- Descripción emergente: información sobre la herramienta visible cuando mantienes el puntero sobre la propiedad de la actividad.
- Requisito: si la propiedad es obligatoria.
- Solo avanzado: si la propiedad solo debe mostrarse en el panel Propiedades. Si se selecciona, la propiedad no se muestra en el panel Diseñador para la actividad generada.
-
Para cambiar el orden en que se muestran las propiedades en la actividad, arrástralas y suéltalas en la lista.
Nota:- En el caso de las bibliotecas, se recomienda usar
Nothing
para asignar un valor nulo a una variable, en lugar de""
. Esto se hace para evitar incoherencias al usar la biblioteca empaquetada como una dependencia para un proyecto. - No se admite la propiedad ImplementationVersion del objeto
System.Activities.ActivityBuilder
. Si se configura un valor para esta propiedad, los argumentos no se guardan. Este objeto se muestra en el panel Propiedades cuando seleccionas la zona en blanco del panel Diseñador.
- En el caso de las bibliotecas, se recomienda usar
Para configurar los ajustes de un proyecto de biblioteca, abre la ventana Configuración del proyecto haciendo clic en Configuración en el panel Proyecto.
Las siguientes opciones están disponibles en la pestaña General:
- Nombre: edita el nombre del proyecto.
- Descripción: edita la descripción del proyecto.
- URL de Automation Hub: URL de una idea de Automation Hub vinculada al proyecto. Para obtener más información, consulta Vincular un proyecto a una idea en Automation Hub.
-
Icono de proyecto: de forma opcional, define un icono personalizado para el proyecto. Puedes buscar y seleccionar un archivo o introducir una ruta o URL pública de un archivo
ico
,jpeg
,jpg
,png
o de hasta 1MB de tamaño.Una vez publicado el proyecto, el icono aparecerá junto al paquete en la sección Gestionar paquetes de Studio.
- Recopilar las expresiones de las actividades: establece en Sí para recopilar y empaquetar todas las expresiones de las actividades con la biblioteca. Esta acción mejora el tiempo de ejecución. Disponible para Windows: solo para las bibliotecas heredadas.
- Listo para ejecutar: establecido en Sí para optimizar los conjuntos generados para la compilación JIT más rápida en tiempo de ejecución.Disponible para Windows: solo para las bibliotecas heredadas.
- Experiencia de diseño moderna: establecida como Sí para permitir una experiencia moderna de trabajo con automatización de IU, incluidas actividades, grabadoras y asistentes nuevos y mejorados, así como el repositorio de objetos.
- Debido a la separación entre tiempo de diseño y paquetes de runtime, las bibliotecas personalizadas publicadas en Studio 2023.4 no están garantizadas como compatibles con versiones anteriores de Studio.
-
Puedes instalar solo el paquete de tiempo de diseño en un proyecto, ya que se reemplaza por el paquete de runtime al publicar. Instalar solo el paquete de runtime causará problemas inesperados en Studio.
Al utilizar bibliotecas, ten en cuenta las siguientes limitaciones:
-
Debido a limitaciones de NuGet:
- No puedes publicar bibliotecas en ubicaciones que contienen subcarpetas restringidas por el usuario utilizando variables de ruta de acceso del entorno Windows.
- Las notas de versión para bibliotecas publicadas solo se ven en Orchestrator.
- Es posible que las bibliotecas con caracteres especiales en los nombres de los archivos
.xaml
que contienen no se publiquen correctamente. - Si una biblioteca contiene un archivo
.xaml
y un argumento que tenga el mismo nombre, la biblioteca no se podrá publicar. - Los proyectos de biblioteca con la compatibilidad de Windows: heredado no se pueden publicar si contienen las actividades Invocar archivo de flujo de trabajo con la opción Aislado seleccionada. Se mostrará un mensaje de error en el panel Salida al intentar publicarlos. Esta limitación no se aplica a las bibliotecas que utilizan la compatibilidad de Windows o de multiplataforma.
- Al usar la actividad Invocar archivo de flujo de trabajo, comprueba que el archivo invocado se encuentra en la misma carpeta que el proyecto de biblioteca.
- Las bibliotecas no admiten la actividad Lanzar flujo de trabajo interactivo.
- Tampoco se puede usar la actividad Invocar archivo de flujo de trabajo dentro de una biblioteca para hacer referencia a la propia biblioteca.
-
Si una biblioteca contiene una actividad que acepta una ruta de archivo como entrada, para garantizar que la ruta se resuelva correctamente en los proyectos donde está instalada la biblioteca, añade la constante global UiPath.Constants.Project.Location cuando hagas referencia a la ruta (utiliza exactamente esta capitalización). Esto deshabilita el cambio de
Environment.CurrentDirectory
a la carpeta de la biblioteca, al inicio de la ejecución para una actividad de biblioteca, y utiliza la constante en su lugar.Por ejemplo, si un archivo llamado Employee.txt, ubicado en la subcarpeta DatosDeEntrada en el proyecto de biblioteca, se utiliza dentro de una actividad Archivo de lectura, proporciona la ruta de la siguiente manera:
UiPath.Constants.Project.Location+"InputData\Employee.txt"
Nota: la constante no debe utilizarse en actividades Invocar archivo de flujo de trabajo dentro de las bibliotecas. - Para hacer referencia a una ubicación desde la carpeta del proyecto donde está instalada una biblioteca, pasa la ruta a la biblioteca como argumento.
- Abre o crea un proyecto nuevo.
- En la categoría Todos los paquetes, elige la fuente en la que se guarda la biblioteca e instala el paquete.
- Selecciona Aceptar y el paquete se añade a la definición del proyecto.
- La actividad se encuentra en la categoría personalizada del panel Actividades.
Consideraciones al instalar bibliotecas en proyectos
- Las bibliotecas con compatibilidad multiplataforma pueden instalarse en proyectos multiplataforma y proyectos Windows. Windows: las bibliotecas heredadas y Windows solo pueden instalarse en procesos que tengan la misma compatibilidad.
- Se pueden producir errores al ejecutar un proyecto que contiene actividades personalizadas desde una biblioteca que se creó en una versión de Studio antes del 1.10.2019 y se publicó desde Studio el 1.10.2019 o después. En este caso, debes recrear y volver a publicar la biblioteca.
- Al usar Importar flujos de trabajo para añadir un flujo de trabajo que contiene una biblioteca en un proyecto de la biblioteca, las dependencias a las que se hace referencia en la biblioteca no se importan.
- Al importar dos versiones de la misma biblioteca personalizada en un proyecto, las actividades adicionales personalizadas contenidas solo en la segunda biblioteca no serán visibles en el panel Actividades a menos que elimines la primera biblioteca importada.
-
El uso de puntos (
.
) en el nombre de la biblioteca separa la biblioteca en grupos anidados cuando se visualiza en el panel Actividades.
- Crear una biblioteca
- Extraer un proyecto como biblioteca
- Configurar el diseño de una actividad
- Opciones para bibliotecas Windows y multiplataforma
- Opciones para bibliotecas Windows (heredado)
- Ajustar la configuración de las bibliotecas
- Publicar una biblioteca
- Limitaciones al utilizar bibliotecas
- Añadir componentes reutilizables a proyectos de automatización