【Salesforce】Lightningアプリのナビゲーションで困った時の本番反映前の切り分け

Salesforce Lightningアプリを導入している企業では、ナビゲーションに表示されるタブやリンクが正しく動作しないというトラブルが頻繁に発生します。特に本番環境に反映する前に問題を発見し、原因を切り分けることが重要です。本記事では、Lightningアプリのナビゲーションに関する一般的な症状から、ユーザー権限、プロファイル、アプリケーション設定、レコードタイプなど、多角的な切り分け手順を解説します。実際の運用で遭遇しやすい失敗パターンや、管理者に伝えるべき情報も含めていますので、開発者や運用担当者の方はぜひご活用ください。

ナビゲーション問題の代表的な症状と原因

Lightningアプリでよく見られるナビゲーションの不具合には、以下のようなものがあります。

• アプリのタブがまったく表示されない、または一部しか表示されない。
• 特定のタブをクリックするとエラーページに遷移する、または真っ白な画面になる。
• カスタムアプリを開くと、標準のナビゲーションバーではなく古いUIが表示される。
• ユーザーごとに表示されるタブが異なり、想定と合わない。

これらの原因は主に、プロファイルや権限セットによるタブの表示権限、アプリケーション定義におけるタブの割り当て、レコードタイプの設定、ユーザーライセンスの種類に起因します。また、Salesforceのセッション設定やリダイレクトルール、外部システムとの連携が影響するケースもあります。

切り分けの基本手順

問題を解決するには、以下の手順で段階的に原因を特定します。すべての手順はSandbox環境でテストしてから本番適用してください。

1. ユーザーのプロファイルを確認する。 該当ユーザーのプロファイルに、表示されるべきタブの権限が設定されているか確認します。設定メニューから「プロファイル」を開き、タブの表示設定(標準タブ、カスタムタブ)をチェックします。
2. 権限セットの割り当てを確認する。 プロファイルに権限がなくても、権限セットでタブの表示権限を追加している場合があります。ユーザーに割り当てられている権限セットを一覧し、不足しているタブの権限が付与されているか確認します。
3. アプリケーション定義を確認する。 該当のアプリが「アプリケーション」設定でどのタブを含んでいるか確認します。アプリに割り当てるタブは、アプリ定義の「選択されたタブ」で指定します。ここに目的のタブが含まれていないと表示されません。
4. レコードタイプの影響を確認する。 特定のオブジェクトのレコードタイプにより、表示されるタブが制限されることがあります。レコードタイプの「タブの表示」設定で、ユーザーがアクセスできるレコードタイプが適切か確認します。
5. 公開グループやロール階層を確認する。 一部のタブは、共有設定やロール階層によって表示が制御される場合があります。特にカスタムタブやビジュアルフォースページを含むタブは、アクセス権が正しいか確認します。
6. ブラウザキャッシュとSalesforceセッションをリセットする。 設定変更後も即時に反映されない場合、ユーザー側でブラウザのキャッシュを削除し、ログインし直します。また、Salesforce側で「すべてのキャッシュをクリア」を実行することも効果的です。

設定箇所の比較表

ナビゲーションに影響する主要な設定項目を以下の表にまとめました。

設定項目	管理者権限	影響範囲	確認方法
プロファイルのタブ設定	システム管理者	プロファイルに割り当てられた全ユーザー	設定 > プロファイル > [プロファイル名] > タブの表示
権限セットのタブ権限	システム管理者	権限セットが割り当てられたユーザー	設定 > 権限セット > [権限セット名] > システム管理者権限(タブの表示)
アプリケーションのタブ割り当て	システム管理者	アプリを使用する全ユーザー	設定 > アプリケーション > [アプリ名] > 選択されたタブ
レコードタイプのタブ表示	システム管理者またはオブジェクト管理者	特定のレコードタイプにアクセスするユーザー	設定 > オブジェクト > [オブジェクト名] > レコードタイプ > [レコードタイプ名] > タブの表示
ユーザーライセンス	システム管理者	ライセンスごとに利用可能な機能が制限	設定 > ユーザー > [ユーザー名] > ライセンス

失敗パターンと対策

権限設定の誤り

最も多いのは、プロファイルまたは権限セットで「表示なし」や「デフォルト表示」に設定されているタブが、ユーザーに表示されないというケースです。対策としては、該当タブの表示設定を「表示」または「デフォルト表示」に変更します。また、権限セットが競合している場合は、権限セットの優先順位や上書きルールを確認してください。

アプリにタブが追加されていない

アプリケーション定義で、表示したいタブが「選択されたタブ」に含まれていないと、権限があってもナビゲーションに現れません。アプリ編集画面でタブを追加し、保存後にユーザーに再ログインを促します。

レコードタイプの制限

特定のレコードタイプのみアクセスできるユーザーが、そのレコードタイプに関連しないタブを開こうとするとエラーになる場合があります。レコードタイプの「タブの表示」設定で、タブの表示を「表示」にし、該当レコードタイプにアクセスできるようにします。

共有設定や組織のデフォルト

カスタムタブや外部システムと連携したタブでは、共有ルールや組織全体のデフォルトアクセス権が影響することがあります。特に「公開グループ」や「ロール階層」でアクセスが制限されていないか確認します。

管理者に伝えるべき情報

問題の切り分け結果を管理者に報告する際は、以下の情報を整理して伝えるとスムーズです。

• 問題が発生しているユーザー名、および正常なユーザー名(対照用)。
• アプリ名と、表示されないタブの名称。
• エラーが発生する場合のエラーメッセージのスクリーンショット。
• Sandbox環境で再現した場合は、その手順と結果。
• プロファイルや権限セットの設定変更履歴(最近変更したかどうか)。

これらの情報があれば、管理者は設定ミスや権限不足の可能性を素早く特定できます。

よくある質問

Q. ナビゲーション項目が一部しか表示されません。

A. まず、プロファイルと権限セットで該当タブが「表示」になっているか確認してください。次にアプリ定義でタブが選択されているか確認します。レコードタイプによる制限も見逃しがちです。

Q. 本番環境だけで問題が起き、Sandboxでは正常です。

A. Sandboxと本番環境で設定が異なる可能性があります。Sandboxから本番へ設定変更をリリースする際に、権限セットやアプリ定義が正しくデプロイされているか、変更セットまたはパッケージの内容を確認してください。また、本番環境のユーザーデータ(レコードタイプなど)がSandboxと異なることも原因です。

Q. 特定のユーザーだけナビゲーションが見えません。

A. そのユーザーのプロファイルや権限セットを他の正常なユーザーと比較します。また、ユーザーライセンスの種類が異なる場合、利用できない機能がある可能性があります。ユーザーが所属する公開グループやロールの階層も確認しましょう。

Q. カスタムアプリのタブが表示されません。

A. カスタムタブが有効かどうか、またタブの種類(Visualforce、Lightningコンポーネントなど)が正しく設定されているか確認します。Visualforceタブの場合、アクセス権が「すべてのユーザー」になっているか確認してください。

まとめ

Salesforce Lightningアプリのナビゲーション問題は、多くの場合、権限設定やアプリ定義の見落としが原因です。本番反映前にSandboxで手順を実施し、比較表を参照しながら原因を切り分けることで、本番トラブルを未然に防げます。管理者と連携して設定を確認し、必要に応じて変更セットを適用してください。適切な切り分けにより、ユーザーの生産性低下を最小限に抑えることができます。