インストールとライセンス管理

このガイドは、Avonni Dynamic Components を Salesforce 環境で動作させるための基本的な手順を説明します。

概要

ユーザーを設定する前に、Avonni コンポーネントへのアクセスは2段階のセキュリティモデルで制御されていることを理解することが重要です。ユーザーがコンポーネントを正常に表示または操作するには、次の両方を持っている必要があります：

1. パッケージライセンス: これはユーザーに特定の“シート”を割り当てます（管理は インストール済みパッケージ).

2. 権限セット: これはコンポーネントコードを読み込むための技術的権利を付与します（管理は 権限セット).

注意：ユーザーがライセンスを持っているが権限セットを持っていない場合（またはその逆）の場合、コンポーネントは読み込まれず、エラーが発生します。

環境と制限

• サンドボックス環境：インストールにはサイトライセンスが含まれます。テストおよび開発のためのユーザー数制限や時間制限はありません。

• 本番環境：インストールには10ライセンスのフリーミアムプランが含まれます。10人を超えるユーザーにアクセスを付与する必要がある場合は、追加のライセンスを購入する必要があります

---

インストール

重要な前提条件：Lightning Web Security

Avonni Dynamic Components パッケージを正常にインストールおよび使用するには、組織で Lightning Web Security（LWS）を有効にする必要があります。

1. 設定 > セキュリティとプライバシー に移動します。

2. Lightning Web Security を見つけます。

3. トグルが有効になっていることを確認してください

直接リンクでのインストール

にアクセスしてください リリースノートサイト Avonni Experience Components アプリをインストールするための直接リンクにアクセスするには、を参照してください。

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

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

割り当て方法

1. 設定に移動します。

2. インストール済みパッケージ を検索します。

3. Avonni Components を見つけて、ライセンスの管理をクリックします。

   • 旧来の注意：レガシーの単独パッケージを使用している場合は、「Avonni Dynamic Component」（単数）を探してください。

4. ユーザーを追加をクリックし、必要なユーザーを選択して保存をクリックします。

---

ステップ2：権限セットの割り当て

Avonni Experience Components パッケージをインストールすると、3つの特定の権限セットが自動的にあなたの Salesforce 組織に追加されます。

これらの権限セットは、ユーザーがどの程度の技術的アクセスを持つかを制御します — ページ上で単にコンポーネントを表示できるか、Avonni Builder を使用して新しい構成を作成できるかを決定します

ユーザーの役割に一致する権限セットを選択してください：

役割	権限セット名	機能
エンドユーザー （内部 Salesforce）	Avonni Dynamic Components User	Salesforce 内で Dynamic Components（例：カスタムデータテーブル、アクションボタン）を表示／操作する必要のあるユーザーに必要です。
エンドユーザー （Experience Cloud）	Avonni Experience Cloud Components User	Experience サイトや標準の Lightning App Builder ページ上でコンポーネントを表示／操作する必要のあるユーザーに必要です。
管理者とビルダー	Avonni Experiences Admin	Avonni Component Builder を使用してレイアウトを作成、編集、構築する必要のあるユーザーに必要です。

割り当て方法

1. 設定 > 権限セット に移動します。

2. 上の表から適切な権限セットを選択します。

3. 割り当ての管理 > 割り当てを追加 をクリックします。

4. ステップ1でライセンスを割り当てたユーザーを選択します。

5. 割り当て をクリックします。

ベストプラクティス（最小特権）：実際にコンポーネントを構築する必要があるユーザーにのみ Avonni Experiences Admin 権限セットを割り当ててください。ほとんどのユーザーは User 権限セットのみで十分です。

---

上級：管理者以外にコンポーネント構築を許可する

デフォルトでは、コンポーネントを作成／編集できるのはシステム管理者のみです。管理者以外のユーザーに Dynamic Components の作成権限を付与する場合は、Avonni Experiences Admin 権限セット（ステップ2）を割り当てる必要があります。 かつ、2つの特定のシステム権限を付与する必要があります.

必要なシステム権限

1. Author Apex: カスタムコンポーネントの作成／変更を許可します。

2. Modify Metadata Through Metadata API Functions: コンポーネント設定の保存を可能にします。

設定方法

1. 設定 > 権限セット に移動します。

2. 新しい権限セットを作成します（例：「Avonni Builder System Permissions」）。

3. システム権限に移動し、Author Apex と Modify Metadata Through Metadata API Functions のチェックボックスにチェックを入れます。

4. このカスタム権限セットを管理者以外のビルダーに割り当てます。

---

ライセンスの購入

Avonni Components パッケージには、本番組織で最大10ユーザーを許可するフリーミアムプランがあります。10人を超えるユーザーにアクセスを付与するには追加のライセンスが必要です。

ライセンスを購入するには、次のメールアドレスまでご連絡ください： [email protected] ご要件を記載するか、 時間を予約して 価格オプションについて相談してください。

---

ヘルプが必要ですか？

ライセンスの割り当てや権限に問題がある場合：

• コミュニティ：私たちの Trailblazer Community Group に参加して、ベストプラクティス、まとめての割り当て、大規模組織向け戦略について議論してください。

• サポート：当社のチームに連絡してください： [email protected].

• 営業：価格の相談や大量ライセンスについては、次までご連絡ください [email protected].