Gestionar paquetes de actividades

Studio usa fuentes de NuGet para instalar paquetes de actividad. Estas fuentes se pueden manejar de dos formas en Studio:

• nivel de aplicación: las fuentes se configuran desde la pestaña Configuración > Administrar fuentes;
• nivel de proyecto: las fuentes se configuran desde el botón Administrar paquetes en la cinta.

Para deshabilitar una fuente de actividades, debes borrar su casilla de verificación correspondiente. Habilitar o deshabilitar una fuente es aplicable tanto en el nivel de proyecto como en el de aplicación.

Las siguientes 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 de UiPath^® en línea, donde puede encontrar los paquetes de actividades que oficialmente admitimos. 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. 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.

  Ten en cuenta que UiPath no tiene ningún control sobre la eliminación de los paquetes creados por los socios o la comunidad de Marketplace. Sin embargo, UiPath mantiene paquetes no enumerados activos para garantizar la retrocompatibilidad con fines de tiempo de ejecución.

  
  

  

  
  
  Nota: La configuración de la fuente persiste tras actualizar a una versión posterior de Studio.

Otras fuentes pueden añadirse por separado, como:

• Sector público: esta fuente es específica para Automation Cloud para el sector público y está alojada en los Estados Unidos. Esta fuente tiene el siguiente origen: https://govcloud.uipath.us/nuget/v3/_shared/libraries/index.json.

La gestión y configuración de fuentes está disponible en la ventana Administrar paquetes si no se cumple una política de gobernanza. Si se aplica dicha política y contiene derechos restringidos sobre la administración de fuentes, se mostrará un mensaje en la ventana. Más información acerca de Control.

Añadir fuentes personalizadas

Nota: En 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 dichos escenarios, debes añadir la fuente personalizada en el archivo UiPath.settings bajo la propiedad ActivitiesFeed en lugar de usar el método siguiente.

1. En la ventana Administrar paquetes, haz clic en la Configuración. Se mostrarán las fuentes del paquete.
   
   

   

   
   
2. Haz clic en el botón para añadir una fuente a la categoría Fuentes de paquetes definidos de usuario.
3. Rellena el nombre del código o el nombre de la fuente NuGet.
4. En el campo Origen, escribe la ruta de la carpeta de unidad local, la ruta de carpeta de red compartida o la URL de la fuente NuGet.
5. Haz clic en Añadir. La nueva fuente se añade automáticamente entre Fuente de los paquetes definidos por el usuario y en la categoría Todos los paquetes de la ventana Administrar paquetes. La fuente está habilitada de forma predeterminada.
6. Haz clic en Guardar para aplicar todos los cambios.

El origen del paquete definido por el usuario y por defecto puede habilitarse o deshabilitarse en la ventana Administrar paquetes.

Ten en cuenta que las fuentes se agregan al momento. Hacer clic en el botón Cerrar o Cancelar después de agregar una fuente no revierte los cambios.

Nota: Si la fuente personalizada contiene un paquete corrupto o que está siendo modificado en un editor, Gestionar paquetes no podrá cargar ningún paquete en la fuente.

Añadir fuentes seguras

Si quieres añadir una fuente NuGet personalizada que requiere autenticación, puedes seguir los pasos explicados aquí.

Debes añadir la fuente de NuGet, el nombre de usuario y la contraseña en el archivo NuGet.config, ubicado en la siguiente ruta: %AppData%\NuGet. Cuando finaliza, la fuente debe ser visible en la ventana Administrar paquetes.

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

Ten en cuenta que key="ClearTextPassword" debe sustituir key="Password" cuando se usen las contraseñas no cifradas.

Eliminar fuentes personalizadas

Nota: Solo se pueden eliminar las Fuentes definidas por el usuario desde la ventana Gestionar paquetes.

1. En la categoría Configuración, haz clic en cualquiera de las fuentes bajo la sección Fuentes de paquete definidas por usuario.
2. Pulsa el botón Eliminar. La fuente se elimina de la categoría Todos los paquetes y la sección Fuentes de paquete definidas por usuario.
3. Haz clic en Guardar para aplicar los cambios.

Ten en cuenta que las fuentes se eliminan al momento. Hacer clic en el botón Cerrar o Cancelar después de eliminar fuentes predeterminadas o personalizadas no revierte los cambios.

Conectar a fuentes mediante un servidor proxy

Si tu ordenador está detrás de un servidor proxy debes ajustar la configuración de proxy NuGet para tener acceso a las fuentes ubicadas fuera de tu red:

1. Descarga nuget.exe desde https://www.nuget.org/downloads.
2. Abre una ventana del símbolo de sistema en la carpeta en la que se haya descargado nuget.exe y ejecuta los siguientes comandos para configurar la dirección, nombre de usuario y la contraseña para el servidor proxy:

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. Comprueba que el archivo NuGet.config ubicado en %AppData%\NuGet ha sido actualizado con la nueva configuración:

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>

4. Reinicia Studio.

