Migrieren älterer Apps zu VB-Ausdrücken

Eine Legacy-App ist eine App, die vor der Einführung der VB-Ausdruckssprache erstellt wurde oder die die Legacy-Ausdruckssprache verwendet.

Der Migrationsprozess verwendet die Legacy-App als Eingabe und generiert eine Kopie der Legacy-App, die mit VB-Ausdrücken gestaltet wurde.

So migrieren Sie eine Legacy-App zu VB-Ausdrücken:

1. Öffnen Sie die gewünschte Legacy-App.
2. Klicken Sie in der oberen Symbolleiste auf Zu VB migrieren. Eine Popup-Meldung informiert Sie über das Ergebnis der Migration.
3. Wählen Sie zum Migrieren Weiter aus . Eine Toast-Meldung informiert Sie über den Migrationsfortschritt.
4. Überprüfen Sie im Benachrichtigungsbereich, um zu sehen, ob die App erfolgreich migriert wurde.

Die migrierte App wird auf der Registerkarte Erstellen mit der folgenden Namenssyntax angezeigt: app_name + Migrationszeitstempel.

Wichtig:

Nach der Migration kann die neue VB-App Fehler anzeigen. Diese Fehler werden durch die Inkompatibilität zwischen Legacy-Ausdrücken und VB verursacht.

Damit Ihre App funktionsfähig ist, gehen Sie jeden Fehler durch und passen Sie den Ausdruck manuell an, um die VB-Anforderungen zu erfüllen.

Funktionen wurden migriert

Die folgende Liste fasst zusammen, welche Apps-Funktionen vom Vorgänger zur VB-Ausdruckssprache migriert werden. Nicht alle Funktionen werden beibehalten und erfordern möglicherweise manuelle Korrekturen. Um Ihnen zu helfen, den älteren Ausdruck in VB-Sprache neu zu schreiben, stellt der Migrationsalgorithmus eine richtungsweisende Zeichenfolge bereit.

App-Seiten, Steuerelemente, Layouts

Alle App-Seiten, Steuerelemente und Layouts, die in der Legacy-Ausdruckssprache erstellt wurden, werden in VB-Ausdrücke in ihre zugehörige Instanz migriert.

Einige Steuerelemente und Elemente werden unterschiedlich migriert:

• Dateiauswahl: Wird als Dateidownloader migriert, wenn das Dateiauswahlsteuerelement nur als Download verwendet wird. Andernfalls wird das Dateiauswahlsteuerelement als Dateiuploadprogramm migriert.
• Wertbindung : Wertbindung wird in VB-Ausdrücken nicht unterstützt.
• Datenkontext : Der Datenkontext wird in VB-Ausdrücken nicht unterstützt.

Hinweis:

Die Eigenschaft Datenquelle wird für mehrere Steuerelemente als leer migriert, z. B. Tabelle, Dropdownmenü oder Liste. Verwenden Sie den Abfragegenerator , um den Ausdruck neu zu erstellen.

Expressions

Alle literalen Ausdrücke werden vollständig migriert. Ein literaler Ausdruck ist ein Wert, der direkt von Benutzern eingegeben wird.

Komplexe Ausdrücke wie Lookup werden durch eine Zeichenfolge ersetzt, die als Anleitung für die Erstellung des neuen VB-Ausdrucks dient.

Integrationen mit Apps

Alle Integrationen, z. B. Prozesse, Warteschlangen oder Speicher-Buckets, werden vollständig migriert.

Es können Fehler auftreten, wenn ein Integrationsname die Namenskonvention für VB-Elemente nicht einhält. Der Migrationsalgorithmus benennt das Element in Ihrem Namen um.

Apps-Variablen

Während der Migration werden Variablen unabhängig von ihrem ursprünglichen Datentyp auf String-Datentypen festgelegt.

Fehler können bei Variablen auftreten, denen andere Datentypen als Strings zugewiesen sind. In diesen Fällen sind manuelle Korrekturen erforderlich.

Stellen Sie sicher, dass die Variablennamen die Namenskonvention für VB-Elemente respektieren.

Direkte Bindungen

Eine direkte Bindung ist nur eine Verknüpfung zwischen zwei einzelnen Elementen. Zum Beispiel in einer Legacy-App die Eigenschaft Wertbindung eines Textfeldsteuerelements oder das Feld Speicher-Bucket der Regel Datei in Speicher-Bucket hochladen .

Seitenübergreifende Bindungen sind in der VB-Ausdruckssprache veraltet, daher werden diese Bindungstypen nicht migriert. Bei Elementen mit seitenübergreifender Bindung wird ein Fehler mit einer Zeichenfolge angezeigt, die Ihnen hilft, den Ausdruck neu zu schreiben.

Alle einfachen Ausdrücke für Steuerelementeigenschaften, wie Erforderlich, Schreibgeschützt oder Ausgeblendet, werden migriert.

App-Regeln

Alle Regeln, die direkte Bindungen enthalten, werden migriert. Komplexe Ausdrücke werden entfernt oder in eine richtungsweisende Zeichenfolge konvertiert.

Die folgende Abbildung vergleicht die Konfiguration für die Regel Werte festlegen vor (Bild 1) und nach (Bild 2) der Migration zu VB-Ausdrücken:

Einige Regeln werden unterschiedlich migriert:

• Entität erstellen/aktualisieren: Die Regel wird als Entität erstellen migriert. Ausdrücke in dieser Regel werden nicht beibehalten, daher müssen Sie die Regel neu konfigurieren.
• Werte festlegen : Wenn die Regel mehrere Elemente im Feld Festzulegende Elemente enthält, werden diese als separate Werte festlegen migriert.
• Ausdrücke in dieser Regel werden durch Strings ersetzt, die als Orientierungshilfe beim Erstellen des neuen VB-Ausdrucks dienen.
• If/else: Die Regel wird ohne Bedingungen migriert.