# ライセンス管理

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

ユーザーが Avonni コンポーネントを表示および操作できるようにするため、特に Experience Cloud サイト上では、2段階の構成手順を完了する必要があります。

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

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

{% hint style="warning" %}

#### 重要

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

***

## ステップ 1：パッケージライセンスの割り当て

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

ライセンスの可用性：

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

割り当て方法：

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

<figure><img src="/files/be3d1396c496abd3d18b3d854c5cc59f328a3d07" alt=""><figcaption></figcaption></figure>

***

## ステップ 2：パーミッションセットの割り当て

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

<figure><img src="/files/c1687e0259a8666909f55e2084db131033042f9a" alt=""><figcaption></figcaption></figure>

ユーザーに適切なパーミッションセットを選択してください：

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

割り当て方法：

1. に移動 **設定** > **パーミッションセット**.
2. 上記の表から適切なパーミッションセットを選択します。
3. クリック **割り当ての管理** > **割り当てを追加**.
4. ステップ 1 でライセンスを割り当てたユーザーを選択します。
5. クリック **割り当て**.

***

## ゲストユーザーの構成

ゲストユーザー（公開サイトの未認証訪問者）は標準のパッケージライセンスを必要としませんが、権限は必要です。

{% hint style="warning" %}

#### 注意

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

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

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

<figure><img src="/files/a09771cbe2b83c34d0c2849da497b1f292ed6f64" 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) セットアップで。 |


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/raisensu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.