混搭迁移故障排除

以下主题介绍了将现有混搭中的旧式小组件和布局迁移到 ThingWorx 9.0、9.1 或 9.3 时可能遇到的常见问题。

不同小组件状态的样式属性显示不正确

在 ThingWorx 的先前版本中，当更改基本状态背景颜色时，某些在不同状态下设置的小组件样式属性应用不正确。此问题已在 ThingWorx 9.1 中得到修复。并已根据您设置的默认样式或值设置小组件状态。如果您已在先前版本中应用某些解决方法解决此问题，则应相应调整样式属性。

例如，如果将透明按钮放置在图像小组件的顶部，则该按钮现在会更改为悬停状态的默认样式。这可能会隐藏按钮后面的图像。要解决此问题，请将每个状态的背景颜色设置为透明。

不会迁移自定义焦点框样式

在旧版小组件 (如“列表”和“下拉菜单”) 中，您可以使用样式定义在小组件级别上编辑焦点框的样式。这些样式不会迁移。但是，您可以使用样式主题编辑器在混搭级别上手动更改焦点样式。

1. 在 Composer 中，编辑应用至混搭的样式主题，然后打开“样式”选项卡。

2. 在“全局”下，展开“焦点”，然后编辑线型、粗细或颜色。

3. 单击“保存”。

小组件的渐变颜色未正确迁移

在 ThingWorx 9.3.0 中，当选择迁移自定义样式定义时，系统不会保留渐变色。仅迁移按钮和日期选取器等小组件的一级颜色。只有使用“旧版样式主题”时，才支持将渐变颜色应用于主题小组件。

要迁移、定义和编辑渐变色，请升级到 ThingWorx 9.3.1。

文本区域小组件的大小已更改

在 ThingWorx 9.3.2 或更高版本中，文本区域小组件已更新为使用容器内所有可用空间的响应式小组件。在容器中迁移具有单个文本区域小组件的混搭后，小组件将展开并可能会对布局产生影响。可向容器添加第二个小组件，以指定文本区域的固定大小。有关详细信息，请参阅文本区域小组件。

文件上载小组件显示滚动条

在 ThingWorx 9.3.4 或更高版本中，使用旧版主题进行迁移时，将保留文件上载小组件的高度。在某些布局中，迁移后可能会显示滚动条。要解决此问题，请手动调整小组件高度。

栅格

问题	说明
不会正确迁移栅格标题样式	新的“栅格”小组件不支持对栅格标题左侧、右侧和顶部线条单独进行样式设置。迁移旧版栅格小组件时，可能会失去自定义边界样式。只能使用小组件边界和分隔线的样式属性来设置标题的样式。
不会迁移旧版栅格小组件的样式。	仅迁移“高级栅格”小组件中的样式。不会迁移应用至旧版“栅格”小组件的样式定义。
不显示栅格数据。	对动态配置服务使用不正确的数据服务输出会阻碍小组件正确显示数据。迁移“高级栅格”小组件时，请确保在 Composer 中将配置数据服务的输出更新为 JSON。高级栅格的动态配置将在 ThingWorx 9.3.4 或更高版本中迁移至小组件 LegacyConfiguration 文本属性。新建配置时，建议改用小组件 Configuration JSON 属性。

图表

问题	说明
不会迁移图表标尺的线型。	在新的“图表”小组件中无法自定义标尺线宽、颜色和类型。不会迁移旧版小组件中这些行的任何自定义样式。

函数

问题	说明
不会迁移确认对话框的文本样式。	确认对话框将使用标签的默认样式，具体取决于应用的样式主题。不会迁移旧版小组件文本的任何自定义样式。但是，您可以通过在样式主题中编辑标题和正文标签类型来自定义样式。

容器和布局

问题	说明
迁移后，不会保留容器之间的间距。	旧版“布局”小组件包括一个用于在布局中设置容器之间间距的属性。在迁移至 ThingWorx 9.3.2 或更低版本中的 Flexbox 容器后，将不再支持此功能。在 ThingWorx 9.3.3 或更高版本中，可使用 Margin 属性设置容器间的间距。
迁移后，不会保留非可见列或行所占用的空间。	在 ThingWorx 9.3.6 或更高版本中，非可见列或行会转换为柔性容器，并将 Visible 属性设置为 False。布局中不会保留不可见容器所占用的空间。

这对您有帮助吗?