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 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 de inquilino está habilitada en Orchestrator. Las fuentes tienen el siguiente origen: https://[Orchestrator_host]/nuget/activities.
• Local: la fuente de los paquetes instalados de forma local con Studio. La fuente tiene el origen: %ProgramFiles%\UiPath\Studio\Packages para instalaciones por máquina o %localappdata%\Programs\UiPath\Studio\Packages para 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 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.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
• Marketplace: esta fuente pública contiene todas las actividades publicadas en UiPath Marketplace. Ten en cuenta que si los paquetes están o no creados y admitidos oficialmente por UiPath se señala específicamente en la ventana Administrar paquetes, pestaña Información de paquetes. 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.

• En la regla de tiempo de ejecución Versión aplicable más baja, el Robot busca la versión especificada o posterior del paquete. 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.

If a feed lacks signed packages and dependencies, the automation might fail. This is because the Robot expects all packages and dependencies to be signed. To prevent this, ensure that all configured feeds contain only signed packages and dependencies.

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 actividades oficialmente compatibles 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.