Mashup Builder > 小组件 > 标准小组件 > KPI 表盘小组件 (可应用主题)
KPI 表盘小组件 (可应用主题)
使用表盘、水平条或竖直条等多种布局之一显示关键性能指标 (KPI) 值。可应用状态格式突出显示一个或多个 KPI 值目标。
* 
此小组件也可用作 ThingWorx Web Component SDK 库中的 Web 组件。
结构
1. 小组件标签
2. 状态格式跟踪器
3. KPI 值
4. 测量单位标签
5. 值跟踪器
小组件布局
除表盘布局外,还可使用以下布局之一配置小组件并显示 KPI 值:
“水平条”
“竖直条”
应用状态格式
可将状态格式应用于小组件以显示目标值弧。弧分为若干段,每个段表示 KPI 值的不同状态或范围。可应用状态格式规则根据当前的 KPI 值对小组件进行样式设置。要应用状态格式,请执行以下步骤:
1. 在 Composer 中,创建一个基于数值范围应用样式定义的状态定义实体。
2. 在 Mashup Builder 中,选择小组件,然后打开“属性”面板。
3. 单击“状态格式”并配置 TargetFormat 属性。
4. “状态格式”对话框中,选择“基于状态的样式定义”
5. “依存字段”下,选择 Value
6. 选择在步骤 1 中创建的状态定义,然后单击“完成”
7. 保存并查看混搭。
运行时,系统会根据所应用的样式定义和当前值将状态格式规则应用于小组件。以下是一表盘示例,其中为小组件应用了状态格式。状态格式弧分为三个 KPI 值范围。
也可为状态定义中定义的每个状态显示状况图标。默认情况下,该图标显示在小组件的右侧。可使用 IconPosition 属性将图标位置设置到左侧。要设置图标的最大尺寸,请使用 MaxIconSize 属性。
有关为小组件应用状态格式的详细信息,请参阅将状态格式应用至小组件
设置表盘的开始角度和结束角度
可使用 EndAngleStartAngle 属性配置表盘弧的开始角度和结束角度。StartAngle 属性用于指定跟踪器弧的起点。这两个属性支持介于 0 到 360 度之间的值。默认情况下,从 6 点钟位置沿顺时针方向 45 至 315 度之间计算弧。可使用小组件的 Direction 属性更改弧方向。以下为起始角度设为 90 度,结束角度设为 270 度的表盘跟踪器示例。
设置 KPI 值格式
要设置 KPI 值格式,有多个配置属性可供选择。可使用 UnitOfMeasure 配置指定 KPI 值的测量单位。当用户将鼠标悬停在 KPI 值上时,此测量单位会出现在工具提示中。将 ShowUOMLabel 属性设置为 true 后,小组件会在 KPI 值旁显示测量单位 (UOM)。ValueFormat 配置允许使用 0.000 语法设置 KPI 数字值的小数格式。
小组件属性
属性名称
说明
基本类型
默认值
绑定
本地化
Clicked
可绑定事件,在单击小组件时触发。
事件
Y
N
ValueFormat
使用状态定义实体将状态格式应用于小组件和 KPI 值。
状态定义
0000
Y
N
Label
指定小组件标签的文本。
STRING
标签
Y
Y
Layout
控制用于显示小组件上 KPI 值的布局类型。选项:“表盘”“水平条”“竖直条”
STRING
“表盘”
N
N
StartAngle
从 6 点钟位置开始,相对于 0 度设置表盘上值和目标跟踪器的开始角度。可输入 0 到 360 之间的正角度。使用 Direction 属性设置角度方向。
NUMBER
45
N
N
EndAngle
从 6 点钟位置开始,相对于 0 度设置表盘上值和目标跟踪器的结束角度。可输入 0 到 360 之间的正角度。使用“方向”属性设置角度方向。
NUMBER
315
N
N
Direction
用于指定:值追踪器在表盘、竖直条或水平条上的方向。
选项
表盘:顺时针/逆时针
水平:从左到右/从右到左
竖直:自下而上/自上而下
STRING
表盘:“顺时针”
水平:“从左到右”
竖直:“自下而上”
N
N
IconPosition
用于指定:KPI 状况图标相对于值标签的位置。可使用状态格式指定要显示的图标。
STRING
“右对齐”
Y
N
LabelAlignment
用于控制:小组件标签的对齐方式。选项:“左对齐”“居中”“右对齐”
STRING
Y
N
IconSize
用于设置:KPI 状况图标的大小。选项:“小”“中”“大”“超大”
STRING
Y
N
LabelType
用于设置:标签类型。选项:“标题”“正文”“标签”“标题”“大标题”“子页眉”“页眉”“大页眉”
STRING
“标签”
N
N
MinimumValue
用于设置:小组件上显示的最小 KPI 值。
NUMBER
0
Y
N
MaximumValue
用于设置:小组件上显示的最大 KPI 值。
NUMBER
100
Y
N
UnitOfMeasure
用于指定:KPI 值的测量单位。测量单位于工具提示中显示。
STRING
空白
Y
Y
ShowUOMLabel
在 KPI 值旁边显示测量单位。
BOOLEAN
False
Y
N
Value
用于设置:KPI 值。
NUMBER
空白
Y
N
验证属性
属性名称
说明
基本类型
默认值
是否可绑定 (Y/N)
是否可本地化 (Y/N)
ValidationState
用于设置验证状态的可绑定属性。可将此属性设置为 UndefinedUnvalidatedValidInvalid
STRING
Undefined
Y
N
ValidationOutput
检索小组件验证的输出。返回值为 UndefinedValidUnvalidatedInvalid
STRING
Y
N
Validate
更改小组件值时触发的可绑定事件。将此事件绑定至服务或函数以应用验证模式或表达式。
事件
Y
N
CriteriaMessage
当验证失败时所显示的消息。
STRING
空白
Y
CriteriaMessageDetails
二级消息,显示关于验证失败消息的更多信息。
STRING
空白
Y
Y
ShowValidationSuccess
当验证成功时显示成功消息。
BOOLEAN
False
Y
N
SuccessMessage
验证成功时显示的消息。
STRING
Y
Y
SuccessMessageDetails
二级消息,显示关于验证成功消息的更多信息。
STRING
Y
Y
ValidationSuccessIcon
针对验证成功时的状况消息,选择在其中显示的 SVG 图标。
SVG 图标列表
PTC Success
N
N
ShowValidationFailure
用于设置:验证失败时显示的失败消息。
BOOLEAN
False
Y
N
ValidationFailureIcon
针对验证失败时的状况消息,选择在其中显示的 SVG 图标。
SVG 图标列表
PTC error
N
N
MinValueFailureMessage
KPI 值小于 MinimumValue 属性中设置的值时显示的消息。
文本字段
<MinValue> is the minimum value.
Y
Y
MaxValueFailureMessage
KPI 值大于 MaximumValue 属性中设置的值时显示的消息。
文本字段
<MaxValue> is the maximum value
Y
Y
这对您有帮助吗?