发行说明 > ThingWorx Platform 9.4 发行说明
ThingWorx Platform 9.4 发行说明
ThingWorx Platform 9.4.0 新增功能
以下增强功能、已知问题和限制以及终止支持信息适用于 ThingWorx 9.4.0。
有关已修复问题的列表,请参阅 Fixed Issues in ThingWorx Platform 9.4.0
增强功能
平台
文件信息库
新增了将 zip 文件内容上传并提取到文件信息库的功能。有关详细信息,请参阅将 zip 文件上载并解压缩到文件信息库
持久化方案提供工具
新增了用于记录使用数据库连接的所有线程的堆栈追踪的新配置和服务。有关详细信息,请参阅持久化方案提供工具服务
事物事件
添加了新事件 DynamicSubscriptionInvalidated。有关详细信息,请参阅事物事件
服务参数
已将新参数 isSortFirst 添加到 QueryImplementingThings 服务。有关详细信息,请参阅使用 QueryImplementingThings 服务
RedHat9 先决条件
已添加在 RedHat9 上运行安装程序的先决条件,以避免 UI 项缺失。用户现在将看到必要的用户界面项,如 PTC 徽标、按钮等。有关详细信息,请参阅面向 Linux 的 ThingWorx Foundation 安装程序
安装错误消息
已添加一条错误消息,指导用户在升级过程中遇到安装失败时查看安装程序日志。
权限
授予用户对 tomcat9.exe 文件的虚拟机本地用户帐户的完全控制权限,并在 Windows Apache Tomcat 服务中将该用户设置为登录用户。这样可避免第二个 ThingWorx 实例部署失败。有关详细信息,请参阅ThingWorx Foundation 文件存储
为 ThingWorx 配置 AKKA TLS 通信
新增了主题:为 ThingWorx 配置 AKKA TLS 通信。此新主题将指导用户完成在 Docker compose 环境中配置 AKKA 的操作。有关详细信息,请参阅为 ThingWorx 配置 Akka TLS 通信
为 AKKA 配置 SSL/TLS
新增了主题:为 AKKA 配置 SSL/TLS。此新主题将指导用户在本地环境中为 AKKA 配置 SSL/TLS。有关详细信息,请参阅为 AKKA 配置 SSL/TLS
安装步骤
已添加一个安装步骤,用于在 Red Hat Linux 上运行安装时提供完全权限。这样,用户即可使用受支持的第三方软件的最新版本来部署 ThingWorx。有关详细信息,请参阅配置面向群集环境的 ThingWorx Foundation
安装步骤
已添加并更新 ThingWorx Ubuntu 的安装步骤,以避免本地部署失败。这样,用户即可使用受支持的第三方软件的最新版本来部署 ThingWorx。有关详细信息,请参阅安装 Java、Apache Tomcat 和 ThingWorx
已更新操作说明
已更新 Docker Files 的操作说明,其中指定了用作 BASE_IMAGE 的 Ubuntu 版本。有关详细信息,请参阅设置 ThingWorx Docker 构建
Influx2PersistenceProviderPackage 改进
已修改 writeAPI,目的是避免通过 Influx2PersistenceProviderPackage 进行高速数据提取时丢失数据PTC 可确保在未达到硬件或软件限制的情况下不会发生数据丢失。
对日志信息进行了改进,以确保所有值流写入错误均记录到 ThingWorx 错误日志中并说明失败原因。
已更正 Number of failed batch writes to streamNumber of stream entries that have been performed 值流监控指标,以正确统计失败的批处理写入。
已添加 2 个新的指标,用于更好地监控和优化 Influx2PersistenceProviderPackage 中的批次大小配置:Number of stream entries sent per batch to write to databaseTime consumed (nanosecond) per batch to write to database
已修改数据流导入进程,确保在达到数据限制时通过控制导入到 InfluxDB Cloud 中的数据以成功写入所有数据。
通过废弃先前由异步 API 使用的 Batch SizeFlush Interval 选项,已简化 Influx2PersistenceProviderPackage 配置。这两个选项将保留在配置表中,以保持向后兼容性,但不会对功能产生任何影响。
Influx2PersistenceProviderPackage 配置中的值流队列和批处理大小提供了必要的控制。现在,现有“清空流缓冲区之前的最大等待时间 (毫秒)”“清空流缓冲区之前的最大项数”“处理块的值流写入最大次数”选项可直接控制批处理大小和刷新间隔。
通过 Influx2PersistenceProviderPackage 改进,现在可支持数据导出。
* 
用户如需使用 InfluxDB OSS 2.0 (利用 Influx2PersistenceProviderPackage) 升级到 ThingWorx 9.4.0 及更高版本,必须首先升级到 ThingWorx 9.3.8,才能移至 InfluxDB OSS v2.6,因为在升级到 InfluxDB v2.6 之前需要导出。
通过避免创建会降低 ThingWorx 服务器速度的不必要 RxNewThreadScheduler 线程来提高可靠性。
使用 InfluxDB Cloud 时的配置要求
为了通过 InfluxDB Cloud 获得更好的吞吐量,建议将“处理线程数目”增加到 20,以达到 40,000 wps 的吞吐量,并将“写超时时间”增加到 20 秒。
PTC 将基于 InfluxDB Cloud 性能和可靠性使用 InfluxData,并提供配置详细信息,以通过更少的线程实现所需吞吐量。
高可用性 (HA) 群集
大规模分布式订阅处理
从 ThingWorx 9.4 及更高版本开始,PTC 能够在 ThingWorx 群集节点之间实现分布式订阅。这对于在各群集节点之间分配处理载荷非常有用,这样在事件触发多个订阅实例时,可实现规模化和更好的资源利用率。例如,基于计时器和计划程序的订阅。您可以通过选择“订阅”选项卡下的“分布”复选框来定义是否以分布式模式 (可跨节点水平扩展) 执行订阅。
分布式订阅方法仅适用于具有多个节点的高可用性环境。安装高可用性 (HA) 系统的标准步骤可启用此功能,而无需执行其他安装过程。有关相关配置信息的详细信息,请参阅以下内容:
有关本地部署,请参阅为 AKKA 配置 SSL/TLS
有关 Docker 环境,请参阅为 ThingWorx 配置 Akka TLS 通信
Mashup Builder
“新建”小组件
组合图 - 使用条形图、折线图、着色折线和数据点可视化的组合来可视化数据。此小组件会替换旧版“标签图表”小组件。有关详细信息,请参阅“组合图”小组件 (可应用主题)
饼图 - 通过将一个圆按比例分成几个部分来可视化来自多个类别的数据。您可以应用填充、指定起始和结束角度以及应用状态格式。有关详细信息,请参阅“饼图”小组件 (可应用主题)
用户界面
增强了“属性”本地化标记选取器的用户界面。现在,您可以使用多种语言的筛选标记和预览标记值。
有关详细信息,请参阅小组件本地化
样式主题和样式属性
已移除条形图、折线图、帕累托图、瀑布图、日程安排图小组件的冗余样式属性。有关详细信息,请参阅已移除的样式属性
通过添加菜单栏、树形栅格、饼图和组合图小组件来更新样式主题预览混搭。现在,可以在样式主题实体的“样式”选项卡上预览对这些小组件的样式主题更改。
混搭迁移
“混搭迁移”对话框中添加了审阅选项卡和汇总选项卡。现在,可以在迁移前查看受影响的小组件和函数的列表。有关详细信息,请参阅迁移混搭
添加了对使用“混搭迁移”对话框迁移不安全的函数的支持。
已将下列小组件从“旧版”类别移至“标准”类别:
博客
Wiki
标记云
首选项
在后续 ThingWorx 版本中,只有存在标准替换的小组件才会归入“旧版”类别。
在 2024 年 4 月之前,PTC 将保持旧版小组件在 ThingWorx 中可用,无需进行任何迁移。您可以按照自己的节奏从旧版小组件迁移到其替换部件。为充分利用最新功能和增强功能,PTC 强烈建议您在创建新混搭时使用标准小组件。您可以使用“混搭迁移”对话框迁移当前混搭中的旧版小组件。有关详细信息,请参阅旧版小组件和布局以及迁移旧版混搭
混搭布局
添加了增强型定位模式 (测试版),将原来使用的绝对定位替换为相对定位。此模式修复了布局问题,即响应式小组件在运行时可能无法正确显示的问题。有关详细信息,请参阅在 ThingWorx 9.4 (测试版) 中使用响应式布局中的增强型定位功能
* 
启用此模式时,“集合”小组件可能无法正确显示。
混搭运行时
在先前版本的 ThingWorx 中,Composer 和 Mashup Builder 使用 Bluebird JavaScript 库作为 promise 的填充代码。此库现已移除,因为新式浏览器和 Node.js 10 或更高版本包含对功能强大且性能更高的 promise 的本机支持。升级到 ThingWorx 9.4 后,使用此库的自定义小组件和扩展可能无法正常工作。
动态订阅
GetProperties 服务的“数据属性”面板中添加了“显示订阅消息”复选框。可选中此复选框,以便订阅在运行时变为无效时通知用户。
有关详细信息,请参阅自动更新混搭中的属性
函数
添加了一个数据导出函数,用于替换旧版数据导出小组件。现在,可以使用混搭中任何类型的事件将数据导出到 CSV 文件。
有关详细信息,请参阅数据导出
Web 组件 SDK
Lit 现已取代 Polymer 成为 SDK 库中使用的主框架。已将 SDK 中的多个 Web 组件迁移到使用 Lit。
更新了入门教程中使用的 Web 组件和小组件扩展示例。现在,您可以使用 Lit Web 组件创建小组件扩展。
有关详细信息,请参阅 ThingWorx Web 组件 SDK 帮助中心
小组件焦点和可访问性
现在,仅当在运行时使用键盘与小组件进行交互时,才会显示小组件焦点框。在先前版本中,使用鼠标或键盘时都会显示焦点框。可以使用混搭上的 LegacyFocus 属性配置此行为。有关详细信息,请参阅在混搭中启用旧版焦点
添加了对加载混搭时应用自动聚焦的支持。可以将自动聚焦应用于混搭中的以下小组件之一:复选框、数据片段筛选器、文件上传、链接、文本区域和文本字段小组件。有关详细信息,请参阅配置自动焦点
为了改善用户体验,现在某些小组件在使用键盘与混搭进行交互时的行为会有所不同。有关更改的详细信息,请参阅 ThingWorx 9.4 及更高版本中的键盘导航更改
“图表”小组件 (可应用主题)
添加了 SampleSize 属性,用于配置折线图小组件的数据采样。有关详细信息,请参阅配置图表的数据采样
添加了可用于自定义条形图、折线图和日程安排图等各种图表的默认消息和图标的属性。有关详细信息,请参阅图表的自定义错误和加载消息
已更新图表剖析结构以包括工具栏区域,其中包含运行时用于缩放或重置图表的操作按钮。
日期时间选取器小组件
添加了验证属性,用于设置:在已启用范围选择的情况下,用户可选择的最大天数。
“仪表”小组件
支持使用绑定来动态设置图表值和标签中的小数位数。
有关详细信息,请参阅“仪表”小组件
有关详细信息,请参阅“栅格”小组件 (可应用主题)
栅格小组件
添加了对于向栅格工具栏添加自定义操作的支持,如添加按钮、切换按钮、下拉列表和链接。有关详细信息,请参阅向栅格工具栏中添加自定义操作
添加了对突出显示添加到栅格中的新行的支持。启用此功能可让用户更轻松地在运行时查找新行。有关详细信息,请参阅添加和删除栅格上的行
添加了可在选择一行或多行时返回 True 的布尔型属性 RowSelected
添加了可包含所有页面上所有选定项的行 ID 的信息表属性。行 ID 允许您在对栅格进行分页或更改页面时保留选定的行 ID。
现在,单击超链接时将触发事件,而不是打开 URL。例如,您可以传递链接数据并导航至混搭。
菜单条
现在,向混搭添加菜单栏时,会自动应用小组件容器的必需配置。在先前版本的 ThingWorx 中,必须使用混搭模板或手动配置容器。
添加了对设置为“退出登录”的菜单实体项的支持。
有关详细信息,请参阅“菜单栏”小组件 (可应用主题)
链接小组件
已将 Clicked 事件添加到小组件。现在,在运行时单击链接时,可使用事件来触发服务。
有关详细信息,请参阅“链接”小组件 (可应用主题)
“列表交换”小组件
“验证”面板上添加了验证属性。现在,可以验证目标列表中选定项的数量。
添加了用于返回列表交换中选定项数量的 NumberOfSelectedItems 属性。
有关详细信息,请参阅“列表交换”小组件 (可应用主题)
分页小组件
选定页面的颜色从蓝色更改为灰色,以改善用户体验。
有关详细信息,请参阅“分页”小组件 (可应用主题)
行为变更
平台
更改类 MenuItem 的 API toValueCollection()
API toValueCollection() 返回值集合。为 toValueCollection() 响应添加了新属性 groupReferences。该属性保留了特定 menuItem 的组。
“待处理”服务删除
平台
存在有关 API SetGlobalSessionInfoTableValue 的已知问题,其中信息表值存储不正确。此 API 将在以后的版本中弃用并移除;不会修复此问题。
适当更新您的应用程序。
这对您有帮助吗?