幻影实体扩展
 |
此扩展只能与 ThingWorx 8.5.x 版本配合使用。ThingWorx Platform 9.0.0 中包含此功能。
|
|
|
“幻影实体”扩展可从
support.ptc.com 中的以下位置获取：“下载软件”>“订购或下载软件更新”> ThingWorx Foundation > Release 8.5 > ThingWorx Ghost Entities Extension >“最近的日期代码”。
|
关于幻影实体
• 幻影实体为因错误而无法创建的实体在内存中的表示。
• 幻影实体仅在下次 ThingWorx 重新启动前持续存在。
• 创建失败的实体不会被提交至数据库。
• 通常情况下，幻影实体是在服务 (CreateUser 或 CreateThing 等) 中以编程方式调用 Create<Entity> 服务时处理异常不当所导致的结果。
• 如果在自定义 ThingWorx 服务的执行期间引发了异常，则所创建的任何实体均不会被提交至数据库。
• 如果存在幻影实体，则无法创建相同类型 (事物、用户、组等) 和名称的实体。
• Composer 中的 Spotlight 搜索无法搜索幻影实体。
• 只能通过特定的 ThingWorx 服务来查找幻影实体。
• 除了通过若干特定的 ThingWorx 服务外，无法通过 Composer 与幻影实体进行交互。
• 重新启动 ThingWorx 时，将从内存中移除幻影实体。
使用幻影实体扩展
• 此扩展会创建名为 GhostEntitiesResource 的新资源实例。
• 新资源提供了采用单个布尔参数 (deleteGhosts) 的 GetGhostEntities 服务。
◦ 如果 deleteGhosts 参数为 false，则该服务将查找并列出当前驻留于内存中的幻影实体。
◦ 如果 deleteGhosts 参数为 true，则该服务将查找并删除当前驻留于内存中的所有幻影实体。
▪ GetGhostEntities (true) 应返回空信息表，这表示所有幻影实体均已删除。