SuperAPI AI 工具集

bitrix-bizproc

办公与效率

查看项目

更新于 10-15 16:34

技能介绍

用途

该技能聚焦 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 的成员名称。

限制

资料未提供安装命令、价格、平台支持范围以及具体的使用步骤示例;以上未提及的内容暂未提供。