填报静态数据¶

DTV 为单页应用提供静态数据填报入口。当页面启用该功能并发布后，应用开发人员或终端用户可以灵活地填写或修改一套静态数据，而无需修改或污染真实的业务数据库。在查看正式页面时，终端用户可以一键切换数据视图，在接入数据和静态数据之间进行对比或演示。

静态数据填报功能主要提供以下业务价值：

填报与接入分离：填报数据可用于测试或演示，避免使用真实业务数据可能带来的敏感信息泄露或误解风险，也可满足部分需要展示静态数据的可视化场景，提供所见即所得的数据填报和可视化渲染。
提升协作效率：产品经理或业务人员无需依赖开发人员准备数据，可通过填报 URL 自行填写符合场景的演示数据，极大缩短了演示准备的链路。
保护生产环境：所有静态数据操作均在独立环境中进行，与真实生产数据库完全隔离，确保了数据环境的纯净与安全。
灵活集成：填报页面既可单独打开使用，也可无缝嵌入到 EnOS 原生应用或第三方应用中，提供一体化的体验。

本文面向应用开发人员，介绍如何配置和填报静态数据。

关键概念¶

使用静态数据填报功能前，了解以下概念将帮助你理解后续操作流程。

静态数据主键¶

静态数据主键是你在填报静态数据时，用来唯一标识一条数据记录的字段或字段组合，类似于数据库表中的主键。

主键的作用是匹配和更新。设置主键后，系统将根据你提交数据中的主键值来判断是更新现有数据还是新增数据，避免数据被意外覆盖。

主键的可选范围是组件中正在使用的原始数据项，包括：

维度：维度中已添加的原始数据项，以及计算字段中使用的原始数据项。
度量：指标、对比、扩展中已添加的原始数据项，以及计算字段中使用的原始数据项。
其他：组件与导航器联动时关联的数据项。例如组件的 timestamp 数据项没有添加到维度或度量中，仅用于与时间筛选器关联，timestamp 数据项也可设为主键。

为确保主键值的唯一性，可选择一个或多个数据项作为静态数据主键：

当单个数据项可唯一标识数据时，可直接指定该数据项为主键，如“资产 ID”可以唯一确定一个资产。
当单个数据项无法保证唯一性时，可指定多个数据项组合成一个主键，如“年份+资产ID”能唯一确定资产在某年的一条数据。

静态数据时间间隔¶

静态数据时间间隔是静态数据的粒度标识和聚合依据，定义了该组件单条静态数据所代表的时间长度。当用户在页面指定时间筛选条件时，静态数据可与时间筛选器进行联动和聚合计算。

例如，当组件的静态数据时间间隔为“日”时，填报的每一个数值代表一整日的汇总值，如日销售额。当用户在页面的时间筛选器中指定时间范围为 2025 年 9 月时，DTV 可对 9 月每一日的静态数据进行求和汇总，得出 9 月销售总额，展示在组件中。

配置静态数据时间间隔时需注意：

仅当组件数据项与时间筛选器联动时，静态数据时间间隔对该组件有效。
当组件未指定静态数据时间间隔，或组件未与时间筛选器联动时，默认时间间隔为日。
当图表内指定的时间间隔大于时间筛选器的时间范围时，图表内容不会发生任何变化。例如静态数据时间间隔为“日”，而时间筛选器中选择的时间范围是“15分钟”，此时组件仍然展示日数据。

操作流程¶

静态数据填报流程如下：

启用填报功能：为页面启用静态数据填报功能。
配置静态数据主键：为需要支持静态数据填报的组件选择主键。
配置静态数据时间间隔（可选）：如需组件内静态数据跟随页面时间筛选器联动，可配置静态数据时间间隔。
获取填报 URL：发布页面，获取页面的填报URL。
填报静态数据：通过在线填写或批量导入的方式，在填报页面填入静态数据。
在运行态切换数据视图：在终端页面切换视图，查看静态数据页面。
为终端用户提供填报入口（可选）：根据需要将填报页面提供给终端用户，授权终端用户填报静态数据。

前提条件¶

确保已拥有 DTV 产品的访问权限。若无可联系 OU 管理员。
确保在 DTV 中已创建单页应用页面，且已为页面中的组件配置数据。

备注

如果页面已保存过填报的静态数据，再次修改静态数据设置并发布后，会影响已填报的数据，需要重新填报数据。

步骤 1：启用静态数据填报功能¶

在 DTV 中心 的 单页应用 标签页，选择目标单页应用的编辑按钮，进入配置页面。
在 基础配置 步骤中，勾选 支持填报静态数据。
在下拉框中指定页面 默认展示静态数据 或 默认展示接入数据。

终端用户首次访问页面时将看到默认展示的数据，并可以在运行态切换数据来源。

步骤 2：配置静态数据主键¶

