别名

介绍

别名是对小部件中使用的单个实体或一组实体的引用。别名可以是静态的或动态的。要创建仪表板，您首先需要创建别名来定义将使用实体的数据。别名可以像引用单个设备一样简单，也可以像为列表中的特定资产创建复杂的搜索查询一样复杂。

在本教程中，将根据下面所示的方案在系统上使用别名，并且所有设备都有“温度”生成值：

别名类型

单一实体

此别名允许选择单个实体。它可以是设备、资产、实体视图、租户、客户、仪表板、数据转换器、调度程序事件、blob 实体或当前客户。在示例中，创建了一个别名来过滤一个设备，在本例中为温度计 1。

让我们学习如何添加单个实体别名：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择单一实体过滤器类型。从“类型”下拉菜单中，选择“ 设备” 并输入所需设备的名称（开始输入名称，系统会自动找到该名称）。
配置好别名后，点击右下角的“添加”按钮。
我们现在可以看到添加了一个新的别名。单击对话框右下角的“保存”。

让我们在小部件中使用添加的别名：

单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型，从列表中选择别名，然后添加遥测数据。
单击对话框右下角的“添加”按钮。
添加了具有过滤一台设备的别名的小部件。
不要忘记单击屏幕右下角的橙色大复选标记来保存所有更改。

实体清单

此别名允许手动选择多个实体，而无需输入查询，这些实体可以是设备、资产、实体视图、租户、客户、仪表板、数据转换器、调度程序事件、blob 实体或客户。在此示例中，创建了一个别名来过滤多个设备的列表。

让我们学习如何添加实体列表别名：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择实体列表过滤器类型。从类型下拉菜单中，选择设备并输入各个设备的名称（开始输入名称，它将自动找到）。
配置好别名后，点击右下角的“添加”按钮。
我们现在可以看到添加了一个新的别名。单击对话框右下角的“保存”。

现在让我们在小部件中使用添加的别名：

单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型，从列表中选择创建的别名的名称，并添加遥测。
单击对话框右下角的“添加”按钮。
添加了带有别名的小部件，用于过滤多个设备的列表，在本例中为设备 D 和设备 E。
不要忘记单击屏幕右下角的橙色大复选标记来保存所有更改。

实体名称

此别名允许选择以输入的查询开头的一个或多个实体名称，这些实体名称可以是设备、资产、实体视图、租户、客户、仪表板、数据转换器、调度程序事件、blob 实体或客户。在此示例中，创建了一个别名来过滤以“Compressor”开头的设备。

让我们学习如何添加实体名称别名：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择过滤器类型 实体名称 。从类型下拉菜单中，选择设备并输入名称或仅输入名称的开头，将按该名称过滤设备。
配置好别名后，点击右下角的“添加”按钮。
我们现在可以看到添加了一个新的别名。单击对话框右下角的“保存”。

现在让我们在小部件中使用添加的别名：

单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型，从列表中选择创建的别名的名称，并添加遥测。
单击对话框右下角的“添加”按钮。
添加了带有别名的小部件，用于过滤名称以“Device”开头的设备。
不要忘记单击屏幕右下角的橙色大复选标记来保存所有更改。

仪表板状态中的实体

此别名允许从仪表板状态中选择实体，可以是设备、资产、实体视图、租户、客户、仪表板、数据转换器、调度程序事件、blob 实体或当前客户。它用于过滤其他仪表板状态的数据。例如，如果在根仪表板状态上创建时间序列小部件，并在其上显示多个实体，并且您希望创建一个仪表板状态，该状态将显示带有您单击的实体的小部件，则需要使用此别名。

以下示例在为组实体创建别名后使用别名。

让我们学习如何从仪表板状态别名添加实体：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，从仪表板状态过滤器类型中选择实体。
单击对话框右下角的“添加”。
添加两个别名后，单击对话框右下角的“保存”。

现在让我们在小部件中使用添加的别名并添加一个状态来查看该别名的工作原理：

单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、实体列表别名和添加遥测。单击右下角的“添加”以添加小部件。
添加小部件后，单击仪表板左上角的图层图标以创建新状态。在打开的对话框窗口中，单击“+”图标添加新状态。
输入状态名并单击“添加”。
现在您会看到一个具有两种状态的列表：一种是根状态，另一种是刚刚创建的状态。单击对话框右下角的“保存”。

是时候向根仪表板小部件添加操作，并使用仪表板状态别名中的实体在已创建状态的小部件上执行该操作：

在根仪表板状态下，进入小部件编辑模式，点击小部件右上角的“铅笔”图标即可进入小部件的编辑模式。
移至“操作”单元格并单击“+”图标以添加新操作。
在“添加小部件”对话框中，选择分别负责每个实体的操作源（操作单元格按钮、行单击等）
输入操作的名称。
如有必要，选择代表按钮的图标以执行操作。
选择导航到新仪表板状态操作类型并将新创建的状态设置为目标仪表板状态。单击“添加”将新操作添加到小部件。
成功添加操作后，单击屏幕右上角的大橙色勾号以应用更改。
然后，通过单击右上角的图层图标从下拉菜单中选择它，进入创建状态。
单击屏幕中央的“添加新小部件”图标。在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型并从仪表板状态别名中选择实体。单击右下角的“添加”。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

