> 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/license-management.md).

# ライセンス管理

## ライセンスと権限の管理

ユーザーが特に Experience Cloud サイト上で Avonni コンポーネントを表示・操作できるようにするには、2 段階の設定が必要です。

<mark style="background-color:orange;">**⚠️ 設定要件:**</mark> ユーザーが Avonni コンポーネントに正常にアクセスするには、次の両方を割り当てる必要があります:

1. **パッケージライセンス** (ユーザーに 1 席を割り当てます)。
2. **権限セット** (コンポーネントへの技術的なアクセス権を付与します)。

{% hint style="warning" %}

#### 重要

ユーザーにライセンスがあるが権限セットがない場合（またはその逆の場合）、コンポーネントは読み込まれず、ユーザーにはエラーメッセージが表示されます。
{% endhint %}

***

## ステップ 1: パッケージライセンスを割り当てる

パッケージライセンスにより、ユーザーは Salesforce 内でこのソフトウェアを使用する基本的な権利を得ます。

ライセンスの提供状況:

* 本番環境: 10 件のフリーミアムライセンスが含まれます。
* サンドボックス: サイトライセンスが含まれます（ユーザー数無制限／期限なし）。

### 何件のライセンスが必要ですか?

サイトにログインする必要がある各ユーザーに 1 件ずつ Avonni ライセンスを割り当ててください。計算するものはありません。

Salesforce Experience Cloud のライセンスがログインベースの場合も同じです。Avonni の席数はログイン数、セッション数、または訪問頻度に対してカウントされないため、想定トラフィックから必要数を見積もることはできません。重要なのは、組織内でそのライセンスを保有しているユーザー数です。

理由は当社の判断ではなくプラットフォームの制約です。Salesforce は、ログインベースのユーザーが実際にサイトへ接続したかどうかを通知しないため、利用状況を測定できません。ログインできるすべてのユーザーにライセンスを割り当てることで、アクセスエラーを防げます。

現在の状況を確認するには、次を開いてください: **設定** > **インストール済みパッケージ**を開き、 **Avonni Experience Components** を見つけて、 **ライセンスを管理**をクリックします。ページにはライセンスを持つユーザーと、使用中のライセンス数が表示されます。

割り当て方法:

1. 移動先: **設定**.
2. 検索して選択 **インストール済みパッケージ**.
3. 見つけてください **Avonni Experience Components** を見つけて、 **ライセンスを管理**.
4. クリック **ユーザーを追加**.
5. アクセスが必要なすべてのユーザーを選択し、 **保存**.

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-78db93c54f54bde5ab1b0194266b15eab2ee9df7%2Fimage%20-%202025-12-11T152901.759.avif?alt=media" alt=""><figcaption></figcaption></figure>

***

## ステップ 2: 権限セットを割り当てる

ライセンスを割り当てたら、ユーザーの役割に応じて適切な権限セットを割り当てる必要があります。Avonni パッケージには 3 つの異なる権限セットが含まれています。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-0a00c03a72b97827756d452f5a243caf1cec5ac1%2Fimage%20-%202025-12-11T152644.009.avif?alt=media" alt=""><figcaption></figcaption></figure>

ユーザーに適した権限セットを選択してください:

| 役割                                                                                      | 権限セット名                                  | 機能                                                                       |
| --------------------------------------------------------------------------------------- | --------------------------------------- | ------------------------------------------------------------------------ |
| <p><strong>エンドユーザー</strong></p><p><strong>(Experience Cloud & App Builder)</strong></p> | Avonni Experience Cloud Components User | Experience Site または標準の Lightning App Builder ページでコンポーネントを表示するユーザーに必要です。  |
| <p><strong>エンドユーザー</strong></p><p><strong>(Dynamic Components)</strong></p>             | Avonni Dynamic Components User          | Salesforce 内で Dynamic Components（例: カスタムデータテーブル、アクションボタン）を操作するユーザーに必要です。 |
| **管理者とビルダー**                                                                            | Avonni Experiences Admin                | Avonni Component Builder を使用してレイアウトを作成、編集、または構築する必要があるユーザーに必要です。         |

割り当て方法:

1. 移動先: **設定** > **権限セット**.
2. 上の表から適切な権限セットを選択してください。
3. クリック **割り当てを管理** > **割り当てを追加**.
4. ステップ 1 でライセンスを割り当てたユーザーを選択します。
5. クリック **割り当て**.

***

## ゲストユーザーの設定

ゲストユーザー（公開サイトの未認証訪問者）には通常のパッケージライセンスは不要ですが、権限は必要です。

{% hint style="warning" %}

#### 注

本番環境でのゲストユーザーアクセスはアドオン機能です。詳細については [サポートまでお問い合わせください](mailto:support@avonni.app) 。
{% endhint %}

ゲストアクセスを有効にするには:

1. Experience Cloud サイトを Builder で開きます。
2. \[設定] > \[一般] に移動し、ゲストユーザープロファイルへのリンクをクリックします。
3. プロファイル設定で、\[権限セットの割り当て] までスクロールします。
4. Avonni Experience Cloud Components の権限セットをプロファイルに追加します。

<figure><img src="https://2929066058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2Fgit-blob-9b4cc640c218ad835c496ceb0530c3dbfdfa9bec%2Fimage%20-%202025-12-11T152750.122.avif?alt=media" alt=""><figcaption></figcaption></figure>

#### アクセス問題のトラブルシューティング

ユーザーから次のエラーが報告された場合 *「この Avonni コンポーネントにアクセスできません。」* 以下を確認してください:

| 問題                | 解決策                                                                                                                                                       |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ライセンスが不足しています** | ユーザーが次に一覧表示されていることを確認してください: *インストール済みパッケージ > ライセンスを管理*.                                                                                                  |
| **権限が不足しています**    | ユーザーに次が割り当てられていることを確認してください: *Avonni Experience Cloud Components* の権限セットが割り当てられていること。                                                                     |
| **LWS が無効**       | 確認してください [*Lightning Web Security* が有効になっていることを](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) 設定で。 |

***

## 任意: Map Routes のルーティング

Map コンポーネントは複数停止のドライブルートを計画できます。この機能は管理者が有効化するまでオフになっており、ライセンスや権限セットとは別の設定が必要です。

* ルーティングは **BYOK（Bring Your Own Key）** です。OpenRouteService または Mapbox の API キーを用意してください。Avonni はルーティング用バックエンドをホストしていません。
* 次から有効にします: **設定** タブで **Avonni Experiences** をアプリランチャーで開きます。
* 権限セットは不要です。ルーティングを有効にすると、ルートパネルをオンにした地図を開けるすべてのユーザーがルートを計算できます。Experience Cloud サイトのゲストユーザーも含まれます。

詳細手順: [Map ルーティングを有効にする](https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/experience-components/ax-map/enable-map-routing.md).


---

# 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/license-management.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.
