在栅格小组件中禁用旧版验证
在 Mashup Builder 中,使用表达式将验证应用于栅格小组件的单元格内容。在运行时,编辑完单元格后,可通过验证器执行所定义的表达式。非安全函数增强功能包括,用更加安全的全新标准验证器替换用于将验证规则应用于单元格内容的现有验证器。新的安全验证器可用于 ThingWorx 9.3.2、9.2.7、9.1.11 和 9.0.16 或更高版本中的以下每一个小组件:
• 主题栅格 (ptcs-grid)
• 栅格 (高级)
• 旧版栅格 (dhxgrid)
可为混搭中的每个栅格小组件设置 DisableLegacyValidation 属性,以将旧版非安全验证器替换为最新的标准版本。
栅格 (可应用主题) 小组件
将新的栅格小组件添加至 ThingWorx 9.3.2 或更高版本中的混搭后,默认将使用最新的标准验证器。因此,小组件 DisableLegacyValidation 属性不可用,无法启用旧版验证。此外,使用 JSON 数据动态配置栅格时,仅支持安全验证器。
为防止出现兼容性问题,若打开的混搭包含在 ThingWorx 9.3.0 或 9.3.1 中添加的栅格小组件,则默认会使用旧版验证器。强烈建议针对该栅格手动禁用旧版验证,改为使用最新的标准验证器。可通过以下两种方式禁用旧版验证:
• 要针对小组件的所有列禁用旧版验证,请在“属性”面板上将小组件 DisableLegacyValidation 属性设置为 true。
• 要针对栅格的特定列禁用旧版验证,请执行以下步骤:
a. 在工作区中选择小组件。
b. 在
“属性”面板上,单击
打开小组件列配置对话框。
c. 在左侧窗格中,选择一个可编辑列,然后打开“列格式”选项卡。
d. 在“表达式验证器”下,选择“验证器”器。
f. 对于使用旧版验证的所有其他列,重复步骤 3 至 5。
g. 单击“完成”关闭对话框,然后保存混搭。
| 使用 JSON 数据动态配置栅格时,应查看并更新全部现有小组件。在 JSON 配置服务中使用不受支持的对象或函数可能会导致验证异常。使用 JSON 配置数据时,栅格支持验证器的全新安全版本。重新使用旧版或高级栅格中的 JSON 配置服务时,只有更新数据服务后才可使用最新的安全栅格。 |
栅格 (高级) 和栅格 (旧版) 小组件
可使用 DisableLegacyValidation 属性在混搭中禁用栅格 (高级) 和栅格 (旧版) 小组件的旧版验证。不能使用“列配置”对话框禁用特定列的旧版验证,这一点不同于栅格 (ptcs-grid) 小组件。
要针对 ThingWorx 9.3.2、9.2.6 和 9.1.11 或更高版本中的栅格 (高级) 小组件禁用旧版验证,请执行以下操作
1. 在工作区中选择小组件
2. 在“属性”面板上,将 DisableLegacyValidation 属性设置为 false。
3. 打开“列配置”对话框,查看为各个栅格列定义的验证表达式
5. 保存混搭。
最新验证器现已用于验证栅格上所有可编辑列的单元格数据。
在 ThingWorx 9.0.x 中,高级栅格的验证配置仅在使用 JSON 配置数据时受支持。要禁用旧版验证,请将 DisableLegacyValidation 属性设置为 false,然后手动查看在 JSON 配置中定义的验证表达式。在 JSON 配置中使用不受支持的对象函数可能会使小组件无法正常工作。