Paquetes y bibliotecas

Paquetes NuGet utilizados por UiPath Robot: fuentes predeterminadas, fuentes locales y de Orchestrator, comportamiento de almacenamiento en caché de paquetes y configuración de fuentes en Studio.

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 por defecto si tu Robot está conectado a Orchestrator y no se pueden desactivar. La opción Tenant de Orchestrator está disponible si la fuente de bibliotecas del tenant está habilitada en Orchestrator. Las fuentes tienen el siguiente origen: https://[Orchestrator_host]/nuget/activities.

• Local - The feed for the packages installed locally with Studio. When Studio of the same version is installed side by side with the Robot, the feed is the Packages folder of Studio, %ProgramFiles%\UiPathPlatform\Studio\<version>\Packages for per-machine installations or %LocalAppData%\Programs\UiPathPlatform\Studio\<version>\Packages for per-user installations. Otherwise, it's the Packages folder in the Robot installation folder, which might not exist.

  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 en línea de UiPath, donde puedes buscar los paquetes de actividades que son compatibles de forma oficial. Esta fuente tiene el siguiente origen: https://pkgs.uipath.com/official/index.json.

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

  Nota:

  Si los paquetes los construye y admite oficialmente UiPath se indica específicamente en la ventana Gestionar paquetes, pestaña de información del paquete.

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

Fuentes personalizadas

In Enterprise installations, a custom activity feed can only be used in workflows started from Studio on that user. Starting a job on the same machine from Orchestrator or the Assistant results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, add the custom feed to the NuGet.config file of the Robot. For the steps, refer to Configuring activity feeds.

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 runtime Versión aplicable más baja, el 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 la 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" />
  

The UiPath Platform Installer adds two feeds to the NuGet.config file in the Robot installation folder: the Local feed, and the Executors feed, which holds the executor packages for agents, functions, and API workflows. Both are enabled by default.

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.

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

  https://pkgs.uipath.com/official/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.