【Salesforce】Service Consoleタブが想定と違う時の本番反映前の切り分け

【Salesforce】Service Consoleタブが想定と違う時の本番反映前の切り分け
🛡️ 超解決

SalesforceのService Consoleで、カスタマイズしたタブが期待通りに表示されない、あるいは表示・非表示が意図と異なるトラブルは、比較的頻繁に発生します。特に権限制御や動的フォーム設定など、複数の要素が絡む場合に原因の特定が難しくなります。本番環境に変更を反映する前に、問題の原因を切り分けておくことで、ユーザーへの影響を最小限に抑え、問い合わせ対応の負荷を減らせます。この記事では、Service Consoleタブの表示に関わる主要な設定項目と、本番反映前に行うべき切り分け手順を具体的に解説します。

【要点】この記事で確認すること

  • 最初に見る場所: 問題のタブがアプリケーション定義の「選択可能なタブ」に含まれているか、およびユーザーのプロファイル・権限セットでタブの表示権限が正しく設定されているかを確認します。
  • 切り分けの軸: タブの表示設定(表示・非表示・デフォルトで表示)と、動的フォームやアクションの条件式、およびレコードタイプやユーザー属性による条件付き表示の有無の3軸で確認します。
  • 注意点: 本番環境での設定変更は最小限に留め、まずSandboxや開発環境で再現テストを行ってください。また、プロファイルや権限セットの変更は他の機能にも影響するため、影響範囲を事前にリストアップしてから作業してください。

ADVERTISEMENT

タブ表示を制御する主要な設定項目

Service Consoleでタブの表示を制御する設定は、主に以下の4つに分類されます。それぞれの役割を理解しておくことが、原因の切り分けに不可欠です。

設定項目 役割 主な確認ポイント
アプリケーション定義 アプリケーションに含めるタブの一覧を定義します。「選択可能なタブ」に入っていないタブは、ユーザーが追加できません。 該当タブが「選択可能なタブ」リストに存在するか。また「デフォルトのタブ」で最初から表示させる設定になっているか。
プロファイル・権限セット タブの表示権限(標準タブ/カスタムタブ)を「表示」「非表示」「デフォルトで表示」から選択します。 権限が「表示」「デフォルトで表示」に設定されているか。権限セットの優先順位(上書き)も確認。
動的フォーム・アクション 特定の条件(レコードタイプ、ユーザー属性など)に応じてタブの表示・非表示を動的に切り替えます。 条件式が正しく設定されているか、複数の条件が競合していないか。
コンソールコンポーネントの設定 Service Consoleのナビゲーション項目やコンポーネント単位でタブの表示を制御します。 「コンソールナビゲーション」や「コンソールタブ」設定が正しいか。

本番反映前に行うべき切り分け手順(5ステップ)

以下の手順に沿って、Sandbox環境や開発環境で事前検証を実施してください。本番でのトラブルを未然に防げます。

  1. アプリケーション定義の確認:設定 → アプリケーション → 該当のService Consoleアプリケーションを開き、「選択可能なタブ」に目的のタブが含まれていることを確認します。含まれていない場合は追加します。また「デフォルトのタブ」に設定すると、ユーザーの画面に最初から表示されるようになります。
  2. プロファイル・権限セットの確認:該当ユーザーのプロファイルまたは権限セットで、タブの表示権限が「表示」または「デフォルトで表示」になっているかを確認します。権限セットが複数割り当てられている場合は、優先順位(権限セットの設定がプロファイルより強い、または同レベルで上書きされる)を考慮します。
  3. 動的フォームの条件式チェック:Service Consoleに表示されるレコード詳細画面でタブの表示を制御している動的フォームがある場合、その条件式が正しいか確認します。例えば、特定のレコードタイプでのみ表示する条件が、対象外のユーザーにも適用されていないかを検証します。
  4. コンソールナビゲーションの設定確認:設定 → Service Console → コンソールナビゲーションで、該当タブがナビゲーション項目として追加され、適切なアイテム(オブジェクトやフォルダ)と関連付けられているか確認します。
  5. ユーザー属性・レコードタイプによる条件付き表示のテスト:タブの表示がユーザーのプロファイルやレコードタイプに依存している場合、複数のテストユーザー(テストプロファイル、テストレコードタイプ)を使って、想定通りの表示になるか確認します。ブラウザのDevツールやSalesforce APIを使用して、表示・非表示が切り替わる条件を厳密に検証します。

よくある失敗パターンとその対策

