配置电子表格——数据透视表

脚本表达式格式

workbook_name=电子表格名称
workbook_description=电子表格描述
sheet_name=测试表单页
sheet_description=该页面用于测试一个电子表格的工作表
sheet_instruction=随便怎么填都行，反正是测试，无所谓
cube_name=业务数据模型
sheet_type=dynamic（或者static）
page1=Entity{IDescendant(MCD_STORE)}#showdescription
page2=Year{FY18}#showdescription||text{年份},name{yearfiscal}
page3=Scenario{Actual}|| text{场景},name{scenario1}
page4=Entity>>Region{IDescendant(R1,0)}}#showdescription
column1=version{version1;version2}->
Period{IDescendant(TotalPeriod)}#showdescription->
Account{Price;Volume;Amount}#showdescription
column2=version{version1}->
Period{IDescendant(TotalPeriod)}->
Account{ProfitMargin;Comment}#showdescription||hideblank
column3=Entity>>Region{IDescendant(@Cur,0)}
row1=Product{IDescendant(PD00)}#showdescription
#showattr(ud1,ud2,ud3[Year{@Cur}>Period{Oct}])||readonly
row2=Product{IDescendant(PD00)}#showdescription#showattr(ud1,ud2,ud3[Year{@Cur}>Period{Oct}])||readonly

workbook_name，workbook_description，sheet_name，sheet_description，sheet_instruction，cube_name，sheet_type 等信息是 workbook 和 sheet 的属性。

Page 在表单中作为下拉选项显示。如果后面有 text 属性，则下拉选项框的名称显示该属性值。如果没有 text 属性，则用该维度在当前语言下的描述作为下拉选项框的名称。

Page 的 name 属性会用于工作表的自定义js取值所用。

row1 表示是第一个定义行。一个定义行视其表达式中的维度成员数量，在实际打开的电子表格中可能表示多行。当 ube_type 是1时，脚本中没有 measure 字样，account 起 measure 的作用。

随后是各个维度的表达式，并且按顺序排列，用逗号分隔。每个表达式后面通过 # 表示显示属性。显示属性有如下几种：

• showname：只显示名称

• showdescription：只显示描述

• showboth：显示名称+ - +描述

维度和度量都可以赋予隐藏属性：

• hide：该维度隐藏。如果是 page 段的隐藏，则该下拉选项框不出现，但所选的维度值还在。如果是行或者列的某个字段隐藏，则视为所有行或者列的该字段都隐藏。

表达式结束后，是该定义行/列的属性，用||符号将其与表达式分隔。可用属性有：

• hideblank：隐藏无数据行/列（page 上无该属性）。比如示例中的 row1 实际会展示出72行（2*12*3），但在显示中其实只有10行有数据。如果有 hideblank 参数，则仅显示这10行，如果没有 hideblank 参数，则显示全部72行。

• readonly：该定义行/列的所有内容即使有编辑权限，也全部只读（page 上无该属性）。

首行/首列

• 编辑视图：

  • 使用视图中表格有效数据的起始行，默认为0，即从第一行开始。下图中首行填写 1，即起始行从第二行开始;

  • 使用视图中表格有效数据的起始列，默认为0，即从 A 列开始。下图中首列填写 1，即起始列从 B 列开始。

  

  
  

• 使用视图：

  

默认单位

• 默认单位为 1 时：

  

  
  

• 默认单位为 1000 时：

  

默认精度

• 默认精度为 0.01 时：

  

  
  

• 默认精度为 1 时：

  

行/列维度层级

• 未开启行列维度层级：

  

  
  

• 开启行列维度层级：

  

允许调整单位

使用视图中，用户调整单位后不用点击刷新按钮，数据直接改变:

允许调整精度

使用视图中，用户调整精度后不用点击刷新按钮，数据直接改变:

允许调整千分位

使用视图中，用户可以修改千分位符勾选情况，数据直接改变:

启用千位分隔符

使用视图中，千分位符勾选且无法修改，数据展示千位分隔符:

默认值

默认值 同 可选项 类似，默认值只能选中一个值：

显示内容

• 仅名称：

  

• 仅描述：

  

• 名称+描述：

  

多层级显示

当设置该属性后，该维度以多个下拉框的形式，每个下拉框中显示一个层级的成员，以非树形的方式展示，此外，除了最高层级外，每个层级的下拉框中的第一个成员都为 全部 +层级名称，如 全部市，全部区县。选择其中一个层级的成员，会联动其他层级的成员和可选成员发生变化，逻辑如下（以省，市，县为例）：

