

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à.

# Connessione ai parametri in Amazon Quick
<a name="parameters-connections"></a>

Utilizza questa sezione dopo aver configurato un parametro per collegarlo e poterlo usare correttamente. 

Dopo aver creato un parametro, puoi creare i consumatori dei parametri. I *consumatori dei parametri* sono componenti che utilizzano il valore di un parametro, ad esempio filtri, controlli, campi calcolati o operazioni personalizzate. 

Puoi spostarti tra queste opzioni in un altro modo, come segue:
+ Per creare un filtro, scegli l'icona **Filtro** nella parte superiore della pagina. In breve, crei un **Custom Filter (Filtro personalizzato)** e abiliti **Use parameters (Utilizza parametri)**. L'elenco mostra solo i parametri idonei.
+ Per aggiungere un nuovo controllo per il parametro, scegli l'icona **Parametri** nella parte superiore della pagina. In breve, scegli il parametro e quindi **Add Control (Aggiungi controllo)**. 
+ Per utilizzare un parametro in un campo calcolato, modifica un campo calcolato esistente o aggiungine uno nuovo selezionando **Add (Aggiungi)** nella parte superiore sinistra. L'elenco di parametri viene visualizzato sotto l'elenco dei campi.
**Nota**  
Non puoi utilizzare i parametri multivalore con i campi calcolati.
+ Per creare un'operazione URL, scegli il menu a forma di **v** in un elemento visivo, quindi scegli **URL Actions (Operazioni URL)**.

Per ulteriori informazioni su questi argomenti, consulta le seguenti sezioni. 

**Topics**
+ [Utilizzo di filtri con i parametri](parameters-filtering-by.md)
+ [Utilizzo dei campi calcolati con i parametri](parameters-calculated-fields.md)
+ [Utilizzo di operazioni personalizzate con i parametri](parameters-custom-actions.md)
+ [Parametri in URLs](parameters-in-a-url.md)
+ [Parametri nei titoli e nelle descrizioni](parameters-in-titles.md)

# Utilizzo di filtri con parametri in Amazon Quick
<a name="parameters-filtering-by"></a>

Utilizza questa sezione per filtrare i dati in un'analisi o in un pannello di controllo in base a un parametro a valore singolo. Per utilizzare un parametro multivalore, uno con un controllo a discesa a selezione multipla, crea un filtro personalizzato uguale (o diverso) ai valori. 

Prima di utilizzare un filtro con un parametro, devi conoscere già come usare i filtri. 

1. Verificare che l'analisi includa un parametro già creato. Scegli **Modifica** dal parametro o dal menu del controllo per individuare le impostazioni utilizzate.

1. Scegli il riquadro **Filter (Filtro)** sul lato sinistro della schermata. Se esiste già un filtro per il campo che si desidera utilizzare, sceglierlo per visualizzare le relative impostazioni. In caso contrario, creare un filtro per il campo che si desidera filtrare in base al parametro.

1. Scegli **Use Parameters (Utilizza parametri)**.

1. Scegliere i parametri dall'elenco o dagli elenchi disponibili sotto l'opzione **Use Parameters (Usa parametri)**. Per i campi di testo (stringa), scegliere **Custom Filter (Filtro personalizzato)**, quindi abilitare **Use Parameters (Usa parametri)**.

   Per i campi data, scegliere i parametri **Start date (Data inizio)** e **End date (Data fine)**, come illustrato nella figura seguente. 

   Per i campi con altri tipi di dati, scegliere **Select a parameter (Seleziona un parametro)** e quindi scegliere il parametro dall'elenco. 
**Nota**  
Parametri che possono contenere più valori devono utilizzare "uguale" o "non uguale" come tipo di confronto.

1. Scegliere **Applica** per salvare le modifiche.

A questo punto, devi eseguire il test del nuovo filtro scegliendo il controllo accanto alla parte superiore dell'analisi. In questo esempio, vengono utilizzati un parametro di base che non dispone di valori predefiniti e un controllo dinamico collegato al campo **Regione** nel set di dati di esempio denominato **Pipeline vendite**. Il controllo esegue la query sui dati e restituisce tutti i valori. 

