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, 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 las nuevas bibliotecas son las mismas que las de los proyectos nuevos con la regla de runtime de la Versión más baja aplicable.

Extraer un proyecto como biblioteca

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.

1. Abrir un proyecto en Studio.

2. En el panel Proyecto, haz clic derecho en el nodo de proceso y a continuación selecciona Extraer como biblioteca.

   

3. Configura las siguientes Opciones de extracción:

   • Include Test Cases: By default, this option is enabled for a Process project and disabled for a Test Automation project. You should enable this option if you want to include test cases as part of the extracted library.
   • Publish and install the library: Automatically selected to publish the package to a shared feed and install the library as a project dependency. You can disable this option if you want to create the library without publishing it. If disabled, the remainder options are not available for configuration.
   • Modifica tus flujos de trabajo tras la instalación de paquetes: elige modificar los flujos de trabajo con actividades recopiladas de la biblioteca.

     • Modo de sustitución: elige el método de sustitución del flujo de trabajo.

       • Selecciona Reemplazar el contenido de los flujos de trabajo invocados para cambiar los flujos de trabajo invocados desde el punto de entrada, o los casos de prueba con actividades correspondientes de la biblioteca extraída.

       • Utiliza esta opción si usas las propiedades de las sesiones Aislada y Destino para invocar las actividades de flujo de trabajo a ejecutar en un proceso de Windows separado, y comienza en una sesión diferente, respectivamente.

       • Selecciona Reemplazar actividades de "Invocar flujo de trabajo" para cambiar las actividades de Invocar flujo de trabajo con actividades de la biblioteca extraída.

       • No selecciones esta opción si estás utilizando las propiedades de las sesiones Aislada y Destino para Invocar las actividades de Invocar flujo de trabajo.

     • Eliminar flujos de trabajo reemplazados: borra los flujos de trabajo que han sido reemplazados por las actividades de la biblioteca extraída.

   • Set Execution Templates from library: Add execution templates to the library.

4. Haz clic en Aceptar para confirmar las opciones de la biblioteca.

   

5. Haz clic en Crear para finalizar la creación de la biblioteca.

   

6. (Optional) Publish the library if you've selected Publish and install the library in step 3, and then click Publish.

   

   Nota:

   In case you didn't enable the Publish and install the library option, you'll be prompted to open the library or continue with the current project.

   

   Importante:

   Replacing workflows or invoked activities from the extracted library will not take place for workflows where mock testing is used.

Configurar el diseño de una actividad

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).

Opciones para bibliotecas Windows y multiplataforma

Selecciona Propiedades de la actividad en el menú a la izquierda e introduce lo siguiente:

• Nombre para mostrar: el nombre de la actividad que se muestra en el panel Actividades. El nombre para mostrar no debe cambiarse al utilizar la biblioteca en un proyecto.
• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.
• SVG Icon - The SVG icon to display next to the activity name.
• Color - The highlight color displayed for the activity in the Designer panel.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • Input Type - The type of input for the property. You can use the default input for the property type or select an input option depending on the type:
    • Boolean: Alternancia (predeterminado). Creador de condiciones, Botón de radio.
    • Numérica (int, double, decimal, long, short, sbyte, byte, ulong, ushort, unit, float): editor de números.
    • String: compositor de texto (predeterminado), compositor de texto enriquecido.
    • String[]: matriz de string.
    • Fecha y hora: selector de fecha y hora.
    • Intervalo de tiempo: selector de duración.
    • Diccionario: creador de diccionarios.
    • Todos los demás tipos: entrada (editor de expresiones).
  • Placeholder - THE Placeholder text to display for the input when no value is selected.
  • 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.

  

Opciones para bibliotecas Windows (heredado)

Select Activity Properties in the left-side menu and enter the following:

• Tooltip - The tooltip that is visible when you hover over the activity in the Activities and Designer panels in projects where the library is installed.
• Help Link - The help link that opens when you select the activity in the Designer panel and press F1 on your keyboard.

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.
  • Tooltip - The tooltip that is visible when you hover over the activity property.
  • 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.

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.

• Automation Hub URL - URL of an Automation Hub idea linked to the project. For more information, see Linking a Project to an Idea in 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.

  After the project is published, the icon is displayed next to the package in the Manage Packages window in 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.

• 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 utilizar bibliotecas

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 con Windows: heredado no se pueden publicar si contienen 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.

• 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.

• 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 flujo de trabajo archivo dentro de 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.

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

• Libraries with the cross-platform compatibility can be installed in cross-platform and Windows projects. Windows - Legacy and Windows libraries can only be installed in processes that have the same compatibility.

• 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.

• Cuando se utilizan actividades personalizadas de una biblioteca, cualquier valor predeterminado definido para los argumentos se completa automáticamente en el panel de propiedades de la actividad cuando la actividad se añade al flujo de trabajo. Si borras el valor de un campo de propiedad en el flujo de trabajo, el valor predeterminado correspondiente no se utiliza en el runtime. En este caso, se pasa explícitamente un valor vacío.

  Por el contrario, cuando se utiliza la actividad Invocar flujo de trabajo, dejar una entrada en blanco en el panel Importar argumentos da como resultado que el valor predeterminado definido en el flujo de trabajo llamado se utilizará en el runtime.