

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Definizione del layout
<a name="layout-definition"></a>

Comprensione della struttura e dei componenti dei layout dell’Esploratore di profili.

**Topics**
+ [

# Come funziona
](how-it-works.md)
+ [

# Widget
](widgets.md)

# Come funziona
<a name="how-it-works"></a>

L’Esploratore di profili offre vari widget per visualizzare le informazioni sui clienti, i layout sono archiviati come definizioni JSON, che rappresentano la struttura e la configurazione complete della dashboard. Ogni widget e componente del layout visivo corrisponde a uno specifico blocco JSON all’interno di questa definizione.

## Componenti principali
<a name="core-components"></a>

Ogni componente della definizione del layout è composto da cinque elementi comuni:
+ **Tipo**
  + Definisce la categoria del componente
  + Determina il modo in cui il componente viene renderizzato
  + Esempi: BoardItem, Tabella, KeyValuePair
+ **Id**
  + Identificativo univoco per ogni componente
  + Utilizzato per il monitoraggio e l’aggiornamento dei componenti
  + Generato automaticamente quando i componenti vengono creati nel generatore
+ **Props**
  + Proprietà specifiche del componente
  + Controlla l’aspetto e il comportamento
  + Include le impostazioni di configurazione
+ **Bambini**
  + Componenti o contenuti annidati
  + Definisce le relazioni gerarchiche
  + Può contenere più sottocomponenti
+ **DataSource**
  + Specifica l’origine dei dati
  + Definisce i parametri di recupero dei dati
  + Controlla l’associazione dei dati per i componenti

## Esempio di definizione di un componente di layout
<a name="example-layout-component-definition"></a>

Di seguito è riportato un esempio di struttura JSON per un componente della tabella della dashboard:

```
{
    "Id": "unique-identifier",
    "Type": "BoardItem",
    "Props": {},
    "Children": [
        {
            "Id": "unique-identifier",
            "Type": "Table",
            "Props": {},
            "Children": [
                {
                    "Id": "unique-identifier",
                    "Type": "TextContent",
                    "Props": {},
                    "Children": ["string"]
                }
            ]
        }
    ],
    "DataSource": [
        {
            "Type": "source-type",
            "Params": {}
        }
    ]
}
```

## Configurazione dinamica dei dati
<a name="dynamic-data-configuration"></a>

L’Esploratore di profili utilizza espressioni modello per accedere e visualizzare i dati dei Profili dei clienti in modo dinamico all’interno dei componenti.

### Supporto a valore singolo
<a name="single-value-support"></a>

Per componenti come le Coppie chiave-valore e le Metriche chiave, puoi accedere a:

#### Informazioni di profilo standard
<a name="standard-profile-information"></a>

```
{{Customer.<StandardProfileInfo>}}
```

Esempio di utilizzo:
+ `{{Customer.FirstName}}`
+ `{{Customer.LastName}}`
+ `{{Customer.PhoneNumber}}`

#### Attributi calcolati
<a name="calculated-attributes"></a>

```
{{Customer.CalculatedAttributes.<attributeDefinitionName>}}
```

Esempio di utilizzo:
+ `{{Customer.CalculatedAttributes._cases_count}}`
+ `{{Customer.CalculatedAttributes._new_customer}}`

### Sintassi di supporto dei dati tabulari
<a name="tabular-data-support-syntax"></a>

#### Attributi calcolati
<a name="calculated-attributes-tabular"></a>

```
{{Customer.CalculatedAttributes.DisplayName}}
```

```
{{Customer.CalculatedAttributes.CalculatedAttributeDefinitionName}}
```

#### Segmenti
<a name="segments"></a>

```
{{Customer.CalculatedAttributes.DisplayName}}
```

```
{{Customer.CalculatedAttributes.SegmentDefinitionName}}
```

#### Oggetti profilo
<a name="profile-objects"></a>

```
{{Customer.ObjectAttributes.<objectTypeName>.<fieldName>}}
```

**Esempio di utilizzo**:
+ `{{Customer.ObjectAttributes.CTR.contactId}}`
+ `{{Customer.ObjectAttributes.Order.orderId}}`

