Migration des applications héritées vers les expressions VB

Une application héritée est une application qui a été créée avant l'introduction du langage d'expression VB, ou qui utilise le langage d'expression hérité.

Le processus de migration prend l'application héritée en entrée et génère une copie de l'application héritée conçue avec des expressions VB.

Pour migrer une application héritée vers des expressions VB :

Ouvrez l'application héritée souhaitée.
Dans la barre d'outils supérieure, cliquez sur Migrer vers VB ( Migrate to VB). Un message contextuel vous informe du résultat de la migration.
Sélectionnez Continuer (Continue) pour migrer. Un message toast vous informe de la progression de la migration.
Vérifiez le panneau de notification pour voir si l'application a été migrée avec succès.

L'application migrée s'affiche dans l'onglet Build , avec la syntaxe de nom suivante : nom_application + horodatage de migration.

Important :

Une fois migrée, la nouvelle application VB peut afficher des erreurs. Ces erreurs sont causées par l'incompatibilité entre les expressions héritées et VB.

Pour rendre votre application fonctionnelle, passez en revue chaque erreur et ajustez manuellement l'expression pour qu'elle réponde aux exigences de VB.

Capacités migrées

La liste suivante résume les fonctionnalités d'Apps qui sont migrées depuis l'ancien vers le langage d'expression VB. Toutes les fonctionnalités ne sont pas conservées et elles peuvent nécessiter des corrections manuelles. Pour vous aider à réécrire l'expression héritée en langage VB, l'algorithme de migration fournit une chaîne de guide.

Pages d'application, commandes, mises en page

Toutes les pages, contrôles et mises en page de l'application construits dans le langage hérité sont migrés vers leur instance associée dans les expressions VB.

Quelques contrôles et éléments sont migrés différemment :

File picker: Migré en tant que téléchargeur de fichiers, si la commande Sélecteur de fichiers est utilisée pour Télécharger (Download) uniquement.
Sinon, la commande Sélecteur de fichiers est migrée en tant que Téléchargeur de fichiers.
Liste personnalisée: La commande Liste personnalisée (Custom list) n'est pas encore prise en charge dans les expressions VB. Par conséquent, pour conserver la mise en page, un espace réservé des mêmes dimensions est utilisé.
Liaison de valeur: La liaison de valeur n'est pas prise en charge dans les expressions VB.
Contexte de données: Le contexte de données n'est pas pris en charge dans les expressions VB.

Remarque :

La propriété SourceDonnées est migrée vide pour plusieurs commandes, telles que Table, Liste déroulante ou Liste. Utilisez le générateur de requêtes pour reconstruire l'expression.

Expressions

Toutes les expressions littérales sont entièrement migrées. Une expression littérale est une valeur directement saisie par les utilisateurs.

Les expressions complexes, telles que Lookup, sont remplacées par une chaîne qui sert de guide dans la création de la nouvelle expression VB.

Intégrations avec des applications

Toutes les intégrations, telles que les processus, les files d'attente ou les compartiments de stockage, sont entièrement migrées.

Des erreurs peuvent se produire si un nom d’intégration ne respecte pas la convention d'affectation de noms pour les éléments VB. L’algorithme de migration renomme l’élément en votre nom.

Variables d’application

Lors de la migration, les variables sont définies sur des types de données de chaîne, quel que soit leur type de données d’origine.

Des erreurs peuvent se produire pour les variables qui ont d’autres types de données autres que la chaîne attribuée. Dans ces cas, des corrections manuelles sont nécessaires.

Assurez-vous que les noms de variables respectent la convention d'affectation de noms des éléments VB.

Liaisons directes

Une liaison directe est un lien entre deux éléments uniques uniquement. Par exemple, dans une application héritée, la propriété Liaison de valeur ( Value binding ) d'une commande Zone de texte ( Textbox ) ou le champ Compartiment de stockage ( Storage Bucket ) de la règle Charger le fichier dans le compartiment de stockage (Upload file to storage bucket ).

Les liaisons multi-pages sont obsolètes dans le langage d’expression VB. Par conséquent, ces types de liaisons ne sont pas migrés. Une erreur s'affiche pour les éléments qui ont une liaison multipage, avec une chaîne de guide pour vous aider à réécrire l'expression.

Toutes les expressions simples des propriétés de commande, telles que Requis (Required), En lecture seule (Readonly) ou Masqué (Hidden), sont migrées.

Règles de l'application

Toutes les règles contenant des liaisons directes sont migrées. Les expressions complexes sont supprimées ou converties en une chaîne de guide.

L'image suivante compare la configuration de la règle Définir les valeurs (Set values) avant (image 1) et après (image 2) lors de la migration vers les expressions VB :

Quelques règles sont migrées différemment :

Créer/Mettre à jour une entité: La règle est migrée en tant que règle Créer une entité (Create entity). Les expressions de cette règle ne sont pas conservées, vous devez donc reconfigurer la règle.
Définir la valeur: Si la règle comporte plusieurs éléments dans le champ Éléments à définir ( Items To Set ), ils sont migrés en tant que règles Définir les valeurs (Set values ) distinctes.

Les expressions de cette règle sont remplacées par des chaînes qui servent de guide dans la création de la nouvelle expression VB.
If /else: La règle est migrée sans conditions.