弃用实体、属性和服务
从 ThingWorx 9.5.0 开始，可弃用实体和特征。弃用实体可在接下来的几个版本中移除。可弃用所有实体及其特征。
可通过三种方式弃用实体和特征。
弃用实体和特征
可使用以下方法之一弃用项：
• 通过 Composer 选中“已弃用”复选框。
• 通过使用 REST 调用。
• 通过 XML 或扩展导入。
• 通过在 EntityServices 下执行 SetDeprecated 服务。此服务可批量设置多个实体和特征的已弃用属性。
 |
必须以 major.minor.patch 格式添加版本。也可按需添加备注。
|
如下图所示，系统会为项显示弃用指示符。用户可通过弃用指示符标识最终可能会被逐步弃用的项，进而选取其他项替代。
查看实体或特征的弃用集
通过在 EntityServices 资源下执行 GetAspects 服务，可查看已弃用的实体或特征。
通过已弃用筛选实体
可在 Composer 中使用 
基于已弃用对象筛选实体。“显示已弃用的对象”复选框默认处于非选中状态。因此，选中此复选框可查看已弃用的对象。
基于已弃用对象筛选实体。“显示已弃用的对象”复选框默认处于非选中状态。因此，选中此复选框可查看已弃用的对象。
| | 浏览器刷新后，将清除“显示已弃用的对象”复选框。 |
记录已弃用内容
如果用户创建、更新或删除实体或特征的已弃用属性，则“审计日志”中会留有相关记录。
有关详细信息，请参阅审计子系统。
| | 通过其他实体、成员或服务调用对实体或特征所进行的修改不会纳入审计范围。 |
弃用相关服务
以下服务适用于弃用特征。
服务 | 资源 | 说明 |
|---|---|---|
SetDeprecated | EntityServices | 此服务将实体设置为已弃用。此服务可用于批量设置多个实体和特征的已弃用属性。 以下是服务的输入参数： • Entity Name • Entity Type • Characteristic Type and Name (属性、服务、配置表) 可选参数 • Deprecated (JSON 中的 Since 和 Comment) |
ListDeprecatedUsage | 此服务会列出当前实体中已弃用实体和特征的所有使用情况。 可通过相应实体的“服务”选项卡访问此服务。 • 执行此服务后会收到下列参数： ◦ entityName ◦ entityType ◦ dependentEntityName ◦ dependentEntityType ◦ whereUsed ◦ characteristicsType ◦ characteristicsName |