搭建并管理财务模型

创建财务模型

1. 登录先胜云，选择目标空间，点击进入目标应用，即进入 元素管理 界面，点击 + 新建，在 组件 类型中选择 财务模型。

2. 进入财务模型创建方式选择界面，根据项目类型，可以选择通用模板或合并报表模板。 两种模板的区别在于预设的维度类型不同，非合并报表项目建议选择通用模板。

   

通过模板引导一步步创建财务模型。具体的操作可以参考 快速入门 。这里我们重点说明模板中的一些配置：

修改字段配置

在模板配置完成，点击加载模板后。用户可以看到财务模型的主视图。在这里，用户可以调整字段和维度顺序，并为每个字段配置更细节的属性。

分布式数据表

对于数据量庞大的财务模型，使用分布式数据表可以有效提升数据查询效率。在使用分布式数据表前，请确认服务器上deepengine数据库已经按照分布式方式部署。 点击财务模型主视图中央的数据表表头，在右侧工具栏可以配置分布式数据表相关属性。数据表默认以非分布式数据表创建，开启分布式选项后，用户可以配置“分片键字段”和“分片策略”两个属性。

• 分片键字段是数据分布的依据，通常选择数据分布较为平均的期间字段Period。

• 分片策略决定了数据在不同分片上的分布规则，目前支持两种策略“均衡分配策略”和“期间数据倾斜策略”。

  • 均衡分配策略适配大多数场景，选择均衡分配策略后，数据将平均的分布在各个数据库分片上。

  • 期间数据倾斜策略只有当分片键字段是期间时才可选，期间数据倾斜策略通常用在数据库主节点硬件配置高，而分支节点配置低的场景。

  

保存

设置完财务模型属性和字段之后，点击右上角 保存 按钮，在弹框中输入编码等必填信息后，点击 确定，即完成了财务模型的创建。 需要注意，财务模型的大部分配置在保存后或数据库有数据之后无法修改，所以请提前规划好财务模型属性配置，确认无误后再进行创建保存。

MainTable 与模型结构

财务模型保存后，系统会生成并关联用于存储明细数据的事实主表，即 MainTable。不同环境中的物理表名可能带有应用前缀或随机后缀，但从模型结构上看，MainTable 承载的是财务模型的明细数据。

模型中的每个维度字段都会落到 MainTable 的一个维度列上。数据保存时，系统按全部维度列的成员组合定位一条明细数据，再把度量值写入对应的值列；在 ClickHouse / DeepEngine 场景下，数值和文本通常分别进入 decimal_val、string_val 这类度量列。

因此，调整模型维度字段本质上是调整 MainTable 的数据坐标结构。模型已有数据后，如果新增维度字段，历史行数据缺少该维度列的成员值；如果减少维度字段，原来按该维度拆分的数据需要先确定合并口径。除 MainTable 外，财务模型还会维护批注表、附件表、日志表等关联表，这些表也会按模型维度结构同步维护，所以不能只把维度增减理解为页面配置变更。

维度关联管理

当财务模型关联了多版本实体维时，可在高级设置中配置维度字段之间的联动策略（如 UD 策略），确保不同实体在汇算时使用各自正确的维度属性。

详见 维度关联管理。

关联元素管理

财务模型保存时，系统会根据配置自动关联或创建以下配套元素：

• 数据表：存储财务模型的明细数据

• 注释表：支持在单元格维度附加文字注释

• 附件表：支持在指定维度组合上传附件文件

• 日志表：记录财务模型的操作日志

若配套元素因迁移或删除等原因缺失，可在财务模型设置中点击 自动创建缺失关联元素，系统一键补全所有缺失的配套元素，避免使用时出现功能异常。

导入与导出

财务模型支持批量导入和导出以下配置数据，便于在不同环境之间迁移或批量维护：

• 审批单元配置：导出当前财务模型的审批单元角色配置，导入到其他财务模型或其他环境，避免逐条重复配置。

• 读写权限配置：批量导出权限配置表格，修改后重新导入，适合权限调整范围较大的场景。

操作入口：财务模型编辑视图 → 高级设置 → 权限配置 → 导入/导出。

无权限与无效数据展示配置

当用户查询到无权限或维度成员已失效的数据时，财务模型支持配置展示方式：

• 默认方式：系统统一用内置占位符（如 #N/A）显示无权限或无效数据，风格一致。

• 自定义方式：可以分别为”无权限数据”和”无效数据”配置各自的展示文本，例如将无权限数据显示为”–”，将无效数据显示为空白，以满足不同业务场景下的展示要求。

此配置在财务模型高级设置中完成，修改后对所有引用该模型的电子表格即时生效。

保存后置管理

财务模型支持在保存成功后自动触发后续操作（回调），用于数据联动和业务流程衔接。

入口：财务模型编辑视图 → 高级设置 → 保存后置管理

支持三种回调类型：

配置回调时，需要选择对应的回调元素（Python 脚本或合并流程元素），并选择回调方式（同步或异步执行）。