Administrar Dependencias

Las dependencias del proyecto en Studio se refieren a los paquetes vinculados a un proyecto específico que contienen actividades, ya sean predeterminadas o personalizadas. Las dependencias son contextuales y tienen en cuenta la definición de cada proyecto, incluyendo las actividades que usas, variables, argumentos de entrada y de salida. Por tanto, la dependencia se establece solo si tiene al menos una referencia en la definición del proyecto.

Las dependencias predeterminadas para un proyecto difieren según el tipo de proyecto, la compatibilidad o la plantilla usada para crearlo.

Si tienes que añadir más, haz clic en el botón Gestionar paquetes e instálalas. Las dependencias instaladas solo están disponibles para el proyecto actual, y la lista de dependencias por proyecto puede verse en el archivo project.json.

El panel Proyecto muestra los paquetes de actividades que están instalados en el proyecto de automatización, junto con sus subdependencias, sus reglas de tiempo de ejecución y sus versiones solicitadas y resueltas. La compatibilidad del proyecto se muestra en el nodo Dependencias.

Mantén el puntero sobre una dependencia para ver las versiones solicitadas y resueltas. Las acciones contextuales como Gestionar, Reparar o Eliminar dependencia solo están disponibles para las dependencias y no para sus subpaquetes.

El estado de las dependencias en el árbol está codificado por color de la siguiente manera:

• Rojo: no se encontró la dependencia.
• Anaranjado: no se encontró un subpaquete.
• Gris: la dependencia no está resuelta.
• Azul desvaído: la versión resuelta es mayor que la versión solicitada.
• Azul intenso: hay una coincidencia exacta entre la versión solicitada y la versión resuelta.

Añadir y actualizar dependencias

Para añadir dependencias a un proyecto, instálalas desde la ventana Gestionar paquetes.Ten en cuenta que los paquetes disponibles difieren en función de la compatibilidad del proyecto.También puedes instalar un paquete añadiendo una de las actividades que contiene a un proyecto de la categoría Disponible del panel de Actividades o la barra de búsqueda Añadir Actividad.

Whenever new versions are available for the current project dependencies, the Manage Packages button from the ribbon gets an update icon .

1. To manage dependencies in a project, simply right-click on the Dependencies category in the Project panel, and then click on Manage. This opens the Manage Packages window, with the Project Dependencies category. The icon shows which packages are currently installed.

   

2. Default dependencies are displayed, together with the versions that are currently linked to the project. To update a package, simply click on the update icon , next to the available version number. The icon is shown next to the package, meaning that dependencies are ready to be installed.

3. Las dependencias se instalan en el proyecto solo después de hacer clic en Guardar. De forma simultánea, las versiones de las dependencias se actualizan en el archivo project.json perteneciente al proyecto.

Eliminar dependencias

• Para eliminar una dependencia del proyecto, haz clic derecho en el panel del Proyecto, y luego selecciona Eliminar dependencia. La dependencia se eliminará del panel del Proyecto y del archivo project.json. También puedes ir a Administrar paquetes > Dependencias del proyecto, seleccionar la dependencia que quieras eliminar y luego hacer clic en Desinstalar.
• Para eliminar todas las dependencias no utilizadas en el proyecto, selecciona Eliminar no utilizadas > Dependencias en la cinta de Studio, o usa el atajo Ctrl + Shift + R. Todos los paquetes instalados que no tienen referencias en el proyecto actual se eliminan del panel del Proyecto y del archivo project.json.

Reparar dependencias

Si un flujo de trabajo abierto en Studio tiene referencias a paquetes con versiones que no están disponibles en las fuentes de Studio actuales, dichas dependencias se marcan como dañadas en el panel Proyecto y los detalles se ofrecen en el panel Salida.

Studio permite reparar todas las dependencias en bloque o de forma individual. Para reparar todas las dependencias dañadas, haz clic derecho en el nodo Dependencia del panel Proyecto, y haz clic en Reparar dependencias.

Haz clic derecho en una dependencia dañada y selecciona Resolver dependencia para repararla de forma individual. También puedes seleccionar Gestionar para abrir la ventana Gestionar paquetes y actualizar los paquetes.

NuGet resolves broken dependencies by applying the Lowest Applicable Version runtime rule, meaning that it searches for the first applicable package version, higher than the one previously set.

Nota:

