Über die Kompatibilität von Windows – Legacy

Studio 2021.10 brachte Unterstützung für .NET-basierte Projekte und führte das Konzept der Projektkompatibilität basierend auf dem Zielframework ein. In Releases vor 2021.10 verwendeten alle Projekte .NET Framework 4.6.1, aber seit Studio 2021.10 haben Sie die Möglichkeit, Projekte mit der „Windows – Legacy“-Kompatibilität (.NET Framework 4.6.1) oder mit der Windows- und plattformübergreifenden Kompatibilität basierend auf .NET zu erstellen.

„Windows – Legacy“-Projekte erhalten keine neuen Funktionen

Die Standardkompatibilität für neue Projekte ist jetzt Windows. Während wir weiterhin die „Windows – Legacy“-Kompatibilität unterstützen, werden neue Funktionen nur in Projekten mit Windows- und plattformübergreifender Kompatibilität verfügbar sein.

Beispielsweise sind die folgenden in Studio 2022.10 eingeführten Funktionen in „Windows – Legacy“-Projekten nicht verfügbar:

• Unterstützung für das Erstellen globaler Variablen und Konstanten im Data Manager.
• Neue Designumgebung für plattformübergreifende Projekte und einige Aktivitäten in Windows-Projekten verfügbar.
• Die Möglichkeit, bei Aktivitäten, die aus Bibliotheken generiert werden, das Layout anzupassen.

So können Sie weiterhin „Windows – Legacy“-Projekte erstellen

Während Sie nur neue Projekte mit der Windows- oder plattformübergreifenden Kompatibilität aus der Backstage-Ansicht erstellen können, können Organisationen weiterhin Governance-Richtlinien verwenden, um die Option zur Erstellung von „Windows – Legacy“-Projekten wiederherzustellen, indem sie die Einstellung Zulässige Kompatibilitätsframeworks konfigurieren. Folgendes ist dafür notwendig:

1. Gehen Sie zu Automation Ops™ > Governance.
2. Definieren Sie eine neue Governance-Richtlinie in Studio. Stellen Sie sicher, dass Sie die Version 24.10.0 installiert haben. Richtlinienvorlage von Studio.
3. Wählen Sie im Fenster „Governance-Richtlinie“ die Registerkarte Design und scrollen Sie zum Abschnitt Designstil.
4. Aktivieren Sie die Einstellung Zulässige Kompatibilitätsrahmen und wählen Sie das Zielframework Windows – Legacy.
5. Speichern Sie die Governance-Richtlinie und stellen Sie sie bereit.

Weitere Informationen dazu finden Sie unter Einstellungen für Studio-Richtlinien im Handbuch zu Automation Ops.

Alternativ können Sie die Einstellung mithilfe des dateibasierten Governance-Modells konfigurieren:

1. Generieren Sie eine JSON-Governance-Datei aus Studio.
2. Suchen Sie die Einstellung AllowedProjectFrameworks in der Governance-Datei.
3. Stellen Sie den Wert des Parameters Classic auf True.
4. Speichern Sie die Governance-Datei und führen Sie die Bereitstellung durch.

Weitere Informationen dazu finden Sie unter Governance im Handbuch zu Studio.

Um über bevorstehende Änderungen auf dem Laufenden zu bleiben, siehe Zeitleiste der veralteten Elemente.

So bearbeiten Sie vorhandene „Windows – Legacy“-Projekte

Das Bearbeiten, Veröffentlichen und Ausführen von „Windows – Legacy“-Projekten wird auch in zukünftigen Releases unterstützt werden, was bedeutet, dass Sie sie wie andere Windows- und plattformübergreifenden Projekte öffnen und bearbeiten können.

Wie Sie„Windows – Legacy“-Projekte zur Kompatibilität mit Windows konvertieren

Wichtig: Abhängigkeiten, für die keine Versionen mit der Windows-Kompatibilität gefunden werden, werden als nicht aufgelöst markiert, und die im „Windows – Legacy“-Projekt verwendete Version wird nach der Konvertierung im Projekt-Bereich angezeigt. Die meisten Aktivitätspakete, die von UiPath entwickelt wurden und im offiziellen Feed verfügbar sind, unterstützen die Windows-Kompatibilität. Eine vollständige Liste finden Sie in den Anleitungen zu Aktivitäten.

Studio verfügt über ein integriertes Konvertierungstool, mit dem Sie jedes „Windows – Legacy“-Projekt zu Windows konvertieren können.

Wenn Sie ein Projekt zu Windows konvertieren, gilt Folgendes:

