bitrix-bizproc について
Bitrixのドキュメントやアクティビティを扱う、ビジネスプロセス開発・運用向けスキルです。ライフサイクル、権限確認、実行時の運用とカスタムアクティビティの実装上の注意をまとめています。
主な機能
- 01プロセスの開始と停止
- 02ドキュメントIDと型の制約
- 03操作前の権限確認
- 04カスタムアクティビティとトリガー
- 05実行時のトラブル対応
活用シーン
- 01ドキュメント承認フローの実装
- 02カスタムビジネスプロセスの追加
- 03停止したプロセス実行の調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-bizprocインストール後、Claude Code で/bitrix-bizprocを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/custom-activities.mdruntime-ops.mdstart-stop.mdtemplates-access.mdtriggers.md詳細
ビジネスプロセス(bizproc)
基準:main 23.0+ · 検証済み:bizproc 26.1400.0、bizprocdesigner 26.800.0、main 26.800.0
ランタイム、ドキュメント、アクティビティは bizproc にあります。テンプレートデザイナーの UI は bizprocdesigner です(機能 BizProc が必要です)。bizproc とドキュメントの所有者モジュール(crm、lists など)を読み込みます。
| タスク | 参照先 |
|---|---|
開始、終了、強制終了、外部イベント、ドキュメント ID、Starter | rules/start-stop.md |
カスタムアクティビティ:フォルダー、.description.php、クラス、予約名、イベント待機 | rules/custom-activities.md |
| Nodes デザイナー用のカスタムトリガー | rules/triggers.md |
| テンプレートの権限、デザイナーコントローラー、インポート、テンプレートサービス | rules/templates-access.md |
| 停止したままの一時停止、障害上限、トラッキング、ストレージのクリーンアップ、エージェントと Messenger の比較 | rules/runtime-ops.md |
不変条件
- ドキュメント ID は
[moduleId, entity, documentId]、型は[moduleId, entity, documentType]です。所有者モジュールまたは既存のテンプレートから 3 要素の組をコピーし、決して独自に作成しないでください。 CBPDocumentメソッドは例外ではなく、(参照渡しの)$errorsを使ってエラーを報告します。呼び出しのたびに確認してください。- 手動で開始する前、およびすべてのカスタムコントローラーで権限を確認してください(
CBPDocument::canUserOperateDocument()/canUserOperateDocumentType())。 - 承認とドキュメントのステートマシンには bizproc を使用します。定期的な同期と負荷の高い I/O にはエージェントまたは Messenger(
bitrix-background-jobs)を使用し、execute()内では決して実行しないでください。 - カスタムアクティビティのクラスとヘルパーにはベンダープレフィックスを付け、
CBPActivityのメンバー名を決して再利用しないでください。
コメント
Markdown 対応