颜色: Range Color 范围颜色
将连续数值映射到颜色区间,并为各区间配置填充、边框和可见性。默认配置为五个区间,可按需新增或删除,支持 1–24 个区间。
功能说明
Range Color 用于温度、压力、液位或负载等连续数值的分段显示。默认四个上限形成五个区间;通过 + Add range 新增区间或删除现有行,可调整为 1–24 个区间。数值上限按递增顺序填写,每个区间设置独立的显示状态。
字段配置
Setup script 准备数据,Range value 返回数值;Range actions 中每行代表一个区间,最后一行为 Final (+∞)。以下代码分别填写到标注字段。
- Behavior name 可编辑,Component name 只读。
- Setup Script:可选,供当前行为准备数值。
- Range value:数值表达式,不填写 Tag 名称字符串或颜色字符串。
- Upper limit:除最终区间外,按递增顺序填写有限数值。
- Fill / Border / Visibility:启用所需通道并逐行配置。
- + Add range 新增区间;删除行后应重新检查相邻边界。
- Quality override:Follow data quality (border / hide) 配置 Good / Bad 与质量异常时隐藏;显式区间边框优先于 Good。
- Save 校验脚本和数值上限;空白、非数字、非有限或非递增上限会阻止保存。
JavaScriptJavaScript
// Setup script
var temperature = ReadTagDouble("PLC_LINE01.OVEN01.TEMPERATURE", 0);
// Range value
temperature
// Upper limit: 60, 80, 95, 110
// Final (+∞): values above 110
适用场景
用于按颜色区分连续数值的档位,例如:
- 温度分段示例:≤60、(60,80]、(80,95]、(95,110]、>110;每段按工艺规范配置颜色。
- 负载分段:按低、正常、偏高和超限区间显示,区间颜色本身不会创建宿主报警事件。
限制与常见问题
区间边界与发布验证:
- 四个上限 L1 < L2 < L3 < L4 对应五段:值 ≤ L1、L1 < 值 ≤ L2、L2 < 值 ≤ L3、L3 < 值 ≤ L4、值 > L4。
- 上限属于它所在的区间;这与 Discrete Color 的 Value < 严格小于规则不同。
- N 个区间对应 N−1 个递增上限;仅一个区间时不设置上限,所有有效数值使用该区间。
- 使用旧版运行时的项目应在更新插件与宿主后重新导出并发布。每次增删区间后,验证各上限及最终区间的填充、边框和可见性。
- 保存前逐行检查有限数值、递增顺序和显示通道;错误值不会自动作为 0 保存。
- 质量覆盖处理数据可信度;工艺报警需要在宿主中独立配置。
图示 1: Range Color 编辑器
用 4 个阈值把数值分成 5 段,每段配一种填充/边框颜色或显隐。