【Salesforce】関連リストのクイックリンクが想定と違う時の本番反映前の切り分け

Salesforceの関連リストに表示されるクイックリンク(「新規」「編集」「削除」など)が、想定した表示にならなかったり、リンクが機能しなかったりするケースに遭遇することがあります。例えば、あるユーザには表示されるが別のユーザには表示されない、あるいはリンク先のページがエラーになるといった現象です。本番環境に反映してから問題に気づくと、既存のユーザーに影響を与える可能性があるため、事前にサンドボックスなどで十分に切り分けを行い、原因を特定しておくことが重要です。この記事では、関連リストのクイックリンクが想定と違う場合に、本番反映前に実施すべき切り分け手順を具体的に解説します。

1. クイックリンクの表示が想定と異なる原因

関連リストのクイックリンクが期待通りに動作しない主な原因として、以下の点が考えられます。

• カスタムボタンによる上書き: 標準のクイックリンクをカスタムボタンで置き換えている場合、カスタムボタンの設定(表示条件、動作)によってはリンクが表示されなかったり、異なる動作をしたりします。
• 関連リストのプロパティ設定: 関連リストの「表示項目」で設定する「クイックリンク」の表示条件が、「条件を満たす場合のみ表示」などになっていると、特定の状況でのみリンクが表示されます。
• プロファイルまたは権限セットの不足: ユーザにオブジェクトに対する「参照」「作成」「編集」権限がない場合、該当するクイックリンクは表示されません。
• ページレイアウトの割り当て違い: 同じプロファイルでも、レコードタイプやページレイアウトの割り当てによって関連リストの設定が異なる場合があります。
• Lightning Experienceとクラシックの違い: どちらのインターフェースで表示しているかによって、クイックリンクの動作が変わることがあります。

1.1 カスタムボタンの影響を確認する

カスタムボタンは、標準のクイックリンクを完全に置き換えるか、追加で表示されるかを設定できます。関連リストに表示されるクイックリンクが想定と違う場合、まずはその関連オブジェクトに設定されているカスタムボタンを確認してください。設定 > オブジェクトマネージャ > 該当オブジェクト > ボタン、リンク、およびアクション で一覧を確認できます。カスタムボタンが存在する場合、そのボタンの「表示の種類」が「関連リストの詳細」になっているか、また「上書き設定」が適切かどうかを確認します。

2. 切り分けのための確認手順

本番反映前に、以下の手順で原因を特定していきます。サンドボックス環境で実施することを推奨します。

1. サンドボックスに最新の本番データをコピーする: 可能であれば、サンドボックスを最新の本番データでリフレッシュし、同様の現象が再現するか確認します。リフレッシュが難しい場合は、該当ユーザの権限や設定を手動で再現します。
2. 問題のユーザと同じプロファイル、権限セットを持つテストユーザを作成する: 実際のユーザと同じ権限でログインし、関連リストを確認します。これにより、権限が原因かどうかを切り分けます。
3. 関連リストのプロパティを確認する: ページレイアウトを開き、該当の関連リストの歯車アイコンから「プロパティの編集」を選択します。「ボタンの表示」セクションで、どのボタンが表示するように設定されているか、また「条件に応じてボタンを表示」がオンになっていないかを確認します。
4. カスタムボタンの設定を確認する: 上記1.1の手順で、上書き設定や表示条件を確認します。複数のカスタムボタンがある場合は、順序も確認します。
5. Lightning Experienceとクラシックで挙動を比較する: 同じユーザで両方のインターフェースで関連リストを開き、クイックリンクの表示が異なるかどうかを確認します。もし異なる場合、Lightning Experienceの特定の設定(例:アクションバー)が影響している可能性があります。
6. 詳細ログまたは権限セットの差分を確認する: システム監査ログや、権限セットの比較ツールを使って、問題が発生しているユーザと正常なユーザの間で、設定の差分がないかを確認します。

3. 設定ごとの影響と比較表

原因を特定するためには、各設定がどのようにクイックリンクに影響するかを理解しておく必要があります。以下の比較表で主要なポイントをまとめました。

