Acerca de la compatibilidad con Windows: heredado

Studio 2021.10 aportó soporte para proyectos basados en .NET e introdujo el concepto de compatibilidad de proyecto basada en el marco de destino. En versiones anteriores a 2021.10, todos los proyectos utilizaban .NET Framework 4.6.1, pero a partir de Studio 2021.10 has tenido la opción de crear proyectos con la compatibilidad Windows (heredado) (.NET Framework 4.6.1) o con las compatibilidades Windows y multiplataforma basadas en .NET.

Los proyectos Windows: heredado no reciben nuevas características

La compatibilidad por defecto para los nuevos proyectos es ahora Windows. Aunque seguimos admitiendo la compatibilidad con Windows: heredado, las nuevas características solo estarán disponibles en proyectos con las compatibilidades de Windows y multiplataforma.

Por ejemplo, las siguientes características introducidas en Studio 2022.10 no están disponibles en proyectos Windows (heredado):

• Soporte para crear variables y constantes globales en Data Manager.
• Nueva experiencia de diseño disponible para proyectos multiplataforma y algunas actividades en proyectos Windows.
• La capacidad de personalizar el diseño de las actividades generadas a partir de bibliotecas.

Cómo continuar creando proyectos de Windows: heredado

Aunque solo puedes crear nuevos proyectos con la compatibilidad de Windows o multiplataforma desde la vista Backstage, las organizaciones pueden seguir utilizando políticas de gobernanza para restaurar la opción de crear proyectos de Windows: heredado configurando el ajuste de marcos de compatibilidad permitidos. Para hacerlo:

1. Navega a Automation Ops™ > Gobernanza.
2. Define una nueva política de gobernanza de Studio. Asegúrate de utilizar la versión 24.10.0 de la plantilla de política de Studio.
3. En la ventana de la política de gobernanza, selecciona la pestaña Diseño y desplázate hasta la sección Estilo de diseño.
4. Habilita la configuración de Marcos de compatibilidad permitidos y selecciona el marco de destino de Windows: heredado.
5. Guarda e implementa la política de gobernanza.

Para obtener más información, consulta Configuración de las políticas de Studio en la guía de Automation Ops.

Como alternativa, puedes configurar el ajuste utilizando el modelo de gobernanza basado en archivos:

1. Genera un archivo de gobernanza JSON desde Studio.
2. Localiza la configuración de AllowedProjectFrameworks dentro del archivo de gobernanza.
3. Establece el valor del parámetro Clásico en Verdadero.
4. Guarda e implementa el archivo de gobernanza.

Para obtener más información, consulta Gobernanza en la guía de Studio.

Para estar al día de los próximos cambios, consulta el calendario de desapariciones.

Cómo editar proyectos existentes de Windows: heredado

En futuras versiones se admitirá la edición, publicación y ejecución de proyectos de Windows: heredado, lo que significa que puedes abrirlos y editarlos como otros proyectos de Windows y multiplataforma.

Cómo convertir proyectos Windows: heredado a compatibilidad de Windows

Importante: Las dependencias para las que no se hayan encontrado versiones con la compatibilidad Windows se marcan como no resueltas y la versión utilizada en el proyecto Windows (heredado) se muestra en panel Proyecto tras la conversión.La mayoría de los paquetes de actividades desarrollados por UiPath que están disponibles en la fuente oficial admiten la compatibilidad Windows. Para obtener una lista completa, consulta la Guías de actividades.

Studio viene con una herramienta de conversión integrada que te permite convertir cualquier proyecto Windows (heredado) a Windows.

Cuando conviertes un proyecto a Windows:

• Las dependencias del proyecto se gestionan en función de las siguientes reglas:
  • Si existe la misma versión del paquete en los orígenes del paquete configurados, la versión utilizada en el proyecto Windows: heredado no cambia.
  • Si no existe la misma versión del paquete, la versión utilizada en el proyecto Windows: Legacy se cambia al parche más alto de la versión más cercana.