### Esempi di implementazione
<a name="implementation-examples"></a>

#### Componente a valore singolo
<a name="single-value-component"></a>

```
{
    "Type": "KeyValuePair",
    "Props": {
        "Items": [
            {
                "Label": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["Customer Name"]
                    }
                },
                "Value": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["{{Customer.FirstName}}"]
                    }
                }
            }
        ]
    }
}
```

#### Componente tabulare
<a name="tabular-component"></a>

```
{
    "Type": "Table",
    "Props": {
        "ColumnDefinitions": [
            {
                "Cell": {
                    "Content": {
                        "Type": "TextContent",
                        "Children": ["{{Customer.ObjectAttributes.CTR.contactId}}"]
                    }
                },
                "Header": "Contact ID"
            }
        ]
    }
}
```

**Nota**  
Assicurati che gli attributi, gli oggetti e i segmenti a cui fai riferimento esistano nella configurazione dei Profili dei clienti prima di utilizzarli nel layout.

# Widget
<a name="widgets"></a>

Esplora i diversi tipi di widget disponibili nell’Esploratore di profili.

## Panoramica di
<a name="widgets-overview"></a>

I widget nell’Esploratore di profili sono elementi compositi creati con componenti JSON all’interno della definizione del layout. Sebbene questi widget rappresentino strutture JSON complesse, il nostro generatore di interfacce utente gestisce automaticamente la composizione tecnica, rendendo la gestione della dashboard semplice e accessibile.