• Projektabhängigkeiten werden basierend auf den folgenden Regeln verwaltet:
  • Wenn die gleiche Version des Pakets in den konfigurierten Paketquellen vorhanden ist, wird die im „Windows – Legacy“-Projekt verwendete Version nicht geändert.
  • Wenn nicht dieselbe Version des Pakets vorhanden ist, wird die im „Windows – Legacy“-Projekt verwendete Version in den höchsten Patch der nächsten Version geändert.
• Alle Aktivitäten und Eigenschaften werden im konvertierten Projekt beibehalten.
• Namespaces, die in „Windows – Legacy“- und „Windows“-Projekten unterschiedlich sind, werden aktualisiert.

• Namespaces, die in Windows-Projekten erforderlich sind, werden hinzugefügt, und diejenigen, die nur in „Windows – Legacy“-Projekten verwendet werden, werden entfernt.

  Wichtig: Konvertieren und veröffentlichen Sie „Windows – Legacy“-Bibliotheken erneut, bevor Sie die Prozesse konvertieren, in denen sie als Abhängigkeiten installiert sind.

So konvertieren Sie ein Legacy-Projekt zur Windows-Kompatibilität:

1. Öffnen Sie das „Windows – Legacy“-Projekt in Studio und achten Sie darauf, dass Sie es nur in einer einzigen Studio-Instanz öffnen.

2. Klicken Sie alternativ mit der rechten Maustaste auf den Projektknoten im Projektbereich und wählen Sie dann In Windows konvertieren aus. Ein neues Fenster wird angezeigt.

   
   

   

   
   

3. Wählen Sie aus, wie konvertiert werden soll:

   • Um eine Kopie des aktuellen Projekts unter Verwendung der Windows-Kompatibilität zu erstellen und das ursprüngliche „Windows-Legacy“-Projekt zu behalten, wählen Sie Ein neues Projekt erstellen aus. Geben Sie den Namen, den Speicherort, an dem es erstellt werden soll, und optional eine Beschreibung für das neue Projekt ein.
   • Um das vorhandene Projekt zu aktualisieren und es zur Windows-Kompatibilität zu konvertieren, deaktivieren Sie das Kontrollkästchen Ein neues Projekt erstellen. Die Änderungen, die am Projekt vorgenommen werden, wenn Sie diese Option auswählen, können nicht rückgängig gemacht werden.
4. Klicken Sie auf Konvertieren.

Wenn Abhängigkeitsprobleme nach der Konvertierung zu nicht aufgelösten Aktivitäten führen, weist eine Meldung oben bei jeder dieser Aktivitäten darauf hin, dass sie fehlt oder nicht geladen werden konnte. Die folgenden Informationen sind für jede Aktivität verfügbar: Anzeigename, Aktivitäts-Namespace, Aktivitätseigenschaften und Werte. Klicken Sie auf Ersetzen, um eine Alternative zu finden und die fehlende oder ungültige Aktivität zu ersetzen. Weitere Informationen finden Sie unter Fehlende oder ungültige Aktivitäten.

Migrationsszenarien für veraltete Bibliotheken

Siehe folgende Szenarien für die Migration von Legacy-Bibliotheken:

1. Mit Studio erstellte Legacy-Bibliothek (Quellcode verfügbar): Migrieren Sie zuerst die Bibliothek, veröffentlichen Sie sie und migrieren Sie dann den Prozess.
2. .NET-Bibliothek mit .NET Framework-Ziel (Quellcode verfügbar): Ändern Sie für .NET-Bibliotheken das Ziel in .NET. Sie können:

   • Die unterstützte Version von .NET Studio (z. B. Studio 24.10.X läuft auf .NET 8) aktivieren.

   • Mehrfachzielsetzung zur Unterstützung sowohl von .NET Framework als auch von .NET.

   • Verwenden Sie Flavors für die .NET-Version. net6.0-windows Ziele sind nur mit Windows-Projekten kompatibel, während net6.0 sowohl mit Windows- als auch mit plattformübergreifenden Projekten kompatibel sind.
   Hinweis: Siehe folgende Ressourcen:

   • Erstellen von Aktivitäten mit Code im Handbuch zu SDK.
   • Migration von Aktivitäten zu . NET 6 im Handbuch zu SDK.
   • MSBuild-Referenz für . NET SDK-Projekte.

3. Veraltete Bibliothek von Drittanbietern (Quellcode nicht verfügbar): Ersetzen Sie Aktivitäten durch von UiPath empfohlenen Alternativen.

Blueprint für die Konvertierung von Windows-Legacy-Projekten

Diese Schritt-für-Schritt-Anleitung soll Ihnen helfen, Ihre Automatisierungen nahtlos von Windows-Legacy zu Windows zu überführen.

