用途
该技能聚焦 Bitrix 框架中的业务流程(bizproc)相关开发。其规则资料按主题组织,可用于实现审批、文档状态流转等业务场景,以及围绕流程运行时、文档与活动的开发与运维工作。
基线版本
资料给出的基线为 main 23.0+;已验证版本为 bizproc 26.1400.0、bizprocdesigner 26.800.0、main 26.800.0。
模块构成
运行时、文档与活动位于 bizproc;模板设计器 UI 位于 bizprocdesigner(需要 BizProc 功能)。使用时应加载 bizproc 以及文档所属模块(如 crm、lists 等)。
规则主题与阅读入口
- 启动、终止、kill、外部事件、文档 id、Starter:rules/start-stop.md
- 自定义活动:目录、.description.php、类、保留名称、等待事件:rules/custom-activities.md
- 面向 Nodes 设计器的自定义触发器:rules/triggers.md
- 模板权限、设计器控制器、导入、模板服务:rules/templates-access.md
- 卡住的暂停、故障上限、跟踪、存储清理、agents 与 Messenger 对比:rules/runtime-ops.md
不变量
- 文档 id 为 [moduleId, entity, documentId],类型为 [moduleId, entity, documentType]。这些三元组应从所属模块或现有模板中复制,绝不能自行臆造。
- CBPDocument 方法通过引用参数 $errors 上报错误,而不是抛出异常:每次调用后都要检查它。
- 在手动启动前以及每个自定义控制器中都要检查权限(CBPDocument::canUserOperateDocument() / canUserOperateDocumentType())。
- 审批与文档状态机应使用 bizproc。周期性同步与重型 I/O 应使用 agents 或 Messenger(bitrix-background-jobs),绝不要放在 execute() 内部。
- 自定义活动类与辅助类应带厂商前缀,绝不重用 CBPActivity 的成员名称。
限制
资料未提供安装命令、价格、平台支持范围以及具体的使用步骤示例;以上未提及的内容暂未提供。