|
A partire da gennaio 2021, i tipi di file classici non potranno più essere utilizzati. È possibile effettuare la transizione dei file classici o scaricare un PDF. Ulteriori informazioni

Centro assistenza di Workiva

Gestire i parametri delle query

Gestire i parametri delle query

  • Ultimo aggiornamento
<!-- display page content -->

Con i parametri, puoi richiedere i valori da utilizzare con i filtri o i calcoli di una query ogni volta che viene eseguita. Impostando questi valori in fase di esecuzione, puoi utilizzare una query in un contesto diverso, come ad esempio un account, una regione o un periodo di tempo, ogni volta che viene eseguita.

Puoi creare parametri personalizzati da utilizzare con una query specifica oppure il proprietario dell'area di lavoro può creare parametri globali da utilizzare con più query.

Creare parametri personalizzati per una query

Puoi impostare i parametri di una query sia nel Builder che nell'Editor SQL. Quando crei un parametro, puoi utilizzarlo con più filtri e calcoli nella query. 

Passo 1. Creare il parametro

  1. Dal pannello Parameters , clicca su Add, e seleziona Create New Parameter.
     manage-query-parameters_04.png
    2. <!--
  2. From the Parameters panel, click Create Parameter.
    manage-query-parameters_01.png
    3. -->
  3. Per facilitare l'identificazione del parametro, inserisci un nome univoco con soli caratteri alfanumerici e senza spazi.
  4. In Tipo di filtro, seleziona il tipo di dati da filtrare, ad esempio Testo o Integro.

Passo 2. Imposta i valori del parametro

Quando una query viene eseguita, i suoi parametri possono accettare valori liberi in base al tipo di dati o fornire un elenco di valori specifici tra cui scegliere. 

  • Per accettare qualsiasi valore libero, inserisci il valore predefinito (se applicabile) e clicca su Crea.
  • Per fornire un elenco di valori specifici:
  1. Abilita Picklist.
  2. Per abilitare più valori per il parametro, seleziona la casella Multi-Select .
  3. In Elenco Opzioni, inserisci i valori da scegliere, premendo Invio dopo ciascuno di essi.
    Nota: Per un parametro di data o ora, inserisci ogni opzione nel formato YYYY-MM-dd.
  4. Seleziona un valore predefinito per il parametro e clicca su Accetta.2023-11-27_16-14-21.png
    Nota: Per un parametro multi-selezione, seleziona almeno un valore predefinito.
  5. Clicca su Crea per terminare.

Passo 3. Usa il parametro nella query

Per applicare il valore del parametro alla query, usalo in un filtro o in un calcolo:


Utilizzare i parametri globali in una query

Il proprietario dell'area di lavoro può configurare i parametri globali per i valori comuni utilizzati in più query. Per utilizzare i parametri globali in una query:

  1. Dal pannello Parameters , clicca su Add, e seleziona Select Global Parameter.
    manage-query-parameters_04.png
  2. Seleziona i parametri globali da utilizzare nella query e clicca su Aggiungi.
  3. Per modificare il parametro globale, selezionalo e aggiorna il suo nome o il suo valore come necessario per la query.
    Nota: Per garantire un'analisi coerente, il proprietario dell'area di lavoro può bloccare un parametro globale per evitare che il suo valore venga modificato.

  4. Per applicare il valore di un parametro globale alla query, usalo in un filtro o in un calcolo:

Modifica un parametro della query

Per modificare o gestire i dettagli di un parametro:

  1. Dal pannello Parametri, seleziona il parametro da modificare.
  2. Modifica il nome, il tipo di dati o i valori del parametro come necessario.
  3. Fai clic su Applica.

Rimuovere un parametro della query

Se non hai più bisogno di un parametro, puoi rimuoverlo dalla query. Dal pannello Parametri, clicca su Elimina , e clicca su Salva .

<!-- display page content --> Con i parametri, puoi richiedere i valori da utilizzare con i filtri o i calcoli di u...