カスタムシステム管理者プロファイルを使用すると、FSL 管理パッケージのインストールが列の欠落および未定義項目エラーで失敗する

現象/エラーメッセージ

FSL 管理パッケージのインストールが失敗したときの通知メールには次のエラーが表示されます。
ダッシュボードエラー (列の欠落):

• Dashboard(FieldServiceWorkCapacityDashboards/CompareAggregatedWorkstreamUtilizationV2):WorkCapacityUsage$ServiceTerritory column is missing
• Dashboard(FieldServiceWorkCapacityDashboards/RRYSGLHrmcRLDBGKUxngyrueoGIwXW1):WorkCapacityUsage$ServiceTerritory column is missing
• Dashboard(FieldServiceWorkCapacityDashboards/WeeklyAggregatedWorkstreamUtilizationV2):WorkCapacityUsage$ServiceTerritory column is missing
• Dashboard(FieldServiceWorkCapacityDashboards/vwfpkAEnvconLBZYbbJkPTWzLlVfrb):WorkCapacityUsage$ServiceTerritory column is missing

LightningComponentBundle 検証エラー:

• markup://FSL:dispatchConsoleMetadataProcessor:Validation error (FieldUndefined@[uiapi/query/UserSetting__c/edges/node/FSL__User_Setting_Territory_UserSettings__r]):Field 'FSL__User_Setting_Territory_UserSettings__r' in type 'FSL__UserSetting__c' is undefined. line:28, column:37, startIndex:1329

これらのエラーは、組織でサービステリトリーが欠落しているか、設定が誤っていることを示しているわけではありません。インストールを実行したユーザーのプロファイルに必要な権限が不足し、管理パッケージのインストールが不完全に終わったことで発生するエラーです。

根本原因

FSL 管理パッケージのインストールは、カスタムシステム管理者プロファイル (通常は、標準のシステム管理者プロファイルからコピーされたプロファイル) が割り当てられているユーザーが実行します。カスタムコピーしたプロファイルは、管理パッケージのインストールに必要なすべてのシステム権限を継承するとは限りません。
この失敗は、次の 2 つの特定の権限が不足するために発生する可能性があります。

1. 「インストールされていない接続アプリケーションを承認」システム権限の不足 - 管理パッケージのインストールを正常に完了させるには、インストールを実行するユーザーのプロファイルにこの権限が必要です。
2. 非標準のシステム管理者プロファイル - Salesforce Field Service 管理パッケージのインストールを実行するユーザーは、標準で用意されている「システム管理者」プロファイルか、必要なすべての権限が明示的に有効化されているカスタムプロファイルを持っている必要があります。カスタムコピーしたプロファイルには、気づかないうちにこれらの権限の 1 つまたは複数が不足している可能性があります。