À propos de la compatibilité Windows - Héritage

Studio 2021.10 a permis la prise en charge des projets basés sur .NET et a introduit le concept de compatibilité de projet basé sur l'infrastructure cible. Dans les versions antérieures à 2021.10, tous les projets utilisaient .NET Framework 4.6.1, mais depuis Studio 2021.10, vous avez la possibilité de créer des projets grâce à la compatibilité Windows - Héritage (Windows - Legacy) (.NET Framework 4.6.1) ou grâce à la compatibilités Windows et multiplate-forme basée sur .NET.

Les projets Windows - Héritage ne bénéficient pas de nouvelles fonctionnalités

La compatibilité par défaut pour les nouveaux projets est désormais Windows. La compatibilité par défaut pour les nouveaux projets est désormais Windows, et bien que nous continuions à prendre en charge la compatibilité avec projets hérités depuis Windows, les nouvelles fonctionnalités ne seront disponibles que dans les projets compatibles Windows et multiplate-forme.

Par exemple, les fonctionnalités suivantes introduites dans Studio 2022.10 ne sont pas disponibles dans les projets hérités depuis Windows :

• Prise en charge de la création de variables globales et de constantes dans le gestionnaire de données.
• Nouvelle expérience de conception disponible pour les projets multiplate-forme et certaines activités dans les projets Windows.
• Possibilité de personnaliser la mise en page des activités générées à partir des bibliothèques.

Comment continuer à créer des projets Windows - Héritage

Bien que vous ne puissiez créer de nouveaux projets qu’avec la compatibilité Windows ou multiplate-forme à partir du mode Backstage, les organisations peuvent encore utiliser des stratégies de gouvernance afin de restaurer l’option de création de projets hérités depuis Windows en configurant le paramètre Infrastructures de compatibilité autorisées. Pour ce faire :

1. Accédez à Automation Ops™ > Governance (Gouvernance).
2. Définissez une nouvelle politique de gouvernance de Studio. Veillez à utiliser la version 24.10.0 Modèle de politique Studio.
3. Dans la fenêtre de la politique de gouvernance, sélectionnez l'onglet Design (Conception) et faites défiler jusqu'à la section Design Style (Style de conception).
4. Activez le paramètre Allowed compatibility frameworks (Infrastructures de compatibilité autorisées) et sélectionnez l'infrastructure cible Windows - Legacy (Windows – Héritage).
5. Enregistrez et déployez la politique de gouvernance.

Pour en savoir plus, consultez la section Paramètres des politiques de Studio du guide Automation Ops.

Vous pouvez également configurer le paramètre à l'aide du modèle de gouvernance basé sur fichier :

1. Générez un fichier de gouvernance JSON à partir de Studio.
2. Localisez le paramètre AllowedProjectFrameworks dans le fichier de gouvernance.
3. Définissez la valeur du paramètre Classic (Classique) sur True (Vrai).
4. Enregistrez et déployez le fichier de gouvernance.

Pour en savoir plus, consultez la section Gouvernance dans le guide Studio.

Pour être informé des changements à venir, consultez la rubrique Calendrier d’obsolescence.

Comment modifier des projets Windows - Héritage existants

La modification, la publication et l’exécution de projets Windows - Héritage continueront à être prises en charge dans les versions futures, ce qui signifie que vous pouvez les ouvrir et les modifier de même que les autres projets Windows et multiplate-forme.

Comment convertir des projets hérités depuis Windows vers la compatibilité Windows

Important : les dépendances pour lesquelles aucune version avec la compatibilité Windows n’est trouvée sont marquées comme non résolues et la version utilisée dans le projet hérité depuis Windows est affichée dans le panneau Projet après la conversion. La plupart des packages d’activités développés par UiPath et disponibles dans le flux officiel prennent en charge la compatibilité Windows. Pour obtenir une liste complète, consultez les Guides d’activités.

Studio est livré avec un outil de conversion intégré qui vous permet de convertir n'importe quel projet hérité depuis Windows en projet Windows.

