ThingWorx Platform 9.3.0 新增功能
以下功能增强、已知问题和限制以及终止支持信息适用于 ThingWorx 9.3.0。
有关已修复问题的列表，请参阅 Fixed Issues in ThingWorx Platform 9.3.0。
|
增强功能
|
||||
|---|---|---|---|---|
|
安全
|
||||
|
ThingWorx 9.3.0 使用 log4j 2.17，且不会显示至使用较早 log4j 版本的当前 CVE。有关较低 ThingWorx 版本的指南，应在此处获取参考。
|
||||
|
修复了潜在的安全问题，包括由安全漏洞扫描软件预先识别的项和 PTC 质检部门测试的项。请尽快升级以充分利用这些重要改进功能。
|
||||
|
有关 ThingWorx 第三方软件使用和更新的重要建议，请参阅此技术支持文章。
|
||||
|
平台
|
||||
|
简化了手动升级过程，可使用户在升级到 ThingWorx 9.3.0 时节省时间和精力。对于从 ThingWorx 9.0.x 或更高版本进行升级的情况，升级脚本已进行组合，从而减少了必须执行的脚本的数量。
|
||||
|
现在，可以从事物模板和事物形态中执行服务。
|
||||
|
GetWhereUsed 服务可用于查看实体或其特征在 ThingWorx 中的引用位置。有关详细信息，请参阅使用 GetWhereUsed 服务。
|
||||
|
现在，许多属性类型都可以建立索引，这样可在使用 QueryImplementingThingsOptimized 和 QueryImplementingThingsOptimizedCount 服务时提高查询速度。有关详细信息，请参阅索引属性。
• 此功能包括新的查询统计数据功能。有关详细信息，请参阅查询统计数据。
• GetPropertyVTQ 服务会返回运行时在 ThingWorx 中接入或设置的事物属性计数，其中事物属性是针对事物、事物模板或事物形态定义的。您可以使用此服务来确定如何优化查询的性能，或如何根据索引属性值总数优化属性值的接入。有关详细信息，请参阅使用 GetPropertyVTQCount 服务。
|
||||
|
已针对点击劫持保护添加了 ClickjackFilterAllowList 筛选器和 ALLOWLIST 参数。将在未来版本中用其替换 ClickjackFilterWhiteList 筛选器和 WHITELIST 参数。ThingWorx 9.3 支持以上两种筛选器和参数，但建议在安装下一个版本之前更新 web.xml 文件。有关详细信息，请参阅允许在 iFrame 中嵌入的混搭。
|
||||
|
高可用性（HA）群集
|
||||
|
ThingWorx HA 群集现已受 Windows 2019 支持。
|
||||
|
Mashup Builder
|
||||
|
自定义 CSS
|
||||
|
旧版混搭迁移
• 混搭迁移功能已得到增强，支持将旧版样式定义迁移到小组件样式属性。可以使用“混搭迁移”对话框迁移到以下样式主题之一：
◦ PTC Convergence 主题 - 对新混搭使用默认样式主题
◦ 旧版样式主题 - 保留旧版样式定义的外观
◦ 自定义主题 - 自定义样式主题
• 现在，您可以使用样式主题实体“更多”菜单中的“按照默认样式定义进行更新”操作，将针对 Composer 中默认样式定义实体所做的自定义迁移到样式主题。
• 现在，您可以使用“更多”菜单中提供的“迁移混搭”操作来隐藏迁移消息，且可稍后再迁移。
现在，以下小组件是将在未来版本中弃用的旧版小组件：
◦ 栅格 (高级) - 将替换为 web 元件栅格小组件。
◦ 首选项
◦ TagCloud
◦ Wiki
◦ 博客
|
||||
|
响应式布局
• 在“布局”面板中添加了容器滚动选项，用于控制容器的竖直和水平滚动行为。
|
||||
|
样式主题
• 添加了名为 Legacy Styles Theme 的新样式主题实体，其中包含与旧版小组件默认样式定义类似的样式。在迁移旧版小组件的混搭时，可以使用此样式主题保留混搭的外观。
|
||||
|
菜单条小组件
• 现在，当使用 FooterLogo 属性展开小组件时，页脚部分会显示公司或产品徽标。
|
||||
|
栅格 (可应用主题)
通过新增可用于执行以下配置的属性，对小组件进行了增强：
• 使用 EditLevel 属性，可启用栅格数据编辑功能。可以配置为在栅格、行或单元格级别进行编辑。
• 在运行时调整栅格列的大小。
• 使用 JSON 数据动态配置栅格。
• 显示可用于在运行时将栅格重置回其默认配置的按钮。
• 动态配置更新时触发筛选器事件。
• 显示可供用户控制特定列的顺序和可见性的下拉菜单。
• 在栅格内的单独列中显示行号。
|
||||
|
已将 chart-line-style 属性添加到折线图和帕累托图小组件的“样式属性”面板中。新属性可显示实线、点线或虚线。
• 对于折线图，新属性将显示在 > > 下。
• 对于帕累托图，新属性将显示在 > > 下。
|
||||
|
通过在以下小组件中为具有默认标签值的多个属性添加本地化标记，对本地化支持进行了增强：
• 条形图
• 按钮
• 复选框
• 基于芯片的数据筛选器
• 日期时间选取器
• 下拉列表
• 栅格
• 标签
• 折线图
• 链接
• 列表
• 列表穿梭
• 帕累托图
• 属性显示
• 单选按钮
• 日程安排图
• 滑块
• 选项卡
• 工具栏
• 瀑布图
|
||||
|
增强了折线图中“日期/时间”和“数字” X 轴类型的格式，以便与用户设置的数据格式保持一致。此增强功能改善了 X 轴上刻度的选择体验和显示效果。
• 对于“日期/时间” X 轴类型，粒度取决于时间显示模式。如果日期/时间格式发生更改，则将使用以下格式来显示轴刻度。
◦ 如果日期/时间格式模式仅为 yy，则数据的粒度为年。
◦ 如果日期/时间格式模式仅为 mm，则数据的粒度最高为月。
◦ 如果日期/时间格式模式仅为 mm/dd，则数据的粒度最高为天。
◦ 如果日期/时间格式模式仅为 mm/dd h，则数据的粒度最高为小时。
• 对于“数字” X 轴类型，也对粒度进行了改进，以便挑选适用于数字格式的数据点。
|
||||
|
在所有图表小组件中添加了 ShowHideLegend 属性，可供用户在运行时使用按钮显示或隐藏图表图例。
|
||||
|
痕迹导航小组件
系统会根据所选的新添 MaxNumberOfLinks 属性在痕迹导航中添加一种溢出模式。MaxNumberOfLinks 属性用于定义痕迹导航中的最大链接数。任何其他链接都将显示在单击溢出控制图标时出现的溢出列表中。以前，提供了可用于在痕迹导航链接中左右浏览的导航箭头按钮。在 ThingWorx 9.3.0 及更高版本中，此按钮已修改为溢出控制图标。
|
||||
|
按钮小组件
在小组件中添加了以下属性：
• MultiLine - 在水平间距不可用时，允许长标签跨新行换行。
• MaxHeight - 设置当标签跨多行换行时，允许小组件增加到的最大高度。
• SVGIcon - 允许显示默认图标集中的 SVG 图标。
|
||||
|
选项卡小组件
添加了 TabNameHeight 属性，用于设置选项卡名称区域的高度。
在选项卡中添加了溢出模式。如果选项卡存在溢出，这些将显示在单击溢出控制图标时出现的溢出列表中。以前，提供了可用于在选项卡中左右浏览的导航箭头按钮。在 ThingWorx 9.3.0 及更高版本中，此按钮已修改为溢出控制图标。
|
||||
|
工具栏小组件
• 添加了使用 ToolbarAction 数据形状显示按钮操作图标集中的 SVG 图标的功能。
• 添加了 HideFilterSeparator 属性，用于显示或隐藏工具栏上分隔筛选器的竖线。
|
||||
|
表达式函数
在配置对话框中添加了“禁用初始输出”选项，可用于防止函数将未定义的值分配给“输出”属性。
|
||||
|
ThingWorx Flow
|
||||
|
有关 ThingWorx Flow 的新增功能，可单击此链接进行阅读。
|
||||
|
PTC 标识和访问管理 (IAM)
|
||||
|
KeyCzar 已被取代，现在使用 Tink 对访问令牌进行加密，然后再将其永久保存到数据库中。使用 Tink 时，必要的密钥集文件会在 ThingWorx 启动时自动创建，并存储在 ssoSecurityConfig 文件夹中。
Tink 不需要 symmetric 文件夹或 ThingWorx sso-settings.json 文件中的 keyczarKeyFolderPath 参数。如果您要从 ThingWorx 早期版本进行升级，则可以按原样保留这些文件和设置，ThingWorx 9.3 及更高版本会忽略它们。但是，如果决定将其移除，则必须等待升级过程完成。
|
行为更改
|
平台
|
|---|
|
上面所述的索引功能会导致 GUID 和 DATETIME 属性基本类型发生以下行为更改：
• DATETIME 的默认 default 值 (如果未在属性定义中显示设置默认值) 现在为 Unix epoch (1/1/1970)。新默认值适用于所有持久化和非持久化属性。
• 如果您拥有可返回平台默认 (default) 值的持久化 DATETIME 属性，则升级到 ThingWorx 9.3 后，该 DATETIME 将开始返回 Unix epoch (1/1/1970)。
• GUID 的默认 default 值现在为 Nil GUID (00000000-0000-0000-0000-000000000000)。升级到 ThingWorx 9.3.0 后，系统将对先前 timestamp 为 epoch，quality 为 unknown 且 Value 值为 default 的 GUID 进行修改，以使其 timestamp 为 "now" (平台升级时间)，并将 quality 修改为 Good。值保持不变。
• 对于用来返回默认 default GUID，基本类型为 GUID 的所有持久化属性：需要对该值将进行迁移以升级到实数值，这样，在升级到 ThingWorx 9.3 后，所返回的 GUID 值将不会更改。
|
|
Mashup Builder
|
|
自定义 CSS
为与最新的 CSS Shadow DOM 规范保持一致，移除了用于为 Web 组件小组件提供样式功能的填充代码。因此，早期版本的 ThingWorx 中应用于 Web 组件小组件的现有 CSS 规则可能不再奏效。如果自定义 CSS 无法正常使用，则必须在升级后手动查看并更新自定义 CSS。有关将 CSS 应用于 Web 组件小组件的详细信息，请参阅将自定义 CSS 样式应用于 Web 组件小组件。
|
已知问题和限制
ThingWorx 9.3.0 中存在下列已知问题和限制：
|
平台
|
|---|
|
当您升级 MSSQL、Azure SQL 或 H2 时，如果数据表中缺少任何自定义索引字段值，升级将失败。在开始升级过程之前，请验证是否所有自定义索引字段均具有值。如果升级失败，您将需要恢复 ThingWorx 数据库和平台、移除自定义索引或为自定义索引字段提供缺失值，然后执行升级。有关详细信息，请参阅升级 ThingWorx。
|
|
在状态定义或媒体实体上执行时，引用者功能和 GetWhereUsed 服务会受到限制。如果状态定义或媒体实体存在于混搭中，则可能会出现结果中未返回混搭的情况。
|
|
Mashup Builder
|
|
混搭迁移
迁移混搭时，不会保留以下样式和配置：
• 布局小组件容器之间的间距。
• 时序图的自定义样式。
• 折线图小组件中突出显示区域的渐变颜色。仅迁移线性渐变中的一级颜色。
• 图表标尺的宽度和线型。仅迁移标尺线条颜色。
• 下拉列表小组件中列表项旁显示的图标。
• 自动刷新小组件中切换开关的标签。
• 针对除旧版按钮小组件基本状态以外的任何状态定义的图标。
• 栅格边界的样式。
• 确认对话框的样式。
• 旧版导航小组件的 PopupTitleStyle 样式定义。
• 列表小组件的 ListBackgroundStyle 旧版样式定义。
• 小组件工具提示的自定义样式。
• 小组件焦点框的自定义样式。
有关详细信息，请参阅混搭迁移故障排除。
|
|
日期选取器小组件
因为清除按钮使用了间距，因此日期值有一部分未显示。
|
|
栅格 (可应用主题)
用于提供配置数据的现有数据服务将在迁移后停止工作。要修复此问题，请在 Composer 中将数据服务的输出类型更改为 JSON。
|