高级数据键配置

简介
高级数据key配置
Charts数据key配置

简介

高级数据key配置负责图表部件上特定数据key列或线条的可见性、样式和外观。

“Alarms table”部件及“Tables”、“Entity widgets”和“Entity admin widgets”bundle使用相同的高级数据 key 配置。

其它所有部件bundle仅支持基础数据 key 配置。

要进入数据key配置，点击需调整的特定数据key旁铅笔图标。

高级数据key配置

“Alarms table”部件、“Tables”、“Entity widgets”和“Entity admin widgets”bundle使用相同的高级数据key配置。下面以“Tables”bundle中的“Entities table”部件为例说明高级数据key配置。

请按下列步骤开始key的高级配置。

Open the dashboard and enter edit mode by clicking the button in the top right corner of the screen;
In the top right corner of the widget, click the "pencil" icon to open the widget editing window;
Now, click "pencil" icon to next to the key that you want to edit;
The data key configuration window has been opened. Navigate to the "Advanced" tab to open advanced data key configuration.

Open the dashboard and enter edit mode by clicking the button in the top right corner of the screen;

In the top right corner of the widget, click the "pencil" icon to open the widget editing window;

Now, click "pencil" icon to next to the key that you want to edit;

The data key configuration window has been opened. Navigate to the "Advanced" tab to open advanced data key configuration.

自定义列标题

默认列名与key名相同。“Custom header title” 选项允许将列标题改为任意文本。

By default, the column name is the same as the key name;

Manually enter the desired custom header title and save all changes;

列宽（px或 %）

“Column width” 功能允许以像素或百分比调整列宽。可手动输入所需宽度（如200px）。同样可改为百分比宽度。

Manually enter the desired width and save all changes;

单元格样式函数

“Cell style function” 允许根据值、实体或 ctx 调整行颜色。配置时需勾选 Use cell style function，并在下方 Cell style function 字段中输入函数。

Check the box "Use cell style function" and input the function in the "Cell style function" field and save all changes;

The cell color changes depending on its values.

单元格颜色随值变化的Cell style function示例：

if(value < 0) {
   return {"background-color" : "#5F4DEB"};
} else if (value < 35) {
    return {"background-color" : "#62c5e3", "color" : "#19154a"};
} else if (value < 45) {
    return {"background-color" : "#b50232", "color" : "#f7e18f"};
} else if (value < 55) {
    return {"background-color" : "#e6b500", "color" : "#ff2200"};
} else if (value < 65) {
    return {"background-color" : "#ff9419"};
} else if (value < 75) {
    return {"background-color" : "#d0ff00"};
} else if (value < 85) {
    return {"background-color" : "#35c433"};
} else { 
    return { "background-color" : "red" };
}

单元格内容函数

“Cell content function” 允许根据值、实体或 ctx 修改数据key列文本。配置时需勾选 Use cell content function，并在下方 Cell content function 字段中输入函数。

示例中设备有两种返回：true或false。Cell content function可修改返回文本显示，适用于设备数量不多的场景。

Click "pencil" icon to next to the "active" key;

Check the "Use cell content function" box and input the function in the "Cell content function" field and save all changes.

The cell content function will change the text in the device name row based on the device's status.

if (value == "true") {
    return "Active";
} else {
    return "Inactive";
}

但有时通过返回文本来判断设备是否在线并不方便。 Cell content function提供更友好的方式，可通过自定义函数以图标等形式展示设备的在线/离线状态（参见下方示例）。

The cell content function will change the color of the icon in the device name row based on the device's status.

用于显示在线/离线状态的函数示例：

if (value == "true") {
    return '<div style="border-radius:50%;background-color:green;width:18px;height:18px"></div>';
} else {
    return '<div style="border-radius:50%;background-color:red;width:18px;height:18px"></div>';
}

默认列可见性

“Default column visibility” 用于选择数据key列在部件中是否默认可见或隐藏。导出部件需排除特定数据key时特别有用。

Select whether the column will be shown in the visibility selection menu so that clients without permissions will not be able to hide it.

显示列

“Column selection in ‘Column to display’“ 用于选择该列是否出现在可见性选择菜单中。无权限的客户端将无法隐藏该列。

导出时包含列

“Include column in export” 用于选择在何种条件下导出部件时包含该数据key列。选项包括：always、仅当列可见时（可在 default column visibility 中修改可见性）和never。

Charts数据key配置

“Charts”部件bundle的高级数据key配置与其它bundle不同。

下面以“Charts”bundle中的“Timeseries Line Chart”部件为例说明数据key配置。

请按下列步骤开始数据key的高级配置。

Open the dashboard and enter edit mode by clicking the button in the top right corner of the screen.;
In the top right corner of the widget, click the "pencil" icon to open the widget editing window;
Now, click "pencil" icon to next to the key that you want to edit;
The data key configuration window has been opened. Navigate to the "Advanced" tab to open advanced data key configuration.