文档中心配置指标公式
本文说明如何在 Account 科目维的成员上维护指标公式、公式说明及依赖关系。配置完成后，Python 项目、电子表格等调用方可读取该公式，并在各自指定的计算范围内执行。
指标公式用于定义“这个科目成员如何计算”，不负责指定何时计算、在哪些维度成员范围内计算，或按什么顺序计算。
使用前提
-
当前维度为 Account 科目维。其他维度暂不支持配置指标公式。
-
当前用户已具备该维度的编辑权限。
-
需要引用其他维度成员时，建议确认当前 Account 维已关联至少一个财务模型。关联模型仅用于辅助输入，不会写入公式。
根节点 #root 不支持指标公式：选中该节点时不会显示“指标公式”页签。
指标公式的基本规则
使用deepcube语法
指标公式的语法使用多维计算deepcube的语法，与Python-deepcube模式中的语法，变量名完全一致。具体语法可以参考：
-
Python-deepcube模式：Python-deepcube模式
公式绑定当前成员
指标公式挂在某一个 Account 成员上，表示该成员的计算规则，但是只需要写来源集的部分，即等号右边。
例如，为 GrossMargin（毛利）成员配置公式时，编辑器中只填写右值表达式：
BLOCK[Account['Revenue']] - BLOCK[Account['Cost']]
不需要、也不能在编辑区填写 GrossMargin = 等赋值左侧；当前选中的 Account 成员就是计算结果的目标成员。
公式中不写计算范围
公式表达式中不要写 SCOPE、cube.scope(...) 或 cube.calc_formula(...)。计算范围由 Python、DeepCube 或电子表格等调用方在执行时指定。
如需针对不同坐标写分支逻辑，可在表达式中使用 ISIN、BLOCK 等 DeepCube 原生表达式，这些语法在辅助输入中都有说明。
在树形视图中配置公式
-
进入目标 Account 科目维，在左侧树中找到需要配置的成员。
-
单击成员，在右侧详情中打开 指标公式 页签。
-
在说明栏填写该指标的业务含义，例如“毛利等于营业收入减营业成本”。
-
在代码编辑器中输入或插入 DeepCube 右值表达式。
-
保存成员配置。
-
单击 校验公式，确认表达式、成员引用和函数使用均有效。
树节点右侧的 fx 用于提示公式状态：
|
状态 |
含义 |
|---|---|
|
不显示 |
该成员尚未配置指标公式 |
|
主题色 |
已配置公式，当前未发现校验错误 |
|
红色 |
已配置公式，但校验结果存在错误 |
树底部会显示已加载节点的成员总数、叶子数、聚合数和已配置公式数。
编辑器功能
指标公式页由工具栏、错误提示、公式说明、代码编辑器和右侧辅助区域组成。
|
功能 |
用途 |
|---|---|
|
说明 |
展开或收起公式说明；已有说明时按钮会显示状态提示 |
|
校验 |
检查当前公式是否有效 |
|
美化 |
整理表达式的空白、换行和缩进，不改变公式语义 |
|
辅助输入 |
打开模板、维度成员和函数面板 |
|
依赖关系 |
查看当前成员与其他成员之间的公式依赖 |
填写公式说明
公式说明用于记录业务口径，不会作为代码注释写入表达式。例如：
毛利等于营业收入减营业成本。
使用美化
单击 美化 可整理多余空格，并按括号、逗号和常见操作符调整表达式的换行与缩进。美化仅是编辑辅助，不会验证公式是否可执行。
使用辅助输入
单击 辅助输入 后，可在右侧使用以下页签：
|
页签 |
使用方式 |
|---|---|
|
模板 |
选择常用的基础派生、比率保护、条件分支、跨维参数等模板，再插入后按实际业务调整 |
|
维度 |
查看关联财务模型中的维度和成员，并将成员引用或表达式片段插入编辑器 |
|
函数 |
查看可用于指标公式的函数说明与示例，并复制或插入函数 |
模板和函数插入的都是右值表达式，不包含当前 Account 成员的赋值左侧。
校验与修正公式
输入表达式并保存后，单击 校验公式 获取校验结果。校验通过时系统给出提示；校验失败时，弹窗中会显示有问题的指标公式。存在多条错误时，可点击跳转查看其余错误。
查看依赖关系
单击 依赖关系 可查看当前公式引用的成员，以及相关成员之间的递归依赖。可在 关系图 和 关系树 两种视图间切换：
|
视图 |
适用场景 |
|---|---|
|
关系图 |
快速理解成员之间的引用路径；支持拖拽、缩放和高亮相关路径 |
|
关系树 |
按层级阅读复杂依赖；可展开或收起节点 |
关系图和关系树都会显示成员编码、描述及 fx 状态。选择节点后，可查看该成员的路径和公式；需要时可使用“定位到成员树”跳转到对应成员继续编辑。
在表格视图中批量维护
表格视图提供 指标公式 和 公式说明 两列，适用于批量查看或维护成员公式。指标公式列可通过 fx 图标打开公式浮层，查看或编辑较长的表达式；公式说明列按普通文本字段编辑。
导入与导出
导入和导出支持以下字段：
-
指标公式；
-
公式说明。
常见问题
为什么不能在公式里写 SCOPE？
同一个成员公式可以被不同调用方在不同范围内复用。将 scope 固定写入成员公式会限制复用，并使公式定义和执行策略混在一起。
为什么树形视图和表格视图中的公式状态不一致？
请先保存最新修改并重新校验。树节点、成员详情和表格单元格使用同一份校验结果；未保存内容或旧校验结果可能暂时无法反映最新表达式。
回到顶部
咨询热线
400-821-9199
