常见问题及解答

推荐浏览器

请安装较新版本的Chrome64位浏览器，以免一些较新的功能在过老版本的浏览器不能使用

想要在动态表后面还要再插入列，要怎么操作呀

拉到最下面，设置画布大小

动态表隐藏无数据后，为什么还有这么多空白区域？

电子表格可以设置画布大小，使用态实际大小=max（画布大小，数据区域大小）。如果画布设置的比较大，动态表隐藏无数据后，就会渲染剩余的画布。

解决方案：可以将画布设的小点。

ck cube多个字段关联相同的维度，左上角表头怎么展示不同的描述？

电子表格2.0中，左上角描述显示优先级为：优先使用财务模型字段描述，其次使用维度描述，都没有，使用财务模型字段编码。

因此，如果多个字段用相同维度，只要补上字段描述就可以了。

查询按钮的颜色可以换吗？

通过空间主题进行更换：

动态表样式配置好后，想要快速复用

大纲树，点动态表脚本，这个部分copy出来后，粘贴进想要复用的动态表脚本

动态表的默认主题可以修改吗？

默认主题界面上不可以随意修改，需要在服务端进行统一配置。

deep-table-server 后端服务增加启动环境变量

配置信息为一个通过“&”分隔的字符串，分隔的每一项为具体的一条配置规则

每一项配置格式如下：区域类型-生效位置-属性名称

区域类型说明：d(动态表区域)，f(浮动表区域)

生效位置说明：r(行头),c(列头),d(数据),t(浮动区域边框)

属性名称说明:

• font 字体

  • 0 Times New Roman

  • 1 Arial

  • 2 Tahoma

  • 3 Verdana

  • 4 微软雅黑

  • 5 宋体（Song）

  • 6 黑体（ST Heiti）

  • 7 楷体（ST Kaiti）

  • 8 仿宋（ST FangSong）

  • 12 华文隶书

  • 13 PingFangSC-Regular

• fontSize 字体大小 如：12

• fontWeight 字体加粗(0:不加粗,1:加粗)

• fontColor 字体颜色 16进制值颜色：如 #FF00FF

• parentFillColor 父级节点填充色(应用在行头、列头) 16进制颜色

• baseFillColor 末级节点填充色(应用在行头、列头) 16进制颜色

• readonlyColor 只读填充色(应用在数据块区域) 16进制颜色

• editableColor 可编辑填充色(应用在数据块区域) 16进制颜色

• borderColor 边框颜色 16进制颜色

• borderLine 边框类型(0：实线，1：虚线)

• borderType 边框位置(0：上下，1：左右，2：所有，3：上下+粗下框)

例如：

• 动态区域，列，字体颜色配置为“#262626”，那么此项配置为“d-c-fontColor=#262626” 动态区域，数据，只读填充配置为“#007bff”，那么此项配置为“d-d-readonlyColor=#007bff”

支持范围(超出范围，配置无效)：

• 动态表支持：行头d-r、列头d-c、数据区域d-d（没有d-t）

• 浮动表支持：列头f-c、数据区域f-d、边框f-t （没有f-r）

支持范围一览表

注意：

主题的具体参数可以只配置局部，只需要将想要覆盖的默认主题配置用“&”拼接即可。配置好后，记得重启所有节点服务

例：EXPORT_DEEP_TABLE_DEFAULT_THEME： d-d-readonlyColor=#f2f3f5&f-d-readonlyColor=#f2f3f5 (动态表和浮动行表的数据区域只读颜色修改为较早版本颜色)

若是临时需要仅针对某些表修改局部的话，可以选择一个自定义主题，并修改至同样的配置

快速操作指南：

theme=2  
row_theme=#font(4)#fontsize(10)#fontweight(0)#fontcolor(#262626)#parentfillcolor(#f5f5f5)#basefillcolor(#f5f5f5)#bordercolor(#dddddd)#borderline(0)#bordertype(2)  
column_theme=#font(4)#fontsize(10)#fontweight(0)#fontcolor(#262626)#parentfillcolor(#f5f5f5)#basefillcolor(#f5f5f5)#bordercolor(#dddddd)#borderline(0)#bordertype(1)  
data_theme=#font(4)#fontsize(10)#fontweight(0)#fontcolor(#262626)#readonlycolor(#e8e8e8)#editablecolor(#FFFFFF)#bordercolor(#dddddd)#borderline(0)#bordertype(2)

动态表设置为万元单位，导出的excel没有千分符，且变成了1位小数

Excel本身对于数据单位的处理如下：

因此，尽管在网页上，我们能正常看到万元+千分符+2位小数，但是，由于Excel没有万元和万万元的比较合理的格式支持，表格导出时采用无千分符的格式，最终导出的效果与网页不同。

如果用户对万元表有比较强烈的格式需求，建议将数据直接处理成/10000，报表按元单位进行设置。处理数据的方法有：

2、动态表计算：override成原始数据/10000

3、静态表计算：取出来的数/10000 隐藏原始数据列

4、添加一个通用维度，成员“万元”=成员“元”* 比重0.0001

怎么实现不同维度的成员每列单独隐藏。比如第一/二列只展示Year,第三列只展示Scenario,第四列只展示Misc

电子表格2.0不支持维度标题在不同的行/列上错位隐藏，只能整体隐藏或不隐藏

但是，可以使用excel公式做一个假的表头，具体见下图操作

也可以隐藏场景和Misc维度后，用override_header([c4:c4],header=”备注”)

怎么添加针对每个Sheet的填报说明

电子表格2.0不再提供基于Sheet的说明配置，只提供基于工作簿的说明配置。

若觉得工作簿说明不明显，可自行在Sheet的第一行，添加说明文字。实施建议如下：

动态表行中，按照维度的ud过滤成员

可使用高级维度表达式

控件关联筛选器的情况（使用维度表达式建立关联关系）

注意，表中@Entity指 @筛选器编码

