À propos de la compatibilité Windows - Héritage

Studio 2021.10 a introduit la prise en charge des projets basés sur .NET et le concept de compatibilité des projets s'appuyant sur le type de robot. Dans les versions antérieures à la version 2021.10, tous les projets utilisaient la compatibilité Windows – Legacy. À partir de Studio 2021.10, vous avez la possibilité de créer des projets avec Windows et la compatibilité multiplateforme, en plus de Windows – Legacy.

Les utilisateurs d’Automation Cloud peuvent choisir entre :

• Studio LTS : assure une stabilité à long terme avec un cycle de publication annuel.

• Studio Continuous Release, Short Term Support (STS) (Publication continue de Studio, prise en charge à court terme) : fournit des mises à jour fréquentes et de nouvelles fonctionnalités tout en préservant la fiabilité.

Pour en savoir plus, consultez la page Conditions de prise en charge du cycle de vie du produit.

Le tableau ci-dessous présente les principales différences entre les deux versions de Studio :

Version de Studio	Public cible	Exigence pour la connexion au cloud	Prise en charge de Windows - Héritage	Modèle de prise en charge	Cycle de publication
Studio LTS Année de Studio.10.Patch Ex. : 2024.10.8	Utilisateurs d’Enterprise ayant besoin d’une assistance longue durée, de stabilité et d’une prise en charge de Windows - Héritage. Peut être utilisé à la fois pour les connexions locales et pour les connexions Automation Cloud/Automation Suite.			Assistance longue durée (LTS) Prise en charge principale de 24 mois + Prise en charge étendue de 12 mois.	Une fois par an.
Studio Continuous Release, Short Term Support (STS) (Version continue de Studio, prise en charge à court terme) Année de Studio.0.Patch Ex. : 2025.0.157	Utilisateurs d’Enterprise à la recherche de mises à jour fréquentes et de nouvelles fonctionnalités tout en garantissant la fiabilité. Ne peut être utilisé qu’avec des connexions Automation Cloud.			Continuous Release, Short Term Support (STS) (Publication continue, prise en charge à court terme) Chaque version est prise en charge jusqu’à la mise à jour suivante.	Tous les deux mois.

Studio LTS (prise en charge à long terme) vous permet de créer, d'ouvrir et de modifier des projets Windows – Legacy pour un avenir prévisible. L'option permettant de créer des projets Windows – Legacy peut être activée par des politiques de gouvernance.

Studio STS ne permet plus de créer ni de modifier des projets Windows – Legacy.

Avantages de convertir des projets Windows – Legacy en compatibilité Windows

La compatibilité par défaut pour les nouveaux projets est désormais Windows. La création et la modification de projets avec la compatibilité Windows - Héritage n’est plus prise en charge, ce qui signifie que les nouvelles fonctionnalités ne seront disponibles que dans les projets compatibles Windows et multiplateforme.

L'utilisation de compatibilités Windows ou multiplateforme ouvre la porte aux innovations à venir et vous prépare au projet d'automatisation agentique UiPath, qui offre :

• Des robots qui gèrent efficacement des tâches structurées basées sur des règles.
• Des agents pilotés par l'IA qui traitent des données non structurées et prennent des décisions intelligentes.
• Des personnes qui valident et supervisent les workflows d'automatisation critiques.

L'automatisation agentique vous permet d'automatiser des processus plus complexes en tirant parti de prises de décisions pilotées par l'IA sur les différents systèmes d'entreprise.

Accéder à de nouvelles fonctionnalités

Les projets Windows et multiplateformes vous permettent d'accéder à des fonctionnalités de nouvelle génération qui ne sont pas disponibles dans Windows – Legacy, notamment :

• Prise en charge de la création de variables et de constantes globales 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.
• Automatisations codées.
• Fonctionnalités Autopilot™.
• Modélisation BPMN (Business Process Model and Notation) dans des workflows de longue durée.

Performances et évolutivité améliorées

Les projets Windows et multiplateformes :

• Sont compilés et améliorent considérablement les performances, ce qui réduit le temps d'exécution des automatisations.
• Conviennent parfaitement aux scénarios d'automatisation à grande échelle comportant des volumes de transactions élevés.
• Offrent une gestion moderne de la mémoire et une compilation JIT (Just-In-Time).

Sécurité renforcée

• .NET inclut les algorithmes de chiffrement et les protocoles de sécurité les plus récents pour protéger les données sensibles.
• La maintenance active garantit une résolution rapide des vulnérabilités, ce qui minimise les risques.

Réduction de la dette technique

• La conversion de projets Windows – Legacy élimine le recours à des bibliothèques et à des technologies obsolètes.
• Les mises à niveau et améliorations futures seront plus faciles et plus rentables.
• Les workflows modernes sont plus faciles à déboguer, à mettre à l'échelle et à adapter à l'évolution des besoins de l'entreprise.

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.
• Les services Web SOAP ne sont pas pris en charge dans les projets Windows et multiplateformes. Vous ne pouvez utiliser cette intégration que dans les projets Windows – Legacy.

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. Une nouvelle fenêtre s'affiche.

   
   

   

   
   

2. Sélectionnez le mode de conversion :

   • Pour créer une copie du projet actuel en utilisant la compatibilité Windows et conserver le projet Windows – Legacy d'origine, sélectionnez Create a new project (Créer un nouveau projet). Saisissez l'emplacement où créer le 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.
3. 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).
Les services Web SOAP ne sont pas pris en charge dans les projets Windows et multiplateformes. Vous ne pouvez utiliser cette intégration que dans les projets Windows – Legacy.