在 DTV 中心，进入单页应用配置页面，选择 画布配置。
依次打开需要配置静态数据的组件配置弹窗，进入数据标签页。
确保组件已配置数据。如何配置数据，参见配置数据。
在 静态数据主键 项选择配置。
在弹窗中勾选一个或多个数据项作为主键，或选择 使用推荐主键，系统自动勾选出推荐的数据项。
勾选完成后选择确定，完成配置。

步骤 3：（可选）配置静态数据时间间隔¶

如需组件达到以下效果，你需要为组件配置静态数据时间间隔：

组件需要展示时间序列趋势。
期望组件的静态数据能与页面时间筛选器智能联动。

配置前需确认：

页面已添加时间类导航器，如时间筛选器。更多信息，参见配置时间筛选器。
组件与时间筛选器已建立联动关系。更多信息，参见关联导航器和组件。

确认无误后，按照以下步骤配置时间间隔：

在 画布配置 步骤，打开组件配置面板。
进入数据标签页，在 静态数据主键 配置项的下方，选择一个粒度作为静态数据时间间隔。建议静态数据时间间隔小于时间筛选器支持的时间间隔，否则静态数据无法跟随时间筛选器进行聚合展示。

例如当时间筛选器支持的间隔为周时，静态数据时间间隔为日，此时 DTV 可通过计算当周每日的数据总和，得出周数据。若静态数据时间间隔为月，无法通过月数据计算出周数据，组件仍然展示月数据。

步骤 4：获取静态数据填报页面 URL¶

可选择以下一种方式获取填报 URL：

进入单页应用的配置页面，选择右上角的发布。发布页面成功后，你可以从页面弹窗中获取 静态数据填报页面 URL。更多信息，参见检查和发布页面。

注意：
- 发布时选择的页面 可见范围 同时影响静态数据填报页面的可见范围：
  - 内部：页面发布后仅当前 OU 可见。仅拥有当前 OU 访问权限的用户，可通过 URL访问该页面及其填报页面。
  - 公开：页面发布后对当前环境内全部 OU 可见。所有用户均可通过 URL 访问该页面及其填报页面。
- 已发布的页面再次发布后，页面 URL 和填报 URL 不变，不随页面更新而更改。
页面发布后，在配置页面的右上角，选择 其它 > 发布信息，获取 静态数据填报页面 URL。

步骤 5：填报静态数据¶

你可以在填报页面通过在线填报或批量导入的方式填报静态数据，并在页面中进行联动验证。

按照以下步骤填报静态数据：

在浏览器访问填报页面 URL。
每个画布标签页内展示当前画布中已配置静态数据主键的组件，在第一次填报前，每个组件的静态数据为空。
选择以下一种方式添加数据：
- 在线填报：依次选择每个组件对应的编辑按钮，打开弹窗。弹窗中展示组件数据项列表，列是组件正在使用的数据项，选择 添加数据 可添加一行静态数据。
- 按画布导入：依次在每个画布标签页中选择 下载模板，一个模板文件对应一个画布，文件中一个工作表对应一个图表。填入后选择 导入数据，上传文件。
- 按组件导入：若仅需为某个组件配置静态数据，可选择组件对应的下载按钮，下载组件的模板文件，填入后选择 导入数据，上传文件。
  
  注意：如果页面已保存过填报的静态数据，当组件的静态数据主键或数据源配置被修改后，你可以选择组件对应的下载按钮，下载修改前和修改后的两份数据。
按画布导入或按组件导入时，若某一组件联动时间筛选器，弹窗提示选择时间粒度和范围。
- 时间粒度 默认为当前组件的静态数据时间间隔，若当前组件未配置静态数据时间间隔，默认为日。如有需要，你可以在弹窗内重新指定。
- 生成范围 是指系统根据所选时间粒度，为模板文件中与时间筛选器关联的数据项自动生成的时间值范围。例如，若选择时间粒度为月，生成范围为 2025-09 至 2025-10，且组件与时间筛选器联动的数据项为 time，则下载的模板文件中 time 字段将自动填充两行数据，第一行为 2025-09-01 00:00:00，你需要在该行填入 2025 年 9 月的月度数据，第二行为 2025-10-01 00:00:00，你需要在该行填入 2025 年 10 月的月度数据。
在线填报或在文件模板中填报时，需注意：
- 静态数据主键的值在当前组件中必须唯一。
- 若组件与导航器关联，建议关联数据项的值与导航器提供的值满足联动条件，否则无法产生联动效果。
- 若组件中使用了计算字段，填报时需填报原始字段的值，填报后系统将展示计算字段，并自动生成计算字段的值。
如需指定部分组件不展示填报数据，或不展示接入数据，可在填报页面中选择 组件管理，将组件移动至对应列表中。当终端用户在页面切换数据来源为填报时，填报数据 列表中的组件将展示填报数据，其余组件仍展示接入数据。
依次切换标签页，为所有画布和组件填报数据。
配置后，可在填报页面顶部切换导航器选项，选择右上角的查询，检查填报数据是否跟随导航器筛选和聚合。