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

# AX - Metrica

## Panoramica

**AX - Metrica** è un componente di Experience Cloud che visualizza valori calcolati dai record Salesforce—come totali, medie, conteggi e altre aggregazioni—nelle pagine dei siti Experience.

Usalo per mostrare agli utenti del portale metriche chiave a colpo d'occhio, come il totale degli ordini, il tempo medio di risoluzione dei casi, il numero di ticket aperti o qualsiasi calcolo personalizzato ricavato dai loro dati. Configura l'etichetta della metrica, l'icona, la formattazione e l'origine dati in Experience Builder senza codice.

Perfetto per dashboard del portale, riepiloghi degli account, scorecard delle prestazioni o ovunque gli utenti del portale debbano vedere numeri chiave sui propri record senza eseguire report.

***

## Per iniziare

Usa questo semplice tutorial per imparare le basi del componente Metric e iniziare a creare i tuoi casi d'uso.

{% @arcade/embed url="<https://app.arcade.software/share/SXruKm5NX2h4AYOxH2EQ>" flowId="SXruKm5NX2h4AYOxH2EQ" %}

***

## **Opzioni di configurazione**

### **Etichetta**

Fornisci un'etichetta descrittiva per la tua metrica (ad es. "Vendite totali", "Utenti attivi"). Questa funge da titolo, fornendo contesto al valore visualizzato.

<figure><img src="/files/0c706e8ab54127b7de90252eb06d758577991630" alt="" width="563"><figcaption></figcaption></figure>

### **Descrizione**

Offri ulteriore contesto o approfondimenti relativi alla metrica. Può trattarsi di una breve spiegazione, una descrizione dell'andamento o informazioni di supporto per facilitarne la comprensione.

### **Valore**

Inserisci il valore numerico principale della metrica. Hai due opzioni:

#### **Inserimento manuale**

Inserisci direttamente il valore se è prontamente disponibile.

#### **Query**

Sfrutta la potenza di Salesforce Object Query Language per recuperare dinamicamente il valore dai dati Salesforce. Ad esempio, puoi calcolare il numero totale di account creati quest'anno usando una query sull'oggetto Account.

<figure><img src="/files/6640e467cc8f92bca52df1ae3632b67a03dc150e" alt=""><figcaption><p>Esempio: conteggio dei nuovi account creati quest'anno</p></figcaption></figure>

### **Valore secondario**

Visualizza una metrica aggiuntiva per confronto o ulteriore contesto. Può essere il valore di un periodo precedente, un valore obiettivo o qualsiasi punto dati secondario rilevante.

### **Prefisso e suffisso**

Aggiungi simboli o abbreviazioni per fornire contesto. Ad esempio, usa "$" per la valuta, "#" per le quantità o "K" per le migliaia.

### **Suggerimento**

Offri maggiori dettagli al passaggio del mouse. Spiega brevemente la metrica o fornisci ulteriori approfondimenti.

### **Avatar**

Rappresenta visivamente la metrica con un'immagine, iniziali o un'icona. Questo rende la metrica più riconoscibile e coinvolgente.

### **Formattazione della metrica primaria e secondaria**

Rifinisci il modo in cui vengono visualizzati i valori della tua metrica:

* **Stile formato:** Decimale, valuta, percentuale: scegli il formato migliore per i tuoi dati.
* **Segno del valore:** Automatico, positivo, negativo: controlla come vengono visualizzati i segni.
* **Cifre:** Specifica il numero minimo e massimo di cifre intere e decimali.
* **Cifre significative:** Arrotonda a un numero specifico di cifre per migliorarne la leggibilità.
* **Mostra il colore dell'andamento:** Usa i colori per indicare istantaneamente andamenti positivi (verde) o negativi (rosso)

Con la sua flessibilità e la gamma di opzioni, il componente Avonni Metric ti consente di presentare dati complessi in modo semplificato e di grande impatto, rendendolo una risorsa preziosa per qualsiasi sito Experience Cloud che desideri fornire ai propri utenti informazioni utili e immediate.

***

## Esempi di casi d'uso

### Esempio 1: importo delle opportunità vinte dell'account

