# Gestione licenze

## Gestione Licenze e Autorizzazioni

Per garantire che gli utenti possano visualizzare e interagire con i Componenti Avonni, in particolare sui siti Experience Cloud, è necessario completare un processo di configurazione in due passaggi.

<mark style="color:predefinito;background-color:orange;">**⚠️ Requisito di configurazione:**</mark> Affinché un utente possa accedere correttamente ai Componenti Avonni, è necessario assegnare ENTRAMBI:

1. **Una Licenza del Pacchetto** (Assegna un posto all'utente).
2. **Un Set di Autorizzazioni** (Concede l'accesso tecnico ai componenti).

{% hint style="warning" %}

#### Importante

Se un utente ha una Licenza ma non il Set di Autorizzazioni (o viceversa), i componenti non verranno caricati e l'utente visualizzerà un messaggio di errore.
{% endhint %}

***

## Fase 1: Assegnare le Licenze del Pacchetto

La licenza del pacchetto concede all'utente il diritto fondamentale di utilizzare il software all'interno di Salesforce.

Disponibilità delle licenze:

* Produzione: Include 10 licenze Freemium.
* Sandbox: Include una Licenza Site (utenti illimitati/Senza scadenza).

Come assegnare:

1. Vai a **Impostazioni**.
2. Cerca e seleziona **Pacchetti installati**.
3. Individua **Avonni Experience Components** e fai clic su **Gestisci licenze**.
4. Fai clic su **Aggiungi utenti**.
5. Seleziona tutti gli utenti che necessitano di accesso e fai clic su **Salva**.

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

***

## Fase 2: Assegnare i Set di Autorizzazioni

Una volta assegnata la licenza, è necessario assegnare il corretto Set di Autorizzazioni in base al ruolo dell'utente. Il pacchetto Avonni include tre set di autorizzazioni distinti.

<figure><img src="/files/7bfcf6e427d3a9988002d0a1d5059d0d5f420fca" alt=""><figcaption></figcaption></figure>

Scegli il set di autorizzazioni corretto per il tuo utente:

| Ruolo                                                                                         | Nome del Set di Autorizzazioni          | Funzione                                                                                                                                                 |
| --------------------------------------------------------------------------------------------- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p><strong>Utenti finali</strong></p><p><strong>(Experience Cloud e App Builder)</strong></p> | Avonni Experience Cloud Components User | Richiesto per gli utenti che visualizzano i componenti sui siti Experience o nelle pagine standard di Lightning App Builder.                             |
| <p><strong>Utenti finali</strong></p><p><strong>(Componenti dinamici)</strong></p>            | Avonni Dynamic Components User          | Richiesto per gli utenti che interagiscono con i Componenti Dinamici (ad es. tabelle dati personalizzate, pulsanti di azione) all'interno di Salesforce. |
| **Amministratori e Builder**                                                                  | Avonni Experiences Admin                | Richiesto per gli utenti che devono creare, modificare o costruire layout utilizzando il Component Builder di Avonni.                                    |

Come assegnare:

1. Vai a **Impostazioni** > **Set di Autorizzazioni**.
2. Seleziona il Set di Autorizzazioni appropriato dalla tabella sopra.
3. Fai clic su **Gestisci Assegnazioni** > **Aggiungi Assegnazione**.
4. Seleziona gli utenti a cui hai assegnato le licenze nella Fase 1.
5. Fai clic su **Assegna**.

***

## Configurazione per gli utenti Guest

Gli utenti guest (visitatori non autenticati su siti pubblici) non richiedono una Licenza di Pacchetto standard, ma richiedono autorizzazioni.

{% hint style="warning" %}

#### Nota

L'accesso dell'Utente Guest per gli ambienti di Produzione è una funzionalità aggiuntiva. Per favore [contatta il supporto](mailto:support@avonni.app) per i dettagli.
{% endhint %}

Per abilitare l'accesso Guest:

1. Apri il tuo sito Experience Cloud in Builder.
2. Vai su Impostazioni > Generale e fai clic sul collegamento al Profilo Utente Guest.
3. Nelle impostazioni del Profilo, scorri fino ad Assegnazioni Set di Autorizzazioni.
4. Aggiungi il set di autorizzazioni Avonni Experience Cloud Components al profilo.

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

#### Risolvere problemi di accesso

Se un utente segnala l'errore *"Non hai accesso a questo Componente Avonni,"* verifica quanto segue:

| Problema                    | Soluzione                                                                                                                                                                       |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Licenza mancante**        | Assicurati che l'utente sia elencato in *Pacchetti installati > Gestisci licenze*.                                                                                              |
| **Autorizzazione mancante** | Assicurati che l'utente abbia il *Avonni Experience Cloud Components* set di autorizzazioni assegnato.                                                                          |
| **LWS disabilitato**        | Assicurati che [*Lightning Web Security* sia abilitato](https://developer.salesforce.com/docs/platform/lightning-components-security/guide/lws-enable.html) nelle Impostazioni. |


---

# 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-it/per-iniziare/gestione-licenze.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.