Gestionar paquetes

La funcionalidad del administrador de paquetes te permite descargar paquetes de actividades, bibliotecas, marcos, wrappers y otros, ver los ya instalados para tu proyecto y actualizarlos, así como añadir y eliminar los tuyos propios. Muestra la lista de paquetes disponibles por fuente y la lista de dependencias por proyecto actual. La ventana Administrar paquetes siempre se abre con la lista Dependencias del proyecto.

Un paquete de actividad es un paquete que puede ayudarte a automatizar una determinada aplicación (UiPath.Excel.Activities, UiPath.Word.Activities) o una categoría de aplicaciones (UiPath.Mail.Activities, UiPath.Terminal.Activities), o usar ciertas tecnologías en tus automatizaciones (UiPath.OCR.Activities, UiPath.FTP.Activities).

Se muestra más información sobre los paquetes y bibliotecas en el panel derecho de la ventana Administrar paquetes, como puedes ver en la captura de pantalla anterior.

Nota: Las notas de la versión para paquetes de actividades no es visible en la ventana Gestionar paquetes debido a una limitación de NuGet v3.

La casilla de verificación Incluir versión preliminar que se encuentra junto a la barra de búsqueda muestra las versiones beta de los paquetes de bibliotecas, si están disponibles, al seleccionarlos.

Marca la casilla Incluir versión previa si las descripciones de las dependencias del proyecto no son visibles en la ventana Gestionar paquetes.

Nota: Los paquetes UiPath.UIAutomation.Activities y UiPath.System.Activities son compatibles con Studio v2018.3 y posterior.

Instalando paquetes

Nota: Es necesaria una conexión a Internet para descargar e instalar paquetes de actividades.

Nota: Si tu organización utiliza la firma forzada de paquetes, deberás añadir certificados de confianza para UiPath con el fin de poder instalar paquetes oficiales. Puedes obtener más información sobre este tema aquí.

1. En la ventana Administrar paquetes, selecciona la categoría Todos los paquetes. Esto abre una lista de todos las paquetes recopilados desde tus fuentes.
   
   

   

   
   
2. Localiza el paquete que quieres instalar. Ten en cuenta que los paquetes de actividades y versiones que estén disponibles dependen de la compatibilidad seleccionada para el proyecto.

   Puedes:

   • Desplázate por la lista para encontrar el paquete.
   • Escribe parte del nombre o de la descripción del paquete en la barra de búsqueda.

   • Filtra la lista haciendo clic en el icono Filtrar junto a la barra de búsqueda y selecciona solo las opciones que quieres ver:

     • Incluir versión: incluye versiones beta de paquetes cuando sea posible.
     • Solo para StudioX: muestra solo los paquetes diseñados para StudioX. (esta opción solo está disponible en el perfil de StudioX)
     • Solo UiPath: enumera solo los paquetes publicados por UiPath.
     • Solo actividades: enumera paquetes de actividades.
     • Solo bibliotecas: enumerar solo bibliotecas.
     • Solo bibliotecas de UI: enumera solo Bibliotecas de IU publicadas desde el Repositorio de objetos.
     • Solo compatible: enumera solo paquetes cuya versión más reciente es compatible con la compatibilidad del proyecto. No selecciones esta opción si quieres ver paquetes con versiones anteriores que son compatibles con la compatibilidad del proyecto.
3. Selecciona un paquete de actividades para ver su descripción, versión, dependencias, la URL de proyecto y la fecha de publicación.
4. Haz clic en la lista desplegable que se encuentra junto a Versión para seleccionar una versión del paquete y luego establece una Regla de tiempo de ejecución. Para obtener más información sobre las reglas del runtime para dependencias del proyecto, consulta la página Administrar dependencias.
5. Haz clic en el botón Instalar. También puedes hacer clic en el icono junto al nombre del paquete y marcarlo con el icono para indicar que está lista para su instalación.
6. La ventana Aceptar licencia muestra los términos para cada paquete de terceros que quieres instalar. Haz clic en Ver licencia para leer los términos de licencia.
   • Haz clic en Aceptar para aceptar los términos de licencia e instalar los paquetes.

   • Haz clic en Rechazar para cancelar la instalación y volver a la ventana Administrar paquetes.

     Nota: Los términos y condiciones para los paquetes de UiPath y sus dependencias se aceptan implícitamente al instalar Studio. Consulta los Términos de uso y la Política de privacidad de UiPath.
7. Haz clic en Guardar para instalar los paquetes o actualiza las versiones.
   Nota: Si durante la instalación de un paquete de actividades se daña la ruta, la instalación no se completará. Se recomienda realizar una copia de seguridad y borrar el contenido de las siguientes carpetas locales %userprofile%\.nuget\packages y %userprofile%\AppData\Local\UiPath\.cache.

Desinstalar paquetes

Para desinstalar paquetes, ve a la categoría Dependencias del proyecto y haz clic en el botón Desinstalar junto al paquete que ya no deseas utilizar. El paquete se elimina solo después de hacer clic en Guardar.

