ナビゲート

概要

Navigate(ナビゲート)インタラクションを使用すると、Dynamic Component 内のボタン、リンク、テーブル行などのインタラクティブ要素がクリックされたときに、ユーザをどこへ移動させるかを制御できます。ユーザを次の場所に送ることができます:

  • Salesforce 内の他のページ

  • 特定のレコードまたはオブジェクト

  • 外部のウェブサイト

  • カスタム Lightning コンポーネント

重要: Navigate インタラクションはデプロイされた Lightning ページでのみ機能します。プレビューモードでは動作しません。


ページ参照タイプの理解

Navigate インタラクションを追加するとき、最初に選択するのは ページ参照タイプです。これにより、Salesforce にどの種類の宛先へ移動するかを伝えます。

利用可能なタイプ:

以下のセクションでは、各ページ参照タイプの設定方法を詳述します。


タイプ別設定ガイド

レコードページ(最も一般的)

これを使用して: 特定のレコードの詳細ページ、編集ページ、または複製ページを開きます。

例のシナリオ

  • ボタンをクリックして取引先レコードを表示する

  • テーブル行をクリックして取引先担当者を編集する

  • カスタムアクションから商談を複製する

設定

  1. ページ参照タイプ: レコードページ

  2. オブジェクト API 名: 開くレコードのオブジェクトタイプ

    • 例: Account(取引先), Contact(取引先担当者), Opportunity(商談), My_Custom_Object__c

  3. レコード ID: レコードの ID をどこから取得するか

    • テーブル行から: 使用する @TableName.firstSelectedRow.Id

    • 現在のレコードから: 使用する @recordId

    • 変数から: ID を含む変数を選択してください

  4. アクション名: どのページを開くか

    • view - 詳細ページ(デフォルト)

    • edit - 編集ページ

    • clone - 複製/クローンページ

例: ボタンをクリックして取引先を表示するようにナビゲート

  • オブジェクト API 名: Account(取引先)

  • レコード ID: @AccountsTable.firstSelectedRow.Id

  • アクション名: view

チュートリアルを見る


オブジェクトページ

これを使用して: 特定のレコードではなくオブジェクトレベルのページに移動します。

例のシナリオ

  • ボタンをクリックして新しい取引先を作成する

  • ケースのホームページを開く

  • すべての商談を表示する

設定

  1. ページ参照タイプ: オブジェクトページ

  2. オブジェクト API 名: 移動先のオブジェクト

    • 例: Account(取引先), Case(ケース), Opportunity(商談)

  3. アクション名: どのページを開くか

    • home - オブジェクトのホームページ(通常はデフォルトのリストビューを表示)

    • list - 特定のリストビュー(追加の設定が必要な場合があります)

    • new - 新規レコード作成ページ

例: 新しい取引先担当者を作成する

  • オブジェクト API 名: Contact(取引先担当者)

  • アクション名: new

ヒント: を使用する場合、 new新規レコードフォームのフィールドを事前入力できます。以下の「自動的に入力されるフィールド」を参照してください。


ウェブページ

固定の URL を指定するか、URL を含むフィールドを動的に参照することでウェブサイトへナビゲートできます。