通过单击所需实体对面的按钮，您将转换到内部状态，该状态显示带有仪表板状态详细信息中的实体的小部件。

资产类型

此别名允许选择输入类型（以及，如果需要）名称以输入查询开头的资产。此别名过滤“field”类型且名称以“Build”开头的资产。

让我们学习如何添加资产类型别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择资产类型过滤器类型。
从下拉菜单中选择资产类型并输入资产名称的开头。单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、资产类型别名，点击右下角“添加”即可添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

设备类型

此别名允许选择输入类型（以及，如果需要）名称以输入查询开头的设备。此别名过滤“设备”类型的设备。

让我们学习如何添加设备类型别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择设备类型过滤器类型。
从下拉菜单中选择之前创建的设备类型，然后单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、设备类型别名和添加遥测。单击右下角的“添加”以添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

实体视图类型

此别名允许选择输入类型（以及，如果需要）名称以输入查询开头的实体视图。名为“压缩机 LK-45 实体视图”和“压缩机 ZX-77 实体视图”的实体视图是使用“压缩机实体视图类型”类型创建的，该类型提供对压缩机 LK-45 和压缩机 ZX-77 中“功率”时间序列的访问。此别名过滤类型为“压缩机实体视图类型”且名称以“压缩机”开头的实体视图。

让我们学习如何添加实体视图类型别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择实体视图类型过滤器类型。
从下拉菜单中选择先前创建的实体视图类型，然后输入实体视图名称的开头。单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
从下拉选择小部件菜单中，选择卡片包。在单元格“最新值”中，选择一个实体表小部件。
选择实体视图类型别名并添加遥测。单击右下角的“添加”以添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

API使用状态

YICONNECT平台主菜单中有API使用布局。API 使用情况显示平台上的完整统计数据。 Api 使用状态别名允许仅从用户仪表板统计中获取您需要的数据。

让我们学习如何添加 Api 使用状态别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择Api 使用状态过滤器类型。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、Api 使用状态别名并添加从 API 使用状态获取统计信息的遥测数据。单击右下角的“添加”以添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

关系查询

此别名允许选择与指定发起者在指定级别和指定方向相关的实体。

在示例中，别名过滤具有从资产“A 区”到关系级别 2 的任何关系的实体。

让我们学习如何添加关系查询别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择关系查询过滤器类型。
选择资产类型并选择资产。将方向设置为“From”并将最大关系级别设置为 2。
单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、关系查询别名并添加遥测。单击右下角的“添加”以添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

资产搜索查询

此别名允许选择与指定发起者相关的指定类型的资产，直至指定级别和指定方向。此别名过滤类型为“field”的资产，这些资产与关系级别为 2 的设备“Compressor ZX-77”有任何关系。

让我们学习如何添加资产搜索查询别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择资产搜索查询过滤器类型。
选择设备类型并选择设备。将方向设置为“至”并设置最大关系级别 2. 输入资产类型。
单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
在打开的小部件包选择中，单击“Cards”。在那里选择实体表小部件。
输入数据源：实体类型、资产搜索查询别名并添加遥测。单击右下角的“添加”以添加小部件。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

设备搜索查询

该别名允许选择与指定发起者相关的指定类型的设备，直至指定级别和指定方向。此别名筛选类型为“设备”的设备，这些设备具有从资产“建筑 A”到关系级别 1 的任何关系。

让我们了解如何添加设备搜索查询别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择设备搜索查询过滤器类型。
选择资产类型并选择资产。将方向设置为“From”，最大关联级别为 1。输入设备类型。
单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
从下拉选择小部件菜单中，选择卡片包。在单元格“最新值”中，选择一个实体表小部件。
选择设备搜索查询别名并添加遥测。单击对话框右下角的“添加”。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。

实体视图搜索查询

此别名允许选择指定类型的实体视图，这些视图与指定的发起者在指定的级别和指定的方向上相关。名为“压缩机 ZX-77 实体视图”的实体视图与 Compressor ZX-77 具有“包含”关系，是使用类型“压缩机实体视图类型”创建的，该类型提供对 Compressor ZX-77 中“功率”时间序列的访问。此别名过滤类型为“压缩机实体视图类型”的实体视图，这些视图具有从设备“压缩机 ZX-77”到关系级别 1 的任何关系。

让我们了解如何添加设备搜索查询别名并在小部件中使用它：

进入仪表板编辑模式。
在窗口的右上角，单击“实体别名”图标。
在打开的实体别名窗口中，单击对话框左侧的“添加别名”按钮。
在打开的对话框添加别名中，输入别名的名称，选择实体视图搜索查询过滤器类型。
选择设备类型并选择资产。将方向设置为“From”，最大关系级别为 1。输入实体视图类型。
单击对话框右下角的“添加”。
添加别名后，单击对话框右下角的“保存”。
单击屏幕中央的“添加新小部件”图标。
从下拉选择小部件菜单中，选择卡片包。在单元格“最新值”中，选择一个实体表小部件。
选择实体视图搜索查询别名并添加遥测。单击对话框右下角的“添加”。
添加小部件后，单击屏幕右下角的大勾号图标以保存所有应用的更改。