> 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/hajimeni/quick-start-guide.md).

# クイックスタートガイド

Avonni のインストーラー一覧テーブルと設置場所の地図付きで、Experience Cloud ポータル向けの「認定インストーラーを探す」ページを15分で作成します。

Experience Builder はサイトの枠組み、つまりテーマ、ナビゲーション、ページを提供します。Avonni Experience Components は、Salesforce レコードを読み取り、ページ上で互いに連携する 40 以上のコンポーネント（テーブル、地図、カレンダー、ギャラリー、タイムライン、メトリクスなど）でそれを埋め、プロパティパネルで設定でき、コードは不要です。

次の15分で、あなたは **認定インストーラーを検索する** 顧客ポータル用のページを作成します。つまり、Accounts から読み取ったインストーラーの表と、選択したインストーラーがすでに設置した住宅を表示する地図です。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FuklRngJNF6vNUgKIyWbF%2Fxp-quickstart-hero.png?alt=media" alt="The SolarOps customer portal with its logo and navigation, showing a Find a certified installer page: a Certified installers table with Flatirons Sun Co. selected, and beside it the installer&#x27;s name, phone number and a Google map of its installations around Boulder"><figcaption><p>最後にできること: インストーラーを選ぶと、地図にその最近の設置先が表示されます。</p></figcaption></figure>

{% hint style="success" %}
**学習内容**

* Experience Builder で AX コンポーネントを見つけて、ページに1つ配置する方法
* Query データソースを使って、コンポーネントを Salesforce レコードに接続する方法
* あるコンポーネントを、訪問者が別のコンポーネントで選んだ内容に反応させる方法
* サイトのメンバーがページを見る前に必要なもの
  {% endhint %}

{% hint style="warning" %}
**始める前に**