**Topics**
+ [

## Panoramica di
](#widgets-overview)
+ [

## Widget disponibili
](#available-widgets)
+ [

# Widget predefiniti
](default-widgets.md)
+ [

# Widget personalizzati
](custom-widgets.md)

## Widget disponibili
<a name="available-widgets"></a>
+ Widget predefiniti
  + [Riepilogo dell’IA generativa](default-widgets.md#generative-ai-summary)
  + [Informazioni sui clienti](default-widgets.md#customer-information)
  + [Attributo calcolato](default-widgets.md#calculated-attribute)
  + [Contatti](default-widgets.md#contacts)
  + [Casi](default-widgets.md#cases-cp)
  + [Ordini](default-widgets.md#orders-cp)
  + [Asset](default-widgets.md#assets-cp)
+ Widget personalizzati
  + [Tabella](custom-widgets.md#table-widget)
  + [Coppia chiave-valore](custom-widgets.md#key-value-pair)
  + [Metrica chiave](custom-widgets.md#key-metric)
  + [Grafico ad anello](custom-widgets.md#donut-chart)

# Widget predefiniti
<a name="default-widgets"></a>

L’Esploratore di profili include una raccolta di widget preconfigurati progettati per funzionare perfettamente con i dati dei Profili dei clienti. Questi widget predefiniti offrono un valore immediato con una configurazione minima, consentendoti di creare dashboard sofisticate con pochi clic.

![\[Aggiungi widget predefiniti nel layout dell’Esploratore.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/default-widgets-1.png)


## Ready-to-use widget
<a name="ready-to-use-widgets"></a>
+ [Riepilogo dell’IA generativa](#generative-ai-summary)
+ [Informazioni sui clienti](#customer-information)
+ [Attributo calcolato](#calculated-attribute)
+ [Contatti](#contacts)
+ [Casi](#cases-cp)
+ [Ordini](#orders-cp)
+ [Asset](#assets-cp)

**Nota**  
Sebbene questi widget siano preconfigurati, puoi comunque personalizzarli per adattarli meglio alle tue esigenze specifiche. Servono come punto di partenza per consentire un facile onboarding.

## Riepilogo dell’IA generativa
<a name="generative-ai-summary"></a>

L’Esploratore di profili offre informazioni predefinite sui clienti basate sull’IA che generano riepiloghi concisi in grado di evidenziare i principali modelli comportamentali, fornisce informazioni personalizzate sui clienti basate sulla cronologia delle interazioni e ricava suggerimenti attuabili dai dati dei clienti a 360°. I riepiloghi generati dall’IA aiutano le organizzazioni a prendere decisioni basate sui dati identificando i modelli in diversi punti di contatto con i clienti, fornendo approfondimenti comportamentali personalizzati specifici per ogni cliente e favorendo una migliore esperienza dei clienti e una maggiore fidelizzazione.

![\[Widget di riepilogo dell’IA generativa.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/generative-ai-summary-1.png)


## Informazioni sui clienti
<a name="customer-information"></a>

Il widget Informazioni sul cliente fornisce una visualizzazione chiara e organizzata dei dati standard del Profilo del cliente utilizzando componenti di coppia chiave-valore. Questo widget predefinito mostra automaticamente le informazioni essenziali sui clienti in un formato facilmente scansionabile.

### Panoramica di
<a name="customer-information-overview"></a>

Questo widget utilizza il componente della coppia di chiave-valore per visualizzare gli attributi del cliente in un layout strutturato.
+ Nome
+ Cognome
+ Indirizzo e-mail
+ Numero di telefono
+ Indirizzo
+ Numero account
+ ID del profilo

### Dati
<a name="customer-information-data"></a>

Il widget si connette automaticamente al dominio Profili dei clienti e recupera le informazioni dagli attributi standard del profilo. Non sono necessarie ulteriori configurazioni per le funzionalità di base.

**Nota**: sebbene questo widget sia preconfigurato con attributi di profilo standard, è possibile personalizzare gli attributi del profilo standard da visualizzare in base alle esigenze specifiche.

#### Ulteriori informazioni
<a name="customer-information-learn-more"></a>
+ [Definizione di profilo standard](standard-profile-definition.md)
+ Coppia chiave-valore

## Attributo calcolato
<a name="calculated-attribute"></a>

Il widget Attributo calcolato consente di visualizzare un componente di metriche chiave utilizzando i dati degli attributi calcolati dei profili cliente.

### Panoramica di
<a name="calculated-attribute-overview"></a>

Il widget Attributo calcolato consente di visualizzare un componente di metriche chiave utilizzando i dati degli attributi calcolati dei profili cliente.

### Funzionalità del componente
<a name="component-features"></a>
+ Visualizza le metriche calcolate come indicatori a valore singolo

### I casi d’uso di esempio potrebbero essere
<a name="example-use-cases"></a>
+ Campagne consegnate
+ Casi riaperti
+ Tempo medio di chiamata
+ Preferenze di canale

### Configurazione
<a name="configuration"></a>

Basta selezionare l’attributo calcolato e scegliere il formato di visualizzazione preferito

**Nota**  
Gli attributi calcolati devono essere configurati nel dominio Profili dei clienti prima di poter essere utilizzati in questo widget.

**Ulteriori informazioni**
+ Metrica chiave
+ [Impostazione degli attributi calcolati](customerprofiles-calculated-attributes-admin-website.md)

## Contatti
<a name="contacts"></a>

Creato utilizzando il componente Tabella JSON, il widget Contatti mostra i dati degli oggetti di contatto dei Profilo dei clienti in un formato tabulare organizzato. Questo widget si connette automaticamente ai dati CTR dei profili dei clienti, mostrando le informazioni di contatto chiave e la cronologia delle interazioni.

### Funzionalità
<a name="contacts-features"></a>
+ Visualizza tutti gli eventi di contatto con i clienti
+ Ordina e filtra i record dei contatti
+ Personalizza i campi di contatto visualizzati
+ Permette di accedere a informazioni di contatto dettagliate

Per ulteriori informazioni sugli oggetti CTR dei Profili dei clienti, consulta [Modelli di record di contatto in Amazon Connect Customer Profiles](ctr-contact-record-template.md).

## Casi
<a name="cases-cp"></a>

Creato utilizzando il componente Tabella JSON, il widget Casi mostra i dati degli oggetti del caso Profili dei clienti in un formato tabulare organizzato. Questo widget si collega automaticamente ai dati del caso Profili dei clienti, mostrando le interazioni di supporto e i dettagli sulla gestione dei casi.

### Funzionalità
<a name="cases-features"></a>
+ Visualizza tutti i casi dei clienti
+ Ordina e filtra i record dei casi
+ Personalizza i campi dei casi visualizzati
+ Accedi a informazioni dettagliate sul caso

Per ulteriori informazioni sugli oggetti del caso dei Profili dei clienti, consulta [Mappatura del tipo di oggetto per il caso standard in Profili dei clienti](object-type-mapping-standard-case.md).

## Ordini
<a name="orders-cp"></a>

Creato utilizzando il componente Tabella JSON, il widget Ordini mostra i dati dell’oggetto dell’ordine dei Profili dei clienti in un formato tabulare organizzato. Questo widget si collega automaticamente ai dati degli Ordini dei Profili dei clienti, mostrando la cronologia degli acquisti e i dettagli delle transazioni.

### Funzionalità
<a name="orders-features"></a>
+ Visualizza tutti gli eventi relativi agli ordini dei clienti
+ Ordina e filtra i record degli ordini
+ Personalizza i campi dell’ordine visualizzati
+ Accedi a informazioni dettagliate sull’ordine

Per ulteriori informazioni sugli oggetti Ordine dei Profili dei clienti, consulta [La mappatura del tipo di oggetto all’ordine standard in Amazon Connect Customer Profiles](object-type-mapping-standard-order.md).

## Asset
<a name="assets-cp"></a>

Creato utilizzando il componente Tabella JSON, il widget Asset mostra i dati degli oggetti dell’asset Profili dei clienti in un formato tabulare organizzato. Questo widget si collega automaticamente ai dati dell’Asset dei Profili dei clienti, mostrando prodotti e servizi di proprietà del cliente.

### Funzionalità
<a name="assets-features"></a>
+ Visualizza tutti i record relativi agli asset dei clienti
+ Ordina e filtra i dati degli asset
+ Personalizza i campi degli asset visualizzati
+ Permette di accedere a informazioni dettagliate sugli asset

Per ulteriori informazioni sugli Asset dei Profili dei clienti, consulta [Mappatura del tipo di oggetto per l’asset standard Profili dei clienti](object-type-mapping-standard-asset.md).

# Widget personalizzati
<a name="custom-widgets"></a>

Crea da zero componenti della dashboard personalizzati per soddisfare esigenze aziendali specifiche. I widget personalizzati consentono di creare visualizzazioni uniche senza dati predefiniti.

![\[Aggiungi i widget dei clienti nel layout dell’Esploratore di profili.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/custom-widgets-1.png)


## Componenti personalizzati disponibili
<a name="available-custom-components"></a>
+ [Tabella](#table-widget)
+ [Coppia chiave-valore](#key-value-pair)
+ [Metrica chiave](#key-metric)
+ [Grafico ad anello](#donut-chart)

## Creazione di widget personalizzati
<a name="building-custom-widgets"></a>

**Ogni widget personalizzato può essere configurato con:**
+ Origini dati personalizzate
+ Display personalizzati
+ Campi personalizzati
+ Interazioni con gli elementi personalizzate

## Tabella
<a name="table-widget"></a>

Il componente tabella personalizzata offre opzioni di configurazione flessibili per la visualizzazione dei dati in formato tabulare, con funzionalità avanzate per l’interazione e l’organizzazione.

### Funzionalità
<a name="table-features"></a>

1. **Configurazioni delle colonne**
   + Definisci le intestazioni di colonna personalizzate
   + Specifica i dati per ogni colonna
   + Imposta le opzioni di formattazione dei dati
   + Definisci il posizionamento delle colonne

1. **Filtraggio**
   + Filtra rapidamente gli elementi all’interno della tabella

1. **Collegamento**
   + Connetti i link alle risorse
     + Navigazione senza interruzioni verso:
       + Segmenti
       + Attributi calcolati
     + Si apre in una nuova scheda
   + **Link agli URL esterni**
     + Converti il valore dell'elemento di riga in URLs quello che puoi scegliere
     + Si apre in una nuova scheda
     + Genera dinamicamente collegamenti in base ai dati delle righe
   + Link alla visualizzazione del cassetto
     + Apri le informazioni dettagliate in un cassetto laterale
     + Visualizza i dettagli completi del record senza uscire dalla pagina

1. Organizzazione dei dati
   + Raggruppamento
     + Raggruppa le righe in base a nomi di campo specifici
     + Impostazioni di gruppo persistenti
   + Ordinamento
     + Ordina in base a qualsiasi campo di colonna
     + Organizzazione in ordine crescente
     + Impostazioni di ordinamento persistenti

**Figura 1**

![\[Esempio di modifica di widget di tabella personalizzati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/table-features-1.png)


**Figura 2**

![\[Un altro esempio di modifica di widget di tabella personalizzati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/table-features-2.png)


### Configurazione di esempio
<a name="table-example-configuration"></a>

```
{
    "Type": "Table",
    "Props": {
        "ColumnDefinitions": [
            {
                "Header": "Table column header"
                "Cell": {
                    "Content": {
                        "Props": {
                            "Variant": "Link",
                            "LinkOptions": {
                                "LinkType": "Drawer"
                            }
                        },
                        "Type": "TextContent",
                        "Children": ["string"]
                    }
                },
            }
        ]
    }
}
```

## Coppia chiave-valore
<a name="key-value-pair"></a>

Il componente Coppia chiave-valore consente di creare visualizzazioni organizzate di punti dati correlati in un formato flessibile e leggibile.

### Panoramica di
<a name="key-value-pair-overview"></a>

Crea visualizzazioni dinamiche dei dati definendo relazioni chiave-valore personalizzate. Questo componente è particolarmente utile per mostrare coppie di attributi come:
+ Dettagli del cliente
+ Informazioni sull’account

### Funzionalità
<a name="key-value-pair-features"></a>

1. **Opzioni di link interattivi**
   + Connetti i link alle risorse
     + Link diretto alle risorse correlate
     + Navigazione senza interruzioni verso:
       + Attributi calcolati
       + Segmenti
     + Si apre in una nuova scheda
   + Link agli URL esterni
     + Converti il valore dell'articolo in URLs quello che puoi scegliere
     + Si apre in una nuova scheda
   + Link alla visualizzazione del cassetto
     + Apri le informazioni dettagliate in un cassetto laterale
     + Visualizza i dettagli completi senza uscire dalla pagina

1. Configurazione della colonna
   + Definizione di 1-4 colonne di coppie chiave-valore

1. Organizza le coppie in raggruppamenti logici

**Figura 1**

![\[Esempio di modifica di widget personalizzati per coppie chiave-valore.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/key-value-pair-features-1.png)


**Figura 2**

![\[Un altro esempio di modifica di widget con coppie chiave-valore personalizzate.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/key-value-pair-features-2.png)


### Configurazione di esempio
<a name="key-value-pair-example-configuration"></a>

```
{
    "Type": "KeyValuePair",
    "Id": "UniqueId",
    "Props": {
        "Columns": 2,
        "Items": [
            {
                "Label": {
                    "Content": {
                        "Type": "TextContent",
                        "Id": "UniqueId",
                        "Props": {
                            "FontWeight": "bold"
                        },
                        "Children": ["Profile id"]
                    }
                },
                "Value": {
                    "Content": {
                        "Type": "TextContent",
                        "Id": "UniqueId",
                        "Props": {},
                        "Children": ["[string]"]
                    }
                }
            }
        ]
    }
}
```

**Nota**  
Questo componente attualmente non supporta `ProfileObjects` nel generatore di interfacce utente.

## Metrica chiave
<a name="key-metric"></a>

Il componente Key Metric consente di visualizzare in modo visibile le metriche aziendali critiche e le statistiche vitali in un formato facilmente comprensibile. KPIs

### Panoramica di
<a name="key-metric-overview"></a>

Crea display metrici ad alta visibilità che evidenziano punti dati, tendenze o indicatori di stato importanti. Questo componente è ideale per mostrare:
+ Indicatori delle prestazioni
+ Misurazioni critiche
+ Riepiloghi dello stato
+ Indicatori di tendenza

### Funzionalità
<a name="key-metric-features"></a>

1. **Testo sul display di grandi dimensioni**

1. **Formato metrico**

1. **Opzioni di link interattivi**
   + Connetti i link alle risorse
     + Link diretto alle risorse correlate
     + Navigazione senza interruzioni verso:
       + Attributi calcolati
       + Segmenti
     + Si apre in una nuova scheda
   + Link agli URL esterni
     + Converti il valore dell'articolo in URLs quello che puoi scegliere
     + Si apre in una nuova scheda
   + Link alla visualizzazione del cassetto
     + Apri le informazioni dettagliate in un cassetto laterale
     + Visualizza i dettagli completi senza uscire dalla pagina

1. **Organizza il layout delle metriche**

**Figura 1**

![\[Esempio di modifica di widget con metriche chiave personalizzate.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/key-metric-features-1.png)


**Figura 2**

![\[Un altro esempio di modifica di widget con metriche chiave personalizzate.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/key-metric-features-2.png)


### Configurazione di esempio
<a name="key-metric-example-configuration"></a>

```
{
    "Type": "KeyMetrics",
    "Props": {
        "MetricDefinitions": [
            {
                "MetricLabel": "Total Revenue",
                "MetricValue": {
                    "Content": {
                        "Type": "TextContent",
                        "Props": {
                            "Format": "USD",
                            "FontSize": "large",
                            "FontWeight": "bold"
                        },
                        "Children": ["[string]"]
                    }
                },
                "Columns": 1
            }
        ]
    }
}
```

**Nota**  
Questo componente attualmente non supporta `ProfileObjects` nel generatore di interfacce utente.

## Grafico ad anello
<a name="donut-chart"></a>

Il componente Grafico ad anello consente la visualizzazione del punteggio della valutazione attraverso un grafico circolare ad anello.

### Panoramica di
<a name="donut-chart-overview"></a>

Crea visualizzazioni dinamiche della valutazione definendo criteri di punteggio personalizzati. Questo componente è particolarmente utile per mostrare:
+ Parametri di riuscita
+ Percentuali di successo
+ Valutazioni del rischio
+ Indicatori delle prestazioni

### Funzionalità
<a name="donut-chart-features"></a>

1. Opzioni di analisi della valutazione
   + Sentiment positivo
     + Inizia da zero
     + Monitora i risultati in base a criteri:
       + Valori in punti personalizzati
       + Segmenti con codice a colori
       + Grigio per condizioni non soddisfatte
     + Mostra la percentuale di successo
   + Sentiment negativo
     + Inizia dal valore massimo
     + Tiene traccia delle deduzioni:
       + Segmenti con codice a colori
       + Sistema di riduzione dei punti
       + Verde per il valore residuo
     + Mostra il punteggio finale

1. Nome attributo calcolato

1. Opzioni dell’operatore
   + Equal to
   + Not Equal to
   + Greater Than
   + Less Than

1. Valore della condizione

1. Punti assegnati per condizione

**Figura 1: esempio di valutazione positiva**

![\[Esempio di modifica del widget Valutazione positiva.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/donut-chart-features-1.png)


**Figura 2: esempio di valutazione negativa**

![\[Esempio di modifica del widget Valutazione negativa.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/donut-chart-features-2.png)


### Configurazione di esempio
<a name="donut-chart-example-configuration"></a>

```
{
    "Type": "DonutChart",
    "Props": {
        "Variant": "PositiveSentiment",
        "ConditionDefinitions": [
            {
                "Title": "Customer Satisfaction",
                "Color": "#4CAF50",
                "CalculatedAttribute": "satisfaction_score",
                "Operator": "GREATER_THAN",
                "ValueCondition": 8,
                "Points": 10
            }
        ]
    }
}
```

**Nota**  
**Al momento, i grafici ad anello supportano solo gli attributi calcolati come origine dati**.
**Tutte le definizioni delle condizioni devono includere un titolo, un colore, un attributo calcolato, un operatore, una condizione di valore e un valore in punti**.