設定項目	クイックリンクへの影響	確認場所
カスタムボタン(上書き設定)	標準リンクを非表示にし、カスタムボタンに置き換える	オブジェクトマネージャ > ボタン、リンク、およびアクション
関連リストプロパティ(ボタンの表示)	特定のボタンの表示/非表示、条件付き表示	ページレイアウト > 関連リストの編集アイコン
プロファイル/権限セット(オブジェクト権限)	「作成」権限がないと「新規」リンクが表示されない	設定 > プロファイル(権限セット) > オブジェクト設定
ページレイアウトの割り当て	異なるレイアウトで関連リスト設定が異なる場合、表示が変わる	設定 > オブジェクトマネージャ > ページレイアウト > 割り当て
Lightning Experienceのアクション設定	アクションバーがクイックリンクを上書きすることがある	設定 > アクション > グローバルアクション(またはオブジェクト固有)

4. よくある失敗パターン

実際の現場でよく見られる失敗例をいくつか紹介します。

• カスタムボタンの上書き設定が「すべてのユーザ」になっていない: カスタムボタンを作成したものの、上書き設定が「管理者のみ」や特定のプロファイルに制限されていると、一般ユーザには標準のクイックリンクが表示されず、かつカスタムボタンも表示されないため、リンクが消えてしまいます。
• ページレイアウトの関連リストで「条件に応じてボタンを表示」を誤って設定: 例えば「レコードの所有者が現在のユーザの場合のみ編集ボタンを表示」に設定していると、所有者でないユーザには編集リンクが表示されません。
• サンドボックスで確認したが本番で違う: サンドボックスに本番のデータが完全に反映されていない、またはサンドボックスと本番で権限セットやカスタムボタンのバージョンが異なる場合、切り分けが不十分になります。
• プロファイル権限の過不足: オブジェクト権限は正しく設定していても、子オブジェクトのレコードを関連リストから作成する場合、親オブジェクトに対する「編集」権限が必要なケースがあります。この条件を忘れがちです。

5. 管理者に伝えるべき情報と対応依頼

問題の原因が特定できない場合、または管理者権限が必要な設定変更が必要な場合、管理者に以下の情報を伝えるとスムーズです。

• 問題のユーザIDまたはユーザ名: 実際に影響を受けているユーザを特定できる情報。
• 発生している関連オブジェクト名と親レコード: どのオブジェクト(例:取引先責任者)の関連リストで、どの親レコード(例:特定の取引先)で発生しているか。
• 期待する動作と実際の動作: 「このリンクが表示されるべきだが、表示されない」「リンクをクリックするとエラーになる」など、具体的な症状。
• サンドボックスでの再現状況: サンドボックスで同じ現象が再現したかどうか、再現した場合はその環境情報。
• すでに確認した設定のスコープ: 権限、ページレイアウト、カスタムボタンなどを自分で確認した結果を伝えると、管理者の負担が減ります。

対応依頼としては、「該当ユーザの権限セットの割り当て再確認」「カスタムボタンの上書き設定の変更」「ページレイアウトの修正」などを具体的に依頼します。

6. よくある質問(Q&A)

Q1: 関連リストに「新規」ボタンが表示されないのですが、権限は持っています。

A: 権限があっても、カスタムボタンによって標準の「新規」リンクが非表示にされている可能性があります。カスタムボタンの「上書き設定」を確認してください。また、親オブジェクトのレコードに対する「編集」権限が必要な場合もあるので、併せて確認します。

Q2: サンドボックスでは問題ないのに、本番でだけクイックリンクが違います。

A: サンドボックスと本番の設定が完全に一致しているか確認してください。特に、権限セットの割り当て、プロファイルのフィールドレベルセキュリティ、カスタムボタンのバージョンなどに差分がないかをチェックします。サンドボックスを本番の最新データでリフレッシュし、再度検証することをお勧めします。

Q3: 特定のレコードタイプでのみクイックリンクが表示されません。

A: レコードタイプごとに異なるページレイアウトが割り当てられていないか確認します。ページレイアウトの関連リスト設定がレコードタイプによって異なる場合、該当のページレイアウトでクイックリンクが非表示になっている可能性があります。

7. まとめ

関連リストのクイックリンクが想定と違う場合、本番反映前に原因を切り分けることで、ユーザへの影響を最小限に抑えられます。主な確認ポイントは、カスタムボタンの上書き設定、関連リストプロパティの表示条件、ユーザの権限、そしてページレイアウトの割り当てです。サンドボックス環境で十分に検証し、問題の再現手順を記録しておくことで、管理者への報告もスムーズになります。ぜひこの記事の手順を参考に、トラブルシューティングに役立ててください。