Lorsque vous convertissez un projet vers Windows :

• Les dépendances du projet sont gérées selon les règles suivantes :
  • Si la même version du package existe dans les sources de package configurées, la version utilisée dans le projet Windows - Héritage (Windows - Legacy) n'est pas modifiée.
  • Si la même version du package n'existe pas, la version utilisée dans le projet Windows - Héritage (Windows - Legacy) est remplacée par le correctif le plus récent de la version la plus proche.
• Toutes les activités et propriétés sont conservées dans le projet converti.
• Les espaces de noms différents dans les projets hérités depuis Windows et Windows sont mis à jour.

• Les espaces de noms requis dans les projets Windows sont ajoutés, et ceux utilisés uniquement dans les projets hérités depuis Windows sont supprimés.

  Remarque : convertissez et republiez les bibliothèques héritées depuis Windows avant de convertir les processus où elles sont installées en tant que dépendances.

Pour convertir un projet hérité vers la compatibilité Windows :

1. Ouvrez le projet hérité depuis Windows dans Studio et assurez-vous de ne l'ouvrir que dans une instance de Studio.

2. Cliquez avec le bouton droit sur le nœud du projet dans le panneau Projet (Project), puis sélectionner Convertir vers Windows (Convert to Windows). Une nouvelle fenêtre s'affiche.

   
   

   

   
   

3. Sélectionnez le mode de conversion :

   • Pour créer une copie du projet actuel à l'aide de la compatibilité Windows et conserver le projet Windows hérité d'origine, sélectionnez Créer un nouveau projet (Create a new project). Saisissez le nom, l'emplacement de création et éventuellement une description du nouveau projet.
   • Pour mettre à jour le projet existant et le convertir vers la compatibilité Windows, décochez la case Créer un nouveau projet (Create a new project). Si vous sélectionnez cette option, les modifications apportées au projet ne peuvent pas être annulées.
4. Cliquez sur Convertir (Convertir).

Si des problèmes de dépendance entraînent des activités non résolues après la conversion, un message affiché en haut de chacune de ces activités indique qu’elle est manquante ou qu’elle n’a pas pu être chargée. Les informations suivantes sont disponibles pour chacune d’entre elles : nom complet, espace de noms de l’activité, propriétés et valeurs de l’activité. Cliquez sur Remplacer (Replace) pour trouver une alternative et remplacer l’activité manquante ou non valide. Pour plus d’informations, consultez la section Activités manquantes ou non valides.

Scénarios de migration de bibliothèques héritées

Consultez les scénarios ci-dessous lors de la migration de bibliothèques héritées :

