> 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).

# ライセンス管理

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

ユーザーが Avonni Components を表示し操作できるようにするには、特に Experience Cloud サイトでは、2段階の設定プロセスを完了する必要があります。

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

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

{% hint style="warning" %}

#### 重要

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

***

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

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

ライセンスの利用状況：

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

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

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

Salesforce Experience Cloud のライセンスがログインベースの場合でも、この考え方は変わりません。Avonni の席はログイン数、セッション数、訪問頻度の対象にならないため、想定トラフィックから算出することはできません。重要なのは、組織内でライセンスを保持しているユーザー数です。

理由は当社の判断ではなく、プラットフォームの制約です。Salesforce は、ログインベースのユーザーが実際にサイトへ接続したかどうかを当社に通知しないため、使用量を計測できません。ログイン可能なすべてのユーザーにライセンスを割り当てることで、そのいずれもアクセスエラーに遭わないようにできます。

現在の状況を確認するには、 **設定** > **Installed Packages**で **Avonni Experience Components** を見つけて **ライセンスの管理**をクリックします。このページには、ライセンスを保持しているユーザーと、使用中のライセンス数が表示されます。

割り当て方法：

1. 次へ移動 **設定**.
2. 検索して選択 **Installed Packages**.
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 サイトまたは標準の 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. Builder で Experience Cloud サイトを開きます。
2. Settings > General に移動し、Guest User Profile へのリンクをクリックします。
3. Profile 設定で、Permission Set Assignments までスクロールします。
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 Component へのアクセス権がありません」* 以下を確認してください：

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


---

# 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 dynamically by asking a question.

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

```
GET https://docs.avonnicomponents.com/experience-cloud/experience-cloud-ja/hajimeni/license-management.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
