将旧版应用程序迁移到 VB 表达式

旧版应用程序是在引入 VB 表达式语言之前创建的应用程序，或者使用旧版表达式语言的应用程序。

迁移流程将旧版应用程序作为输入，并生成使用 VB 表达式设计的旧版应用程序的副本。

要将旧版应用程序迁移到 VB 表达式，请执行以下操作：

1. 打开所需的旧版应用程序。
2. 在顶部工具栏上，单击“迁移到 VB” 。系统会弹出一条消息，通知您迁移结果。
3. 选择“继续迁移”。系统会显示一条 Toast 消息，通知您迁移进度。
4. 查看通知面板，查看应用程序是否已成功迁移。

迁移的应用程序将显示在“构建”选项卡上，使用以下名称语法：应用程序名称 + 迁移时间戳。

重要提示：

迁移后，新的 VB 应用程序可能会显示错误。 这些错误是由旧版表达式和 VB 之间的不兼容性引起的。

为了使您的应用程序正常运行，请检查每个错误并手动调整表达式以满足 VB 要求。

迁移的功能

以下列表总结了哪些 Apps 功能已从旧版迁移到 VB 表达式语言。 并非所有功能都会保留，并且可能需要手动更正。 为帮助您用 VB 语言重写旧表达式，迁移算法提供了指导字符串。

应用程序页面、控件、布局

使用旧表达式语言构建的所有应用程序页面、控件和布局都将迁移到 VB 表达式中的相关实例。

一些控件和元素的迁移方式有所不同：

• 文件选取器 ：如果文件选取器控件仅用作下载，则迁移为文件下载器。否则，文件选取器控件将迁移为文件上传器。
• 值绑定（已弃用）：VB 表达式中不支持值绑定。
• 数据上下文 ：不支持 VB 表达式中的数据上下文。

备注：

对于多个控件（例如“表格”、“下拉列表”或“列表”），“数据源”属性被迁移为“空白”。使用“查询生成器”重建表达式。

Expressions

所有文本表达式都将完全迁移。 文本表达式是由用户直接输入的值。

复杂表达式（例如Lookup ）将替换为字符串，该字符串可作为构建新 VB 表达式的指导。

与 Apps 集成

所有集成，例如流程、队列或存储桶，都会完全迁移。

如果集成名称不符合 VB 元素命名约定，则可能会发生错误。迁移算法会代表您重命名元素。

Apps 变量

在迁移期间，变量将设置为字符串数据类型，无论其原始数据类型如何。

如果变量分配了字符串以外的其他数据类型，则可能会发生错误。 在这些情况下，需要手动更正。

确保变量名称遵循 VB 元素的命名约定。

直接绑定

直接绑定指的是仅两个元素之间的链接。例如，在旧版应用程序中， “文本框”控件的“值”绑定属性或“上传文件到存储桶”规则的“存储桶”字段。

VB 表达式语言中已弃用跨页面绑定，因此不会迁移这些类型的绑定。 系统会向具有跨页面绑定的元素显示错误，并提供指导字符串以帮助您重写表达式。

控件属性上的所有简单表达式（例如“必需”、“只读”或“隐藏”）都将迁移。

应用程序规则

将迁移所有包含直接绑定的规则。 复杂表达式将被删除或转换为指导字符串。

下图比较了迁移到 VB 表达式之前（图 1）和之后（图 2） “设置值”规则的配置：

几个规则的迁移方式有所不同：

• 创建/更新实体 ：此规则将迁移为“创建实体”规则。系统不会保留此规则中的表达式，因此需要重新配置规则。
• 设置值（默认值）：如果规则在“要设置的项目” 字段中包含多个项目，则这些项目将作为单独的“设置值”规则进行迁移。
• 此规则中的表达式将替换为字符串，这些字符串可作为构建新 VB 表达式的指导。
• If/else ：无条件迁移规则。