service-omni-command-center-configure

service-omni-command-center-configure

Settings:OmniChannel を通じて Service V2 の Command Center を有効化し、必要に応じて同じ Metadata API 契約で公開される 5 つのスーパーバイザー制御を設定します。ライターは組織の設定ドキュメント全体を取得し、要求された要素のみを変更して、そのドキュメントを保持したままデプロイします。その後、もう一度取得し、値と、プラットフォームによって作成された CommandCenterForServiceV2_L ページおよび V2 タブの両方を検証します。

取得した設定ドキュメントに enableCommandCenterForServiceV2 が含まれていない場合、このスキルは platform_api_unavailable として処理を中止します。

まず service-omni-base-settings-configure を実行して、Omni の基盤を有効にしてください。組織が Command Center V2 に対応していない場合は、代わりに従来のスーパーバイザー設定に service-omni-supervisor-config-deploy を使用してください。

エンドツーエンドのセットアップでは、service-omni-channel-setup-coordinate は OMNI_COMMAND_CENTER_V2=1 の場合に限り、このスキルを呼び出します。コーディネーターのデフォルトのスーパーバイザーパスは変更されません。

入力

bash scripts/configure-and-report.sh plan <org-alias> [options]
bash scripts/configure-and-report.sh run  <org-alias> --apply [options]

オプション：

オプション	Metadata 要素	値
--conversation-monitoring	enableConversationMonitoring	true または false
--agent-sneak-peek	enableAgentSneakPeek	true または false
--customer-sneak-peek	enableClientSneakPeek	true または false
--whisper-messaging	enableWhisperMessaging	true または false
--queues-and-skills	enableSkillsAndQueueActions	true または false

enableCommandCenterForServiceV2=true は常に要求されます。指定されていないスーパーバイザー制御は、取得時の値のまま正確に保持されます。組織レベルのスーパーバイザーエクスペリエンスの無効化は性質が大きく異なる操作であるため、このスキルでは意図的に V2 を無効化できないようにしています。

安全性

• plan は読み取り専用で、デプロイは行いません。
• run では、変更を行う前に文字列どおりの --apply フラグが必要です。
• 書き込みが許可されるのは、IsSandbox=true、TrialExpirationDate が null 以外、または OrganizationType が Developer Edition か Base Edition の場合のみです。本番環境向けのオーバーライドはありません。
• Settings は Metadata API のドキュメント全体を扱う型です。不完全な、またはハードコードされた OmniChannel.settings-meta.xml は決してデプロイしないでください。無関係な Omni 設定がリセットされる可能性があります。
• 対象の組織では、Enhanced Omni-Channel と Command Center for Service V2 のリリースゲートが必要です。また、API フィールドには Customize Application による権限も必要です。

動作

1. 認証を行い、API v66 で Settings:OmniChannel を取得します。
2. V2 フィールドが存在することを確認します。存在しない場合は reason_code=platform_api_unavailable を指定して blocked を返し、デプロイは試みません。
3. V2=true と、呼び出し元が明示的に指定したオプションの制御のみを含む、要求値のセットを作成します。
4. plan では書き込みを行わず、action_needed または reused を返します。
5. run では --apply と非本番環境のガードを適用し、取得したドキュメントのプライベートコピーを変更してデプロイします。
6. 設定を再取得し、要求したすべての値が一致することを確認します。
7. シードされた FlexiPage（CommandCenterForServiceV2_L）と V2 の TabDefinition の両方が確認可能であることを必須とします。プロビジョニングの証跡が見つからない、または読み取れない場合は blocked を返します。このスキルが推測で判断することはありません。

プラットフォームの ON 遷移フックは冪等です。プロファイルのタブ設定が存在しない場合に作成し、必要な場合に限り基本の FlexiPage をシードします。既存のページのカスタマイズは上書きされません。設定がすでに true でもシード成果物が不足している場合、スキルは seed_incomplete を返します。破壊的な OFF→ON の切り替えを強制することはありません。

出力契約

スクリプトは、次の項目を含む 1 つの JSON オブジェクトを出力します。

• status：configured、reused、action_needed、または blocked
• reason_code：changes_required、already_configured、platform_api_unavailable、unsafe_target、deploy_failed、verification_failed、seed_incomplete などの安定した理由コード
• requested、before、after：設定値。スナップショットでは存在の有無も保持されます
• safe_to_write、deploy_id、verification
• manual_actions：権限の割り当てと、必要なフォローアップ
• blocking_issue：ブロックされた場合にのみ設定されます

組織の設定を有効にしても、ユーザーにアクセス権は付与されません。CommandCenterForServiceUser を含む権限セットを、対象とする各スーパーバイザーに割り当てた後、service-omni-command-center-analyze <org> <supervisor> を実行して、エンドツーエンドの準備状況を確認してください。

参考資料

ファイル	読むタイミング
references/api-notes.md	メタデータ名、プラットフォームのゲート、シードの動作、既知の制限事項