• Todas las actividades y propiedades se conservan en el proyecto convertido.
• Los espacios para nombre que son diferentes en los proyectos Windows y Windows (heredado) son actualizados.

• Se añaden los espacios de nombre necesarios en los proyectos Windows y los utilizados solo en proyectos Windows (heredado) se eliminan.

  Aviso: Convierte y vuelve a publicar las bibliotecas de Windows (heredado) antes de convertir los procesos en los que están instaladas como dependencias.

Para convertir un proyecto heredado a la compatibilidad Windows:

1. Abre el proyecto Windows (heredado) en Studio y asegúrate de abrirlo solo en una instancia de Studio.

2. Haz clic derecho en el nodo del proyecto en el panel de Proyecto y a continuación selecciona Convertir a Windows. Se mostrará una nueva ventana.

   
   

   

   
   

3. Selecciona cómo convertir:

   • Para crear una copia de proyecto actual utilizando la compatibilidad Windows y mantener el proyecto original Windows (heredado), selecciona Crear un nuevo proyecto. Introduce el nombre, la ubicación donde crearlo y, de forma opcional, una descripción para el nuevo proyecto.
   • Para actualizar el proyecto existente y convertirlo a la compatibilidad Windows, desactiva la casilla Crear un nuevo proyecto. Si seleccionas esta opción, los cambios realizados al proyecto no podrán deshacerse.
4. Haz clic en Convertir.

Si los problemas de dependencia provocan actividades no resueltas tras la conversión, en la parte superior de cada una verás un mensaje que indica que falta o que no se ha podido cargar.Se dispone de la siguiente información para cada una: nombre para mostrar, espacio de nombres de la actividad, propiedades y valores de la actividad. Haz clic en Reemplazar para encontrar una alternativa y reemplazar la actividad faltante o no válida. Para obtener más información, consulta Actividades faltantes o no válidas.

Escenarios de migración de bibliotecas heredadas

Consulta los siguientes escenarios cuando migres bibliotecas heredadas:

1. Biblioteca heredada creada con Studio (código fuente disponible): migra primero la biblioteca, publícala y luego migra el proceso.
2. Biblioteca .NET con .NET Framework de destino (código fuente disponible): para las bibliotecas .NET, cambia el destino a .NET. Puedes:

   • Comprueba la versión de .NET Studio compatible (por ejemplo, Studio 24.10.X se ejecuta en .NET 8).

   • Objetivo múltiple para admitir tanto .NET Framework como .NET.

   • Utilizar sabores para la versión .NET. Los objetivos net6.0-windows son compatibles solo con proyectos Windows, mientras que net6.0 es compatible tanto con proyectos Windows como multiplataforma.
   Nota: Consulta los siguientes recursos:

   • Crear actividades con código en la guía del SDK.
   • Migrar actividades a .NET 6 en la guía del SDK.
   • Referencia de MSBuild para proyectos de SDK de .NET.

3. Biblioteca heredada de terceros (código fuente no disponible): reemplaza las actividades utilizando alternativas recomendadas por UiPath.

Proyecto para convertir proyectos de Windows: heredados

Esta guía paso a paso tiene como objetivo ayudarte a realizar la transición sin problemas de tus automatizaciones de Windows: heredado a Windows.

1. Inventario y evaluación: prepara un inventario detallado de todos tus proyectos de Windows: heredado y sus dependencias:
   • Enumera todos los proyectos, bibliotecas y dependencias.
   • Evalúa la compatibilidad con el entorno de Windows (.NET).
   • Identifica componentes que necesitan actualizaciones o reemplazos.
   Nota: la aplicación Explorador de paquetes de NuGet se puede utilizar para inspeccionar marcos de destino de .NET.
   
   
   
   
   
