service-omni-agent-work-sharing-configure

service-omni-agent-work-sharing-configure

標準の AgentWork オブジェクトにおける組織全体のデフォルト設定を検出し、必要に応じて構成します。サポート対象のヘッドレス契約は CustomObject:AgentWork メタデータです。現在のメタデータを取得し、externalSharingModel を保持したまま、内部の sharingModel=Read をデプロイして、証明のために再度取得します。

この設定により、すでにオブジェクトへのアクセス権を持つ社内ユーザーに、広く読み取りアクセスが付与されます。これは OmniSupervisorConfig の代わりにはなりません。この設定はスーパーバイザーに表示する担当者、キュー、スキル、アクション、タブを絞り込みますが、レコードへのアクセス権は付与しません。

入力

bash scripts/configure-and-report.sh <org-alias> --plan
bash scripts/configure-and-report.sh <org-alias> --confirm-org-wide-visibility

• org-alias は必須で、事前に sf で認証されている必要があります。
• --plan は現在のモデルと希望するモデルを取得して報告しますが、デプロイは行いません。
• Private を Read に変更する必要がある場合に限り、--confirm-org-wide-visibility が必須です。これを省略すると、デプロイ前に処理がブロックされます。

安全性の契約

• 実行時に本番の顧客組織は拒否されます。プランモードは読み取り専用です。
• externalSharingModel はそのまま保持されます。
• Read と ReadWrite ではすでに社内ユーザーに読み取りアクセスが付与されるため、そのまま使用します。このスキルは ReadWrite を Read に変更しません。
• サポート対象の変更は Private から Read への変更のみです。このスキルが社内ユーザーに編集アクセスを付与することはありません。
• 分類、取得、デプロイ、または再取得に失敗した場合、処理はブロックされます。結論の出ない応答をもとに成功を報告することはありません。
• OWD の変更によって共有の再計算が開始される可能性があるため、専用のサンドボックスまたはテスト組織を使用してください。

ワークフロー

1. 対象組織を分類し、本番環境への書き込みを防ぐガードを適用します。
2. Metadata API を通じて CustomObject:AgentWork を取得します。
3. 内部と外部の共有モデルを読み取ります。
4. Read または ReadWrite の場合は、デプロイせずにそのまま使用します。
5. プランモードでは、提案する Private から Read への変更を報告し、黄色のステータスで終了します。
6. 実行モードでは、影響範囲について明示的な確認を必須とします。
7. 外部共有設定を保持し、内部の Read を含む標準オブジェクトのメタデータのみをデプロイします。
8. 再度取得し、内部が Read であり、外部モデルが変更されていないことを確認します。

出力

status、previous_sharing_model、sharing_model、external_sharing_model、changed、dry_run、deploy_id、blocking_issue を含む単一の JSON オブジェクトです。

• configured：Private から Read へのデプロイが成功し、再取得した値が一致しました。
• reused：現在の Read または ReadWrite ですでにアクセスが可能です。
• action_needed：プランモードで Private が検出されました。書き込みは行われていません。
• blocked：安全性ガードまたはサポート対象 API による検証に失敗しました。

制限事項

• このスキルが変更するのは表示範囲であり、スーパーバイザーの対象範囲ではありません。絞り込みにはスーパーバイザー構成スキルを使用してください。
• 共有ルールやレコード単位の AgentWorkShare 行は作成しません。
• 特定のスーパーバイザーが UI 全体にアクセスできることは証明できません。構成後、対象のスーパーバイザーユーザーを使用して Command Center の一連の操作をエンドツーエンドで検証してください。

参考資料

ファイル	読むタイミング
references/api-notes.md	組織全体への変更を承認する前、または取得／デプロイの失敗を診断する際