Workiva Support Center

为了与 Chains 工件的最佳实践保持一致，建议对 Wdata 对象（例如 Tables 和 Queries）实施一致的命名约定，以便于更轻松地导航和管理。这里提供的指南旨在帮助您从一开始就以一致的方式组织资料。

事实表和维度表

事实表通常包含随时间累积的数据，而维度表存储补充数据集，为数据提供额外的上下文。命名这两种类型的表时，请考虑以下最佳实践：

• 命名约定： 使用一致的命名约定，清楚地表明事实表和维度表的用途和内容。
• 描述性名称： 为两种类型的表应用描述性名称，以确保它们易于识别和理解。
• 源系统： 在名称中包含数据的原始系统。

例如：

• 事实表： 试算表 - Workday

  描述： 存储来自 Workday 的 Avikro Financial 的试算表交易数据。

• 维度表： 会计科目表 - Workday

  描述： 存储来自 Workday 的 Avikro Financial 的会计科目表数据。

• 维度表： 利润中心 - SAP

  描述： 存储来自 SAP 的 Avikro Financial 的利润中心信息。

• 维度表： 汇率 - 中央银行 API

  描述： 提供 Avikro Financial 的货币转换汇率，数据来源于中央银行 API。

该模板确保事实表和维度表的命名约定一致、描述清晰，并能准确识别源系统。

查询

在定义查询命名规则时，保持标准方法至关重要。这样可以确保用户能够轻松找到用于检索特定数据的正确查询。

• 命名约定： 使用一致的命名约定，明确定义查询的目的和内容。
• 描述性名称： 为查询应用描述性名称，以便于轻松识别和理解。
• 源系统： 指定数据的来源系统。

例子：

• 查询名称： 扩展试算表 - Workday - 财务报表

  描述： 此查询从 Workday 检索试算表数据，以及为生成财务报表而定制的补充数据集。

注意： 务必避免在 表和查询中使用管道分隔符 (| ) 。请改用连字符（-）以避免这些工件可能出现的任何问题。

遵循此命名约定还可以明确在创建与电子表格的传入连接时应该使用哪个查询。

描述

描述往往是设计和构建过程中最容易被忽视的部分，但它们对于提高理解和可用性至关重要。描述应提供更多背景信息，例如：

• 指示表或查询是否为占位符。
• 注意查询语句在使用前是否需要编辑。
• 明确查询等工件的具体功能，例如识别比上一时期减少不到 20% 的付款。

通过提供清晰详细的描述，用户可以快速掌握每个工件的用途和内容，从而减少混淆、最大限度地减少错误，并提高管理 Wdata 环境的整体效率。

文件夹/环境

整理工作区时，建议根据表格和查询的预期用途，将它们分类到不同的文件夹中。这种结构使用户能够轻松浏览和确定哪些工件指定用于开发、测试和生产。

由于 Wdata 目前缺乏对开箱即用的应用程序生命周期管理的支持，建议在工件和文件夹名称后附加名称，以指示它们各自的环境。这有助于管理应用程序生命周期，避免任何错误或问题。请注意，生产环境中的工件不需要附加名称。