10.3 使用插件
连接到 IDMP 后，TDengine EAI 功能区选项卡提供了用于检索数据、浏览事件、过滤资产和配置插件的所有工具。每个按钮都会在 Excel 右侧打开一个任务窗格，您可以在其中配置查询并选择输出单元格。
功能区概览
| 按钮 | 说明 |
|---|---|
| 当前值 | 检索一个或多个属性的最新值 |
| 历史值 | 检索特定时间点的属性值 |
| 原始数据 | 检索某一时间范围内的原始时序数据 |
| 采样数据 | 按固定间隔采样检索时序数据 |
| 时间点数据 | 检索特定时间戳处的属性值 |
| 计算数据 | 检索时间窗口内的聚合（计算）值 |
| 时间过滤 | 按状态或条件表达式过滤后检索数据 |
| 事件浏览器 | 查询并导出 IDMP 中的事件 |
| 属性过滤 | 搜索并导出属性元数据 |
| 资产过滤 | 搜索并导出元素（资产）元数据 |
| 属性 | 检索元素属性的特定元数据属性 |
| 更新 | 刷新工作簿中的所有数据 |
| 设置 | 配置插件全局设置 |
公共字段
大多数数据检索表单共用以下字段：
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的 IDMP 元素属性。点击搜索图标可浏览资产层级并选择一个或多个属性。 |
| 输出单元格 | 写入结果的 Excel 单元格。默认为当前选中的单元格（如 Sheet1!A1）。 |
| 时间位置 | 时间戳与数据的排列方式：不显示时间戳（仅显示值）、时间在左侧（时间戳在左列）或时间在顶部（时间戳在上方行）。 |
点击确定可插入数据并关闭窗格；点击应用可插入数据并保持窗格打开以继续查询。
当前值
检索所选属性的最新值并写入输出单元格。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 输出单元格 | 目标单元格 |
| 时间位置 | 不显示时间戳 / 时间在左侧 / 时间在顶部 |
历史值
检索特定历史时间戳处的属性值，支持空值填充。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 填充类型 | 当时间戳处无精确值时的填充方式：前一个非空值（使用之前最近的已知值），或其他填充策略 |
| 时间戳 | 要查询的特定时间戳（必填） |
| 输出单元格 | 目标单元格 |
| 时间位置 | 不显示时间戳 / 时间在左侧 / 时间在顶部 |
原始数据
检索某一时间范围内所有原始时序数据点，不做任何聚合。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 开始时间 | 时间范围的起始时间（必填） |
| 结束时间 | 时间范围的结束时间（必填） |
| 输出单元格 | 输出范围的左上角单元格 |
| 时间位置 | 不显示时间戳 / 时间在左侧 / 时间在顶部 |
采样数据
按固定间隔对时间范围内的时序数据重新采样。无论原始数据频率如何，均可获得均匀间隔的序列。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 开始时间 | 时间范围的起始时间（必填） |
| 结束时间 | 时间范围的结束时间（必填） |
| 时间间隔 | 重采样间隔（如 1h、30m、1d） |
| 过滤表达式 | 可选的过滤条件，在采样前排除特定数据点 |
| 输出单元格 | 输出范围的左上角单元格 |
| 时间位置 | 不显示时间戳 / 时间在左侧 / 时间在顶部 |
时间点数据
检索您提供的一个或多个特定时间戳处的属性值，支持空值填充。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 填充类型 | 当给定时间戳处无精确值时的填充方式（如前一个非空值） |
| 时间戳 | 要查询的特定时间戳（可多个） |
| 输出单元格 | 目标单元格 |
| 时间位置 | 不显示时间戳 / 时间在左侧 / 时间在顶部 |
计算数据
检索按固定时间窗口聚合后的数据——例如每小时平均值、每日最大值或每班次求和。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 开始时间 | 时间范围的起始时间（必填） |
| 结束时间 | 时间范围的结束时间（必填） |
| 时间间隔 | 聚合窗口大小（如 1h） |
| 过滤表达式 | 聚合前应用的可选过滤条件 |
| 聚合函数 | 要应用的聚合函数（必填）。支持所有每窗口返回一行数据的 TDengine 选择和聚合函数（如 AVG、MAX、MIN、SUM、COUNT、FIRST、LAST、TOP、BOTTOM）。 |
| 输出单元格 | 输出范围的左上角单元格 |
| 时间选项 | 可选择在聚合值旁显示开始时间、结束时间或最大/最小时间列 |
时间过滤
检索在由开始表达式和结束表达式定义的状态或条件期间内的数据——适用于仅提取特定运行条件下的数据（例如机器处于运行状态时）。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 表达式 — 开始条件 | 标记有效时段开始的条件表达式（必填） |
| 表达式 — 结束条件 | 标记有效时段结束的条件表达式（必填） |
| 开始时间 | 搜索范围的起始时间（必填） |
| 结束时间 | 搜索范围的结束时间（必填） |
| 时间间隔 | 每个有效时段内数据点的间隔 |
| 时间单位 | 时间间隔的单位（如秒） |
| 输出单元格 | 输出范围的左上角单元格 |
| 时间选项 | 可选择显示开始时间和/或结束时间列 |
事件浏览器
查询 IDMP 事件并将结果以表格形式导出到电子表格中，支持按多种条件过滤。
| 字段 | 说明 |
|---|---|
| 名称 | 按事件名称过滤 |
| 描述 | 按事件描述过滤 |
| 模板 | 按事件模板过滤 |
| 严重级别 | 按严重程度过滤（全部、警告、严重等） |
| 是否已确认 | 按确认状态过滤 |
| 创建时间 | 按事件创建时间范围过滤 |
| 更新时间 | 按最后更新时间范围过滤 |
| 最大结果数 | 返回的最大事件数（默认：1000） |
| 排序方式 | 排序字段，支持升序或降序 |
| 元素条件 — 根路径 | 将结果限定为特定资产树路径下的元素关联事件 |
| 输出单元格 | 输出表格的左上角单元格 |
| 显示列 | 选择在输出表格中包含哪些事件字段作为列。多选选择器允许从所有可用事件字段中选择（如确认状态、状态等）。 |
属性过滤
搜索 IDMP 属性元数据并将结果导出为表格，适用于审计数据模型或构建动态引用。
| 字段 | 说明 |
|---|---|
| 属性名称 | 按属性名称过滤 |
| 属性描述 | 按属性描述过滤 |
| 属性分类 | 按属性分类标签过滤 |
| 属性值类型 | 按数据类型过滤（Float、Int、Bool 等） |
| 最大结果数 | 最大结果数（默认：1000） |
| 排序方式 | 排序字段，支持升序或降序 |
| 元素条件 | 按拥有该属性的元素过滤：根路径、名称、描述、分类、模板 |
| 输出单元格 | 输出表格的左上角单元格 |
| 显示列 | 选择在输出表格中包含哪些属性字段作为列。多选选择器允许从所有可用属性字段中选择（如名称、描述等）。 |
资产过滤
搜索 IDMP 元素（资产）并将结果导出为表格。
| 字段 | 说明 |
|---|---|
| 根路径 | 将结果限定为资产树中特定路径下的元素 |
| 名称 | 按元素名称过滤 |
| 描述 | 按元素描述过滤 |
| 属性名称 | 过滤具有匹配该名称属性的元素 |
| 属性描述 | 按元素上的属性描述过滤 |
| 分类 | 按元素分类过滤 |
| 模板 | 按元素模板过滤 |
| 创建时间 | 按元素创建时间范围过滤 |
| 更新时间 | 按最后更新时间范围过滤 |
| 最大结果数 | 最大结果数（默认：1000） |
| 排序方式 | 排序字段，支持升序或降序 |
| 输出单元格 | 输出表格的左上角单元格 |
属性
检索元素属性的特定元数据属性（如计量单位、描述或配置的限值），并写入单元格。
| 字段 | 说明 |
|---|---|
| 数据项 | 要查询的属性（必填） |
| 属性 | 要检索的元数据属性（如计量单位、描述、高限值） |
| 输出单元格 | 目标单元格 |
更新
点击功能区中的更新可刷新工作簿中的所有数据。由 TDengine EAI 插件填充的每个单元格都会使用原始参数重新查询并以最新结果更新。
无需逐个重新打开表单即可保持工作簿数据的实时性。如需定期自动刷新，请在设置中配置间隔。
设置
配置插件的全局默认值。
| 字段 | 说明 |
|---|---|
| 时间格式 | 将时间戳写入单元格时使用的格式（默认：YYYY-MM-DD HH:mm:ss） |
| 数字格式 | 应用于数值输出单元格的 Excel 数字格式（默认：General） |
| 最大事件浏览器搜索数 | 事件浏览器查询的默认最大结果数（默认：1000） |
| 最大属性/资产过滤数 | 属性过滤和资产过滤查询的默认最大结果数（默认：1000） |
| 间隔（秒） | 自动刷新间隔（秒）。设为 0 可禁用自动刷新。 |
点击确认保存设置。
