从 ThingWorx Apps 8.5.2 升级到 9.0.0
要从 ThingWorx Apps 8.5.x 升级到 ThingWorx Apps 9.0.0，请完成以下各部分中的步骤：
开始升级流程之前
在开始升级之前，请查看以下信息：
升级 ThingWorx 之前
在将 ThingWorx 升级到 9.0 之前，请先完成以下步骤：
1. 如果已自定义任何本地化表，请在执行升级前导出自定义的本地化表。升级过程中将覆盖本地化表。可在升级完成后导入已导出的本地化表，以保留您的修改。
升级 ThingWorx
完成以下步骤：
2. 重新启动 ThingWorx 服务器。
升级 ThingWorx Apps
完成以下步骤以将 ThingWorx Apps 升级到 9.0：
 |
此时请勿更新 ThingWorx Remote Access Extension (RAE)。
|
|
|
• 9.0 新增的可选 ThingWorx-Apps-<版本>-extension-factory-demo 扩展需在 ThingWorx 服务器重新启动后才能导入。
• ThingWorx Apps 9.0 支持可选的 ThingWorx-Rockwell-FT-MES-8-5-0-Extension-Bundle。如果此扩展已存在于您的 8.5.x 系统，无需在升级到 9.0 之后重新导入该扩展。
|
3. 重新启动 ThingWorx 服务器。
4. 通过导入 9.0.0 支持的版本，更新 ThingWorx 中的 ThingWorx Remote Access Extension (RAE)。有关详细信息，请参阅 ThingWorx 帮助中心的
ThingWorx Remote Access Extension 和 Remote Access Client 支持一览表。
5. 重新启动 ThingWorx 服务器。
6. 清除浏览器缓存。
8. 迁移数据。
a. 在 ThingWorx Composer 中，打开 PTC.SCA.SCO.OAMigrator 事物。
b. 在“服务”下，执行 MigrateFrom_8_5_2_To_9_0_0 服务。当服务输出窗格中显示“无结果”时，即表示服务已成功完成。
9. 如果您的设备具有通过之前的本地到本地绑定实施绑定至 KEPServerEX 标记的属性，且您想要利用新的远程绑定实施，那么请完成以下步骤。此时将更新属性绑定，以针对执行这些步骤的所有设备使用新的远程绑定实施。
有关将属性绑定至 KEPServerEX 标记的实施更改的详细信息，请参阅
ThingWorx Apps 9.0.0 版本说明。
a. 确保已将属性绑定至 KEPServerEX 标记的任何设备均可直接在设备事物本身、设备类型的事物模板中或设备类型继承的事物模板中实施 IndustrialThingShape。将 IndustrialThingShape 添加到事物或事物模板后，便无法将其移除。实施 IndustrialThingShape 的设备只能将属性远程绑定至 KEPServerEX 标记。
在将 IndustrialThingShape 添加到设备类型的事物模板前，请考虑是否此类型的所有设备均将属性绑定至 KEPServerEX 标记。若是，则可将 IndustrialThingShape 添加至事物模板。如果某些设备必须将属性远程绑定至非 KEPServerEX 数据源，例如 Edge MicroServer (EMS) 设备，那么请考虑创建要用于该设备的单独设备类型，或仅向将属性绑定至 KEPServerEX 标记的单个设备事物添加 IndustrialThingShape。
更新相应的设备事物或事物模板以实现事物形态。
|
|
如果使用 PTC 提供的“资产”设备类型的设备无需将属性绑定至 Edge MicroServer (EMS) 设备，则该设备只应添加 IndustrialThingShape。有关详细信息，请参阅
将资产连接到 Edge MicroServer (EMS)。
|
b. 请确保已将属性绑定至 KEPServerEX 标记的任何自定义设备类型的事物模板均可继承以下事物模板之一：RemoteThing、RemoteThingWithFileTransfer、RemoteThingWithTunnels 或 RemoteThingWithTunnelsAndFileTransfer。有关详细信息，请参阅
为设备类型创建自定义事物模板。
c. 在 ThingWorx Composer 中，打开 PTC.SCA.SCO.MigrationUtility 事物。
d. 在“服务”下，执行 MigrateLocalKepServerBindingsToRemoteBindings 服务。对于实现 IndustrialThingShape 的指定设备类型的所有设备，此服务可将设备事物上的本地到本地属性绑定迁移至远程属性绑定。对于设备事物从事物模板或事物形态继承的属性，如果这些属性在事物模板或事物形态中本地绑定到 KEPServerEX 标记，则继续保持本地绑定，不受迁移服务的影响。使用 KEPServerEX 标记的状况表达式、趋势和警报将继续在本地绑定，且不受迁移服务的影响。
在服务的 equipmentType 输入表中，添加要为其迁移属性绑定的每个设备类型。输入的值必须匹配 PTC.Factory.C_LaunchPointConfigurationThing_[ReleaseVersion] 事物的 EquipmentTypeSettings 配置表中的设备类型的 EquipmentType 值。每种设备类型的可选 overrideKepServerThingName 字段将替换用于绑定属性的 KEPServerEX 连接。
在为设备类型设置 overrideKepServerThingName 字段时，请考虑以下指导原则：
▪ 如果针对某一设备类型的所有设备使用单个 KEPServerEX 连接，那么请将 overrideKepServerThingName 字段留空。
▪ 如果存在多个 KEPServerEX 连接，但每台设备的属性仅绑定至单个 KEPServerEX 连接，那么请将 overrideKepServerThingName 字段留空。
▪ 如果存在多个 KEPServerEX 连接，且任何设备的属性均绑定至多个 KEPServerEX 连接，那么请确定要将每个此设备类型的设备绑定至的 KEPServerEX 连接。从 overrideKepServerThingName 字段中选择此 KEPServerEX 连接的名称。一台设备的属性只能绑定至一个 KEPServerEX 连接上的标记。确保其他 KEPServerEX 连接中的标记存在于所选的 KEPServerEX 连接上。
当服务输出窗格中显示“无结果”时，即表示服务已成功完成。
10. 通过查找并清除所有错误数据来做好向数据库添加外键的准备。错误数据是在向数据库添加外键后可能违背参考完整性的现有数据。
a. 在 ThingWorx Composer 中，打开 PTC.SCA.SCO.DatabaseManager 事物。
b. 在“服务”下，执行 ForeignKeyDataIntegrityReport 服务。此服务的输出是一个信息表，其中列出了需要解决的每个数据形状名称和参考字段。
如果未找到错误数据，则服务输出为空。请继续执行步骤 9。
c. 执行 GetFailedDataForForeignKey 服务，将 ForeignKeyDataIntegrityReport 服务返回的数据形状和参考字段作为输入提供。此服务的输出是一个信息表，其中最多可列出 500 条带有错误数据的数据库记录。
d. 根据系统要求处理每个错误数据实例：删除记录、将引用字段值设置为空 (如果允许) 或更新记录，以使引用字段具有有效的外键值。
|
|
对于高级数据库管理员，PTC.SCA.SCO.DatabaseManager 事物上的 GetDataShapeSqlQuery 服务会返回一个可在直接数据库查询中使用的 SQL 查询。
|
e. 重复步骤 c 和 d 直至不再存在错误数据。
11. 向数据库中添加外键。
a. 在 ThingWorx Composer 中，打开 PTC.SCA.SCO.OAMigrator 事物。
b. 在“服务”下，按所列顺序执行以下服务：
▪ MigrateDropIndexes
▪ MigrateAddForeignKeys
▪ MigrateAddIndexs
当服务输出窗格中显示“无结果”时，即表示各个服务已成功完成。
12. MPMLink OData 连接器事物 (PTC.SCA.SCO.MPMLink_ODataConnector) 已针对9.0 进行了更新，且无需再创建欲针对其执行配置的事物的复本。如果借助 Operator Advisor 从 Windchill MPMLink 转换工艺计划，那么请配置并使用随 ThingWorx Apps 9.0 提供的 MPMLink OData 连接器事物，而非保留先前版本中的已配置副本。有关详细信息，请参阅
为工艺计划转换配置 Windchill 连接。
13. 将 Windchill 属性映射至 Operator Advisor 属性以进行工艺计划转换的过程在 9.0 中已发生更改。如果您已覆盖 TranslateODataBOPToWDJson 服务以在 ThingWorx Apps 8.5 中指定自定义 Windchill 属性的映射，那么在升级至 ThingWorx Apps 9.0 后，这些映射必须在新映射进程完成后重新执行。有关详细信息，请参阅
支持 Windchill 自定义属性。