> For the complete documentation index, see [llms.txt](https://docs.avonnicomponents.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md).

# 移動

コンポーネントとやり取りしたときに、レコード、オブジェクトページ、名前付きページ、外部 URL などのページへユーザーをリダイレクトします。

## 概要

Navigate インタラクションを使用すると、ユーザーがボタンをクリックするなどコンポーネントとやり取りしたときのナビゲーションアクションを定義できます。この機能により、さまざまなページタイプへシームレスにリダイレクトでき、ユーザーのエンゲージメントを高め、サイト全体でスムーズな閲覧体験を実現します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-b76cdd189cdf5f4bc6b29a9931ea057133c580fd%2F2023-11-06_11-26-43.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### **主な機能**

* 複数のページ参照タイプをサポート
* カスタマイズ可能なナビゲーションアクション
* サイトのナビゲーションフローを改善

### ユースケース

* **製品ページ:** 詳細な製品仕様ページにリダイレクトします。
* **サポートページ:** ヘルプ記事またはお問い合わせフォームへ移動します。
* **コミュニティページ:** メンバープロフィールまたはディスカッショントピックにリンクします。
* **イベントページ:** イベント登録フォームへ直接移動します。
* **ランディングページ:** キャンペーン詳細ページへ案内します。
* **プロフィールページ:** 関連する連絡先レコードへ移動します。

## 設定

Experience Cloud サイトページ上のコンポーネント（例: ボタン）に Navigate インタラクションを追加し、プロパティパネルのコンポーネントのインタラクション設定から構成します。Experience Builder には独立した Interactions タブはありません。設定は、設定しているイベントのエディタ内にあります。たとえば、ボタンの **クリック時** またはリスト項目の **リンク先**.

### **利用可能なナビゲーションタイプ**

これらのページ参照タイプは、ユーザーの移動先を指定します。

| ナビゲーションタイプ             | 説明                                  | 使用例                        |
| ---------------------- | ----------------------------------- | -------------------------- |
| **Aura - 外部レコードページ**   | Aura フレームワークを使用して特定のレコードページにリンクします。 | 連絡先の詳細を表示します。              |
| **Aura - 外部レコード関連ページ** | 関連レコード（例: 取引先の連絡先）にリンクします。          | 取引先の商談を表示します。              |
| **Aura - ログインページ**     | ログインまたはログアウトのアクションを実行します。           | 制限付きコンテンツにアクセスするにはログインします。 |
| **ナレッジ記事**             | 特定のナレッジ記事へ移動します。                    | サポート記事にアクセスします。            |
| **管理コンテンツページ**         | CMS で管理されるコンテンツページにリンクします。          | ニュース記事を表示します。              |
| **名前付きページ**            | Experience Builder 内のページにリダイレクトします。 | 「Support」という名前付きページへ移動します。 |
| **オブジェクトページ**          | オブジェクトのリストビューまたは新規レコードページへ移動します。    | 連絡先のリストビューを開きます。           |
| **レコードページ**            | 特定レコードの詳細ページにリンクします。                | 取引先レコードを表示します。             |
| **レコード関連ページ**          | 関連リスト（例: 連絡先の商談）へ移動します。             | 取引先のケースを表示します。             |
| **Web ページ**            | 外部または内部の Web ページへリダイレクトします。         | パートナーサイトにリンクします。           |

*<mark style="background-color:green;">**ベストプラクティス**</mark>:* 対象に応じてタイプを選択します（例: レコードには Record Page）。プレビューでナビゲーションをテストしてください。

**特定ページへのナビゲーションを設定する**

特定のページまたはリソースへのナビゲーションを設定するには、ユースケースに応じて次の手順に従ってください。

### **名前付きページへ移動する**

1. Button コンポーネントを追加し、その **クリック時** 設定を開きます。
2. 選択して **移動** を選択し **名前付きページ**.
3. **ページ名:** ターゲットページの API 名を入力します（例: Content\_Document\_\_c）。
4. *なぜこれを使うのですか?* Experience Builder で定義された内部ページ（例: コンテンツドキュメントページ）へユーザーを移動します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-e9561697b8d10bf218981515183b03208b8db1c6%2F2025-09-05_15-36-22.png?alt=media" alt=""><figcaption></figcaption></figure>

### **レコードページへ移動する**

Experience Cloud サイトで、ボタンまたはコンポーネントに特定レコードの詳細ページを開かせたい場合にこのオプションを使用します

#### 設定手順

1. 選択して **移動** を選択し **レコードページ**.
2. **オブジェクト API 名:** オブジェクトを入力します（例: Contact）。
3. **レコード ID:** リダイレクト用の正しいレコード ID フィールドを選択します。通常は「**`レコード: Id`**」です。
4. **アクション名:** View に設定します（詳細表示の既定値）。

*なぜこれを使うのですか?* 特定のレコード（例: 連絡先レコード）の詳細ページへユーザーを移動します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-c4d70da683e39ea1bb32268b0779996cd6128cbc%2F2025-09-05_15-41-52.png?alt=media" alt="" width="304"><figcaption></figcaption></figure>

{% hint style="warning" %}

#### 重要

レコードページへのナビゲーションが正しく動作するように、まず Navigate インタラクションの遷移先となる Experience サイト上に Object Page を作成してください。このページが存在しない場合、Navigate to Record Page インタラクションは機能しません。
{% endhint %}

### **外部 Web ページへ移動する**

ボタンまたはコンポーネントに外部サイトや別の Web リソース（メインサイト、パートナーポータル、ドキュメントページなど）を開かせたい場合にこのオプションを使用します

#### 設定手順

1. インタラクションを選択し、 **移動** を選択 **Web ページ** オプションを選択します。
2. **ターゲット URL:** 次のいずれかを選択できます:
   * フィールド（例: URL を保存するレコード上の数式フィールド）を選択して、リダイレクト先を動的に設定します。
   * または、 **カスタム** を選び、外部 URL（例: <https://www.example.com）を手動で入力します。>
3. **なぜこれを使うのですか?** このオプションはユーザーを外部 Web サイトまたはリソースへリダイレクトし、サイトの接続性を高めます。
4. **トラブルシューティング:** ナビゲーションが機能しない場合は、URL または選択したフィールド値が有効であることを確認し、ユーザーにターゲットサイトへアクセスするために必要な権限があることを確認してください。

### **名前付きページへの Navigate で URL パラメータを渡す**

この機能を使用すると、動的データ（例: レコード ID）をターゲットページに送信し、ユーザーの状況に応じて内容をカスタマイズできます。新しいページで特定のレコード詳細を表示するなど、パーソナライズされた体験の作成に最適です。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-ae4dd3b64c530bed1bab9f5cfa5a581985f4c167%2F2024-10-17_15-22-41.png?alt=media" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### **ターゲットページを設定する**

ターゲットページ（例: CustomerDetails）に Avonni Record Detail のようなコンポーネントを追加します。「Record ID」属性では、式 {!Route.recordId} を使用して recordId という名前の URL パラメータを取得します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-67906ac9c31e38326caa838ca3563a069cd78933%2F2024-10-17_15-21-19.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### **ボタンを設定する**

ソースページ（例: ホームページ）で Avonni Button を追加します。 **移動** 設定で、 **名前付きページ** を選び、API 名（例: CustomerDetails）を入力します。
{% endstep %}

{% step %}

#### **パラメータを追加する**

* **名前:** recordId を入力します（ターゲットコンポーネントの属性と一致させます）。
* **値:** フィールド（例: {!Record.Id}）を選択するか、渡したい特定のレコード ID を入力します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-eed5b139b882ece8e987c1489203359113df215d%2Fimage%20-%202025-09-05T160337.867.avif?alt=media" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
*これが便利な理由*

この機能を使用すると、動的データ（例: レコード ID）をターゲットページに送信し、その内容をカスタマイズできます。たとえば、ホームページのボタンをクリックすると、渡された recordId に基づいて特定の連絡先情報を表示する CustomerDetails ページへユーザーを移動できます。
{% endstep %}

{% step %}
*たとえれば*

手紙の宛名を書くようなものだと考えてください。Navigate to Named Page は封筒、URL パラメータ（例: recordId）は住所であり、システムに行き先と取得するデータを伝えます
{% endstep %}

{% step %}
*トラブルシューティング*

ターゲットページが正しく読み込まれない場合は、recordId パラメータがターゲットコンポーネントの属性と一致していること、また ID が有効であることを確認してください。
{% endstep %}
{% endstepper %}

### **ナレッジ記事へ移動する**

1. 選択して **移動** を選択し **ナレッジ記事**.
2. **URL 名:** 式を入力します `{{Record.UrlName}}` を使って、現在のレコードに関連付けられたナレッジ記事へ動的にリンクします。
3. *なぜこれを使うのですか?* 次に基づいて、ユーザーを特定のナレッジ記事ページへ移動します `UrlName` 現在のレコードのフィールドにより、サポートコンテンツへのアクセスを簡素化します。
4. *ヒント:* その `{{Record.UrlName}}` この式は LWR 構文を使用してナレッジ記事の一意の URL 名（例: 関連レコードから）を取得します。レコードに有効な `UrlName` フィールドが入力されていることを確認してください。
5. *トラブルシューティング:* ナビゲーションに失敗する場合は、 `UrlName` フィールドが存在し、有効なナレッジ記事の URL セグメント（例: article-title）を含んでいることを確認してください。記事にアクセスするユーザー権限も確認してください。

***

## 例

### **例 1: サポートページへ移動**

この例では、Experience Cloud サイトのサポートページへ移動するボタンを追加します。

1. **ボタンを設定:**
   * **ラベル:** 「Get Support」
   * **アイコン名:** utility:help
   * **バリアント:** neutral
   * *なぜこれを使うのですか?* ユーザー支援用のヘルプボタンを作成します。
2. **Link To インタラクションを設定:**
   * **Navigate:**
     * **タイプ:** 名前付きページ
     * **ページ名:** Customer\_Support\_\_c
     * *なぜこれを使うのですか?* Experience Builder で定義された CustomerSupport ページへリダイレクトします。

**結果:** ユーザーはどのページでもボタンをクリックし、サポートページへ移動します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-d0e9c60e20d1a81967af5bdb9e08d6e8111f716d%2F2025-09-05_15-49-24.png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

***

## トラブルシューティング

* **ナビゲーションが機能しない:** 選択したタイプとターゲット（例: 正しいページ名またはレコード ID）を確認し、権限を検証します。
* **ページが見つかりません:** 名前付きページまたはオブジェクトが Experience Builder に存在することを確認してください。
* **動的 ID が失敗する:** レコード ID のソース（例: {!Record.Id}）が有効であることを確認してください。
* **問題が解決しない場合:** サポートチームまでご連絡ください: <support@avonni.com> までお問い合わせください。

***

## 重要な考慮事項

* **ターゲットの正確性:** ページ名または ID が完全に一致していることを確認してください。
* **パフォーマンス:** ナビゲーション先は軽量に保ってください。
* **アクセシビリティ:** ボタンのフォーカスとコントラストをテストしてください。
* **セキュリティ:** 問題を防ぐために外部 URL を検証してください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/interactions/navigate.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
