详细介绍：iBizModel 实体主状态（PSDEMAINSTATE）及主状态逻辑（PSDELOGIC`MAINSTATELOGIC`）模型详解

一、实体主状态（PSDEMAINSTATE）概述

iBizModel中用于定义和管理实体数据状态的核心控制模型。它通过最多三个实体属性值的组合（称为主状态标记）来标识数据的当前状态，并基于状态对实体行为（如增删改查）和数据管理标识（如权限控制）施加精细化控制。主状态控制逻辑超越传统的权限体系，例如，即使当前用户具备删除权限，若数据处于特定主状态（如“已锁定”状态），系统仍可拒绝删除操作，从而确保业务规则和材料的完整性。就是实体主状态

下图示例了主状态在开源产品iBizEHR在招聘流程中的应用。
表格设计界面

流程设计界面

1.1 PSDEMAINSTATE模型属性详解

PSDEMAINSTATE模型包含以下关键属性（基于Groovy DSL语法定义）：

• allowmode（必填）：枚举类型，指定主状态行为的控制模式，可选值为ALLOW（允许模式）或DENY（拒绝模式）。例如，设置为DENY时，该状态下的指定行为将被强制拒绝。
• codename（必填）：主状态的代码标识，需在实体中唯一。
• defaultmode：枚举类型，定义主状态类型，包括：
  • 0（常规）：普通状态。
  • 1（实体默认）：实体创建时的初始状态。
  • 2（锁定控制）：用于数据锁定场景，禁止非授权操作。
  • 3（关闭控制）：表示数据生命周期结束，如“已关闭”状态。
• msvalue、msvalue2、msvalue3：分别对应主状态属性1、2、3的值，通过组合形成唯一状态标记（mstag）。
• psdeid（必填）：引用所属实体（PSDATAENTITY），建立父子关系。
• name（必填）：主状态名称，需在实体中唯一。
• deactiondenymsg 和 deopprivdenymsg：自定义拒绝操作时的提示信息，提升用户体验。
• color 和 pssysimageid：用于界面展示，如状态颜色和图标。

1.2 主状态控制机制

PSDEMAINSTATE通过嵌套成员模型实现细粒度控制：

• PSDEMSFIELD：定义主状态控制的实体属性（如字段的只读或隐藏规则）。
• PSDEMSOPPRIV：绑定实体执行标识（PSDEOPPRIV），控制特定状态下的内容执行（如“编辑”或“删除”）。
• PSDEMSACTION：关联实体行为（PSDEACTION），指定状态允许或拒绝的行为（如“提交”或“审核”）。

例如，在订单实体中，可定义主状态“已审核”（msvalue=“REVIEWED”），并通过PSDEMSACTION拒绝“修改”行为，即使当前用户有修改权限，系统也会拦截处理。

---

二、主状态逻辑PSDELOGIC（MAINSTATELOGIC）详解

主状态逻辑是PSDELOGIC的一种特殊类型（logictype: “MAINSTATELOGIC”），专门处理主状态之间的迁移路由和业务流转。它利用逻辑节点（PSDELOGICNODE）和连接（PSDELOGICLINK）定义状态切换规则，帮助动态条件判断和业务触发。

2.1 核心特性

• 专用节点类型：仅支持MAINSTATE逻辑节点，无需定义BEGIN和END节点，简化配置。
• 状态匹配机制：通过logictag和logictag2属性定义支持的数据状态值，支持通配符*（如logictag: "*"匹配任意状态值1），实现多层状态迁移的分离定义。
• 双配置模式：
  • 常规模式：通过psdemainstateid引用预定义的PSDEMAINSTATE模型，适用于复杂状态管理。
  • 简单模式：直接通过节点参数（如param1定义状态值）快速配置，适用于轻量级场景。

2.2 应用场景

主状态逻辑广泛应用于业务状态机、工作流和数据生命周期管理：

• 订单处理流程：状态从“草稿” → “已提交” → “已审核” → “已完成”，每个迁移可绑定条件（如金额阈值）或外部逻辑。
• 项目任务管理：任务状态（如“未开始”、“进行中”、“已延期”）控制可管理行为（如“启动任务”仅允许在“未开始”状态）。
• 数据审批流：结合PSDEACTION和PSDEOPPRIV，实现状态驱动的权限升降级，例如“驳回”操作将状态回退至“草稿”。