• 当选中一个成员时，其以下的层级的可选成员变为该选中成员的下级，其以上层级的可选成员变为该选中成员的上级。如在 市 pov 中选择了 南京市，则 区县 pov 中均只保留南京市下的区县，并且自动选中 全部 ；省 则自动选中 江苏省，但省的可选成员清单不变。此时，用于查询的 region 成员为 南京市。

• 当将一个成员选为 全部 后，其用于查询的成员为其上级的非 全部 的一个 POV 的成员。如原本 pov 的选择是：江苏省-南京市-鼓楼区，此时的查询 pov 是 鼓楼区。将 区县 POV 设置为 全部 后，查询的 pov 变为 南京市。

期间维度未开启多层级显示：

期间维度启用多层级显示：

• 编辑视图：可下拉多选该维度设置的层级名：

  

  
  

• 使用视图：以选中的层级名+层级成员依次展示该维度成员：

  

全局联动

页面字段如果设置了全局联动，则当该维度在其他工作表被重新选过成员并刷新后，联动的工作表也会被刷新。

.. note:: 必须至少两个工作表的相同维度同时启用此功能才会生效。

比如，Year 维度在 工作表1 中和 工作表2 中都设置了全局联动。当用户在 工作表1 上面选择了一个新的 Year 成员，点击 刷新当前 按钮时，会同时把 工作表2 的数据也刷新，因为 工作表2 的 Year 通过联动的方式也被重新选择过了。

• 编辑视图：

  • 对 工作表1 的 Year 维度设置全局联动：

    

  • 对 工作表2 的 Year 维度设置全局联动：

    

    
    

• 使用视图：

  • 工作表1 的 Year 维度切换为 2021 年，刷新当前：

    

  • 切换到 工作表2，Year 维度也自动切换为 2021 年：

    

允许多选

当一个维度在页面中存在，同时又存在于行/列中，且行/列维度成员表达式用 @Cur 相关函数引用页面上同维度的值时，该页面会多出一个属性：允许多选。

当开启 允许多选 框时，会出现 可选成员数量 的输入框，只允许填写正整数（大于0）或者不填。不填表示可选成员数量不受限制。当填写了数字后，该页面的默认值也受该值影响。如果填了3，则页面的默认值最多能选3个成员，如果没有填，则页面默认值数量不受限制。

• 编辑视图：

  • 行上的 Year 维度成员表达式配置 @Cur：

    

  • 页面上的 Year 字段开启 允许多选 ，如下图中填写了数字2，则页面的默认值最多能选2个成员：

    

    
    

• 使用视图：该页面 年份 字段的多选数量受 可选成员数量 影响，如下图中最多只能选到2个：

  

显示树形结构

• 关闭时：

  

  
  

• 开启时：

  

隐藏

• 维度 Period 未勾选 隐藏 选项：

  

  
  

• 维度 Period 勾选 隐藏 选项：

  

隐藏无数据

若启用，打开数据透视表使用视图时，若某行所有列都无数据，系统自动将该行隐藏。

• 未启用 隐藏无数据：

  

  
  

• 启用 隐藏无数据：

  

隐藏无权限行

若启用，打开数据透视表使用视图时，如果用户对一整行的数据都没有读的权限，则该行不显示。

此属性是对某一定义的行的属性，即允许 row1 启用隐藏无权限行，row2 不启用的情况。

• 未启用 隐藏无权限行：

  

  
  

• 启用 隐藏无权限行 ：

  

隐藏零行

若启用，打开数据透视表使用视图时，如果该行上只有空单元格以及值为0的单元格，则该行不显示。注意，这里不考虑通过自定义js计算出的0。

此属性是对某一定义的行的属性，即允许 row1 启用隐藏无权限行，row2 不启用的情况。

• 未启用 隐藏零行：

  

  
  

• 启用 隐藏零行：

  

只读

对于原本允许编辑的行设为只读格式（只能以行整体为单位设为只读，不能细分到该行下的某维度成员）。

• 未启用 只读：

  

  
  

• 启用 只读：

  

单元格置空

设置了该属性后，该行上只做行头渲染，而不从数据表中读数，同时，数据透视表保存数据的时候也不会将这些行上的数据传给后台保存，即相当于对该行所有单元格置空，不读不写。使用视图中该行变为不可编辑样式。