* その [Avonni Experience Components パッケージ](https://appexchange.salesforce.com/appxListingDetail?listingId=2e584bb3-b5e0-415d-9347-d6567158d840) がインストールされています。まず **Lightning Web Security** を有効にし、 **設定** > **セッション設定**で、これがないとインストールは `LWC1503: Dynamic imports are not allowed`.
* Aura サイトでは、さらに **Lightning Web Security** サイトの **設定** > **セキュリティとプライバシー**.
* 作業するサイトと、表示するいくつかのレコードがあります。このガイドでは、タイプが *Installation Partner* である Accounts とその Contacts を使い、各 Contact には設置済み住宅の住所が入っています。
  {% endhint %}

***

## インストーラー検索を作成する

{% stepper %}
{% step %}

#### Experience Builder でページを開く

「 **設定**」で、 **Digital Experiences**を検索し、 **All Sites**を開いて、 **Builder** をサイトの横でクリックします。左上のメニューからページを選び（このガイドでは **Home**を使います）、テーブルと地図を配置する2カラムのセクションを追加します。
{% endstep %}

{% step %}

#### AX コンポーネントを見つける

左側のサイドバーにある **コンポーネント** アイコン（稲妻）をクリックして、検索ボックスに `AX` と入力します。すべての Avonni コンポーネントは **カスタムコンポーネント**の下に一覧表示され、各項目の先頭に **AX -** プレフィックスが付いています。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F9s2CYQmXVNWFRacjGtfF%2Fxp-quickstart-components.png?alt=media" alt="The Components panel of Experience Builder, searched for AX, with Custom Components (46) listing AX - Accordion, AX - Alert, AX - Avatar, AX - Banner, AX - Button and more" width="560"><figcaption><p>AX でフィルタされたコンポーネントパネル。</p></figcaption></figure>

{% hint style="info" %}
Screen Flow のコンポーネントは **Avonni** *Component*と呼ばれ、Experience 用のものは **AX -** *Component*です。どちらのパッケージも同じ org に共存できます。
{% endhint %}
{% endstep %}

{% step %}

#### AX - Data Table を配置して

ドラッグし、 **AX - Data Table** を左カラムへドラッグします。右側にプロパティパネルが開きます。このページでは2つの設定が重要です:

* **API 名**: `installers`。これは、訪問者が選んだ行を他のコンポーネントが読み取るために使う名前です。
* **最大行選択数**: `1`、これにより訪問者は一度に1つのインストーラーだけを選べます。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FMdH77yw3FRoQZ0jkhHQy%2Fxp-quickstart-table-settings.png?alt=media" alt="The AX - Data Table selected on the canvas, and its property panel with API Name set to installers and Max Row Selection set to 1"><figcaption><p>テーブルのプロパティパネル: API 名と最大行選択数。</p></figcaption></figure>
{% endstep %}

{% step %}

#### Accounts を参照するように設定する

プロパティパネルを **データソース** までスクロールして **Query**.

1. **オブジェクト API 名**: `Account`.
2. **フィルター**: **Account Type** equals `Installation Partner`にし、 **Billing State/Province** equals `CO`.
3. **追加フィールド**: **Account Phone**。これは列ではありませんが、ページには表示されます。
4. の下の **データマッピング**で、 **列を追加** をクリックし、Account Name、Billing City、Account Description を選びます。各列を開いて短いラベルを付けます: Installer、City、Specialty。

テーブルはキャンバス上で、すぐにレコードで埋まります。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FVMyidwqml4muZh284R6o%2Fxp-quickstart-table-query.png?alt=media" alt="The Data Source section of the AX - Data Table with Query selected, Object API Name Account, two filters (Account Type equals Installation Partner, Billing State equals CO) and the table on the canvas listing six Colorado installers"><figcaption><p>Query データソース: オブジェクト、フィルター、そしてキャンバス上のレコード。</p></figcaption></figure>
{% endstep %}

{% step %}

#### テーブルに連動する AX - Map を配置する

ドラッグし、 **AX - Map** を右カラムにドラッグし、その **データソース** を **Query**:

1. **オブジェクト API 名**: `Contact`.
2. **フィルター**: **Account ID** equals `{{installers.selectedRecord.Id}}`.
3. の下の **データマッピング**に設定し、ピンの **Title** を Contact の Title に、位置を **Mailing Latitude** と **Mailing Longitude**.

に設定します。 `installers` そのフィルターがすべての鍵です。 `はテーブルの API 名で、` selectedRecord `は訪問者が選んだ行、そして` はそこから読み取るフィールドです。訪問者が別のインストーラーを選ぶと、地図はコードもページの再読み込みもなしに、もう一度クエリを実行します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FRiatWpqiK5o3Yl9Fb5Np%2Fxp-quickstart-map-query.png?alt=media" alt="The AX - Map selected, with its Data Source set to Query on Contact and a filter Account ID equals {{installers.selectedRecord.Id}}, and its Data Mappings below" width="340"><figcaption><p>テーブルで選択された行でフィルタされた地図のクエリ。</p></figcaption></figure>
{% endstep %}

{% step %}

#### 地図の上にインストーラー名を表示する

を配置し、 **AX - Text Block** を地図の上にドラッグして、同じ構文でテキストを書きます:

```
最近の設置
{{installers.selectedRecord.Name}}
{{installers.selectedRecord.Phone}}
```

テーブルが検索した任意のフィールドはこの方法で読み取れます。追加フィールドとして追加した Phone も含まれます。
{% endstep %}

{% step %}

#### プレビューする

クリック **プレビュー** を右上で。インストーラーを選ぶと、その名前と電話番号が表示され、地図はそのインストーラーが設置した住宅へ移動します。

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FtDbABxjI9E87N8Ee1UPB%2Fxp-quickstart-selected.png?alt=media" alt="The same page with Pikes Peak Power selected in the table, its phone number above the map, and the map showing its installations around Colorado Springs"><figcaption><p>別のインストーラー、別のピンのセット: ページは訪問者の選択に応えます。</p></figcaption></figure>
{% endstep %}

{% step %}

#### 公開してメンバーにアクセス権を付与する

1. クリック **公開**.
2. サイトのメンバーに Avonni ライセンスと権限セットを付与します。場所は [ライセンス管理](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/license-management.md) ページです。
3. プロファイルがレコードを読み取れることを確認してください: ここでは Account と Contact です。Avonni コンポーネントは共有設定に従い、それを迂回しないため、メンバーは Salesforce が許可した行だけを正確に見ることができます。 [基本を学ぶ](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/learning-the-basics.md) に詳細があります。
   {% endstep %}
   {% endstepper %}

***

## 今使ったもの

| アイデア                                | ここでは                                          | これを再利用する場面                                       |
| ----------------------------------- | --------------------------------------------- | ------------------------------------------------ |
| **Experience Builder の AX コンポーネント** | データテーブル、地図、テキストブロック                           | 40以上のコンポーネント: カレンダー、ギャラリー、タイムライン、メトリクス、カンバンなど    |
| **Query データソース**                    | Account からのインストーラー、Contact からの設置情報            | メンバーが読み取れる任意のオブジェクト。フィルターと並び順付き                  |
| **リアクティブなコンポーネント**                  | `{{installers.selectedRecord.Id}}` 地図のフィルター内の | 2つ目のテーブルを駆動するテーブル、テキストブロックを駆動する地図、タイムラインを駆動するリスト |
| **あなたのサイト、あなたのブランド**                | コンポーネントを囲む SolarOps テーマとナビゲーション               | Aura または LWR サイトのすべてのページ                         |

## 何かがおかしく見える場合

| 見えているもの                   | 考えられる原因                                      | 修正方法                                                                                |
| ------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------------- |
| コンポーネントパネルに AX コンポーネントがない | パッケージがインストールされていない、またはサイトのセキュリティレベルがブロックしている | インストールを確認し、その後 **カスタムコンポーネント**                                                      |
| テーブルが空                    | フィルターが一致しないか、閲覧者がそのオブジェクトを読み取れない             | 既知のレコードでフィルターをテストし、プロファイルのアクセス権を確認する                                                |
| 行を選んでも地図が動かない             | フィルター内の API 名がテーブルのものと一致していない                | `installers` の `{{installers.selectedRecord.Id}}` はテーブルのものと完全に一致している必要がある **API 名** |
| 何も選ぶ前に地図に既定の領域が表示される      | まだフィルターする行がクエリにない                            | 想定どおりです。訪問者が行を選ぶとすぐに埋まります                                                           |

まだ詰まっていますか？ [Reactive Components](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/reactive-components.md) では、トラブルシューティングをさらに詳しく説明しています。

## 続ける

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="image">カバー画像</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4>データソース</h4></td><td>Query、CMS Collection、Manual: コンポーネントにデータを供給するすべての方法と、どれを選ぶべきか。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FJKfTje5RpchEizxF30XE%2Fxp-quickstart-cover-query.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FJKfTje5RpchEizxF30XE%2Fxp-quickstart-cover-query.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/puropatipaneru/data-sources.md">データソース</a></td></tr><tr><td><h4>Reactive Components</h4></td><td>selectedRecord 構文の完全版、対応コンポーネント、トラブルシューティング。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FqzYl3awWaUu4HRWqiwau%2Fxp-quickstart-cover-reactive.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FqzYl3awWaUu4HRWqiwau%2Fxp-quickstart-cover-reactive.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/reactive-components.md">リアクティブコンポーネント</a></td></tr><tr><td><h4>データテーブルと地図を連携させる</h4></td><td>同じテーブルと地図のパターンを、Accounts で、段階的に説明します。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FMmoOE8XAYZIOdgI60QN0%2Fxp-quickstart-cover-map.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FMmoOE8XAYZIOdgI60QN0%2Fxp-quickstart-cover-map.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/chtoriaru/reactive-components/linking-data-table-and-map-for-dynamic-locations.md">動的な場所のためにデータテーブルと地図をリンクする</a></td></tr><tr><td><h4>すべてのコンポーネント</h4></td><td>Accordion から Video まで、各 AX コンポーネントを専用ページ付きで閲覧できます。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FEE7PAy1DqgMswl2R1cUu%2Fxp-quickstart-cover-components.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FEE7PAy1DqgMswl2R1cUu%2Fxp-quickstart-cover-components.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/view-all-components.md">すべてのコンポーネントを表示</a></td></tr><tr><td><h4>AX - Data Table</h4></td><td>並び替え、検索、インライン編集、各行のファイル: テーブルがメンバーのためにできることのすべて。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FdYBnT69WbVXtAxk8Po6r%2Fwelcome-portal-data-table.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FdYBnT69WbVXtAxk8Po6r%2Fwelcome-portal-data-table.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-data-table.md">AX - データテーブル</a></td></tr><tr><td><h4>ポータルとパートナーサイト</h4></td><td>実際の org で一から最後まで構築した完全なプロジェクトと、それぞれの背後にある設定。</td><td><a href="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F3KtJGDtgwDzuWVjJKH9n%2Fprojects-portals-and-partner-sites.png?alt=media">https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F3KtJGDtgwDzuWVjJKH9n%2Fprojects-portals-and-partner-sites.png?alt=media</a></td><td><a href="https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites">https://docs.avonnicomponents.com/projects/use-cases/portals-and-partner-sites</a></td></tr></tbody></table>


---

# 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/hajimeni/quick-start-guide.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.