---

三、关系图例

以下应用Mermaid语法展示PSDEMAINSTATE及其相关模型的层级和引用关系：

图例说明：

• PSDEMAINSTATE作为PSDATAENTITY的子模型，借助成员模型（PSDEMSFIELD等）扩展控制能力。
• PSDELOGIC（MAINSTATELOGIC）依据PSDELOGICNODE引用PSDEMAINSTATE，形成状态迁移链路。
• 外部模型（如PSDEACTION、PSDEOPPRIV）通过关联关系受主状态约束。

---

四、示例DSL代码

以下提供一个完整的DSL示例，展示如何定义订单实体（PSDATAENTITY）的主状态及主状态逻辑。示例包含：

1. 定义订单实体和主状态（草稿、已提交、已审核）。
2. 配置主状态逻辑，搭建状态迁移（草稿 → 已提交 → 已审核）。
3. 集成行为控制和操作标识管理。

// iBizModelDSL建模指令，目标：定义订单实体的主状态及状态迁移逻辑
def de_order = "Demo.ORDER" // 订单实体标识
// 1. 定义订单实体的主状态
psdemainstate(
allowmode: "DENY",        // 行为控制模式：拒绝
codename: "DRAFT",        // 状态代码
defaultmode: 1,           // 实体默认状态
msvalue: "DRAFT",         // 状态值1
name: "草稿",             // 状态名称
psdeid: de_order,         // 所属实体
deactiondenymsg: "草稿状态下不允许执行此操作",
ordervalue: 10
) {
// 嵌套成员：定义主状态控制的属性（如订单金额字段只读）
psdemsfield(
name: "控制金额字段",
psdefid: de_order + ".AMOUNT", // 引用订单金额属性
defaultvalue: "READONLY"
)
// 嵌套成员：定义拒绝的操作标识（如删除权限）
psdemsoppriv(
psdemsactionname: "拒绝删除",
psdeopprivid: de_order + ".DELETE"
)
}
psdemainstate(
allowmode: "ALLOW",
codename: "SUBMITTED",
msvalue: "SUBMITTED",
name: "已提交",
psdeid: de_order,
ordervalue: 20
) {
psdemsaction(
psdemsactionname: "允许提交",
psdeactionid: de_order + ".SUBMIT"
)
}
psdemainstate(
allowmode: "ALLOW",
codename: "REVIEWED",
msvalue: "REVIEWED",
name: "已审核",
psdeid: de_order,
ordervalue: 30
) {
psdemsoppriv(
psdemsactionname: "允许编辑",
psdeopprivid: de_order + ".EDIT"
)
}
// 2. 定义主状态迁移逻辑（MAINSTATELOGIC）
psdelogic(
logictype: "MAINSTATELOGIC",
codename: "ORDER_STATE_FLOW",
name: "订单状态迁移逻辑",
psdeid: de_order,
logictag: "*",           // 匹配任意状态值1
logictag2: "*"           // 匹配任意状态值2
) {
// 状态节点：草稿（默认状态）
psdelogicnode(
id: "STATE_DRAFT",
codename: "STATE_DRAFT",
logicnodetype: "MAINSTATE",
param9: 1,           // 默认状态
psdemainstateid: de_order + ".DRAFT" // 引用主状态
)
// 状态节点：已提交（简单模式配置）
psdelogicnode(
id: "STATE_SUBMITTED",
codename: "STATE_SUBMITTED",
logicnodetype: "MAINSTATE",
param9: 0,
param1: "SUBMITTED", // 状态值1
param7: 1,           // 行为允许模式：允许
param4: "SUBMIT;UPDATE", // 允许的行为列表
param8: 1,           // 操作标识允许模式：允许
param5: "EDIT"       // 允许的操作标识
)
// 状态节点：已审核
psdelogicnode(
id: "STATE_REVIEWED",
codename: "STATE_REVIEWED",
logicnodetype: "MAINSTATE",
param9: 0,
psdemainstateid: de_order + ".REVIEWED"
)
// 状态迁移连接：草稿 → 已提交
psdelogiclink(
ordervalue: 10,
name: "草稿到已提交",
srcpsdelogicnodeid: "STATE_DRAFT",
dstpsdelogicnodeid: "STATE_SUBMITTED"
) {
// 迁移条件：订单金额大于0
psdellcond(
dstpsdlparamid: "Default",   // 默认参数
logictype: "SINGLE",
ordervalue: 10,
customdstparam: "AMOUNT",    // 订单金额属性
condvalue: "0",
psdbvalueopid: "GT",         // 大于
name: "金额大于0"
)
}
// 状态迁移连接：已提交 → 已审核
psdelogiclink(
ordervalue: 20,
name: "已提交到已审核",
srcpsdelogicnodeid: "STATE_SUBMITTED",
dstpsdelogicnodeid: "STATE_REVIEWED"
) {
// 组合条件：审核人非空且状态为已提交
psdellcond(
logictype: "GROUP",
ordervalue: 10,
groupop: "AND"
) {
psdellcond(
dstpsdlparamid: "Default",
logictype: "SINGLE",
ordervalue: 10,
customdstparam: "REVIEWER",
condvalue: "",
psdbvalueopid: "ISNOTNULL", // 非空
name: "审核人存在"
)
psdellcond(
dstpsdlparamid: "Default",
logictype: "SINGLE",
ordervalue: 20,
customdstparam: "STATE",
condvalue: "SUBMITTED",
psdbvalueopid: "EQ",      // 等于
name: "状态为已提交"
)
}
}
}