但需要注意的是，如果该行上同时勾选了 隐藏无数据 行，则还是先处理 隐藏无数据 属性，以决定显示多少行头。

此选项一般配置在需要添加自定义js公式的行上。

• 未启用 单元格置空：

  

  
  

• 启用 单元格置空：

  

隐藏

若启用，打开数据透视表使用视图时，系统自动将该行隐藏。

• 开启 隐藏 前：

  

  
  

• 开启 隐藏 后：

  

显示内容

• 仅名称：

  

  
  

• 仅描述：

  

  
  

• 名称+描述：

  

多层级显示

• 比如 Entity 维度未开启多层级显示：

  

  
  

• 比如 Entity 维度开启多层级显示：

  • 编辑视图：

    

  • 使用视图：

    

行标题列宽

在行上，对行标题的列宽设置会影响所有的行。比如 row1 上的设置会影响 row2 上相同维度或属性的列宽设置。

如果行上有维度设置了多层级显示，则该维度的所有层级的标题列宽都根据该维度设置的列宽来显示。

• 小：

  

  
  

• 大：

  

合并单元格

• 比如维度 Version 未开启 合并单元格：

  

  
  

• 比如维度 version 开启 合并单元格：

  

默认收起维度

• 比如维度 Period 未开启 默认收起维度：

  

• 比如维度 Period 开启 默认收起维度：

  

隐藏

• 比如维度 Period 未勾选 隐藏 选项：

  

• 比如维度 Period 勾选 隐藏 选项：

  

列宽

设置该列的列宽，可选择 默认、小、中、大、自适应 或 自定义，自定义值为像素值，只允许输入正整数，不允许为空。

显示内容

• 仅名称：

  

  
  

• 仅描述：

  

  
  

• 名称+描述：

  

多层级显示

• 比如 Entity 维度未开启多层级显示：

  

  
  

• 比如 Entity 维度开启多层级显示：

  • 编辑视图：

    

  • 使用视图：

    

合并单元格

• 比如 Version 维度未开启 合并单元格：

  

  
  

• 比如 Version 维度开启 合并单元格：

  

默认收起维度

• 比如 Period 维度未开启 默认收起维度 ：

  

  
  

• 比如 Period 维度开启 默认收起维度 ：

  

隐藏

• 关闭时：

  

  
  

• 开启时：

  

全局变量

全局变量为整个应用统一的变量。在配置维度成员表达式时，可用全局变量替代维度成员。全局变量的设置详见 变量 文档。

用处：若多张表都引用了此维度，且表单维度成员都可能不定期发生变化，则配置全局变量后只需要进入变量元素更改变量值，而无需依次进入各个表单编辑视图更改维度成员表达式。

用户变量

用户变量为管理员统一添加，用户允许各自设置变量值，用法与全局变量相同。

函数

函数只有行/列上的维度成员表达式才可使用。

• @Cur 含义

  当同一维度既配置在页面上又配置在行或列上时，若对行/列上的维度成员表达式配置 @Cur 函数，使用视图中行/列上该维度成员将随页面上该维度下拉选择的成员的变化而变化。

• @cur 的使用

  • 页面 Entity 维度成员表达式=entity{A;B;C}

  • 列1 上 Entity 维度成员表达式=entity{IDescendant(@Cur,0)}

  当页面上 Entity 选择 A 时，列1 展示 IDescendant(A,0) 的结果。

• @cur 可以配成 @cur+1，@cur-1

  • 页面 Year 维度成员表达式=year{2018;2019;2020}

  • 列1 上 Year 维度成员表达式=year{@cur-1;@cur}

  当页面上 Entity 选择 2019 年时，列1 显示 2018 和 2019 的成员。 +1/-1 代表取 @Cur 成员的下一个/上一个同级成员。

• 当一个维度使用 @Cur 函数引用 pov 上同维度的值时，允许用户在使用表单时在 pov 上对该维度进行多选

  • 页面 Entity 维度成员表达式=entity{A;B;C}

  • 列1 上 Entity 维度成员表达式=entity{IDescendant(@Cur,0)}

  此时，pov 上的 Entity 维度就允许用户多选。如果用户选择了多个，如 A 和 B 两个成员，则列上的实际解析的表达式为 entity{IDescendant(A,0);IDescendant(B,0)}