Las actividades pendientes o inválidas se marcan en el panel Diseñador, mientras que un anuncio de error proporciona información adicional sobre el flujo de trabajo y sus conflictos de dependencias sin resolver.

Configurar reglas de dependencias

Los paquetes de actividades están disponibles en múltiples versiones, razón por la que tras instalarlos o actualizarlos usando la opción Gestionar paquetes, puedes configurar reglas de tiempo de ejecución de dependencias para cada una de ellas.

La Regla de tiempo de ejecución especifica qué versión del paquete hay que instalar en el tiempo de ejecución. Cuenta con dos opciones.

The Strict runtime rule is the default state for dependencies added upon process creation, and for activities packages installed from the Manage Packages window. It means that only the specified version of the package is used at runtime to execute the parent process. The Strict rule is marked in the Project panel, under Dependencies by the sign next to the package version.

The Lowest Applicable Version runtime rule means that if the target package isn’t found, the next higher version is searched in order to resolve dependencies. The Lowest Applicable Version rule is marked in the Project panel, under Dependencies by the sign next to the package version.

Al ejecutar un proyecto de automatización desde Studio, el Robot descarga la versión del paquete especificada o indicada que necesita para ejecutar el proyecto de acuerdo con las reglas de tiempo de ejecución establecidas previamente para cada paquete. Si la dependencia utilizada durante la ejecución tiene una regla de tiempo de ejecución Estricto y no se encuentra la versión del paquete exacta, aparece un error. Para obtener más información sobre el establecimiento de reglas de tiempo de ejecución para dependencias de proyectos, consulta la página Gestionar dependencias.

Resolver conflictos de dependencias

La instalación de paquetes de actividades tiene en cuenta las reglas de tiempo de ejecución de las dependencias configuradas previamente para esos paquetes, pero podrían generarse algunos conflictos entre versiones al automatizar los proyectos. Tanto el proyecto de automatización como la biblioteca que contiene podrían tener el mismo paquete de actividades, pero con versiones y reglas de tiempo de ejecución diferentes. En el momento del diseño, NuGet resuelve estos conflictos eligiendo la dependencia de nivel superior, que es la más cercana al proyecto en la jerarquía.

A continuación se explica cómo resolver los conflictos que podrían generarse:

El proyecto contiene un paquete de actividades con la versión 1.0. La biblioteca hace referencia al proyecto y utiliza el mismo paquete, pero con una versión posterior. La dependencia de nivel superior v1.0 se usa en el tiempo de ejecución. Aparece un aviso que indica que se detectó un cambio a una versión anterior.

The resolution of this scenario is applicable regardless of the runtime rule (Strict or Lowest Applicable Version ) previously set for the activities packages.

• Si eliges Sí, el paquete de actividades referenciado en el proyecto se actualiza a la versión utilizada en la biblioteca.

• Si eliges la opción No, se abre la ventana Gestionar paquetes con la ventana Dependencias del proyecto.

  

The project contains an activities package with the version 2.0. The library uses the same pack, but with a lower version and the Strict runtime rule. The top level dependency used in this case is v2.0 and a warning is given when the package is installed in the project.

The project contains an activities package with the version 2.0. The library uses the same pack, but with a lower version and the Lowest Applicable Version runtime rule. The top level dependency used in this case is v2.0 and a warning is given when the package is installed in the project.

The project references a library with an activities package version 1.0 and Strict runtime rule. The project references another library, but with an activities package version 2.0. The top level dependency in this case is the pack with v2.0, since it has the highest version. A warning is given when the activities package is installed.

In this conflict the project references two libraries, which in turn have Strict dependencies referenced among them. This scenario isn't supported. For detailed information, check the Dependency Resolution page.

Los ciclos de dependencias son tipos de conflictos que se generan cuando un paquete hace referencia a sí mismo. Si llamas a tu proyecto UiPath, Studio detecta un conflicto de dependencias. Esto ocurre porque el paquete UiPath ya existe y es una dependencia para UiPath.UIAutomation.Activities. Se recomienda evitar asignar al proyecto el nombre de un paquete ya existente que intentas añadir como una dependencia.

El mismo ciclo de dependencias se produce si abres un archivo .xaml desde una carpeta llamada UiPath o cualquier nombre de un paquete ya existente que intentas añadir como una dependencia y no hay project.json en esa carpeta. Cuando abres un archivo .xaml que no tiene un archivo project.json asociado, Studio crea uno y la etiqueta "name" se rellena con el nombre de la carpeta principal.

