# ライセンス管理

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

ユーザーが 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="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FBDKTTwhvu3t0ImAOVjkx%2Fimage%20-%202025-12-11T152901.759.avif?alt=media&#x26;token=1f2777ff-1066-4ff9-86e8-ef42eaea5d0b" alt=""><figcaption></figcaption></figure>

***

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

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

<figure><img src="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2FTGmfthAFHbjNRuCBeb9j%2Fimage%20-%202025-12-11T152644.009.avif?alt=media&#x26;token=6728ac59-3b3c-435f-8740-0ae500aa4d4c" 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="https://9391847-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDL6JQuZArjJeQvX2ot4y%2Fuploads%2F6yGKn0t0cQmnKmvKYcrY%2Fimage%20-%202025-12-11T152750.122.avif?alt=media&#x26;token=32ad5907-e2f6-43fc-a706-03cd5422d86f" 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) セットアップで。 |