8.2合并流程控制页面配置

合并动作权限

我们在进行合并动作计算时，都会先根据编辑态的合并动作权限进行鉴权，具备权限的用户/用户组才可进行具体操作

合并动作预置策略

合并动作我们在配置中已经发现配置了如下这些策略，

• 单体（base实体对应的流程单元）不允许【合并】及【强制合并】；

• 无父级信息的实体（父级为#root或不带父级信息的实体），不允许【折算】及【贡献】；

• 合并实体对应的流程单元，不允许【计算】

合并动作校验

ℹ️合并动作上预置了些合并场景常见的校验策略：

点击 【折算】时，同单元计算状态必须为已完成

点击【贡献（抵消）】时，同单元计算状态和折算状态必须为已完成

~~点击【强制合并】时，同单元的【计算状态】必须为~~~~已完成~~

合并动作前置提醒（20240108新增）

点击**【任意合并计算】**按钮时，系统会检测当前任务与正在进行的合并操作任务，并对用户做相应提醒。

PS：20240411新增加下级合并节点相关提醒

财务模型回调

基于财务模型搭建的电子表格在保存后可配置回调合并流程重置逻辑，重置所有「合并计算」状态为「数据变更」，重置范围：

• year+period+scenario+version+entity 维度背景下的所有流程单元

• entity为「父点子」或「实体」，都回写 实体（子） 的信息，不考虑parent信息

• 除了每个被重置的单元自身外，每个单元向上所有实体单元的计算状态、折算状态、贡献状态，均会被重置

• python_sdk财务模型元素保存—cube.save()

  • 可配置是否回调，参数callback：默认True

财务模型 — DeepFOS

• DeepCube—submit_calc()

  • 直接提交数据库clickhouse，不走财务模型故不会走回调逻辑

⚠️如直接在py里保存财务模型数据，且不想回调重置状态，需使用cube.save()，且callback设置为False

合并校验

• 合并校验的预置逻辑，即通过校验配置的pov去查询合并财务模型的每个合并单元，取到的多行数据聚合计算：

  • 未校验：所有校验值均为空（null）

  • 异常：至少1个有值，且存在校验值 != 0

  • 正常：至少1个有值，且所有校验值 == 0

  • 如果校验没有启用，或者部分如折算没有启用，对应的校验值

    视为「未校验」

• 合并校验是在「查询」动作时进行动态校验，

案例

在合并流程配置中，我们配置了【阶段一】的合并校验规则，如下图所示，系统将会校验所有如下pov的单元格的每个值。

我们可以拉取动态表看到，对应pov组合下的单元格有值且不为0

因为我们打开了阶段1的计算和折算校验，故此时，我们在使用视图查询对应pov的流程单元，它的阶段状态为校验失败

合并校验看板

上一节我们讲解了合并校验的逻辑，校验看板帮助我们更好地呈现校验结果，实现在合并流程使用视图通过点击「校验状态」查看具体校验明细，我们可以在合并流程控件UX添加弹窗的方式来展示校验看板。

a.首先我们在合并流程UX控件的编辑态，添加「弹窗」控件

b.我们在弹窗中添加我们的合并校验看板，合并校验看板的数据来源可以选择合并流程控制模型或者财务模型数据源，我们此处选择「合并流程控制模型」，并选择对应的合并流程元素

c.我们点击合并校验看板，并在「模型入参」处编辑表达式

{
  phase: $components.consol_process_table_X1Xc.clickedCol?.parent?.config?.key,
  unitId: $components.consol_process_table_X1Xc.clickedRow?.unitId,
  validateMode: $components.consol_process_table_X1Xc.clickedCol?.key,
  expectedName: $components.consol_process_table_X1Xc.clickedRow?.expectedName,
}

d.最后我们在流程控制表格的「事件」中，点击校验状态列添加「打开弹窗」配置，「目标控件」选择之前配置的合并校验看板弹窗

回到使用视图，点击校验状态，效果图如下：

合并流程历史看板（新）

如果我们需要查看历史操作记录，合并流程使用视图提供了弹窗展示历史记录功能，我们可以在合并流程UX控件添加弹窗的方式来展示流程历史看板，分为「审批历史」和「计算历史」：

• 审批历史：点击审批进度列，查看审批记录

