Über die Kompatibilität von Windows – Legacy

Mit Studio 2021.10 kam die Unterstützung für .NET-basierte Projekte und die Einführung des Konzepts der Projektkompatibilität, basierend auf dem Robotertyp. In Versionen vor 2021.10 verwendeten alle Projekte die Kompatibilität mit Windows-Legacy.Beginnend mit Studio 2021.10, haben Sie die Option, Projekte mit Windows- und plattformübergreifender Kompatibilität in Ergänzung zu Windows – Legacy zu erstellen.

Vorteile der Konvertierung von Windows-Legacy-Projekten zur Windows-Kompatibilität

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.

Die Verwendung von Windows- oder plattformübergreifenden Kompatibilitäten schaltet zukünftige Innovationen frei und bereitet Sie auf die Automatisierung mit Agenten von UiPath mit folgenden Funktionen vor:

• Roboter, die strukturierte, regelbasierte Aufgaben effizient erledigen.
• KI-gestützte Agents, die unstrukturierte Daten verarbeiten und intelligente Entscheidungen treffen.
• Menschen, die kritische Automatisierungsworkflows validieren und überwachen.

Mit der Automatisierung mit Agenten können Sie komplexere Prozesse automatisieren und eine KI-gestützte Entscheidungsfindung in allen Unternehmenssystemen nutzen.

Zugriff auf neue Funktionen

Windows- und plattformübergreifende Projekte geben Ihnen Zugriff auf Fähigkeiten der nächsten Generation, die in Windows–Legacy nicht verfügbar sind, einschließlich:

• Unterstützt das Erstellen globaler Variablen und Konstanten in Data Manager.
• Neue Designumgebung für plattformübergreifende Projekte und einige Aktivitäten in Windows-Projekten verfügbar.
• Die Möglichkeit, das Layout von Aktivitäten anzupassen, die aus Bibliotheken generiert werden.
• Codierte Automatisierungen.
• Autopilot™-Funktionen.
• Modellierung mit Business Process Model and Notation über langlaufende Workflows.
• Lösungen.

Verbesserte Leistung und Skalierbarkeit

Windows- und plattformunabhängige Projekte:

• Werden kompiliert und bieten erhebliche Leistungsverbesserungen und reduzieren die Ausführungszeit für Automatisierungen.
• Ideal für großflächige Automatisierungsszenarien mit hohem Transaktionsvolumen.
• Bieten moderne Speicherverwaltung und Just-In-Time-Kompilierung (JIT).

Erweiterte Sicherheit

• .NET enthält die neuesten Verschlüsselungsalgorithmen und Sicherheitsprotokolle zum Schutz vertraulicher Daten.
• Eine aktive Wartung stellt eine schnelle Behebung von Schwachstellen sicher, wodurch Risiken minimiert werden.

Reduzierung technischer Schulden

• Durch die Konvertierung von Windows-Legacy-Projekten wird die Abhängigkeit von veralteten Bibliotheken und veralteten Technologien beseitigt.
• Zukünftige Upgrades und Verbesserungen werden einfacher und kosteneffizienter sein.
• Moderne Workflows sind einfacher zu debuggen, zu skalieren und an sich ändernde Geschäftsanforderungen 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. Dazu gehen Sie wie folgt vor:

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 in zukünftigen Versionen weiterhin unterstützt. Windows-Legacy-Projekte werden in einer neuen Studio Legacy-Instanz geöffnet, die für Windows-Legacy-Projekte vorgesehen ist. Mit dieser Studio-Legacy-Instanz können Sie Windows-Legacy-Projekte bearbeiten, veröffentlichen und in die Windows-Kompatibilität konvertieren.

Hinweis:

Die Studio Legacy-Instanz ist derzeit nicht für Studio Continuous Release, Short Term Support (STS) verfügbar. Studio STS ermöglicht derzeit nicht das Erstellen oder Bearbeiten von Windows-Legacy-Projekten.

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 unterschiedlich sind
  • Legacy- und Windows-Projekte werden aktualisiert.
• Namespaces, die in Windows-Projekten erforderlich sind, werden hinzugefügt, und diejenigen, die nur in „Windows – Legacy“-Projekten verwendet werden, werden entfernt.
  Hinweis:

  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 mithilfe der Windows-Kompatibilität zu erstellen und das ursprüngliche Windows-Legacy-Projekt zu behalten, wählen Sie Ein neues Projekt erstellen. Geben Sie den Speicherort ein, an dem das Projekt erstellt werden soll. Das neue Projekt übernimmt den Namen des alten Projekts + _Windows
   • 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 Paket Explorer kann verwendet werden, um .NET-Zielframeworks zu überprüfen.

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.	{} zu new Object() {}new Object() {task_output.Id.ToString,task_action,now,I_comment }zunew 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: {}   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).