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.

Crear una biblioteca

1. Accede a la Vista Backstage de Studio > Inicio > Biblioteca. Se abre la ventana Nueva biblioteca en blanco.
2. Indica el nombre y elige una ubicación para la biblioteca. La ubicación predeterminada es C:\Users\<current_user>\Documents\UiPath. Añade una descripción, selecciona la compatibilidad y el lenguaje del proyecto, y luego selecciona Crear. La nueva biblioteca se crea y se guarda en tu máquina local.
   Nota:

   • El nombre de la biblioteca no puede tener más de 128 caracteres y la descripción no puede tener más de 500 caracteres.
   • No uses lib como nombre de la biblioteca, ya que recibirás un error de compilación en los proyectos en los que esté instalada la biblioteca.
3. El panel Proyecto muestra la vista de árbol con la carpeta de proyecto, dependencias y el NewActivity.xaml, que contiene el flujo de trabajo real.

   Cada archivo del flujo de trabajo de una biblioteca está disponible como una actividad en los proyectos en los que la biblioteca está instalada como una dependencia. Si quieres convertir determinado archivo en privado, haz clic con el botón secundario en él y selecciona Convertir en privado. En este caso, el archivo está incluido en el paquete de la biblioteca, pero no está disponible como componente reutilizable en el panel Actividades.

   Nota: De forma predeterminada, las dependencias disponibles para bibliotecas nuevas son las mismas que para proyectos nuevos en blanco, es decir, UiPath.Excel.Activities, UiPath.Mail.Activities, UiPath.System.Activities y UiPath.UIAutomation.Activities, con la regla de tiempo de ejecución Versión aplicable más antigua.

Para añadir información sobre herramientas y un enlace de ayuda a una actividad, haz clic derecho en el archivo del flujo de trabajo en el panel Proyecto y selecciona Propiedades. La información sobre herramientas se hace visible cuando mantienes el puntero sobre la actividad en los paneles Actividades y Diseñador en los proyectos en los que está instalada la biblioteca. El enlace de ayuda se abre cuando seleccionas la actividad en el panel Diseñador y pulsas F1.

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. Los argumentos marcados como necesarios están disponibles en el cuerpo de la actividad en el panel del Diseñador. Las anotaciones que añades a un argumento en la biblioteca se muestran como información sobre herramientas para la propiedad en el panel Propiedades de la actividad resultante. Para obtener más información sobre los argumentos, consulta el panel Argumentos.

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.

Ajustar la configuración de las bibliotecas

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.

• Incluir orígenes: establécelo en Sí para incluir todos los orígenes .xaml dentro del paquete de la biblioteca, incluidos los flujos de trabajo que se convirtieron en privados anteriormente. Para bibliotecas Windows heredadas, los archivos se guardan en el archivo de conjunto generado y en la carpeta lib\net45 en el archivo .nupkg. Para bibliotecas de Windows y multiplataforma, los archivos se guardan en la carpeta content en el archivo .nupkg.
• 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.

Publicar una biblioteca

Publicar bibliotecas es similar a publicar procesos. Para obtener más información, consulta la sección Información sobre la publicación de proyectos.

Limitaciones al publicar bibliotecas

Al publicar 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, cuando el componente se utilice en un proyecto, las rutas que incluyen variables de entorno se interpretan como rutas relativas a la carpeta de la biblioteca. Como solución, utiliza el método Environment.GetEnvironmentVariable o una actividad Obtener carpeta de entorno para recuperar la ruta de la carpeta, y luego utiliza la salida para crear una ruta absoluta por la que pase el componente reutilizable.
• Si un archivo de flujo de trabajo dentro de una carpeta y en una biblioteca se utiliza como espacio de nombres en un proyecto, cambiar el nombre de la carpeta, republicar e instalar la biblioteca actualizada en el proyecto da lugar a actividades desconocidas.

Añadir componentes reutilizables a proyectos de automatización

1. Abre o crea un proyecto nuevo.
2. En la categoría Todos los paquetes, elige la fuente en la que se guarda la biblioteca e instala el paquete.
3. Selecciona Aceptar y el paquete se añade a la definición del proyecto.
4. La actividad se encuentra en la categoría personalizada del panel Actividades.

Consideraciones al instalar bibliotecas en proyectos

• Las bibliotecas solo se pueden instalar en proyectos que tengan la misma compatibilidad.
• Si una biblioteca multiplataforma contiene un flujo de trabajo con actividades de Automatización de IU, añadir la actividad generada en un proyecto multiplataforma da lugar a un error de validación cuando se ejecuta el proyecto.
• 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.