Gestionar paquetes de actividades

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

• application level - feeds are configured from the Settings > Manage Sources tab
• 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 del tenant está habilitada en Orchestrator. Las fuentes tienen el siguiente origen: https://[Orchestrator_host]/nuget/activities.

• Local - The feed can be excluded when installing Studio with the .msi installer. If you choose not to install the local activities feed, the folder is still created but contains only the default activities, UiPath.UIAutomation.Activities, UiPath.System.Activities, UiPath.Excel.Activities and UiPath.Mail.Activities, together with dependencies previously set to a project. If installed, the feed has the following source: %ProgramFiles(x86)%\UiPath\Studio\Packages. Check out the list of default activities packages here.

• Oficial: la fuente oficial en línea de UiPath, en la que puedes encontrar los paquetes de actividad oficialmente admitidos por nosotros. Esta fuente tiene el siguiente origen: https://www.myget.org/F/workflow/.

• 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 Gestionar paquetes, pestaña Información de paquetes. Esta fuente tiene el siguiente origen: https://gallery.uipath.com/api/v2.

  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 fuente persiste al actualizar a una versión de Studio posterior.

Feed management and configuration is available in the Manage Packages window if a governance policy was not enforced. If such a policy is enforced and contains restricted rights regarding feed management, then a message is displayed in the window. Read more about Governance.

Añadir fuentes personalizadas

Nota:

En las instalaciones Enterprise solo se puede usar una fuente de actividad personalizada en flujos de trabajo iniciados desde Studio en ese usuario. Si se inicia un trabajo en la misma máquina desde Orchestrator o el agente (bandeja del Robot), el Robot no podrá 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 a continuación.

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, el Administrador de 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 Administrar 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 botón. La fuente se elimina de la categoría Todos los paquetes y de la sección Orígenes de paquetes definidos por el 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 versión para los paquetes de actividades no son visibles en la ventana Administrar paquetes debido a una limitación NuGet.

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

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. Click on the drop-down list next to Version to pick a version of the package, and then set a Runtime Rule. To read more about runtime rules for project dependencies check the Managing Dependencies page.

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 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:

   La instalación de un paquete de actividades no se completará si la ruta se corrompe. 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 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:

• During installation, by installing from the command line with the option 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 (x86)\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>