Se cancelli o crei di nuovo un parametro utilizzato in un filtro, puoi aggiornare il filtro in base al nuovo parametro. Per eseguire questa operazione, apri il filtro, scegli il nuovo parametro da utilizzare e quindi scegli **Apply (Applica)**.

Se rinomini un parametro, non devi aggiornare il filtro o qualsiasi altro consumatore.

# Utilizzo di campi calcolati con parametri in Amazon Quick
<a name="parameters-calculated-fields"></a>

Puoi passare il valore di un parametro a un campo calcolato in un'analisi. Quando crei un calcolo, puoi scegliere i parametri esistenti dall'elenco di parametri disponibili in **Parameter list (Elenco parametri)**. Non è possibile creare un campo calcolato che contiene un parametro multivalore, ovvero quelli con un controllo a discesa multiselezione.

Per la formula, puoi utilizzare una delle funzioni disponibili. È possibile passare la selezione del visualizzatore dal controllo dei parametri alla funzione `ifElse`. In cambio, ottieni un parametro. Di seguito viene riportato un esempio. 

```
ifelse(

${KPIMetric} = 'Sales',sum({Weighted Revenue}),

${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),

${KPIMetric} = '# Active', distinct_count(ActiveItem),

NULL

)
```

L'esempio precedente crea un parametro (un valore decimale) che puoi utilizzare in un contenitore di campi. Quando un utente sceglie un valore dal controllo parametro, gli elementi visivi visualizzati vengono aggiornati in base alla selezione.

# Utilizzo di azioni personalizzate con parametri in Amazon Quick
<a name="parameters-custom-actions"></a>

Un'*azione personalizzata* ti consente di avviare URLs o filtrare immagini selezionando un punto dati in una visuale o scegliendo il nome dell'azione dal menu contestuale. Quando utilizzi un'operazione URL con un parametro, puoi passare o inviare i parametri all'URL in modo dinamico. Per farlo, imposta un parametro e utilizzalo nell'URL quando crei un'operazione personalizzata di tipo **URL**. I parametri in corrispondenza del punto di invio e ricezione devono corrispondere a livello di nome e tipo di dati. Tutti i parametri sono compatibili con le operazioni URL.

Per dettagli sulla creazione di un'operazione URL, consulta [Creazione e modifica di azioni personalizzate in Amazon Quick Sight](custom-actions.md). Per utilizzare un parametro solo in un collegamento senza creare un'operazione URL, consulta [Utilizzo di parametri in un URL](parameters-in-a-url.md).

# Utilizzo di parametri in un URL
<a name="parameters-in-a-url"></a>

Puoi utilizzare il nome e il valore di un parametro in un URL in Amazon Quick per impostare un valore predefinito per quel parametro in una dashboard o in un'analisi. 

L'esempio seguente mostra l'URL di un pannello di controllo che consente di impostare un parametro per un altro pannello di controllo.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```

Nell'esempio precedente la prima parte corrisponde al collegamento al pannello di controllo di destinazione: `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`. Il carattere di cancelletto (`#)` segue la prima parte per introdurre i *segmenti* contenenti i valori da impostare.

I valori nei frammenti non vengono ricevuti o registrati dai AWS server. Questa funzionalità garantisce la sicurezza dei valori dei dati.

Il segmento successivo a `#` è conforme alle seguenti regole: 
+ I parametri sono preceduti dal prefisso `p.`. I nomi sono il nome del parametro, non il nome del controllo. Per visualizzare il nome del parametro, apri l'analisi e scegli **Parameter (Parametro)** sulla barra laterale sinistra.
+ Il valore viene impostato utilizzando l'operatore "uguale" (`=`). Si applicano le regole seguenti:
  + I valori letterali non utilizzano virgolette. 
  + Gli spazi all'interno dei valori vengono automaticamente codificati dal browser, quindi non è necessario utilizzare i caratteri di escape quando si crea manualmente un URL. 
  + Per restituire tutti i valori, impostare il parametro come uguale a `"[ALL]"`.
  + Per assegnare il valore del parametro a `null`, impostalo uguale a `%00`. Ad esempio, `p.population=%00`.
  + Nelle operazioni personalizzate, i nomi dei parametri di destinazione iniziano con `$`, ad esempio: `<<$passThroughParameter>>`
  + Nelle operazioni personalizzate i valori dei parametri sono visualizzati in parentesi angolari `<< >>`, ad esempio `<<dashboardParameter1>>`. Gli utenti del pannello di controllo visualizzano il valore di ricerca, non la variabile. 