2. Prueba de concepto: prueba el proceso de conversión en un pequeño subconjunto de flujos de trabajo:
   • Selecciona un flujo de trabajo representativo que tenga una biblioteca añadida como dependencia.
   • Realiza una conversión piloto para identificar desafíos y bloqueadores.
   • Valida el resultado con pruebas.
   Consejo:

   • Crea una copia de seguridad del proyecto y de la biblioteca de Windows: heredado.
   • No cambies el nombre del proyecto o biblioteca al migrar.
   • Primero migra la biblioteca y publícala. No te preocupes: la versión migrada de la biblioteca no se puede utilizar en proyectos de Windows: heredado.
3. Escalado: convierte todos los proyectos y bibliotecas de forma sistemática:
   • Migra todas las bibliotecas y publícalas.
   • Migra todos los proyectos.
4. Validación y pruebas: garantiza que los flujos de trabajo convertidos se ejecuten según lo previsto.
   • Realiza pruebas.
   • Aborda errores de dirección o problemas de compatibilidad de forma iterativa.
   • Prueba las interacciones con sistemas y orígenes de datos externos.
5. Implementación de producción: transición del proyecto al entorno de producción:
   • Implementa flujos de trabajo en producción.
   • Supervisa problemas de estabilidad y rendimiento.
   • Proporciona formación al usuario o documentación actualizada si es necesario.
6. Supervisión posterior a la migración: informa de problemas de migración a UiPath para futuras mejoras:
   • Envia comentarios.
   • Comparte desafíos o soluciones con representantes de UiPath.

Problemas conocidos

Incidencia	Solución
Algunas expresiones son incompatibles con proyectos de Windows y necesitan ser cambiadas manualmente para convertir correctamente un proyecto de Windows: heredado a Windows.	{} a new Object() {} new Object() {task_output.Id.ToString,task_action,now,I_comment } a new Object() {task_output.Id.ToString,task_action,now,I_comment }
Errores de validación generados por otras expresiones que funcionaron antes de la conversión.	Corta la expresión utilizando el atajo de teclado CTRL + X y pégala de nuevo en el campo de actividad utilizando CTRL + V.
En una actividad Para cada, nombrar la variable cuyos valores deseas iterar como "expresión" da como resultado un error de compilación.	Absténete de nombrar la variable "expresión".
Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.	Después de convertir un proyecto que contenía versiones anteriores del paquete de actividades de IntelligentOCR, asegúrate de actualizar a la última versión del paquete de IntelligentOCR.
BC36915: Cannot infer an element type because more than one type is possible. Specifying the type of the array might correct this error. BC30512: Option Strict On disallows implicit conversions from 'Object()' to 'String()'. The selected value is incompatible with the property type. BC36914: Cannot infer an element type, and Option Strict On does not allow 'Object' to be assumed. Specifying the type of the array might correct this error.	Los lenguajes de programación modernos imponen una inferencia de tipos más estricta en comparación con las versiones anteriores. Convierte la matriz o el elemento al tipo deseado, por ejemplo: {} a new Object() {} <object>.ToString() CType(<element>, Object)
Operaciones sensibles a la codificación	Añade System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance) utilizando InvokeMethod.
“ (0x201C) frente a " (0x22)	Reemplaza todas las instancias por " (0x22), que es la única marca de comillas válida para literales de cadenas en .NET moderno.
BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.	Elimina y vuelve a añadir los argumentos de la actividad de Computer Vision.
BC31424: Type ‘System.Data.DataTable' in assembly ‘…’ has been forwarded to assembly 'System.Data.Common’ … BC30652: Reference required to assembly ‘System.Collections’ … containing the type 'List(Of )'. Add one to your project. BC30057: Too many arguments to 'Public Overloads Property SpecificContent As Dictionary(Of String, Object)'.	Para solucionar estos errores de validación: Navega a las propiedades de la actividad que contienen los errores. Elimina la configuración (Cortar o Ctrl + X). Haz clic fuera de la actividad. Añade de nuevo la configuración (Pegar o Ctrl + V).