2024 3月1日

数组类型映射优化

当全局变量为数组时：

• 单人任务（新）/多人任务（新）-任务监听-事件监听-{订阅类型=订阅撤回}，增加输入方式「执行信息」（但暂无数组类型的预置执行信息参数可选）

• 单人任务-任务监听-事件监听-{订阅类型=通用消息}，增加输入方式「消息参数」，可选同类型参数

• 等待消息-高级-数据映射，增加输入方式「消息参数」，可选同类型参数

完成任务增加附件配置

单人任务（新）和多人任务（新）节点，当动作的执行逻辑是【完成任务】时，增加二级配置项【附件选项】，可选项：

• 不启用：默认选项

• 启用

用以控制完成任务时，是否可以上传附件：

注意：默认不启用附件，如需启用，需要重新配置工作流后发布，方可使用！

Cron定时功能相关优化

增加插入工具和预览最近10次执行时间（以当前时间为基准进行预览，但实际执行时会以发布时间为基准）。 Cron表达式的默认值：0 0 * * * ? *（从发布时间开始后，每小时执行） Cron表达式插入工具：

手动输入Cron表达式，也可以反解析至插入工具进行展示（适合对Cron表达式熟悉的用户使用）：

预览功能：建议使用以避免输入无效Cron表达式

其他调整：首次激活时间调整为定时策略的二级配置项（因为该配置项对Cron表达式无效）

单元日志增加下级合并计算记录

原先操作了父级的合并/强制合并，可能也会改写下级的计算、折算、贡献状态，但历史看板不会记录相应下级的计算历史，本次完善所有流程单元级操作，主要包括以下操作：

• 合并（consolidate）：补充下级操作历史

• 强制合并（consolidate_force）：补充下级操作历史

• 状态重置：cub保存回调导致的数据变更操作

合并流程表格使用视图优化

本次迭代对合并流程表格前端底层技术进行了优化调整，支持列筛选和列宽调整

增加凭证行权限

在凭证头权限的基础上，提供凭证行权限的配置，用于【凭证查看】权限：

配置【凭证查看】的条件时，支持到凭证行（其他权限项有凭证头权限就有全部凭证行的权限）。 如果不配置凭证行的条件，则不会对凭证行额外控制权限，即只要有头权限就有全部行权限。

效果： 管理员：能看到所有行（2行）

A公司用户：只能看到A公司的

B公司用户：只能看到B公司的

过账配置初始化映射值

减少用户配置量，新增过账字段映射的配置时，自动将编码相同的值初始化出来（大小写不敏感），基本原则是：先找凭证头表中字段编码相同的、再找凭证行表中字段编码相同的。

凭证功能可选逻辑范围优化

根据业务场景，当前一些可选范围不合理，例如删除前后置不应该可选『过账』等，需要优化各节点的可选逻辑范围，优化后的可选范围如下：

按照度量值过滤计算范围

在实际需求中，往往会遇到根据度量值进行条件判断，从而决定计算范围的场景。由于python语法层面的限制，deepcube SDK无法直接使用源生if else语法实现此类需求，但是用户可以使用when then otherwise语法来满足过滤计算范围的场景。 使用时，在when()中传入判断条件，如果条件判定为true则执行then()中的计算，否则执行otherwise()中的计算，或继续下一个when判断。 在计算处理时，它表示的语义是对待计算的目标集做条件过滤，满足when条件的数据做then语句中的计算，并赋值到目标集。 但是与普通的条件过滤不同，when语句中的条件可以跨维度做判断，比如用科目A的度量值做判断，影响科目B的计算范围。跨维度时，与loc计算的原则一样，只能一对一或多对一，不能一对多或多对多。

例如我们有如下动态表，行上配置的是12家entity，列上配置的是account，其中flag科目是文本类型，科目A-E则是数值类型：

比如我们的需求是， 上述数据块中，每行数据如果flag中保存的是“规则1”，则计算科目A=BC； 如果是“规则2”，则计算科目A=D2； 如果是“规则3”，则计算科目A=E。 对应代码如下：

from deepcube.cube.cube import DeepCube
from deepcube import when

def main(p1, p2):
    # 实例cube1对象
    cube1 = DeepCube('cube1')
    year = cube1.year
    period = cube1.period
    scenario = cube1.scenario
    version = cube1.version
    account = cube1.account
    category = cube1.category
    entity = cube1.entity

    cube1.init_data(
        [year['2022'], 
         period['1'], 
         scenario['Actual'], 
         category['NoCategory'], 
         version['Working'],
         entity['Total'].Base(),
         account['A', 'B', 'C', 'D', 'E', 'flag']])

    cube1.scope(year['2022'], period['1'], scenario['Actual'], category['NoCategory'], version['Working'])
    # 如果flag中保存的是“规则1”，则计算科目A=B*C；如果是“规则2”，则计算科目A=D*2；如果是“规则3”，则计算科目A=E
    cube1.loc[account['A']] = when(cube1.loc[account['flag']].col('string_val') == '规则1').then(
        cube1.loc[account['B']] * cube1.loc[account['C']]).when(
        cube1.loc[account['flag']].col('string_val') == '规则2').then(
        cube1.loc[account['D']] * 2).when(
        cube1.loc[account['flag']].col('string_val') == '规则3').then(
        cube1.loc[account['E']])
    # 将计算结果写入Cube
    cube1.submit_calc()

更多详细规则和相关示例，请参考《deepcube使用手册》

元素对象目录更新

本次迭代重新梳理定义了组件分类，且对UI样式做了优化