bitrix-documentgenerator

Bitrix ドキュメントジェネレーター

ベースライン：main 23.0+ · 検証済み：documentgenerator 26.200.100、main 26.800.0

Bitrix24 エディションのみ（クラウドおよびオンプレミス）：インストールには humanresources が必要です。「Site Management」には含まれていません。PDF/JPG には transformer モジュールとドキュメントサーバーが必要です。

タスク	参照先
プレースホルダー、修飾子、テーブル、画像、コードからテンプレートを作成	rules/templates.md
独自のエンティティデータ：プロバイダークラス、フィールド、リスト、登録	rules/providers.md
DOCX/PDF の生成、番号、ストレージ、削除、イベント	rules/generation.md
モジュールの権限、ロール、テンプレートへのアクセス、REST、UI コンポーネント	rules/access-rest.md

CRM ドキュメント（請求書、取引）では、CRM 独自のプロバイダーを使用します：bitrix24-crm。

不変条件

• Loader::requireModule('documentgenerator') を呼び出します。コードは /local/modules/ 配下の独自モジュールに配置し、そのモジュール ID でプロバイダーを登録します。
• テンプレートの MODULE_ID はプロバイダーの MODULE と一致し、インストール済みモジュールである必要があります。一致しない場合、プロバイダーは通知なく無視されます。
• getFields() / Document::createByTemplate() の前に Template::setSourceType() を呼び出し、getSourceType() を確認します。
• 権限を明示的に確認します：UserPermissions、テンプレートへのアクセス、Document::hasAccess()。読み込みと作成では権限は確認されず、ユーザー 0 はデータチェックを通過します。
• ファイルは b_documentgenerator_file.ID（FILE_ID、PDF_ID）で参照します。FileTable::getBFileId() で変換します。
• PDF の生成は非同期です：getFile(false) で生成するか、変換エラーを無視し、onDocumentTransformationComplete に応じて処理します。