mcpField
B
bitrix-bizproc

bitrix-bizproc

github.com/bxmaximum生産性47266 回インストール2 週間前に更新
リポジトリ

bitrix-bizproc について

Bitrixのドキュメントやアクティビティを扱う、ビジネスプロセス開発・運用向けスキルです。ライフサイクル、権限確認、実行時の運用とカスタムアクティビティの実装上の注意をまとめています。

主な機能

  1. 01プロセスの開始と停止
  2. 02ドキュメントIDと型の制約
  3. 03操作前の権限確認
  4. 04カスタムアクティビティとトリガー
  5. 05実行時のトラブル対応

活用シーン

  1. 01ドキュメント承認フローの実装
  2. 02カスタムビジネスプロセスの追加
  3. 03停止したプロセス実行の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bxmaximum/bitrix-framework-skills --skill bitrix-bizproc

インストール後、Claude Code で/bitrix-bizprocを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

rules/
custom-activities.md
runtime-ops.md
start-stop.md
templates-access.md
triggers.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、Starterrules/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 のメンバー名を決して再利用しないでください。

コメント