bitrix24-tasks

Bitrix24 のタスク（サーバー側）

対象範囲：Bitrix24 オンプレミス版 · 検証済みバージョン：tasks 26.300.100、main 26.800.0

タスク	参照先
API 層の選択、作成、更新、完了、削除、エラー	rules/writing.md
単一タスクまたは一覧：フィルター、並べ替え、ページング、日付	rules/reading.md
メンバー、期限とタイムゾーン、チェックリスト、タグ、プロジェクト、テンプレート、コメント	rules/details.md
アクセス制御アクション、イベントとその引数、REST マッピング	rules/access-events.md

不変条件

• V2 コマンド（AddTaskCommand、UpdateTaskCommand など）を通じて書き込みます（レガシーの CTaskItem／CTasks も同じ V2 サービスを呼び出します）。TaskTable やメンバー／チェックリストのテーブルには書き込まないでください。カウンター、チャット、検索、イベント、リサイクルビンが更新されません。
• コマンドは権限を確認しません。run() の前に、操作を行うユーザーについて TaskAccessService／TaskAccessController を確認してください。
• 操作を行うユーザーの ID を明示的に渡してください（設定の userId）。エージェントと CLI には $USER がありません。USER_ID を指定せずに CTasks::Add を呼び出すと、ユーザー 1 として操作します。
• V2 エンティティの日付は Unix タイムスタンプ（deadlineTs）です。バックグラウンドコードからサイト形式の日付文字列を渡さないでください。
• V2 呼び出しは、1 つの /local ゲートウェイクラスにまとめてください。コマンドが受け取る V2\Internal\… エンティティと設定は、リリース間で変更される可能性があります。V2 層は tasks 26.300.100 でのみ検証済みです。class_exists(AddTaskCommand::class) が false の場合は、CTaskItem を使用してください。
• 新しいタスクカードでは、コメントはタスクチャット内のメッセージです（rules/details.md、bitrix24-im を参照）。