OrFilter(Base(@Entity,0),Attr(ud1,’

筛选器间联动功能说明

维度成员之间可能存在关联关系，存在如下几种情况

1、相同的成员出现在多个维度，比如“部门”和“公司”维度都有某个Entity成员

2、某个维度的UD是另一个维度，比如“公司”的区域属性是“区域维度”

3、同一个维度的上下级之间天然存在关系

4、通过外部数据（比如映射表），建立维度之间的关系

在编制报表时，多个维度都需要作为筛选器时，维度之间的关系便转移成为筛选器之间的关系，此为筛选器联动功能的初衷。

场景1：选完公司之后，部门筛选器的可选范围都属于该公司。

实现方式

1、先建一个正常的Entity筛选器

2、再建一个部门筛选器，可选范围与Entity筛选器关联

Department{Base(@Entity_wb1,0)} 这个表达式的含义是，@Entity_wb1的值由Entity筛选器决定，

当@Entity_wb1=E1时，Department={Base(E1,0)}

3、效果

场景2：选完区域之后，公司的可选范围都属于该区域

1、先建一个正常的区域筛选器

2、再建一个公司筛选器，可选范围与区域筛选器关联

手动输入高级表达式：OrFilter(Base(All_Entity,0),Attr(ud2,’@

含义为，当@Region_wb1=华南时，Entity=Entity{OrFilter(Base(All_Entity,0),Attr(ud2,’华南’))}

3、效果

由于公司依赖区域，部门依赖公司，可以实现三级联动

注意事项：

1、筛选器联动范围：

工作簿级：可选其他工作簿级筛选器

Sheet级：可选工作簿级筛选器 及 本Sheet的 其他Sheet级筛选器（不可选其他Sheet的Sheet级筛选器）

2、筛选器联动不要求是同一个维度，只要传过来的值及表达式，在被联动筛选器的维度内可解析即可

3、筛选器之间的联动关系

4、默认值概念拓展：

• 普通模式下，筛选器的可选范围是不变的，默认值仅在首次开表时生效

• 联动模式下，可选范围是变的，默认值在每次可选范围变动后都要重算 。

• 默认值本身算法保持不变：本身可配置表达式，但是需要符合：在可选范围内，不超过多选数量的成员。若未配默认值，则为第一个。

5、支持多选

场景3：若筛选器之间的关系无法通过维度表达式来表达，可通过自定义JS实现

增加了加载筛选器后/开表前JS执行时间点，可通过JS对筛选器的可选范围和值进行修改。

注意：原写在开表后节点的自定义JS可改为在此处触发，避免报表需要二次查询的问题

关联了筛选器后，能在对应动态表列上展示@Cur-1吗

动态表成员引用筛选器时叠加位移-1就相当于@Cur(-1) ，在2.0中的表现方式为@Year_wb1(-1)

1.0中的 @Cur 全都用 @筛选器 功能替代

动态表中，滚动预测时，是否可以根据变量期间（举例3月），显示1-3月为实际场景数，（4-12月）显示预测数。

可以通过增加Period层级结构，以实现此需求。

当场景为实际时，Period为所选月份的Base成员；

当场景与预测时，Period为所有期间-所选月份的Base成员

PS：若为静态表，可以直接将场景维度成员放在单元格上，使用Excel公式计算某个期间对应的场景是实际还是预测，然后DF函数直接引用单元格值作为维度成员。

动态表中，维度表达式配置了倒序，区域配置了汇总节点在下方，倒序没有效果

在维度表达式中，可以修改第二个参数，以达到正序或倒序的效果

比如：Descendant(维度成员名,排序方式(0/1))

但是，如果此时表格同时启用，汇总位置向下或向右，倒序就没有效果。

倒序算法：所有成员倒着排；汇总位置算法：子成员正排汇总节点在下。

这两种算法是冲突的，维度侧后处理汇总位置，因此，就体现为倒排没有效果。

编制报表时，从通用的科目树形下，挑出了个别科目（不同的表有不同组合），怎么实现+-和缩进效果。

正常情况下，动态表会对Ibase、Ichildren、Idescend维度表达式有+-和缩进效果，如果编制报表时，科目是一个个挑出来的，比如 COA;1001;1003;1101;110101，动态表只会平铺展示这些科目。

但由于这些科目都在同一个大的成员COA下，层级有一定的关系可寻，要实现按层级缩进，可采用以下方法曲线救国。

首先，给维度添加一个UD1，并且ud的值设置成和维度编码一样

接着，将动态表中的表达式 1001;1003;1101;110101 替换为 OrFilter(IDescendant(COA,0),Attr(ud3,’1001’,’1003’,’1101’,’110101’))

这样，就将原先通过科目编码挑个别科目的过程，转换成了通过UD过滤某个大科目下的小科目。并且，两个表达式有相似之处，可以快速转换。

多版本实体维，开启了过滤未激活实体，但是没有效果

注意：目前维度表达式函数第三个参数有0,1,2三个枚举值

关于维度表达式中第三个参数的说明如下：

电子表格中，与多版本实体相关的功能总结

列1实际场景，列2预算场景，期间维是IDESCENDANTS(TotalPeriod,0)或者用户多选的，想要看所有期间的预实差异，但是不想写12个月的公式。

可以先建一个预实对比的dummy成员，然后构建动态表结构，再在dummy成员上使用override fx功能，计算出结果

注意：该方案下，动态表不要启用隐藏无数据，因为override是动态表所有配置中最后执行的，如果隐藏了无数据，dummy成员也会被隐藏，就无法计算了。

隐藏无数据的曲线救国之路：第三列直接使用actual作为动态表被覆盖前的数据，然后将actual覆盖成fx公式，这样，就按照actual是否有数据来进行隐藏。

怎么设置一个Idescendent表达式的其中一个成员只读

不需要人为拆分成三列，使用override特定科目只读即可

override_data([account{费率}],[readonly=1,theme={editablecolor:”#f2f3f5”}])

问题2：如果拆分三列后，还能合并单元格吗？

电子表格2.0可以跨动态表列合并（不care动态表分多少列，都可以合并）

科目在维度成员里面是平级的，想通过override展现出层次感？

用一个全角空格“　”来实现标题人为缩进

如何让某一科目的数据展示为相反数

使用override计算

行上设置了只读，override成员之后，还是可写

override是最末的处理，也就是说override member成员之后，会以新成员的模型权限重新渲染只读。

解决：

override之后，再叠加只读就好了

override_data([r2:r2],[member=”period{NoPeriod}”,readonly=1,theme={editablecolor:”#e8e8e8”}])

注意，这里editablecolor是指override之前，可编辑的单元格的背景色，editablecell’s color的意思， readonlycolor是指override之前，只读的单元格的背景色，readonlycell’s color的意思，

如果不管单元格权限本身只读和可写，都想改颜色，可以都加上theme={editablecolor:”#e8e8e8”,readonlycolor:”#e8e8e8”}

override theme参数对照表

•font: 字体，0-Times NewRoman，1-Arial，2-Tahoma，3-Verdana，4-微软雅黑，5-宋体，6-黑体，7-楷体，8-仿宋，9-华文隶书，13-Pingfang

•fontsize: 字号，9-72

•fontweight: 字体粗细，0-默认（汇总加粗，非汇总不加粗），1-加粗，2-不加粗

•fontcolor: 字体颜色，任意16进制颜色值

•bordercolor: 边框颜色，任意16进制颜色值

•borderline : 边框线型，0-实线，1-虚线，

•bordertype: 边框位置，0-上下，1-左右，2-所有，3-上下+粗底，

•readonlycolor: 只读单元格的填充色，16进制颜色（注意是财务模型提供的权限属性，不受override+readonly影响）

•editablecolor: 可填单元格的填充色，16进制颜色（注意是财务模型提供的权限属性，不受override+readonly影响）

•parentfillcolor: 汇总节点填充色

•basefillcolor: 非汇总节点填充色

动态表左上角表头可以调整吗？通用维想要在不同的表展示不同的名称

可通过Override_header([r0:r0],[header=”字段1;字段2;字段3”])

r0:r0 专门代表左上角表头

条件格式可以写公式么？比如，动态表列1=列2，标红

可以的，但是注意，公式只能用excel公式，需将动态表起点位置转换为具体的单元格。具体见图示例子

有多个判断依据的话，还可以用AND OR逻辑运算

根据有无$，判断公式会随着应用范围进行偏移

具体逻辑同excel

查看E3的数据验证公式=B1

查看E5的数据验证公式=B2

结论：不管是条件格式还是数据验证中使用公式的，如果公式中的单元格没有加时，下拉公式）

通过条件格式或数据验证，实现限制录入日期的格式和范围

因此，应当将数据本身的格式与校验的目标匹配起来：

当数据是文本(动态表和浮动行表都是这种情况)

数据验证：使用公式判断，将文本通过datevalue函数转换后再比较日期范围

条件格式：与数据验证写法类似，唯一的区别，一个是返回false呈现效果（数据验证），一个是返回true呈现效果（条件格式）。

效果的区别：错误提示方式不同，一个是用角标和悬浮文本并且可在错误的情况下禁止录入（数据验证），一个是用背景色和字体颜色（条件格式）。

例子中的公式，通过长度、符号、日期值综合来认定填报的正确性，如需其他条件，可自行叠加公式。

如果需要限制的日期范围与筛选器值相关：比如页面维1月1日~页面维12月31日 之间

可通过DFfilter将筛选器值，引到单元格上，然后，通过拼字符串的方式，得到2025-01-01和2025-12-31两个文本。接着，再依据上例使用条件格式或数据验证。

能否根据左侧的实时选择，不同的选项出来不同的下拉列表

warning 如果下拉选项比较复杂（比如需要通过mapping表才能找到），可以使用自定义JS来实现。本例是不借助自定义JS的简单实现

比如下图， 若【专业条线】选择秩序，则【岗位】下拉选择则可选择秩序领班、保安主管、保安队长、保安；若【专业条线】选择绿化，则【岗位】下拉选择则可选择绿化领班、绿化主管、绿化工

第一步，通过excel公式，计算出每行的下拉列表的值

第二步，通过数据验证功能，实现下拉

在动态表列2应用条件格式时，由于W3:Z3没有加$锁定，下拉列表的引用区域会跟随列2的单元格进行偏移计算。比如：

• 列2的第一个单元格C3，引用区域为：W3:Z3

• 列2的第二个单元格C4，引用区域为：W4:Z4

• …

至此，综合实现，当填报不同的内容时，出现不同的下拉列表。

数据验证下拉列表添加了一个超长列表（字符长度大于255），下载到excel后，没有下拉列表了

Excel的数据验证功能，不支持超过255个字符，但是luckysheet是支持的，因此，尽管网页上能够正常使用，但是下载到excel文件后，会被excel当成错误数据，自动删除，导致excel没有下拉功能。

在动态表列固定行不固定，添加条件格式/数据验证时，其中某行不需要校验，但是由于动态表行是动的，也不好使用固定范围

样例如下：

配置条件格式或数据验证时，可选择应用范围为动态表的列3（注意是动态表坐标），然后使用公式计算条件格式/数据验证结果

条件格式案例分享：不同的月份有不同的指标值，根据指标值对进度列未达标进行样式突出显示

1、将月份通过dffilter函数引到表单上

2、通过excel公式计算本月指标值

3、条件条件格式：使用公式计算

DF公式用法示例

DF公式示例.xlsx

注意：

1、DFdata/fx函数需包含cube中的所有维度

2、引用单元格(维度成员引自单元格)需要二次查询，因此会降低查询效率，若静态表较大对性能有较高要求，请避免使用引用单元格。

3、可在Excel上编辑好公式和样式了，导入到编辑态

若一张静态表中同时包含DFDATA和DFDATAFX等多种类型公式，为方便编辑，可套用以下模版编制静态表

复杂静态表模版.xlsx

维度/字段比较多，DF函数下载到excel失效了

由于DF函数的第二个维度及成员参数是一个长字符串，当公式里的字符串长度大于255个字符时，excel就不支持了，所以编辑态导出的时候，excel会自动修复删除掉这些不识别的公式。

解决方法，将字符串拆分用&进行连接。举例：

“ABC”&”123” 就是excel的字符串加法，最后得出的结果是”ABC123”

可结合DF公式的引用单元格功能，将行或列上的成员直接拼接单元格

这样就能解决公式超长后，excel不识别的问题

DFdata单元格右键数据审计，没有历史记录，但是动态表相同维度下有

是因为动态表取数接口兼容大小写，数据审计不兼容大小写，

DFDATA由于引用了现有单元格里的成员，没有区分大小写，导致数据审计查询不到历史记录

所以，注意，引用单元格上的维度成员要区分大小写

报表中要展现上期数，通过@筛选器-1功能，当期间为1月的时候，则会报错，无法取到上年12月

将筛选器值通过DFfilter取到单元格上，再通过年和月计算出上期对应的年月

再使用DFDATA函数，拼接单元格上的成员，实现取数

下载的Excel时能把筛选条件也导出吗？

标准功能下载时不会导出筛选条件（因为筛选器是个表外内容），但是我们编制报表时，可以主动将筛选器值通过DFFliter函数放到Sheet中，这样，导出时报表上就能自然而然带出筛选器信息。

下图是一张带报表名称、公司、年月、单位等信息的报表设计参考。

为什么动态表右键没有即席分析

线上即席分析功能默认关闭，如需开启，在deep-table-server 后端服务增加启动环境变量:

线上即席分析功能点如下：

电子表格挂MDX脚本怎么取到POV参数？

与电子表格1.0不同，1.0可以获取到表格POV作为参数传递给计算脚本，在表格2.0中，将筛选器作为默认参数给计算脚本

解决方案：将筛选器编码直接作为脚本里的参数进行使用 或 ** 配置参数映射表 ，将筛选器映射到脚本自定义参数**

添加映射之后，除了默认给的筛选器参数外，也会同时提供这几个自定义参数的值

开表前触发计算脚本 ， 参数没传过去

注意<表单加载前运行> 和 <开表前/加载筛选器后运行>的区别

<表单加载前运行> ：

指整个电子表格元素开始渲染前。此时触发的参数：仅有元素和路径

<开表前/加载筛选器后运行>：

指电子表格已经渲染了筛选器，但是还没有渲染Sheet上的数据表格。此时添加算法，可以获取到筛选器值并且将计算后的结果渲染到sheet上。

此时触发的参数：包含了筛选器值、元素、路径

表头上配了跳转功能，跳转到目标表后，部分参数没有传过去

比如下图：年份和版本信息无法给到目标表的筛选器

动态表跳转热区可以配置：整行、整列、表头、自定义维度组合

注意，点击不同的位置，能传递的参数是不同的：

• 行头单元格：财务模型信息、

  行&pov
  维度成员，在区域中所处的行号、当前值

• 列头单元格：财务模型信息、

  列&pov
  维度成员，在区域中所处的列号、当前值

• 数据单元格：财务模型信息、

  行&列&pov
  维度成员，在区域中所处的行号列号、当前值

• 计算的单元格：财务模型信息、

  pov
  维度成员，在区域中所处的行号列号、当前值

浮动行表关联筛选器后，会自动保存筛选器值到字段吗？

可以关联筛选器，作为查询条件

情况1：关联筛选器后，该字段不放展示列上（不是隐藏 ， 隐藏时实际列还在），保存时会自动以筛选器值进行保存

**情况2：**如果该字段同时放在了筛选器和列上，为了支持可选成员范围可能有多个值，保存时以列上填报的值为准（因此，放在列上并关联了筛选器，如果列不填的话，会以空值进入保存过程，就可能出错）

**情况3：**如果该字段仅有一个成员，可以配置该字段的默认值取筛选器，就能实现字段即在筛选器上，又在列上，同时以筛选器值进行保存：

浮动行表如何控制只能填报筛选器对应的公司

当公司同时放在筛选条件和展示列上时，可查看的是A公司，填入B公司数据。

当筛选器关联筛选条件后，主要影响的是数据查询条件，并不绝对意味着保存也是按照筛选器值。

保存时，如果字段

那么如何控制只能填报筛选器对应的公司呢？

• 方案一：公司字段仅配筛选条件上，不放列上

• 方案二：配在列上，但是逻辑属性的可选值=@筛选器，此时若填入其他公司，保存时会出现逻辑属性校验报错（成员超范围）

• 方案三：配在列上，保存时默认值配置为筛选器并开启列只读。此时阻拦了填入其他公司的机会。

当数据源有多个数据表时，怎么写插入SQL及删除SQL

其中，联接字段是A

插入SQL

INSERT INTO {t1} (A,B,C,D,E) VALUES ({A}, {B}, {C}, {D}, {E});

INSERT INTO {t2} (A,BBB,CCC,DDD,EEE) VALUES ({A_1}, {BBB}, {CCC}, {DDD}, {EEE});

其中A_1是联接字段的别名，可通过此处修改

如果，想要把左表的A字段值存到右表，Values直接取A字段即可（t1.A）

删除SQL

DELETE FROM {t1} WHERE _id={_id};

DELETE FROM {t2} WHERE _id={_id};

其中，_id是物理字段名，删除操作时，前端会将某一行数据代表的各表id给到后端，执行删除操作。

多版本实体维筛选器启用父子结构后，在浮动行中关联筛选器，查询不到数据

多版本实体维，实际存储到数据表中，依然是以纯子结构存储的数据。

动态表对应的财务模型接口做了特殊逻辑，当没有value或value等于ParentCurrency以下，不管成员写A.B 还是 C.B 还是 B，都从B成员取数，但是浮动行表则没有财务模型的这些转换逻辑，他不会自动将不同写法的成员识别为同一个。

所以，当筛选器传 父.子 结构的成员作为浮动行表的查询条件时，就找不到数据了，只能通过修改筛选器维度表达式的第三个参数，传纯子成员作为查询条件。

但是当workbook有多个sheet页的时候，比如有动态表需要父子结构的话，有浮动行表需要子结构，建议设置多个筛选器并且配合隐藏来解决。

如何限制浮动行查询出来的行数，比如只要前10行

在数据源中填入limit条件

浮动行表如何在使用态删除行

在浮动行中，默认假设：如果浮动行区域的整行数据都被清除，对应数据表执行删除记录操作（删除某个id的行）。但是，如果一个填报区域中，有计算的列处于只读状态（或配置只读列），用户就无法将整行清除内容，也就无法达到数据表删除行效果。

在编辑态，启用清空行按钮

浮动行表如何在使用态增加空白行

场景一、不同单位数据量差异大：浮动行表用于填报时，每次刷新后，在现有的数据基础上，最多预留10000行空白行。但是，对于个别情况，比如同一张表，A公司仅需要填报10行，B公司需要填报10000行，不同的公司差异较大，难以取舍预留数。

场景二、需要一次性导入超过10000行的数据：基于目前表格2.0多区域的设定，浮动行表区域是有边界的，超过边界的数据无法保存。

在编辑态，启用追加行按钮，默认1-1000，根据需要可配置5000,10000。注意，如果浮动行表列数较多，整体超多50万单元格，需考虑性能问题。

注意，建议此时编辑态画布大小不要设的过大，以免数据较少时，浮动行区域内的空白上和画布本身的空白行 ，造成用户混淆。

怎么控制浮动行表只有10行可填，每次保存后，不会再多出新的10个空白行

可以配置允许新增，并预留空白行0，

然后，使用insertFloatTableRow JSAPI，判断当前小于10行时，插入(10-现有数据行数)行。

浮动行表Groupby之后，金额只有原始数据的第一行，没有自动汇总

Groupby只负责分组，不负责非分组字段进行SUM聚合

非分组字段只能拉到分组后的第一条

如果需要聚合，可以添加自定义列/属性，使用聚合函数进行计算，比如sum(金额字段）

数据源的处理只有Join，如果想要Union怎么办？

比如有下述两张结构相同的表，想要上下拼在一张表里展示

变相的实现方法供参考：

注意：只能查看数据哦，编辑的话因为union过来的表没有实际lineid，更改不了

Excel只有n位小数，上传到电子表格后小数不一样了。

Excel显示的小数位与上传到电子表格后的小数出现不同的情况主要原因是Excel本身显示精度与存储精度不同导致的。

Excel显示精度：15位，存储精度17位。比如一个数据31203713.290000003，由于超过显示精度，因此Excel显示为31203713.29，用户看到这个数据，表面以为只有2位小数，实际存储是多位小数。电子表格的显示精度和存储精度都是17，因此，就与Excel显示的不一样了，但不妨碍实际的数据都是17位。

查询Excel实际数据的方法见下视频，总体来说，Excel数据具有一定的迷惑性：

此处为语雀卡片，点击链接查看

小数位数会影响数据上传的质量，比如浮动行报表，我们一般会在数据表中设置小数位数，如果超过小数位数，即使电子表格填报侧绕过了校验，到数据表服务依然会报错和不让存储。

实施时可在浮动行表上，开启自动四舍五入功能：

对上传后的数据进行加工后再保存到数据表。

自定义JS支持哪些API

见自定义JS使用手册

自定义JS写法

书写自定义JS的标准结构

export default () => {
  const function_name = function (params) {
      //自定义函数的具体代码
      //function_name:自定义函数名
  };
  
  return {
    function_name,
  }
}

注意，写完函数后，需要return函数体function_name，并且挂载在电子表格的执行钩子上。

目前执行自定义JS的钩子有：

工作簿设置：

开表前/加载筛选器后：仅部分API可用(比如筛选器相关API），一般是开表前（加载具体的sheet前）配置筛选器联动时需要

Sheet设置：

初次开表后：首次加载Sheet后需要执行的自定义JS函数。

刷新后：后续重新查询报表（比如切换筛选器后查询）需要执行的自定义JS函数

保存前：数据保存前执行的自定义JS函数。

动态表行数不确定，怎么用JS添加excel计算公式

注意：优先使用动态表公式，大部分场景下可支持

超出支持部分优先考虑用Python或MDX实现

最末考虑用JS，参考如下代码：

export default () => {
  const formula = [
    {
      index: 0,
      formula: [
        ['AU', '=IFERROR(IF(AA{row}<0,2-AN{row}/AA{row},AN{row}/AA{row}),"-")'],
      ],
    },
  ];
  const viewRow = 3,
    viewCol = 1;

  const init = (index, { luckySheetApi: {suspendDraw,suspendCalculate,getRowCount, setCellValue, setCellFormula} }) => {
    // console.log('luckySheetApi: ', luckySheetApi);

    const config = formula.find((item) => item.index === index);
    let rowCount = getRowCount(0)
    suspendDraw(true)
    suspendCalculate(true)
    for (let row = viewRow; row < rowCount; row++) {
      for (let i = 0; i < config.formula.length; i++) {
        const [col, formula] = config.formula[i];
        const value = formula.replace(/{row}/g, row + 1);
        setCellFormula(index, row, ltn(col), value);
        //setCellValue(index,row,ltn(col),i)
      }
    }
    suspendCalculate(false)
    suspendDraw(false)
  };

  const init1 = (params) => {
    init(0, params);
  };

  return {
    init1,
    // init2,
  };
};

// 工具函数
const ltn = (letter) => {
  let num = -1;
  const len = letter.length;
  for (let i = 0; i < len; i++) {
    num += (letter.charCodeAt(i) - 64) * Math.pow(26, len - i - 1);
  }
  return num;
};
const ntl = (num) => {
  let letter = '';
  while (num >= 0) {
    letter = String.fromCharCode((num % 26) + 65) + letter;
    num = Math.floor(num / 26) - 1;
  }
  return letter;
};

如果数据不需要保存，可通过syncOriginData（具体见JS API文档）接口进行处理

动态表样式可以配置数字居中吗？

暂时没有标准功能支持居中样式的修改，只能通过自定义JS，如下代码供参考

import { message } from '/package-base/antd4.mjs';

export default () => {
  //获取Sheet1单元格内容
  const st1fun = function (params) {
    const {luckySheetApi:{suspendDraw,getSheet}} = params; 
    suspendDraw(true)
    let sheet1 = getSheet(0); //返回sheet1下面的所有luckysheetapi
    console.log('开始啦');
    //将第5行的3至41列修改为居中
    let i=2;
    for (i=2; i<40; i++) {
      sheet1.setHorizontalAlign(4,i,'center');
    }
    console.log('搞定啦');
    suspendDraw(false)
  };
  return {
    st1fun,
  }
}

如何根据筛选器和每行选择，出来不同的下拉列表（有筛选字段、行字段、下拉字段的关系表）

大致实现思路是：在科目列上通过单元格变更事件，查找映射表，生成对应的下拉列表

1、科目列的单元格发生变更时

涉及如下JS API

• bindEvent

• getCellValue

• getFilterMember

• DataVerify

浮动行表某列通过excel公式从其他列计算而来，追加行时如何处理

为了实时展现某列的计算结果，有些项目可能会采用自定义JS的方法在浮动表开表时叠加计算公式，但是若用户需要在追加行，填报时追加的行上没有公式，导致存入数据库时此列无值。

比如此例：A列=B列

注意：不可直接写公式=B2，而应该写 = if(B2=0,””,B2)，这样空数据行不会因为计算产生一个0数据。

实现时：

1、配置计算列只读，以免用户修改

2、自行实现追加行功能，并在追加后添加公式，追加公式参考代码

params.luckySheetApi.syncOriginData(true);
//开启初始化原数据，认为添加的公式不属于单元格变更，只有B列填报后，引起的A列计算才是变更
for (var i=1; i<20; i++) {
  sheet1.setCellFormula(i,0,'=if(B'+(i+1)+'=0,"",B'+(i+1)+')'); //在单元格添加公式
}
params.luckySheetApi.syncOriginData(false);

跳转非电子表格元素-自定义JS参考案例

目标标准功能只支持跳转电子表格2.0/1.0，若要跳转到其他类型元素，可通过自定义JS。

注意：sign和folderid随着应用变化，可采用下述方法，使元素在不同的应用间迁移时兼容。

import { extend } from '/package-base/@deepfos/request@2.0.0.mjs';
const appServer = extend({
  prefix: `/deepfos-server/app-server`,
});

export default () => {
    
  const getsignFromUrl = () => {
    const str = window.location.search.substring(1);
    const list = str.split('&');
    const obj = {};
    list.forEach(item => {
      const arr = item.split('=');
      obj[arr[0]] = decodeURIComponent(arr[1]);
    });
    const sign = obj['sign']
    //const info = atob(decodeURIComponent(obj['sign']));
    //const appId = info.split('&');
    return sign;
  }

  // ======================跳转凭证清单======================
  let elementName1="Journal_Report"
  let moduleId1="JL1_0"
  let Path1="/Consolidation_App/Journal/Journal_Report/"
  //let folder
  let folderId1 = '';

  appServer.get('/folders/get-folder-id/by-full-path', {
    params: {
      fullPath: Path1
    }
  }).then(res => {
    folderId1 = res;
  });
  
  const jump_jr = (params,context) => {
    const { cube, povDimension, cellDimension, value } = context;
    let pov = {
                "entity2": povDimension.entity,
                "scenario2": povDimension.scenario,
                "version2": povDimension.version,
                "year2": povDimension.year,
                "period2": povDimension.period,
              }
    return `/element-journal/1-0-0/list?pov=${JSON.stringify(pov)}&elementName=`+elementName1+"&folderId="+folderId1+"&moduleId="+moduleId1+"&sign="+getsignFromUrl()
  }  

  // ======================跳转分组报告======================   

  let elementName2="InterCo"
  let Path2="/Consolidation_App/RR/"
  //let folder
  let moduleId2="GR1_0"
  let folderId2 = '';

  appServer.get('/folders/get-folder-id/by-full-path', {
    params: {
      fullPath: Path2
    }
  }).then(res => {
    folderId2 = res;
  });
  
  const jump_rr = (params,context) => {
    const { cube, povDimension, cellDimension, value } = context;
    let pov = {"pov":{
                      "entityPartners":
                         [{
                           "entityText": povDimension.entity,
                           "partnerText": povDimension.entity
                         },],
                      "head.year": povDimension.year,
                      "head.period": povDimension.period,
                }}
    return `/element-group-report/1-0-0/report/use?customConfig=${JSON.stringify(pov)}&elementName=`+elementName2+"&folderId="+folderId2+"&moduleId="+moduleId2+"&sign="+getsignFromUrl()
  }

  //======================跳转清单表======================
  let elementName3="815"
  let Path3="/Consolidation_App/RR/"
  //let folder
  let moduleId3="LST1_2"
  let folderId3 = '';

  appServer.get('/folders/get-folder-id/by-full-path', {
    params: {
      fullPath: Path3
    }
  }).then(res => {
    folderId3 = res;
  });
  
  const jump_list = (parmas, context)=>{
    const { cube, povDimension, cellDimension, value } = context;   
    let pov = {
      CPMC1: povDimension.entity
    }
    return `/element-list-table/1-2-0/?pov=${JSON.stringify(pov)}&elementName=`+elementName3+"&folderId="+folderId3+"&moduleId="+moduleId3+"&sign="+getsignFromUrl()
    
  }

  return {
    jump_jr,
    jump_rr,
    jump_list,
  }
}

展现层权限定义

在电子表格中，涉及权限的控件有：

• 动态表、DF公式：使用财务模型权限

• 浮动行表：使用数据源权限

• 筛选器权限：按筛选器配置继承维度/自定义

• sheet、按钮权限：按sheet配置

我们将使用到的这些权限分为两类：

• 模型侧权限：一般是指

  外部模型
  提供的数据查询与保存权限。比如财务模型权限、筛选器的继承维度权限

• 展现层权限定义：除模型侧的

  数据权限
  外，在展现层额外配置的权限。比如sheet权限、按钮权限、筛选器自定义权限。

展现层权限与模型侧数据权限的对比：

• 模型侧权限
  在模型上进行配置，所有通过模型获取数据的，兼受此权限控制，无需在表格上每张表配置。

• 展现层权限
  需要每张表重复配置，因为Sheet、按钮、筛选器这些内部元素在每个表格中都是相互独立的。

• 模型侧和Sheet权限都能达到锁数的目的（通过状态控制数据填写或只读）

  • 模型侧权限

    优势
    ：可以按照维度配复杂组合，控制到每个数据块的权限，同一张表按照维度组合分别应用不同的权限。

  • 模型侧权限

    劣势
    ：配置较为复杂，理解难度高。

  • 展现层权限

    优势
    ：若用于权限控制的维度组合过于复杂，比如到了科目级，可直接以表为单位进行权限控制。逻辑简单，理解成本低。

  • 展现层权限

    劣势
    ：一个sheet只能使用统一的权限控制方案，无法按照不同数据块拆分权限。权限控制颗粒度粗。用户通过建不同的表，可绕过展现层权限。

• 注：数据源权限比较特殊，他是在表格侧配置的权限，但是一个数据源对应多个浮动行表时可重复利用权限方案，是在数据查询中提供的权限，具有模型侧权限的特征。

筛选器和模型都可以配权限，会不会冲突

不会冲突，筛选器是单独内部元素，权限不遵循模型，所以，才需要额外配置权限。

当使用时，筛选器启用权限控制后，用户有权限的成员向动态表区域去传递，也就是说，可以模型不配权限，只通过筛选器去控制用户的可见数据范围。

筛选器权限相当于前端控权，比如某一张表筛选器漏配权限，容易造成权限泄露，从严谨的角度来说，财务模型实现控权相当于后端控权，前端+后端双重保证更不容易出问题。

筛选器权限和模型权限不一样也没关系，最多是，筛选器能选到，但是模型查出来都是noaccess。

由于每张表的筛选器都要关联权限，略繁琐，建议使用继承维度权限功能，或者专门存一张电子表格元素，把常用的筛选器都配置好，接下来就复制元素建新的表格。

财务模型权限、数据源权限和sheet锁定在权限控制上有什么区别

当我们编制一张动态表或浮动行表时，如果需要实现用户权限控制，可以选择财务模型权限、数据源权限和sheet权限，那么这几种权限改怎么选择呢？

首先看三种权限在实现上的区别：

1️⃣ 财务模型权限：

**维度成员可见权限：**通过权限方案，获取用户对维度成员的可见权限。

**数据状态：**通过流程控制字段+审批单元字段，按维度组合作为流程控制的最小单元。

比如上例，最后形成的流程控制单元如下：

**权限配置：**通过角色+状态，得出用户最终对某个维度组合的访问权限

计算过程举例：

2️⃣ 浮动行表数据源权限：

**维度成员可见权限：**通过权限方案，获取用户对维度成员的可见权限（查询浮动行数据时，具有过滤行作用）。

**数据状态：**指定浮动行列中，用于状态的字段（浮动行表的数据状态不是通过流程控制单元额外查询，而是在行上直接提供）。

**权限配置：**通过角色+状态，得出用户最终对某些字段的访问权限

计算过程举例：

3️⃣ Sheet锁定：

**查询用户角色：**通过权限方案，获取用户在某个维度下的角色。

举例，当筛选器的值如下时，可根据entity+product成员，得到用户当前的角色

**数据状态：**外接入一张流程状态表，通过筛选器传参，得出当前sheet所处状态。

举例，根据year+period+entity筛选器成员+表名，得到当前sheet状态

**权限配置：**通过角色+状态，得出用户最终对这张sheet的访问权限

计算过程举例：

综上，三种权限控制方式基本逻辑类似，但是在权限控制颗粒度上有明显的区别

• 财务模型权限：以

  维度组合
  为颗粒度进行权限控制，流程状态表由财务模型自动生成

• 浮动行表数据源权限：以

  行
  为颗粒度进行权限控制，流程状态由每行的状态字段上自带

• sheet权限：以

  sheet
  为颗粒度进行权限控制，入参依赖筛选器，流程状态表由用户自建

某张Sheet，想要所有人（除应用管理员外）都不可见/只读

可使用Sheet权限实现此功能

1)在权限方案中（新增/已有）增加一行数据，创建一个代表所有用户的角色。

2)在Sheet上配置权限，对改角色隐藏。就能实现属于该角色的所有应用用户，开表时都隐藏/锁定此sheet。

表格2.0可以装到页面2.0中吗？

不可以，表格2.0只支持装在UX中，UX是比页面更丰富功能的新组件

表格2.0可以和UX联动吗？

目前支持

1、别的控件联动查询表格

2、表格监控其他控件值变化，主动联动刷新表格

3、设置表格内筛选器隐藏或禁用

4、表格通过单元格点击事件配置后续动作：比如修改其他控件的值

5、跳转到新窗口打开表格

{
    // WB级筛选器
    "wbFilter": {
        "Period_wb1": $components.deep_dimension_jt6x.value
    }
    // sheet级筛选器
    "sheetFilter": {
        // sheet名称
        "Sheet1": {
            "Cost_Center_st1": $components.object_select_SNjv.value
        }
    }
}

UX-电子表格批量下载后，ZIP文件不能打开

下载的ZIP打开失败，F12看download接口报错文件过多

若采用zip方式，平台侧打包下载接口（ /deepfos-server/platform-file-server/files/batch/download ）默认限制10个文件，超出这个文件数量则会ZIP失败（一个电子表格元素是一个excel文件），可根据项目服务器配置情况（比如内存大小），自行进行调整参数和测试

套表只支持一次导出一家公司的多张报表，怎么实现多家公司多个报表随意组合

批量导出功能接受Json格式作为入参，并by元素前端模拟开表后导出。

[
  {
    "elementName": "",  //元素编码
    "folderId": "",  
    "fileName": "动态表示例", // 指定下载的文件名(仅适用于ZIP或单文件导出方式)
    "sheetSuffix": "_sheet后缀", // 指定Sheet名称后缀(适用于合并成一个excel的导出方式)，暂未上线
    "filterMap": {
        "wbFilter":{
            "筛选器_wb1":"A01", //筛选器_wb1为筛选器编码
        },
        "sheetFilter":{
            "sheet1":{
                "筛选器_st1":"A0102"
            }
        }
    }
  }
]

因此，通过UX自带的方法，可以按照多个维度对Json参数进行加工，并按需导出报表

示例1：通过table选择报表，通过Entity筛选器选择公司，为每家公司导出所选报表，以ZIP方式导出

$components.report_table.selectedRows?.map((n) => {
  return $components.Entity.info?.map((e) => {
    return {
      elementName: n.element_code,
      folderId: n.folder_id,
      fileName: n.element_name + "_" + e.description,
      filterMap: {
        wbFilter: {
          "Scenario_wb1": $components.Scenario.value,
          "Year_wb1": $components.Year.value,
          "Period_wb1": $components.Period.value,
          "Entity_wb1": e.expectedName
        }
      }
    }
  })
}).flat()

示例2：

有value的报表导出公司报表value组合，没value的报表导出公司*报表组合。合并成一个文件

$components.package.directoryList.map((n) => {
    if (n.linkageParam.wbFilter.Value_wb1) {
        return $components.entity.info?.map((e) => {
            return $components.value.value.map((v) => {
                return {
                    elementName: n.element.elementName,
                    folderId: n.element.folderId,
                    sheetSuffix: "_" + e.name + "_" + v,
                    filterMap: {
                        wbFilter: {
                            "Scenario_wb1": $components.scenario.value,
                            "Year_wb1": $components.year.value,
                            "Period_wb1": $components.period.value,
                            "Entity_wb1": e.expectedName,
                            "Value_wb1": v,
                        }
                    }
                }
            })
        }).flat()
    } else {
        return $components.entity.info?.map((e) => {
            return {
                elementName: n.element.elementName,
                folderId: n.element.folderId,
                sheetSuffix: "_" + e.name,
                filterMap: {
                    wbFilter: {
                        "Scenario_wb1": $components.scenario.value,
                        "Year_wb1": $components.year.value,
                        "Period_wb1": $components.period.value,
                        "Entity_wb1": e.expectedName,
                    }
                }
            }
        })
    }
}).flat()

财务模型view逻辑

期间汇总的几种组合：

• 用通用维类型，不开启view逻辑：通用维汇总逻辑（科目上开启了父节点允许录入不汇总，其他自动汇总）

• 用期间维类型，不开启view逻辑：不会自动汇总，全靠脚本计算

• 用期间维类型，开启老view或新view：notype科目类型不自动计算，其他科目类型都自动汇总

老view逻辑：

新view逻辑：

执行Python计算之后，数据审计有数据，但是表格上没数据

动态表上的数据取自财务模型底表（默认为Maintable_***）,数据审计来自于模型log表（默认为财务模型名称+log）。执行Python计算的时候，可能因为各种原因，数据已经生成到log表，没有生成到Maintable表，或者相反。

遇到以上问题，先确认是否Maintable确实没数，再查找Python代码是否有问题，确认Python无误，可寻求模型侧解决。

查找Maintable特定维度组合数据的方法：

新增公司没有权限

模型权限初始化之后

新增加的公司并且已经在权限方案里面配置了权限，表格依然提示noacess

在模型点击权限控制初始化之后，会生成如下权限控制单元状态表（基于此表中的process_status值控制读写权限），但是新增的公司不会自动同步到此表中。需要手动同步

实施建议：使用工作流，在每个流程开始期间，初始化一下模型的权限表

clickhouse限制最大并发查询100

修改模型侧服务端参数

导出导入元素后，查询财务模型失败，提示维度的td表不存在

ck库中维度对应的td表在元素导入导出的过程中丢失，重新编辑保存维度，进行同步。

解释：维度的td表创建的时候是存mysql的，但是如果模型是ck，会同时在ck里同步一下。导入的时候，只导入了mysql的那个td表，ck的丢掉了。重新编辑维度的时候，会触发mysql向ck同步的过程 。

其他表都没有问题，仅某张表获取财务数据异常

检查一下，是否某个维度成员的td表里面的层级或汇总关系不对

模型权限速查

两个用户同时开表填报数据，其中一人做了流程提交，另一个人仍然可编辑。

先胜云财务模型中，数据的查询和保存权限可以不完全一致。前面所有对于权限的配置仅指的是查询数据时的权限。对于数据保存的权限，财务模型提供了三种权鉴模式：

• 宽松模式：财务模型默认为宽松模式，此模式下只在数据查询时控制权限，数据保存时不控制。

• 严格模式：保存的数据中只要存在无权限的数据，则这一批数据均不保存。此策略在遇到无权限数据时会视为保存失败，并进行报错提醒。

• 普通模式：过滤掉无权限的数据，仅保存其中有写入权限的数据。此策略在遇到无权限数据时会静默处理，并视为保存成功。

电子表格侧效果：

如上图电子表格，开表时一月份有数据，此时录入了二月数据，点击保存，三种策略效果如下：

严格模式： 在编辑过程中权限发生了变化，开表时可写，保存时只读，此时将提示单元格无编辑权限。

普通模式： 在编辑过程中权限发生了变化，开表时可写，保存时只读，此时将提示保存成功并刷新表单，但是这期间录入的无权限数据不会保存。

宽松模式： 在编辑过程中权限发生了变化，开表时可写，保存时只读，此时将提示保存成功并刷新表单，并且这期间录入的无权限数据仍然会保存。

电子表格1.0 和 电子表格2.0的区别

注：