1. Bestandsaufnahme und Bewertung – Erstellen Sie eine detaillierte Bestandsaufnahme all Ihrer Windows-Legacy-Projekte samt Abhängigkeiten:
   • Listen Sie alle Projekte, Bibliotheken und Abhängigkeiten auf.
   • Bewerten Sie die Kompatibilität mit der Windows (.NET)-Umgebung.
   • Identifizieren Sie zu aktualisierende oder ersetzende Komponenten.
   Hinweis: Die Anwendung NuGet Package Explorer kann verwendet werden, um Pakete zu inspizieren. NET-Zielframeworks.
   
   
   
   
   
2. Proof of Concept – Testen Sie den Konvertierungsprozess mit einer kleinen Untermenge des Workflows:
   • Wählen Sie einen repräsentativen Workflow, dem eine Bibliothek als Abhängigkeit hinzugefügt wurde.
   • Führen Sie zur Identifizierung von Herausforderungen und Hindernissen eine Pilotkonvertierung durch.
   • Validieren Sie das Ergebnis mit Tests.
   Tipp:

   • Erstellen Sie eine Sicherung des Windows-Legacy-Projekts und der Bibliothek.
   • Ändern Sie den Namen des Projekts oder der Bibliothek während der Migration nicht.
   • Migrieren Sie zuerst die Bibliothek und veröffentlichen Sie sie. Keine Sorge – die migrierte Version der Bibliothek kann nicht in Windows-Legacy-Projekten verwendet werden.
3. Skalierung – Konvertieren Sie alle Projekte und Bibliotheken systematisch:
   • Migrieren Sie alle Bibliotheken und veröffentlichen Sie sie.
   • Migrieren Sie alle Projekte.
4. Validierung und Tests – Stellen Sie sicher, dass die konvertierten Workflows wie beabsichtigt funktionieren:
   • Führen Sie Tests durch.
   • Beheben Sie Fehler oder Kompatibilitätsprobleme iterativ.
   • Testen Sie Interaktionen mit externen Systemen und Datenquellen.
5. Produktionsbereitstellung – Überführung des Projekts in die Produktionsumgebung:
   • Stellen Sie Workflows für die Produktion bereit.
   • Überwachen Sie diese auf Stabilitäts- und Leistungsprobleme.
   • Stellen Sie bei Bedarf Benutzerschulungen oder eine aktualisierte Dokumentation bereit.
6. Überwachung nach der Migration – Melden Sie Migrationsprobleme an UiPath für zukünftige Verbesserungen:
   • Senden Sie Feedback.
   • Teilen Sie Herausforderungen oder Lösungen Vertriebsmitarbeitenden von UiPath mit

Bekannte Probleme (Known Issues)

Problem	Lösung
Einige Ausdrücke sind mit Windows-Projekten inkompatibel und müssen manuell geändert werden, um ein Windows-Legacy-Projekt erfolgreich in Windows zu konvertieren.	{} in new Object() {} new Object() {task_output.Id.ToString,task_action,now,I_comment } in new Object() {task_output.Id.ToString,task_action,now,I_comment }
Validierungsprobleme, die durch andere Ausdrücke verursacht wurden, die vor der Konvertierung funktionierten.	Schneiden Sie den Ausdruck mithilfe der Tastaturkombination STRG + X aus und fügen Sie ihn mit STRG + V wieder in das Aktivitätsfeld ein.
In einer For Each-Aktivität führt die Benennung der Variablen, deren Werte Sie iterieren möchten, als „Ausdruck“ zu einem Kompilierungsfehler.	Geben Sie der Variablen nicht den Namen „expression“.
Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.	Nach Konvertierung eines Projekts mit älteren Versionen des IntelligentOCR-Aktivitätspakets sollten Sie ein Upgrade auf die neueste Version des IntelligentOCR-Pakets durchführen.
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.	Moderne Programmiersprachen setzen eine strengere Typinferenz durch im Vergleich zu älteren Versionen. Konvertieren Sie das Array oder das Element in den gewünschten Typ, wie zum Beispiel: {} in new Object() {} <object>.ToString() CType(<element>, Object)
Kodierungssensible Vorgänge	Fügen Sie System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance) mithilfe von InvokeMethod hinzu.
“ (0x201C) vs. " (0x22)	Ersetzen Sie alle Vorkommen durch " (0x22), das einzige gültige Anführungszeichen für Zeichenfolgeliterale im modernen .NET.
BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.	Entfernen Sie die Argumente der Computer Vision-Aktivität und fügen Sie sie erneut hinzu.
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)'.	So beheben Sie diese Validierungsfehler: Gehen Sie zu den Aktivitätseigenschaften, die die Fehler enthalten. Entfernen Sie die Konfiguration (Ausschneiden oder Strg + X). Klicken Sie außerhalb der Aktivität. Fügen Sie die Konfiguration wieder hinzu (Einfügen oder Ctrl + V).