設定

  • ページ参照タイプ: ウェブページ

  • URL: 選択肢は 2 つあります:

    • 静的 URL: ウェブサイトの完全な URL を直接入力します(例: https://www.example.com)。これにより常に同じウェブサイトに移動します。

    • 動的 URL(フィールドから): コンポーネントのコンテキストから URL を含むフィールドを選択します。この式フィールドは通常、他のデータに基づいて URL を構築します。例えば、取引先オブジェクトに取引先のウェブサイトへの URL を生成する式フィールドがある場合、その式フィールドをここで選択できます。これにより、表示中または選択中のレコードに基づいて宛先 URL を動的に変更できます。

ウェブページナビゲーションのトラブルシューティング

問題: Web Page インタラクションを持つボタンをクリックしても何も起こらない、またはナビゲーションが動作しない。

考えられる原因と解決策:

  1. プレビューモードの制限

    • ⚠️ インタラクションはプレビューモードでは動作しません

    • ナビゲーションインタラクションをテストするには、Dynamic Component を Lightning ページにデプロイして実際の Salesforce 環境で表示する必要があります

    • プレビューモードは視覚的なレイアウト確認のみを目的としており、機能テストには向いていません

  2. 無効または空の URL

    • URL が正しくフォーマットされており、プロトコルが含まれていることを確認してください(例: https://)

    • 動的 URL フィールドを使用している場合、そのフィールドが実際に有効な URL 値を含んでいるかを確認してください

    • ブラウザで直接 URL をテストしてアクセス可能であることを確認してください

    • ブラウザの開発者ツール(F12)のコンソールを使用して JavaScript エラーを確認してください

  3. プロトコルの欠如(http:// または https://)

    • URL には完全なプロトコルを含める必要があります: https://www.example.com (正しい例)

    • www.example.com のみでは動作しません(誤り)

    • 動的フィールドを使用している場合は、フィールド値にプロトコルが含まれていることを確認してください

  4. Salesforce のセキュリティ制限

    • 外部 URL は組織の信頼済みサイトに追加する必要がある場合があります

    • 設定 → CSP Trusted Sites に移動してドメインを追加してください

    • 一部の組織では厳格なコンテンツセキュリティポリシーにより外部ナビゲーションがブロックされることがあります

  5. ポップアップブロッカー

    • ナビゲーションが新しいタブ/ウィンドウで開く場合、ブラウザのポップアップブロッカーがそれを防ぐことがあります

    • ブラウザ設定を確認し、Salesforce ドメインのポップアップを許可してください

    • 同じタブで開くナビゲーションを使用することを検討してください

  6. 動的 URL フィールドの問題

    • フィールド参照が正しく、正しいオブジェクト/レコードを指していることを確認してください

    • フィールドにデータがあるか(null または空ではないか)を確認してください

    • 式フィールドの場合、式が正しく URL を構築していることを確認してください

    • フィールド値を独立してテストし、有効な URL を含んでいることを確認してください

  7. インタラクションが正しく設定されていない

    • インタラクションが実際にコンポーネントに追加されているか確認してください(Interactions パネルを確認)

    • 正しいイベントトリガーが選択されていることを確認してください(例:ボタンの場合は「クリック時」)

    • Navigate アクションがインタラクション内で正しく設定されているか確認してください

  8. コンポーネントのコンテキストの問題

    • 選択された行やレコードからの動的 URL を使用している場合は、実際にレコードが選択されていることを確認してください

    • データテーブルコンポーネントを使用している場合、行選択が有効で機能していることを確認してください

    • コンテキスト変数(例: @AccountsTable.firstSelectedRow.Website__c)に値があることを確認してください。


アプリ

これを使用して Lightning アプリに移動します。

  • 設定:

    • ページ参照タイプ: アプリ

    • アプリターゲット: 次のいずれかを入力してください: どちらか:

      • 次の アプリ ID (例: 06mRM0000008dNrYAI)。アプリを Setup > App Manager で編集しているときの URL に App ID が表示されます。URL は次のようになります: /lightning/app/06mRM0000008dNrYAI.

      • 次の アプリ開発者名 (例: standard__LightningSales)。これはアプリの API 名です。

    • サンプル URL(参考情報のみ — これらの URL を入力する必要はありません): これらの URL を入力

      • アプリのホームページへ(App ID を使用): /lightning/app/06mRM0000008dNrYAI

      • アプリ内のオブジェクトホームへ(App ID を使用): /lightning/app/06mRM0000008dNrYAI/o/Case/home

      • アプリのホームページへ(開発者名を使用): /lightning/app/standard__LightningSales

      • アプリ内のオブジェクトホームへ(開発者名を使用): /lightning/app/standard__LightningSales/o/Case/home


ナレッジ記事

これを使用して特定のナレッジ記事に移動します。

  • 設定:

    • ページ参照タイプ: ナレッジ記事

    • 記事タイプ: ナレッジ記事タイプの API 名を入力してください(例: Knowledge__kav).

    • URL 名: リンクしたい特定の記事の URL 名を入力してください。

    重要な注意事項: Experience Builder サイトでは、 記事タイプ は無視され、 URL 名 のみが使用されます。


Lightning コンポーネント

これを使用して: カスタム Lightning Web Component(LWC)または Aura コンポーネントに移動します。

設定

  1. ページ参照タイプ: Lightning コンポーネント

  2. コンポーネント名: コンポーネントの API 名

    • フォーマット: namespace__componentName

    • デフォルトネームスペース: c__myComponent

    • マネージドパッケージ: myNamespace__myComponent


ログインページ(Experience Builder サイト)

これを使用して: Experience Builder サイトのログインまたはログアウトページに移動します。

設定

  1. ページ参照タイプ: ログインページ

  2. アクション名:

    • login - ログインページへ移動

    • logout - ユーザをログアウトさせる


標準の名前付きページ

これを使用して: 標準の Salesforce ページに移動します。

設定

  1. ページ参照タイプ: 標準の名前付きページ

  2. ページ名: 以下から選択:

    • home - Salesforce ホームページ

    • chatter - Chatter フィード

    • today - 今日のカレンダー表示

    • dataAssessment - データ評価ページ

    • filePreview - ファイルプレビュー ページ


ナビゲーションアイテムページ

これを使用して: カスタムタブに関連付けられたページに移動します。

設定

  1. ページ参照タイプ: ナビゲーションアイテムページ

  2. タブ API 名: カスタムタブの API 名

    • 例: My_Custom_Tab__c


新しいレコード作成時に自動的に入力されるフィールド

(オブジェクトページでアクションが newのときに)新しいレコードを作成する際、フォームのフィールドを事前入力できます。

使用例

現在の取引先に自動的に紐づく新しい取引先担当者を作成する。

仕組み

  • Navigate インタラクションでフィールドマッピングを設定する

  • 新規レコードフォームがそのフィールドで既に入力された状態で開く

  • ユーザは保存前に値を変更できます

取引先ページから取引先担当者を作成する際に取引先フィールドを事前入力する

  • オブジェクトページへナビゲート: Contact(取引先担当者)

  • アクション: new

  • フィールドマッピングを追加: AccountId = @Record: Id


チュートリアル

オブジェクトページへナビゲートするインタラクションを作成する方法

レコードページへナビゲートするインタラクションを作成する方法

最終更新

役に立ちましたか?