実際の現場でよく見られる失敗例を3つ紹介します。同様のケースに当てはまる場合は、原因の特定が容易になります。

失敗パターン1:アプリケーション定義で「選択可能なタブ」に追加していない

カスタムタブを作成したが、アプリケーション定義に追加し忘れるケースです。この場合、ユーザーはタブを追加できません。対策として、上記手順1を確実に実施し、Sandbox間や本番環境間で設定の差分がないか定期的にチェックする仕組みを導入してください。

失敗パターン2:複数の権限セットでタブ表示権限が競合する

ユーザーに複数の権限セットが割り当てられており、それぞれでタブの表示権限が異なる場合、意図しない上書きが発生します。例えば、権限セットAでは「デフォルトで表示」、権限セットBでは「非表示」と設定されていると、後から適用された方が優先される可能性があります。対策として、権限セットごとにタブ設定を統一するか、優先順位を明確に管理します。管理者は、権限セット一覧から「ユーザー権限セットの割り当て」レポートを活用するとよいでしょう。

失敗パターン3:動的フォームの条件式が正しく記述されていない

動的フォームを使用してタブの表示を制御する場合、条件式に論理エラーがあると、常に表示されない・常に表示されるといった状態が発生します。例えば、RecordTypeのDeveloperNameを大文字小文字を間違えて指定すると、条件がマッチしません。対策として、条件式を構築する際には、対象のレコードタイプやユーザー属性のAPI名を正確にコピーし、小文字・大文字の区別に注意してください。また、条件式を複数回テストし、期待通りに動作するか確認します。

管理者に確認すべき情報と準備

問題の切り分けを迅速に進めるためには、事前に関連情報を整理しておくことが重要です。以下の情報を管理者(または自分自身)が準備しておくと、原因特定がスムーズになります。

  • 問題が発生しているユーザーのプロファイル名、割り当てられている権限セットの一覧
  • 対象Service Consoleアプリケーションの設定(選択可能タブ、デフォルトタブのリスト)
  • 該当タブが関連するオブジェクトのレコードタイプ一覧と、動的フォームの条件式のスクリーンショット
  • 問題が再現するユーザーと再現しないユーザーの違い(プロファイル、権限セット、レコードタイプなど)
  • 最近実施した設定変更の履歴(変更日時、変更者、変更内容)

よくある質問(FAQ)

  • Q: タブは表示されるが、クリックしても内容が表示されない。なぜですか?
    A: タブそのものの表示設定は正しくても、そのタブ内のコンポーネント(例えばVisualforceページやLightningコンポーネント)が表示されない場合があります。その場合はコンポーネントの権限やアクセス設定を確認してください。
  • Q: 特定のユーザーのみタブが表示されない。原因は?
    A: ユーザーのプロファイルや権限セットのタブ表示権限、またはユーザーアカウントのライセンスタイプ(例えば、Service Cloudライセンスが必要な機能など)が原因の可能性があります。対象ユーザーと正常なユーザーの設定を比較してください。
  • Q: Sandboxでは正しく動作するのに、本番環境では動作しない。何を確認すべき?
    A: Sandboxと本番環境で設定の差分がないか確認します。特に権限セットの割り当てや、カスタムメタデータの値が異なることが多いです。また、本番環境のデータ(レコードタイプ、ユーザー属性)がSandboxと異なる場合もあります。差分チェックツール(Salesforce CLIのComparisonなど)を活用すると効率的です。
  • Q: タブが「デフォルトで表示」設定なのに、最初から開いていない。なぜ?
    A: Service Consoleの「初期タブ」設定で、別のタブが最初に開くように指定されている可能性があります。アプリケーション定義の「デフォルトのタブ」は、ユーザーがタブを追加できる候補の一覧であり、最初に開くタブではありません。最初に開くタブは、コンソールナビゲーションやアプリケーション設定の「初期のタブ」で制御されます。

まとめ

Service Consoleのタブ表示問題は、アプリケーション定義、プロファイル・権限セット、動的フォーム、コンソールナビゲーションの4つの設定が複雑に絡むことで発生します。本番反映前に、本記事で紹介した5つの手順をSandbox環境で実施し、問題を事前に摘出することが重要です。また、よくある失敗パターンを理解しておけば、原因特定が格段に早くなります。管理者と協力して設定差分を確認し、影響範囲を十分に検証した上で本番環境にリリースしてください。


この記事の監修者
✍️

超解決 第一編集部

疑問解決ポータル「超解決」の編集チーム。正確な検証と、現場視点での伝わりやすい解説を心がけています。