Paquetes y bibliotecas

Un paquete es un conjunto que comprende todos los elementos de automatización, como actividades, flujos de trabajo, archivos y datos. Al crear un proyecto en Studio, lo publicas como paquete en una ubicación o fuente específica. Desde ahí, el robot puede descargarlo y utilizarlo para ejecutar la automatización.

Importante:

Utiliza rutas absolutas para indicar la ubicación de los paquetes.

Fuentes predeterminadas

Las siguientes ubicaciones y fuentes se configuran de forma predeterminada en Studio:

• Tenant de Orchestrator y Host de Orchestrator : estas fuentes de actividades se añaden de forma predeterminada si tu UiPath Robot está conectado a Orchestrator y no se pueden deshabilitar.

  La opción Tenant de Orchestrator solo está disponible si la fuente de bibliotecas de tenant está habilitada en Orchestrator. Las fuentes tienen el siguiente origen: https://[Orchestrator_host]/nuget/activities.

• Local : la fuente de los paquetes instalados localmente con Studio.

  La fuente tiene el origen: %ProgramFiles%\UiPath\Studio\Packages para instalaciones por máquina o %localappdata%\Programs\UiPath\Studio\Packagepara instalaciones por usuario.

  Nota:

  La fecha de publicación que se muestra en la ventana Gestionar paquetes para los paquetes provenientes de la fuente local es la fecha en la que se creó el instalador de Studio, y no la fecha en la que se publicaron los paquetes.

• Oficial: la fuente oficial de UiPath en línea, donde puedes encontrar los paquetes de actividades que son compatibles oficialmente con nosotros.

  Esta fuente tiene el siguiente origen: https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.

• UiPath Marketplace: esta fuente pública contiene todas las actividades publicadas en UiPath Marketplace.

  Nota:

  Si los paquetes están creados o no y son compatibles oficialmente con UiPath se indica específicamente en la ventana Administrar paquetes , pestaña Información del paquete.

  Esta fuente tiene el siguiente origen: https://gallery.uipath.com/api/v3/index.json.

Fuentes personalizadas

En las instalaciones Enterprise solo se puede usar una fuente de actividad personalizada en flujos de trabajo iniciados desde Studio en ese usuario. Al iniciar un trabajo en la misma máquina desde Orchestrator o el Asistente, el Robot no puede recuperar el paquete correspondiente. Para evitar tales escenarios, añade la fuente personalizada

Importante:

Para usar transmisiones personalizadas, asegúrate de que los robots tengan acceso a la ubicación personalizada.

Fuentes de actividad

Cuando se utilizan varias fuentes, NuGet selecciona la que responda más rápido. Dado que los paquetes de actividades pueden tener varias versiones, el Robot busca una versión basada en las reglas de tiempo de ejecución en Studio, de la siguiente manera:

• Para la regla de tiempo de ejecución estricta, el Robot solo busca la versión del paquete especificada.

  Por ejemplo, si seleccionas la Versión 2.5.0 y estableces la Regla de tiempo de ejecución como estricta, el Robot busca solo la versión 2.5.0. Si no se encuentra, genera un error.

• Para la regla de tiempo de ejecución Versión aplicable más baja , el UiPath Robot busca la versión del paquete especificada o superior.

  Por ejemplo, si seleccionas la Versión 2.5.0 y estableces la Regla de tiempo de ejecución como Versión aplicable más baja, el Robot busca versiones a partir de la 2.5.0 (2.5.0, 2.5.1, 2.5.2, etc.). Si no se encuentra, genera un error.

Si una fuente carece de paquetes y dependencias firmados, la automatización puede generar un error. Esto se debe a que el Robot espera que se firmen todos los paquetes y dependencias. Para evitarlo, asegúrate de que todas las fuentes configuradas contengan solo paquetes y dependencias firmados.

Importante:

• Cada vez que modifiques archivos de configuración, debes reiniciar el mantenimiento de robot de UiPath para que los cambios surtan efecto.
• Para ignorar las fuentes HTTPS desde NuGet.config, añade la siguiente línea en UiPath.config, en <packageSettings>:

<add key="skipHttpConfigurationSources" value="true" >

La siguiente lista resume las fuentes que utiliza el Robot, dependiendo de cómo esté configurada la fuente:

• Si eliges instalar la fuente local se crea la carpeta %ProgramFiles%\UiPath\Studio\Packages. Contiene los paquetes de actividad compatibles de forma oficial con UiPath en el momento de la instalación. La fuente está habilitada de forma predeterminada.
• Si eliges no instalar la fuente local, se crea la carpeta %ProgramFiles%\UiPath\Studio\Packages, sin embargo, solo contiene los paquetes que se añaden como dependencias predeterminadas a un nuevo proyecto:
  • UiPath.UIAutomation.Activities
  • UiPath.System.Activities
  • UiPath.Excel.Activities
  • UiPath.Mail.Activities

Cuando conectas el Robot a Orchestrator, este último proporciona una fuente NuGet. Contiene los paquetes de actividad compatibles de forma oficial con UiPath. Esta fuente está habilitada de forma predeterminada y depende de tu configuración de almacenamiento.

La siguiente lista resume las fuentes que utiliza el Robot, dependiendo de la conexión del Robot a Orchestrator:

• UiPath Robot conectado a Orchestrator

  • Si NuGet.Repository.Type se establece como Legacy, las actividades se guardan en la ubicación ~/NuGetPackages/Activities de forma predeterminada. Este valor es personalizable y se guarda en la máquina de Orchestrator, en el parámetro NuGet.Activities.Path del archivo web.config.
  • Si NuGet.Repository.Type se establece como Composite, las actividades se guardan en la ubicación especificada mediante los parámetros Storage.Type y Storage.Location.
    Importante:

    La opción Composite restringe el uso de comandos copiar y pegar en el directorio de paquetes.

• UiPath Robot no está conectado a Orchestrator

  Cuando el robot no está conectado a Orchestrator o no busca las actividades necesarias en la fuente local, utiliza la siguiente fuente:

  https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
  

Esta es la fuente oficial en línea de UiPath, que es el origen desde el que el gestor de paquetes en Studio recupera sus actividades. De forma predeterminada, esta fuente no está activa. Para habilitarla, en Studio, ve a Configuración > Administrar fuentes y selecciona la opción correspondiente.

Carpetas de paquetes alternativos

Una carpeta de paquetes alternativos es una carpeta de respaldo que el robot puede utilizar para recuperar los paquetes necesarios si falla la fuente principal.

Para configurar esta carpeta, añade la variable de entorno NUGET_FALLBACK_PACKAGES en la máquina del robot. La variable debe contener la lista de rutas completas, cada una separada por un punto y coma, a estas carpetas de copia de seguridad. Si la variable de entorno no existe, el robot intenta leer las carpetas de los paquetes NuGet alternativos del archivo Nuget.config.

Importante:

No se pueden utilizar carpetas alternativas para almacenar y ejecutar automatizaciones o flujos de trabajo completos.

Los procesos implementados en carpetas alternativas no son compatibles, solo las dependencias.