> 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-it/experience-components/ax-avatar-group.md).

# AX - Gruppo avatar

## Panoramica

**AX - Gruppo avatar** è un componente di Experience Cloud che mostra più foto profilo, iniziali o icone in una riga compatta nelle pagine dei siti Experience.

Usalo per mostrare membri del team, collaboratori di progetto, contatti dell'account o qualsiasi gruppo di utenti o record correlati. Il componente dispone gli avatar orizzontalmente e mostra un indicatore "+X" quando ci sono più avatar di quanti ne possano stare nell'area di visualizzazione.

Perfetto per elenchi del team, gruppi di collaborazione, visualizzazioni di assegnazione dei casi o per mostrare chi ha accesso ai record condivisi nei portali clienti o partner.

***

## **Opzioni di configurazione**

### **Origine dati**

Indica dove trovare le informazioni per far sì che il tuo Gruppo avatar mostri le persone giuste. È qui che **Le origini dati** entrano in gioco. Consideralo come il collegamento dei tuoi avatar al cuore dei tuoi dati Salesforce.

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

#### **Manuale**

Questa opzione è ideale per team più piccoli o per situazioni in cui devi mostrare gli avatar solo per un evento o un progetto specifico.

1. **Aggiungi ogni persona:** Inserirai i loro dettagli direttamente nelle impostazioni del Gruppo avatar per ciascuna persona che desideri includere.
2. **Fornisci le informazioni chiave:** Questo include:
   * **Immagine avatar:** Se hai una foto, puoi caricarla qui.
   * **Iniziali:** Saranno visualizzate se non è disponibile alcuna immagine.
   * **Altri dettagli:** Puoi includere informazioni aggiuntive come il titolo o il reparto della persona.

Sebbene l'opzione Manuale richieda un maggiore lavoro pratico, ti offre il controllo completo su chi viene visualizzato nel tuo Gruppo avatar.

#### **Query**

Questa opzione è la scelta giusta se il tuo team cambia frequentemente o vuoi che gli avatar corrispondano sempre alle informazioni più recenti nella tua organizzazione Salesforce.

Ecco come funziona:

1. **Scegli il tuo oggetto:** Seleziona l'oggetto Salesforce (come Utente, Contatto o un oggetto personalizzato) in cui sono presenti le informazioni del tuo avatar.
2. **Mappa i dati:** Collega i punti tra gli attributi del tuo gruppo avatar (come Nome, Titolo, Immagine profilo) e i campi corrispondenti nell'oggetto scelto. Questo indica al Gruppo avatar esattamente dove trovare i dettagli corretti per ciascuna persona.

Utilizzando l'opzione Query, il tuo Gruppo avatar diventa una rappresentazione dinamica dei tuoi dati Salesforce, mostrando sempre le informazioni più accurate e aggiornate.

### **Variante**

* **Quadrato:** Gli avatar vengono visualizzati come quadrati, con un aspetto classico e pulito.
* **Cerchio:** Gli avatar vengono visualizzati come cerchi più moderni e accoglienti.
* **Vuoto:** Se non è disponibile alcuna immagine, iniziali o icone segnaposto appaiono all'interno di cerchi o quadrati vuoti. Scegli questa opzione per mantenere la coerenza visiva anche quando mancano i dati dell'immagine.

<figure><img src="/files/09424c67d9254b6ab5ca99f66ce8375784c6f5bc" alt=""><figcaption></figcaption></figure>

### **Dimensione**

* Controlla le dimensioni di ciascun avatar. Scegli tra una gamma di dimensioni per adattarle al layout e al contesto del tuo sito. Le opzioni includono x-small, small, medium, large, x-large e xx-large.

### **Layout**

* **Pila:** Gli avatar sono impilati verticalmente, ideali per spazi stretti o barre laterali.
* **Griglia:** Gli avatar sono disposti in un layout a griglia, perfetto per mostrare un gruppo più grande di utenti o team.
* **Elenco:** Gli avatar sono visualizzati in una riga orizzontale, utile quando lo spazio è limitato ma vuoi comunque mostrare più avatar.

### **Conteggio massimo**

* Limita il numero di avatar visualizzati nel gruppo. Questo aiuta a mantenere un layout pulito ed evita di sovraccaricare l'utente con troppi elementi visivi.

### **Iniziali formattate automaticamente (interruttore)**

* Abilita questa opzione per visualizzare automaticamente le iniziali degli utenti o dei team quando le immagini non sono disponibili. Ciò fornisce una rappresentazione visiva coerente anche quando i dati dell'immagine mancano.

### Collega a (Rendi i tuoi avatar interattivi)

Pensa a questa sezione come a un superpotere per i tuoi avatar: portare i tuoi utenti altrove quando fanno clic!

<figure><img src="/files/14697f5fac4b47c27821f3cf2efcdae39ca764aa" alt=""><figcaption></figcaption></figure>

#### Perché è utile?

* **Profili utente:** Immagina di mostrare un team di esperti. Impostando un collegamento a un'azione, fare clic su un avatar potrebbe aprire la loro pagina profilo completa.
* **Azioni personalizzate:** Forse vuoi che un clic attivi un Flow specifico o persino reindirizzi a un sito web esterno.

#### Come funziona

1. **Scegli il tipo:** Seleziona dove vuoi che il clic porti i tuoi utenti. Può trattarsi di una pagina record, una pagina personalizzata, un Flow o un URL esterno.
2. **Personalizza il nome dell'azione:** Quando usi un'interazione di navigazione, scegli il nome dell'azione da richiamare.

Usando la funzionalità Collega a, il tuo Gruppo avatar diventa più di una semplice visualizzazione di volti: diventa una porta di accesso a informazioni o azioni aggiuntive.

***

## **Utilizzo del componente Avonni Gruppo avatar**

Queste opzioni di configurazione ti consentono di adattare il componente Avonni Gruppo avatar alle tue esigenze. Ad esempio, puoi mostrare i membri del team in una pagina di progetto, visualizzare gli avatar dei clienti nelle pagine degli account o creare elenchi visivamente coinvolgenti dei membri della community.

Ricorda, il componente Avonni Gruppo avatar è altamente adattabile. Puoi personalizzarne ulteriormente l'aspetto con lo stile visivo e persino aggiungere elementi interattivi per rendere gli avatar cliccabili o collegarli ai profili utente.

Sfruttando il componente Avonni Gruppo avatar, puoi creare un'esperienza più personalizzata e informativa per gli utenti del tuo sito Experience Cloud, favorendo le connessioni ed evidenziando l'elemento umano all'interno della tua community online.


---

# 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-it/experience-components/ax-avatar-group.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.
