配置设备状况
状态最初在全局级别定义,适用于所有设备。可根据特定设备类型定义和配置状态,以便与该设备类型生成的实际状态保持一致。必要时,还可为单个设备定义和配置状态。每种状况定义均可配置标签、图标、默认评估顺序和趋势颜色。还可按设备类型或针对单台设备全局显示或隐藏状态,从而仅向最终用户显示与其设备相关的状态。
状况在 ThingWorx Composer 的 Status Definition Entries 页面中配置。此页面可从下列实体的“混搭”页面访问:PTC.SCA.SCO.StatusDefinitionEditorMashup、PTC.SCA.SCO.DefaultStatusManager、PTC.SCA.SCO.StatusUtils。
配置状态时请注意以下事项:
• 全局级别、设备类型事物模板以及单台设备事物的状态均不得超过 9 种。
• 为设备类型事物模板或单台设备事物配置状态时,无需定义该级别的所有状态。评估单台设备状态时,系统会使用适用的最低级别上已启用的状况定义:
◦ 系统首先检查单台设备事物启用的状况定义。
◦ 如果该台设备事物尚未定义状态,则系统会检查适用的设备类型事物模板上已启用的状态定义。
◦ 如果适用的设备类型事物模板上未定义该状况,则采用全局状况定义。
要为设备类型事物模板或单台设备添加新的状况定义条目:
1. 针对要添加条目的设备类型事物模板或单个设备事物,在 Status Definition Entries 列表中选择全局状况定义条目。
2. 在 Entries Editor 窗格中:
a. 在 UID 字段中输入唯一值。
b. 在 entityName 字段,添加此新状况定义适用的设备类型事物模板或单台设备事物的名称。输入的值必须与 ThingWorx Composer 中显示的事物模板名称或事物名称相匹配。
c. 根据需要更新状况定义条目的可编辑字段:
▪ color - (必填) 状态在图形和图表中显示的颜色,例如,Asset Advisor 中或 生产 KPI 中资产的状态在“性能”页面显示的颜色。颜色值必填且指定为十六进制代码。多个状态可使用相同的 color 值。
▪ criticalityOrder - (必填) 按重要性对 Asset Advisor 资产列表排序时的状态排序顺序。值越高,则重要性越高。该值在适用于特定设备类型事物模板或单台设备事物的状态中必须是唯一值。
▪ editableExpression - 如果选中此复选框,可查看单台设备并选择
“状况”页面,从
“配置和设置”的
“设备”选项卡编辑单台设备的状况表达式。有关详细信息,请参阅
指定状态表达式。
▪ enabled - 如果选中此复选框,状态即在 ThingWorx Apps 中可用。否则,状态会被忽略。必须至少启用一种状态。
▪ evaluationOrder - (必填) 新建设备的状态的默认评估顺序。该值必须为正整数,且在适用于特定设备类型事物模板或单台设备事物的状态中是唯一值。
▪ icon - 媒体实体,包含要在 ThingWorx Apps 中用作状态图标的图像。该值可留空。多个状态可使用相同的 icon 值。
▪ localizationToken - 用作
ThingWorx Apps 中状态显示名称的本地化标记。如果该值留空,则显示状态的
internalName。多个状态可使用相同的本地化标记。有关详细信息,请参阅
ThingWorx 帮助中心的
“本地化表”。
▪ timeElement - 在计算时使用状况的 KPI 元素。最佳做法是,切勿更改事物模板或事物上状态的
timeElement 值,避免与该状态在全局级别定义的值不一致。有关详细信息,请参阅
计算 KPI。
| statusIndex 和 internalName 共同构成给定 entityName 值的状况定义条目的唯一标识。最佳做法是,让设备类型事物模板或设备事物上状况的状况定义条目 internalName 和 statusIndex 与状况全局级别定义的值保持一致。 |
3. 单击 Add/Update。新的状况定义条目即会添加到 Status Definition Entries 列表中。
要更新现有状况定义条目:
1. 在 Status Definition Entries 列表中选择条目。
2. 在 Entries Editor 窗格中,根据需要更新可编辑字段。
3. 单击 Add/Update。现有状况定义条目会在 Status Definition Entries 列表中更新。
要删除状况定义条目:
1. 在 Status Definition Entries 列表中选择要删除的状况定义条目。
| 只有设备类型事物模板或设备事物上的状况定义条目才可以删除。不能删除全局层级的状况定义。 |
2. 在 Entries Editor 窗格中,单击 Delete。