+ Per un'operazione URL personalizzata, i parametri multivalore hanno solo bisogno di un'istanza dello stesso parametro nel frammento, ad esempio: `p.city=<<$city>>`
+ Per un URL diretto, più valori per un singolo parametro dispongono di due istanze dello stesso parametro nel frammento. Per un esempio, osserva quanto segue.
+ Il carattere "e commerciale" (`&`) separa più parametri. Per un esempio, osserva quanto segue.

Il server converte la data in formato UTC e la invia al back-end come stringa senza un fuso orario. Per usare date in formato UTC (Universal Coordinated Time), devi escludere il fuso orario. Di seguito, sono riportati alcuni esempi di formati di data funzionanti: 
+ `2017-05-29T00%3A00%3A00` 
+ `2018-04-04 14:51 -08:00`
+ `Wed Apr 04 2018 22:51 GMT+0000`

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

Nel browser questo codice viene convertito nel modo seguente.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

L'esempio precedente imposta quattro parametri:
+ `shipDate` è un parametro di tipo data: `Sept 30, 2018`.
+ `city` è un parametro stringa multivalore: `New York` e `Seattle`
+ `teamMember` è un parametro di tipo numero intero: `12`.
+ `percentageRank` è un parametro di tipo numero decimale: `2.3`

L'esempio seguente mostra come impostare i valori per un parametro che accetti più valori.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA
```

Utilizza le operazioni URL personalizzate per passare i valori da un pannello di controllo (o da un'analisi) a un altro pannello di controllo in base alla selezione del punto dati dell'utente. Se lo desideri, puoi anche generarli URLs manualmente e utilizzarli per condividere una visualizzazione specifica dei dati.

Per informazioni sulla creazione di operazioni personalizzate, consulta [Utilizzo di operazioni personalizzate per il filtraggio e la navigazione](quicksight-actions.md).

# Utilizzo dei parametri nei titoli e nelle descrizioni in Amazon Quick
<a name="parameters-in-titles"></a>

Quando crei parametri in Amazon Quick, puoi utilizzarli nei titoli e nelle descrizioni dei grafici e delle analisi per visualizzare dinamicamente i valori dei parametri. 

Puoi utilizzare i parametri nelle seguenti aree dell'analisi:
+ Titoli e sottotitoli dei grafici
+ Titoli degli assi
+ Titoli delle legende
+ Titoli dei controlli dei parametri
+ Titoli e descrizioni dei fogli

L'immagine seguente mostra un titolo del grafico che utilizza un parametro.

![\[Immagine del riquadro Formatta elemento visivo con un parametro nel titolo del grafico e un grafico con il valore del parametro nel titolo cerchiato in rosso.\]](http://docs.aws.amazon.com/it_it/quick/latest/userguide/images/parameters-in-titles-labels2.png)


Completa le seguenti procedure per scoprire come aggiungere parametri alle aree durante l'analisi. Per ulteriori informazioni sui parametri e su come crearli, consulta [Parameters](parameters-in-quicksight.md).

## Aggiunta di parametri ai titoli e ai sottotitoli dei grafici
<a name="parameters-in-titles-chart-titles"></a>

Completa la seguente procedura per scoprire come aggiungere parametri ai titoli e ai sottotitoli dei grafici.

**Aggiunta di un parametro al titolo o al sottotitolo di un grafico**

1. Apri il riquadro **Proprietà** per l'elemento visivo che desideri formattare.

1. Nel riquadro **Proprietà**, scegli la scheda **Titolo**.

1. Seleziona **Mostra titolo** o **Mostra sottotitolo**. Queste opzioni potrebbero essere già selezionate.

1. Scegli i tre punti a destra di **Modifica titolo** o **Modifica sottotitolo**, quindi scegli un parametro dall'elenco.

   Il parametro viene aggiunto al titolo nel riquadro **Proprietà**. Nel grafico, il valore del parametro viene visualizzato nel titolo.

   Per ulteriori informazioni sulla modifica di titoli e sottotitoli negli elementi visivi, consulta [Titoli e sottotitoli per tipi di immagini in Quick](customizing-a-visual-title.md).

## Aggiunta di parametri ai titoli degli assi
<a name="parameters-in-titles-axis-titles"></a>

Completa la seguente procedura per scoprire come aggiungere parametri ai titoli degli assi.

**Aggiunta di un parametro al titolo di un asse**

1. Apri il riquadro **Proprietà** per l'elemento visivo che desideri formattare.

1. Nel riquadro **Proprietà**, scegli l'asse che desideri formattare.

1. Seleziona **Mostra titolo**.

1. Scegli i tre punti alla destra del titolo dell'asse predefinito, quindi scegli un parametro dall'elenco.

   Il parametro viene aggiunto al titolo dell'asse nel riquadro **Proprietà**. Nel grafico, il valore del parametro viene visualizzato nel titolo dell'asse.

   Per ulteriori informazioni sulla modifica dei titoli sugli assi, consulta [Assi e linee della griglia](showing-hiding-axis-grid-tick.md).

## Aggiunta di parametri ai titoli delle legende
<a name="parameters-in-titles-legend-titles"></a>

Completa la seguente procedura per scoprire come aggiungere parametri ai titoli delle legende.

**Aggiunta di un parametro al titolo di una legenda**

1. Apri il riquadro **Proprietà** per l'elemento visivo che desideri formattare.

1. Nel riquadro **Proprietà**, scegli **Legenda**.

1. Seleziona **Mostra titolo della legenda**.

1. Scegli i tre punti alla destra di **Titolo della legenda**, quindi scegli un parametro dall'elenco.

   Il parametro viene aggiunto al titolo della legenda nel riquadro **Proprietà**. Nel grafico, il valore del parametro viene visualizzato nel titolo della legenda.

   Per maggiori informazioni sulle legende di formattazione, consulta [Legende sui tipi visivi in Quick](customizing-visual-legend.md).

## Aggiunta di parametri ai titoli dei controlli
<a name="parameters-in-titles-control-titles"></a>

Completa la seguente procedura per scoprire come aggiungere parametri ai titoli dei controlli dei parametri.

**Aggiunta di un parametro a un titolo di controllo dei parametri**

1. Seleziona il controllo dei parametri da modificare, scegli i tre punti a destra del titolo, quindi scegli **Modifica**.

1. Nella pagina **Modifica controllo** che si apre, seleziona **Mostra titolo**.

1. Scegli i tre punti alla destra di **Nome visualizzato**, quindi scegli un parametro dall'elenco.

   Il parametro viene aggiunto al titolo del controllo del parametro.

   Per ulteriori informazioni sull'uso dei controlli dei parametri, consulta [Controlli parametro](parameters-controls.md).

## Aggiunta di parametri ai titoli e alle descrizioni dei fogli
<a name="parameters-in-titles-sheet-titles"></a>

Utilizza la procedura seguente per scoprire come aggiungere parametri ai titoli e alle descrizioni dei fogli nelle tue analisi.

**Aggiunta di un parametro al titolo o alla descrizione di un foglio**

1. Nella pagina dell'analisi scegli **Fogli** nella barra delle applicazioni, quindi scegli **Aggiungi titolo** o **Aggiungi descrizione**.

   Sul foglio viene visualizzato il titolo o la descrizione del foglio.

1. Per **Titolo del foglio** o **Descrizione**, scegli i tre punti a destra, quindi scegli un parametro dall'elenco.

   Il parametro viene aggiunto al titolo o alla descrizione del foglio e il valore del parametro viene visualizzato nel testo quando chiudi la casella di testo.

   Per ulteriori informazioni sull'aggiunta di titoli e descrizioni dei fogli, consulta [Aggiunta di un titolo e una descrizione a un'analisi](adding-a-title-and-description.md).