1. Bibliothèque héritée créée avec Studio (code source disponible) : migrez d'abord la bibliothèque, publiez-la, puis migrez le processus.
2. Bibliothèque .NET avec cible .NET Framework (code source disponible) : pour les bibliothèques .NET, remplacez la cible par .NET. Vous pouvez :

   • Vérifiez la version de .NET Studio prise en charge (par exemple, Studio 24.10.X s'exécute sur .NET 8).

   • Ciblage multiple pour prendre en charge à la fois .NET Framework et .NET.

   • Utilisez des variantes pour la version .NET. Les cibles net6.0-windows sont compatibles uniquement avec les projets Windows, tandis que net6.0 est compatible à la fois avec les projets Windows et multiplateformes.
   Remarque : consultez les ressources suivantes :

   • Créer des activités avec du code dans le guide du SDK.
   • Migrer des activités vers .NET 6 dans le guide du SDK.
   • Référence MSBuild pour projets .NET SDK.

3. Bibliothèque héritée tierce (code source non disponible) : remplacez les activités par des alternatives recommandées par UiPath.

Schéma de conversion de projets Windows – Legacy

Ce guide étape par étape vise à vous aider faire passer vos automatisations de Windows-Legacy à Windows de manière transparente.

1. Inventaire et évaluation — Préparez un inventaire détaillé de tous vos projets Windows-Legacy et de leurs dépendances :
   • Dressez la liste de tous les projets, bibliothèques et dépendances.
   • Évaluez la compatibilité avec l'environnement Windows (.NET).
   • Identifiez les composants qui doivent être mis à jour ou remplacés.
   Remarque : l'application NuGet Package Explorer peut être utilisée pour inspecter les infrastructures .NET cibles.
   
   
   
   
   
2. Preuve de concept — Testez le processus de conversion sur un petit sous-ensemble de workflows :
   • Sélectionnez un workflow représentatif auquel une bibliothèque a été ajoutée en tant que dépendance.
   • Effectuez une conversion pilote pour identifier les difficultés et les obstacles.
   • Validez le résultat avec des tests.
   Astuce :

   • Créez une sauvegarde du projet et de la bibliothèque Windows – Legacy.
   • Ne modifiez pas le nom du projet ni de la bibliothèque lors de la migration.
   • Migrez tout d'abord la bibliothèque et publiez-la. Ne vous inquiétez pas : la version migrée de la bibliothèque ne peut pas être utilisée dans les projets Windows – Legacy.
3. Mise à l'échelle — Convertissez systématiquement tous les projets et bibliothèques :
   • Migrez toutes les bibliothèques et publiez-les.
   • Migrez tous les projets.
4. Validation et tests — Vérifiez que les workflows convertis fonctionnent comme prévu :
   • Effectuez des tests.
   • Corrigez les erreurs ou les problèmes de compatibilité de manière itérative.
   • Testez les interactions avec des systèmes et des sources de données externes.
5. Déploiement en production — Faites passer le project en environnement de production :
   • Déployez les workflows en production.
   • Surveillez les problèmes de stabilité et de performance.
   • Fournissez une formation aux utilisateurs ou une documentation mise à jour si nécessaire.
6. Surveillance postérieure à la migration — Signalez les problèmes de migration à UiPath pour permettre de futures améliorations :
   • Envoyez des commentaires.
   • Discutez des difficultés ou des solutions avec les représentants UiPath.

Problèmes connus

Problème	Solution
Les expressions suivantes sont incompatibles avec les projets Windows et doivent être modifiées manuellement pour convertir un projet Windows – Legacy en projet Windows.	{} vers new Object() {} new Object() {task_output.Id.ToString,task_action,now,I_comment } vers new Object() {task_output.Id.ToString,task_action,now,I_comment }
Erreurs de validation générées par d'autres expressions qui fonctionnaient avant la conversion.	Coupez l'expression à l'aide du raccourci clavier Ctrl + X et collez-la dans le champ d'activité à l'aide du raccourci Ctrl + V.
Dans une activité Pour chaque (For Each), le nommage de la variable dont vous souhaitez itérer les valeurs en tant qu’« expression » entraîne une erreur de compilation.	Abstenez-vous de nommer la variable « expression ».
Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.	Après avoir converti un projet contenant des anciennes versions du package d'activités IntelligentOCR, veillez à mettre à jour le package IntelligentOCR avec la dernière version.
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.	Les langages de programmation modernes appliquent une inférence de type plus stricte que les versions précédentes. Attribuez au tableau ou à l'élément le type souhaité, par exemple : {} vers new Object() {} <object>.ToString() CType(<element>, Object)
Opérations sensibles à l'encodage	Ajoutez System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance) avec la méthode InvokeMethod.
“ (0x201C) vs. " (0x22)	Remplacez toutes les instances par " (0x22), qui est le seul guillemet valide pour les chaînes littérales en .NET moderne.
BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.	Supprimez et ajoutez à nouveau les arguments de l'activité Computer Vision (Vision par ordinateur).
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)'.	Pour corriger ces erreurs de validation : Accédez aux propriétés de l'activité qui contiennent les erreurs. Coupez la configuration (Couper ou Ctrl + X). Cliquez hors de l'activité. Rétablissez la configuration (Coller ou Ctrl + V).