Acerca de las bibliotecas

A library is a project which contains one or more workflows that can be reused as activities in other projects. Libraries are saved as NUPKG files when published and can be installed as dependencies from the Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

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 y selecciona la opción 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.

1. 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 deseas convertir en privado un archivo concreto, haz clic derecho y selecciona Ignorar desde la publicación. 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.

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

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.
• Incluir orígenes: establece en Sí para empaquetar todos los orígenes .xaml dentro del archivo de ensamblado generado, incluidos los flujos de trabajo que se hicieron privados con anterioridad. Si lo necesitas, puedes descompilar el archivo de ensamblado y extraer los flujos de trabajo, ya que puede serte útil en el momento de la depuración.
• 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.
• Ready to Run - set to Yes to optimize the generated assemblies for faster JIT compilation at runtime.
• Modern Design Experience - set to Yes to enable a modern experience of working with UI Automation, including new and improved activities, recorders, and wizards, as well as the Object Repository.

Publicar una biblioteca

Publishing libraries is similar to publishing processes. For more information, see About Publishing Automation Projects.

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.
• Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
• 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.
• La actividad Iniciar flujo de trabajo interactivo no es compatible con las bibliotecas.
• No se admite el uso de Invocar archivo de flujo de trabajo dentro de una biblioteca para hacer referencia a la propia biblioteca.

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.

   Nota:

   • Las Bibliotecas solo son compatibles con versiones posteriores, lo que significa que solo se pueden usar con proyectos creados con Studio v2018.3 y versiones posteriores. Las bibliotecas no se pueden publicar en versiones de Orchestrator anteriores a 2018.3.
   • 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.

Ten en cuenta que en un proyecto de biblioteca, al usar la opción Importar flujos de trabajo para añadir un flujo de trabajo que contiene una biblioteca, las dependencias referenciadas en la biblioteca no se importan.

Al importar dos versiones de la misma biblioteca personalizada en un proyecto de Studio, las actividades personalizadas adicionales contenidas solamente en la segunda biblioteca no pueden verse en el panel Actividades, a menos que elimines la primera biblioteca importada.