Abrir proyectos creados con versiones anteriores

Importante:

No es posible abrir proyectos creados con la versión de Studio v2016.2 directamente en la versión v2020.4 o superior. Primero abre estos proyectos con la versión v2018.4 de Studio y luego con la 2020.4 o superior.

Al abrir un proyecto con o sin dependencias, diseñado con una versión anterior a v2018.3 (excepto para v2016.2). Studio te pregunta si se realizará una migración automática, para tratar de recuperar las dependencias que faltan o añadir las predeterminadas.

Upon confirmation, Studio attempts to retrieve missing dependencies and sets the Strict runtime rule for the packages that it finds. When using the Repair Dependency option in the Project panel, Studio attempts to install the next best package version. If the package version is not found, alerts are shown in the Output panel and you should check the configured feeds in the Manage Packages window.

Processes containing dependencies and that were built with Studio versions prior to v2018.3 continue to execute with Robot v2018.3. The runtime rule for such projects is set to Lowest Applicable Version.

Projects created with versions prior to v2018.3 that were never published don't have dependencies listed in the project.json file. When opening such projects, an alert in the Output panel notifies you of missing dependencies. UiPath packages delivered locally with Studio are added as dependencies with the Strict runtime rule. The latest version of such packages is automatically set.

Si dichos proyectos contienen paquetes distintos a los entregados con Studio de forma local, recomendamos:

• Publicar el proyecto utilizando la versión de Studio en la que se creó, lo que ayuda al proceso de migración al añadir dependencias en el archivo project.json;
• Instalar manualmente el paquete que falta desde la ventana Gestionar paquetes, después de configurar la fuente necesaria;
• Usar la herramienta Actualización masiva de dependencias del proyecto para añadir la dependencia que falta a un volumen de proyectos.
  Nota:

  Los flujos de trabajo que contienen actividades inválidas no se pueden guardar. Instala la dependencia necesaria y, a continuación, guarda el proyecto.

Los paquetes de actividades UiPath.V7.Activities, UiPath.Platform.Activities y UiPath.Framework.Activities están obsoletos. Al abrir proyectos con paquetes UiPath.Platform.Activities y UiPath.Framework.Activities, la versión de Studio v.2018.3 o posterior intenta realizar una migración automática para reemplazar las versiones antiguas de actividades por unas nuevas.

Nota:

Los flujos de trabajo que contienen actividades que forman parte del paquete UiPath.V7.Activities no pueden migrarse.

Existe una solución para casos en los que la migración no se realiza de forma automática.

1. Abre el archivo project.json con Notepad++.
2. Elimina el parámetro "schemaVersion": "3.2".
3. Sustituye "studioVersion" por "toolVersion".
4. Cambia el valor "toolVersion" de "18.3.xxx" a una versión anterior. Por ejemplo, cambia el valor de "18.3.0.958" a "18.2.958". Guarda el archivo.
5. Abre el archivo .xaml con la versión de Studio v2018.3 o posterior para que se realice la migración. Los paquetes de actividades obsoletos se sustituyen por otros nuevos, tal y como se ilustra en la sección Dependencias del panel Proyecto.
   Nota:

   En algunos casos, los archivos .xaml que contienen los paquetes UiPath.Platform.Activities y UiPath.Framework.Activities no se pueden migrar de forma automática y la solución no es aplicable. En estas situaciones, se recomienda abrir el proyecto en Studio v.2018.2 o anterior y sustituir las actividades pertenecientes a los paquetes mencionados por actividades contenidas en el paquete UiPath.Core.Activities. Se puede hacer lo mismo para los flujos de trabajo que contienen actividades del paquete UiPath.V7.Activities.

A partir de Studio v2018.4.1, Microsoft.Activities v.1.0.1 y Microsoft.Activities.Extensions v2.0.6.9 ya no están empaquetadas en el instalador UiPathStudio.msi.

En caso de que sea necesario reparar al migrar proyectos que contienen estos paquetes como dependencias, instala los dos paquetes desde la fuente Oficial o la fuente local. Antes de ejecutar dichos proyectos creados con versiones anteriores a v2018.4.1, comprueba que los paquetes mencionados estén disponibles en una fuente a la que el Robot pueda acceder.

Si te actualizas desde una versión anterior a v2018.4.1, los dos paquetes de actividades permanecen en la fuente Local.