DSL代码说明：

• 主状态定义：通过psdemainstate定义三个状态（草稿、已提交、已审核），并嵌套成员模型控制属性和操作。
• 状态逻辑配置：使用psdelogic（logictype: “MAINSTATELOGIC”）定义迁移路径，通过psdelogiclink和psdellcond添加条件判断。
• 业务规则：例如，从“草稿”迁移到“已提交”需满足金额大于0的条件；从“已提交”到“已审核”需审核人非空。

---

五、应用场景深度解析

5.1 工作流状态管理

在采购订单环境中，主状态逻辑可驱动完整的审批流程：

• 状态设计：草稿（DRAFT）→ 提交（SUBMITTED）→ 部门审核（DEPT_REVIEW）→ 财务审核（FINANCE_REVIEW）→ 完成（COMPLETED）。
• 行为控制：在“部门审核”状态，通过PSDEMSACTION拒绝“修改”行为，确保数据一致性。
• 迁移条件：使用PSDELOGICLINK条件检查审核人角色或金额阈值，实现动态路由。

5.2 数据安全与权限增强

在客户管理系统中，主状态用于强化数据保护：

• 锁定状态：定义“锁定控制”状态（defaultmode: 2），通过PSDEMSOPPRIV拒绝所有操作标识，防止误修改。
• 审计追踪：结合PSDELOGICNODE记录状态变更日志，满足合规要求。

5.3 界面交互优化

通过主状态与界面部件（如PSDEFORM、PSDEGRID）集成：

• 动态表单：在“已关闭”状态，利用PSDEMSFIELD隐藏编辑字段，提升用户体验。
• 状态提示：利用color和pssysimageid在界面上直观展示状态（如红色表示“紧急”）。

5.4 异常处理与回退

主状态逻辑支持异常迁移路径：

• 回退机制：从“已审核”状态回退至“草稿”，需附加条件（如管理员权限）。
• 超时控制：借助PSDELOGIC集成定时任务，自动将“待处理”状态标记为“已过期”。

---

六、总结

实体主状态（PSDEMAINSTATE）和主状态逻辑（PSDELOGIC类型MAINSTATELOGIC）是iBizModel中构建精细化状态管理的核心组件。它们通过属性组合、行为控制、迁移路由和条件判断，为复杂业务环境提供灵活、可靠的状态机支持。应用场景覆盖工作流、权限管理、数据完整性及界面交互，显著提升架构的可维护性和业务适应性。凭借本文提供的DSL示例和关系图例，开发者可快速上手建模，实现高效的状态驱动业务逻辑。