{% @arcade/embed url="<https://app.arcade.software/share/KEG70at1gkiT4HyGtaBj>" flowId="KEG70at1gkiT4HyGtaBj" %}

Metti il fatturato totale delle chiusure vinte in primo piano in ogni pagina account, offrendo agli utenti partner una visione immediata del valore della relazione senza uscire dal record.

***

#### **Cosa otterrai**

* **Visibilità del fatturato aggregato:** Visualizza in tempo reale la somma di tutti gli importi delle opportunità chiuse vinte collegati all'account, offrendo ai partner un'istantanea immediata del valore del cliente.

***

#### **Come configurarlo**

{% stepper %}
{% step %}

#### **Aggiungi il componente alla tua pagina**

Trascina il componente AX – Metric in Experience Builder nella pagina dei dettagli dell'Account.
{% endstep %}

{% step %}

#### **Configura la fonte dati**

* Fai clic nel campo Valore e imposta una query usando le seguenti impostazioni:
  * Nome API oggetto: `Opportunity`
  * Campo: `Amount`
  * Funzione di aggregazione: `SOMMA`
    {% endstep %}

{% step %}

#### **Applica filtri**

Limita la query all'account corrente e solo alle trattative vinte:

* ID account: `{!Item.Id}`
* Fase: `Chiuso Vinto`
  {% endstep %}

{% step %}

#### **Personalizza la visualizzazione**

* Imposta l'etichetta su `Importo vinto`
* Imposta l'icona avatar su `standard:opportunity`
  {% endstep %}

{% step %}

#### **Visualizza l'anteprima del componente**

* Usa l'anteprima di Experience Builder per verificare che la metrica venga visualizzata correttamente prima della pubblicazione.
  {% endstep %}
  {% endstepper %}

***

#### **Collegamenti**

{% content-ref url="/pages/cf869fa1856c81b19edfb1f2bcadd252379f56c0" %}
[AX - Scheda profilo](/experience-cloud/experience-cloud-it/experience-components/ax-profile-card.md)
{% endcontent-ref %}

{% content-ref url="/pages/32c41c4ec20b132e395248826b7548bf488451b2" %}
[AX - Dettagli record](/experience-cloud/experience-cloud-it/experience-components/ax-record-detail.md)
{% endcontent-ref %}

***

### Esempio 2: casi aperti dell'account

{% @arcade/embed url="<https://app.arcade.software/share/S4TjnIAEL1dUly6hcTtg>" flowId="S4TjnIAEL1dUly6hcTtg" %}

Fornisci agli utenti partner un conteggio in tempo reale dei casi irrisolti direttamente sulla pagina dell'account, in modo che possano valutare rapidamente il carico di assistenza e dare priorità ai loro contatti di conseguenza.

***

#### **Cosa otterrai**

* **Conteggio dei casi aperti a colpo d'occhio:** Mostra il numero totale di casi attivi collegati a un account, aiutando i partner a restare informati sullo stato di salute del cliente senza dover navigare a un elenco separato.

***

#### **Come configurarlo**

{% stepper %}
{% step %}

#### **Aggiungi il componente alla tua pagina**

Trascina il componente AX – Metric in Experience Builder nella pagina dei dettagli dell'Account.
{% endstep %}

{% step %}

#### **Configura la fonte dati**

* Fai clic nel campo Valore e imposta una query usando le seguenti impostazioni:
  * Nome API oggetto: `Caso`
  * Campo: `Id`
  * Funzione di aggregazione: `CONTEGGIO`
    {% endstep %}

{% step %}

#### **Applica filtri**

* Limita la query all'account corrente e solo ai casi aperti:
  * ID account: `{!Item.Id}`
  * Chiuso: `falso`
    {% endstep %}

{% step %}

#### **Personalizza la visualizzazione**

* Imposta l'etichetta su `Casi aperti`
  {% endstep %}

{% step %}

#### **Visualizza l'anteprima del componente**

* Usa l'anteprima di Experience Builder per verificare che il conteggio venga visualizzato correttamente prima della pubblicazione.
  {% endstep %}
  {% endstepper %}


---

# 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-metric.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.