Al ejecutar un proyecto de automatización, el botón Administrar paquetes quedará deshabilitado, lo que significa que los paquetes de actividad no se pueden instalar o eliminar hasta que se haya detenido la ejecución.

Degradación de paquetes

No se recomienda degradar los paquetes de actividades. La razón principal son los efectos negativos que puede tener en las dependencias. Las dependencias entre diferentes paquetes de actividades se gestionan cuidadosamente en cada versión. Por lo tanto, la degradación puede causar inconsistencias o incluso flujos de trabajo disfuncionales. Además, los paquetes de actividades más nuevos ofrecen características y funcionalidades mejoradas que pueden no estar disponibles en versiones anteriores. Por lo tanto, para garantizar un rendimiento óptimo y evitar errores potenciales, es aconsejable mantener los paquetes de actividades en sus versiones actuales o actualizar a las últimas versiones.

Cambiar la carpeta de descarga para paquetes

Por defecto, los paquetes de actividades se descargan y se instalan en la carpeta %userprofile%\.nuget\packages. Puedes establecer una carpeta diferente de estas formas:

• Durante la instalación, instalando desde la línea de comandos con la opción PACKAGES_FOLDER.
• Después de la instalación, editando el archivo uipath.config:
  1. Abre el archivo uipath.config en un editor de texto. Por defecto, el archivo está ubicado en C:\Program Files\UiPath\Studio.
  2. En el nodo packageSettings, añade la clave packagesInstallationFolder con la ruta a la nueva carpeta como valor.

  3. Guarda los cambios y, si el Robot está instalado como servicio, reinicia el servicio.

     Por ejemplo, añade lo siguiente a uipath.config para cambiar la ubicación de descarga a C:\nuget.

     <packageSettings>
       <add key="packagesInstallationFolder" value="C:\Nuget" />
     </packageSettings>

Nota: eliminar el contenido de la carpeta .nuget causa conflictos de dependencia al abrir un proyecto en Studio.

Gestionar paquetes en entornos sin conexión

Cuando utilizas Studio en un ordenador que no esté conectado a Internet, puedes descargar paquetes en otro ordenador y transferirlos manualmente al ordenador donde esté instalado Studio. Esto solo es necesario si la conectividad de Orchestrator no está disponible. Cuando Studio está conectado a Orchestrator, los paquetes pueden instalarse desde fuentes de Orchestrator.

Nota: para evitar que Studio intente descargar paquetes de fuentes en línea, deshabilita todas las fuentes en línea en máquinas sin conexión.

Para instalar un paquete en una máquina Studio sin conexión:

1. En un ordenador con acceso a Internet, descarga e instala NuGet Package Explorer.
2. Abre NuGet Package Explorer y selecciona Abrir un paquete desde una fuente en línea.
3. En el campo Origen del paquete introduce la URL de la fuente de la que descargar el paquete. La fuente oficial de paquetes UiPath es https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json.
4. Localiza el paquete en la fuente y descárgala.
5. Transfiere el archivo NUPKG al ordenador con Studio en una carpeta definida como origen de paquetes en Studio. Para añadir el paquete a la fuente local predeterminada, copia el archivo a %ProgramFiles%\UiPath\Studio\Packages para las instalaciones por máquina o %localappdata%\Programs\UiPath\Studio\Packages para las instalaciones por usuario.

Utilizar el archivo con paquetes opcionales

Para reducir el tamaño del instalador de Studio, algunos paquetes de actividades ya no se incluyen en el archivo UiPathStudio.msi a partir de la versión 2022.10. Para facilitarle las cosas a los usuarios que trabajan en entornos con cortafuegos o que siempre guardan los paquetes que necesitan en el almacenamiento local, en el Customer Portal puedes descargar un archivo ZIP con los paquetes que ya no están incluidos en el instalador y sus dependencias, lo que permite colocar los paquetes en máquinas Studio o Robot.

El archivo contiene las últimas versiones de los siguientes paquetes:

• UiPath.MobileAutomation.Activities
• UiPath.Terminal.Activities
• UiPath.Persistence.Activities
• UiPath.PDF.Activities

Para añadir los paquetes a la carpeta de fuente local:

1. Descarga el archivo ZIP del Customer Portal de UiPath.
2. Coloca el archivo en una ubicación accesible desde la máquina de Studio o Robot.

3. Añade los paquetes de una de las siguientes maneras:

• Durante la instalación: antes de iniciar la instalación, coloca el archivo comprimido en la misma carpeta raíz que el instalador MSI de Studio. El instalador añade los paquetes a la carpeta de fuente local.
• Tras la instalación: extrae el contenido del archivo en la carpeta de paquetes locales, por defecto:
  • %localappdata%\Programs\UiPath\Studio\Packages para instalaciones por usuario.
  • %ProgramFiles%\UiPath\Studio\Packages para instalaciones por máquina.