• 计算历史：点击计算状态列，查看合并计算记录

a.首先我们在合并流程UX控件的编辑态，添加「弹窗」控件

b.我们在弹窗中添加我们的合并历史看板，并选择对应的「合并流程控制模型」

c.我们点击合并历史看板，并在「模型入参」处编辑表达式

({
  phase: $components.consol_process_table_OhU7.clickedCol?.parent?.config?.key,
  unitId: $components.consol_process_table_OhU7.clickedRow?.unitId
})

({
  parent: $components.consol_process_table_2BVk.clickedRow?.parentName,
  unitId: $components.consol_process_table_2BVk.clickedRow?.unitId
})

d.最后我们在流程控制表格的「事件」中，点击审批进度列添加「打开弹窗」配置，「目标控件」选择之前配置的合并历史看板弹窗

回到使用视图，点击审批状态，效果图如下：

审批动作权限

我们在进行动作审批时，都会先根据编辑态的审批动作权限进行鉴权，具备权限的用户/用户组才可进行具体操作

审批动作校验

原则1：合并的业务场景，即上级严重依赖下级的数据，因此审批控制，上级的进度不能超过下级

原则2：所有前进类审批，均需要鉴别同单元下的”计算校验状态”为“校验通过”

1、前进类审批，需要同时满足以下条件：

• 作业状态需要空闲

• 同单元的「计算/合并的业务状态」 为“已计算”

• 同单元的计算校验状态为“校验通过”（合并校验开启的状态下）

• 前进的目标进度 不超过(≤) 任意下****级实体单元的进度

2、后退类审批

• 后退的目标进度 不小于(＞) 任意上级实体单元的进度

审批动作自定义逻辑

{
  "is_success": True,  
  # 布尔值，表示业务逻辑运行成功失败
  "notification": {
    "success": {
      "title": "成功标题",
      "description": "成功文案"
    },
    "info": {
      "title": "提示标题",
      "description": "提示文案"
    },
    "warning": {
      "title": "警告标题",
      "description": "警告文案"
    }
  }
}

{
  "is_success": False,  
  # 布尔值，表示业务逻辑运行成功失败
  "notification": {
    "info": {
      "title": "提示标题",
      "description": "提示文案"
    },
    "warning": {
      "title": "警告标题",
      "description": "警告文案"
    },
    "error": {
      "title": "错误标题",
      "description": "错误文案"
    }
  }
}

{
  "year": "2022",
  "period": "12",
  "scenario": "Actual",
  "version": "Working",
  "entity":"AC",
  "parent":"MC",
  "unit_id":"2022_12_Actual_Working_AC",
  "action_code": "approve01",
  #操作范围：self-实体本身，idescendant-实体本身和后代，ichildren-实体本身和子代
  "scope"："idescendant",
  "origin_state":"state_2",
  "target_state": "state_5"
  "origin_num":"2",
  "target_num": "5"
  "batch_entities": [
    "AC",
    "A",
    "B"
  ],
  "batch_parents": [
    "MC",
    "AC",
    "AC"
  ],
  "unit_ids": [
    "2022_12_Actual_Working_AC",
    "2022_12_Actual_Working_A",
    "2022_12_Actual_Working_B"
  ]
}

{
	  "year": "2022",
    "period": "12",
    "scenario": "Actual",
    "version": "Working",
  	"entity": "A",
    "parent": "AC",
  	"unit_id": "2022_12_Actual_Working_A",
  	"action_code": "approve01",
    #操作范围：self-实体本身，idescendant-实体本身和后代，ichildren-实体本身和子代
  	"scope"："idescendant",
		"origin_state": "state_1",
		"target_state": "state_5",
  	"origin_num": "1",
		"target_num": "5"
    "unit_ids": [
      {
        "entity":"A",
        "parent":"AC",
        "unit_id":"2022_12_Actual_Working_A"
      },
      {
        "entity":"B",
        "parent":"AC",
        "unit_id":"2022_12_Actual_Working_B"
      }
    ]
}

后代批量审批（新）

当实际业务场景中有批量审批或解锁下属所有单位的需求时，我们在编辑态会打开「允许对实体后代操作」功能以提升合并流程控制的使用效率和性能，后代批量功能在使用态主要有以下几方面影响：