Parametri della dashboard LookML

Le dashboard possono essere create in due modi. Le dashboard definite dall'utente vengono create utilizzando la UI di Looker e sono descritte nella pagina della documentazione Creazione di dashboard definite dall'utente. Le dashboard possono anche essere create utilizzando LookML e le loro impostazioni generali modificate come descritto in questa pagina.

Questa pagina descrive i parametri della dashboard LookML che interessano l'intera dashboard.

Una dashboard LookML contiene anche elementi, ovvero le visualizzazioni di dati, i riquadri di testo e i pulsanti della dashboard. Consulta la pagina Parametri degli elementi della dashboard per i link alle pagine di riferimento per ogni tipo di elemento.

Esempio di utilizzo

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter | string_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations

Definizioni dei parametri

Nome parametro	Descrizione
dashboard	Crea una dashboard.
preferred_viewer	Questo parametro viene ignorato.
title (per la dashboard)	Modificare la modalità di visualizzazione del nome di una dashboard per gli utenti.
description (per la dashboard)	Aggiungi una descrizione che può essere visualizzata nel riquadro Dettagli dashboard o in una cartella impostata sulla visualizzazione elenco.
enable_viz_full_screen	Definisci se gli spettatori della dashboard possono visualizzare i riquadri della dashboard nelle visualizzazioni a schermo intero ed espanse.
extends	Basare la dashboard LookML su un'altra dashboard LookML.
extension	Richiedere che la dashboard venga estesa da un'altra dashboard.
layout	Definisci il modo in cui la dashboard posizionerà gli elementi.
rows	Inizia una sezione di LookML per definire gli elementi che devono essere inseriti in ogni riga di una dashboard layout: grid.
elements (per le righe)	Definisci gli elementi che devono essere inseriti in una riga di una dashboard layout: grid.
height (per le righe)	Definisci l'altezza di una riga per un layout: grid dashboard.
tile_size	Definisci le dimensioni di un riquadro per un dashboard layout: tile.
width (per la dashboard)	Definisci la larghezza della dashboard per una dashboard layout: static.
refresh (per la dashboard)	Imposta l'intervallo in cui gli elementi della dashboard verranno aggiornati automaticamente.
auto_run	Determina se i prospetti vengono eseguiti automaticamente quando vengono aperti o ricaricati inizialmente.
Parametri di filtro
crossfilter_enabled	Attiva o disattiva i filtri incrociati per una dashboard.
filters_bar_collapsed	Aggiunto nella versione 21.16 Imposta la barra dei filtri della dashboard come compressa o espansa predefinita per una dashboard.
filters_location_top	Aggiunto il 22.8 Imposta la posizione della barra dei filtri della dashboard come in alto o a destra per una dashboard.
filters (per la dashboard)	Inizia una sezione di LookML per definire i filtri della dashboard.
name (per i filtri)	Crea un filtro.
title (per i filtri)	Modificare il modo in cui il nome di un filtro viene visualizzato dagli utenti.
type (per i filtri)	Determina il tipo di filtro da utilizzare.
default_value	Imposta un valore predefinito per un filtro.
allow_multiple_values	Limitare gli utenti a un singolo valore del filtro.
required	Richiedi agli utenti di inserire un valore di filtro per eseguire la dashboard.
ui_config	Configura i controlli dei filtri disponibili quando gli utenti visualizzano una dashboard LookML. Ha i sottoparametri type, display e options.
model (per i filtri)	Specifica il modello che contiene il campo sottostante di un filtro type: field_filter.
explore (per i filtri)	Specifica l'esplorazione che contiene il campo sottostante di un filtro type: field_filter.
field	Specifica il campo sottostante di un filtro type: field_filter.
listens_to_filters	Restringi i suggerimenti per i filtri della dashboard di field_filter in base a ciò che l'utente inserisce per un altro filtro della dashboard di type: field_filter.
Parametri della dashboard incorporata
embed_style	Inizia una sezione di LookML per definire le personalizzazioni della dashboard incorporata.
background_color	Imposta un colore di sfondo di una dashboard incorporata.
show_title	Specifica se il titolo della dashboard è visibile in una dashboard incorporata.
title_color	Imposta il colore del titolo di una dashboard incorporata.
show_filters_bar	Specifica se la barra dei filtri è visibile in una dashboard incorporata.
tile_background_color	Imposta il colore di sfondo del riquadro di una dashboard incorporata.
tile_text_color	Imposta il colore del testo dei riquadri di una dashboard incorporata.
Parametri elemento
elements (per la dashboard)	Inizia una sezione di LookML per definire gli elementi della dashboard.

dashboard

Il parametro dashboard dichiara una nuova dashboard e specifica un nome per la dashboard. Il numero massimo di caratteri è 255; i caratteri consentiti sono lettere (A-Z), numeri (0-9), trattini (-) e trattini bassi (_). In genere, la best practice prevede di inserire ogni dashboard LookML nel proprio file LookML, ma è possibile dichiarare più dashboard in un unico file.

- dashboard: sales_overview

Per visualizzare qualsiasi elemento, è necessario aggiungere almeno un elemento a una dashboard utilizzando il parametro elements.

Nota :se modifichi il valore del parametro dashboard di una dashboard LookML per una dashboard che è stata spostata dalla cartella Dashboard LookML, la dashboard LookML verrà spostata automaticamente di nuovo nella cartella Dashboard LookML.

preferred_viewer

Importante: questo parametro viene ignorato.

Prima del ritiro delle dashboard legacy in Looker 23.6, il parametro preferred_viewer ti consentiva di scegliere il formato per la visualizzazione e il download di una dashboard come esperienza dashboard predefinita di Looker o come dashboard legacy.

title (per la dashboard)

Questa sezione si riferisce al parametro title che fa parte di una dashboard.

title può essere utilizzato anche nell'ambito di un filtro della dashboard, come descritto nella sezione title (per i filtri) di questa pagina.

title può essere utilizzato anche come parte di qualsiasi elemento del dashboard. Un esempio rappresentativo del suo utilizzo è disponibile nella pagina di documentazione Elementi del grafico a colonne.

Il parametro title consente di modificare la modalità di visualizzazione del nome di una dashboard per gli utenti nelle cartelle e nella parte superiore della dashboard. Se non specificato, il titolo corrisponde al nome del dashboard. Il testo del titolo può essere localizzato.

Considera questo esempio:

- dashboard: sales_overview
  title: "1) Sales Overview"

Se hai fatto questo, anziché visualizzare la dashboard come Panoramica delle vendite, la vedrai come 1) Panoramica delle vendite.

description (per la dashboard)

Questa sezione si riferisce al parametro description che fa parte di una dashboard.

description può essere utilizzato anche nell'ambito di un'esplorazione, come descritto nella pagina della documentazione dedicata al parametro description (per le esplorazioni).

description può essere utilizzato anche nell'ambito di un campo, come descritto nella pagina della documentazione dedicata al parametro description (per i campi).

Il parametro description consente di aggiungere una descrizione a una dashboard LookML.

I contenuti del parametro description verranno visualizzati nel campo Descrizione del riquadro Dettagli dashboard di una dashboard LookML.

La descrizione viene visualizzata sotto il titolo della dashboard negli elenchi di dashboard quando viene visualizzata in una cartella impostata sulla visualizzazione elenco. Se non viene specificata una descrizione, nell'elenco viene visualizzato solo il titolo della dashboard.

Il testo della descrizione può essere localizzato.

enable_viz_full_screen

Questo parametro ha effetto solo quando l'impostazione Visualizzazioni a schermo intero è attivata da un amministratore di Looker. L'impostazione Visualizzazione a schermo intero è abilitata per impostazione predefinita.

Il parametro enable_viz_full_screen consente di impostare se gli utenti che visualizzano la dashboard possono vedere i relativi riquadri nelle visualizzazioni a schermo intero ed espanse. Equivale all'impostazione del dashboard Consenti la modalità a schermo intero per le visualizzazioni.

Questo parametro accetta i valori true (visualizzazioni a schermo intero ed espanse disponibili) e false (visualizzazioni a schermo intero ed espanse non disponibili). Il valore predefinito è true.

extends

Come descritto nella pagina di documentazione Riutilizzo di codici con extends, il parametro extends consente di basare una dashboard LookML su un'altra dashboard LookML, aggiungendo o sostituendo alcune impostazioni. Il parametro extends accetta il nome di un'altra dashboard di LookML.

Quando estendi un oggetto, tieni presente che anche alle tue estensioni si applicano le regole di localizzazione. Se estendi un oggetto e poi definisci nuove etichette o descrizioni, devi fornire le definizioni di localizzazione nei file di stringhe delle impostazioni internazionali del progetto. Per ulteriori informazioni, consulta la pagina della documentazione Localizzazione del modello LookML.

extension

Come descritto nella pagina della documentazione Riutilizzo del codice con extends, il parametro extension indica che la dashboard deve essere estesa da un'altra dashboard. Questa dashboard non è mai visibile ad altri utenti, ma può essere utilizzata come modello per creare altre dashboard visibili ad altri utenti. Il parametro extension accetta solo il valore required. Se il parametro extension non è incluso, l'estensione non è necessaria per la dashboard.

layout

Il parametro layout imposta il metodo di layout che Looker utilizzerà per posizionare gli elementi della dashboard. Accetta i seguenti valori:

• newspaper: gli elementi della dashboard verranno visualizzati in una griglia a 24 colonne. La dimensione predefinita di un elemento è una larghezza di 8 colonne e un'altezza di 6 righe. Gli elementi sono configurabili lungo questa griglia, specificata dai parametri degli elementi width, height, row e col. Questa opzione di layout viene utilizzata quando una dashboard definita dall'utente viene convertita in una dashboard LookML, oltre a essere il layout predefinito quando viene creata una nuova dashboard LookML tramite l'IDE di Looker. Inoltre, newspaper e grid sono gli unici layout che supportano la conversione da una dashboard LookML a una dashboard definita dall'utente.

• grid: gli elementi della dashboard vengono visualizzati con larghezze dinamiche, basate su un insieme di righe che definisci con il parametro rows e i relativi sottoparametri elements e height. newspaper e grid sono gli unici layout che supportano la conversione da una dashboard LookML a una dashboard definita dall'utente.

• static: gli elementi della dashboard vengono visualizzati nell'ordine in cui sono elencati nel file LookML. Ogni elemento del dashboard deve essere posizionato manualmente utilizzando i parametri top e left. Questi parametri si applicano a tutti i tipi di elementi e i dettagli sul loro utilizzo sono disponibili nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per esempi rappresentativi di come funzionano top e left, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard LookML. static non supporta la conversione da una dashboard LookML a una dashboard definita dall'utente.

• tile: gli elementi della dashboard vengono visualizzati nell'ordine in cui sono elencati nel file LookML. La larghezza della dashboard è dinamica e si basa sulla larghezza del browser. Gli elementi della dashboard si posizioneranno dinamicamente all'interno del browser per riempire lo spazio disponibile. tile non supporta la conversione da una dashboard LookML a una dashboard definita dall'utente.

rows

Per i dashboard layout: grid, il parametro rows avvia la sezione di LookML in cui definisci quali elementi devono essere inseriti in quali righe, nonché l'altezza di ogni riga. All'interno di ogni riga, ogni elemento ha la stessa larghezza. Se non elenchi un elemento in questa sezione, non verrà visualizzato nella dashboard.

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

Il parametro elements accetta un elenco di nomi di elementi del dashboard separati da virgole. Ogni dichiarazione elements crea una nuova riga nella dashboard. Gli elementi inseriti in una riga avranno tutti la stessa larghezza. Pertanto, se inserisci due elementi in una riga, ognuno occuperà il 50% dello spazio disponibile. Se inserisci 4 elementi in una riga, ognuno occuperà il 25% dello spazio disponibile.

height

Il parametro height definisce l'altezza di una riga in pixel. Il valore predefinito è 300.

tile_size

Per i dashboard layout: tile e layout: static, l'unità utilizzata per dimensionare e posizionare gli elementi è la dimensione del riquadro. Definisci tile_size in pixel e il valore predefinito è 160. Ad esempio:

- dashboard: sales_overview
  layout: tile
  tile_size: 100

In questo caso, un elemento del dashboard con height: 5 e width: 3 avrà un'altezza di 500 pixel e una larghezza di 300 pixel. I parametri height e width si applicano a tutti i tipi di elementi e i dettagli sul loro utilizzo sono disponibili nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo di come funzionano height e width, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard LookML.

width

Questa sezione si riferisce al parametro width che fa parte di una dashboard.

width può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è riportato nella pagina della documentazione relativa agli elementi del grafico a colonne.

Per le dashboard layout: static, il parametro width definisce la larghezza totale della dashboard che prevedi di utilizzare in pixel. Il parametro width non limiterà la dashboard a una determinata dimensione se definisci un elemento troppo grande o troppi elementi in una riga. L'impostazione width, invece, aiuta a mantenere il cruscotto centrato sullo schermo. Se non imposti una larghezza, il valore predefinito è 1200.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

Questa sezione si riferisce al parametro refresh che fa parte di una dashboard.

refresh può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è riportato nella pagina della documentazione relativa agli elementi del grafico a colonne.

Il parametro refresh consente a una dashboard di ricaricarsi automaticamente a intervalli regolari, recuperando così dati aggiornati. Ciò è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio su una TV in ufficio. Tieni presente che il parametro ha effetto solo se la dashboard è aperta in una finestra del browser. Questa impostazione non viene eseguita in background per "preriscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere qualsiasi numero (senza decimali) di secondi, minuti, ore o giorni. Ad esempio:

- dashboard: sales_overview
  refresh: 2 hours

Presta attenzione quando imposti intervalli di aggiornamento brevi. Poiché i dashboard possono contenere molte query, alcune delle quali potrebbero richiedere molte risorse, alcuni dashboard potrebbero sovraccaricare il database.

auto_run

Il parametro auto_run determina se una dashboard verrà eseguita quando viene aperta o ricaricata inizialmente. Il valore predefinito è true. Quando questo parametro è impostato su false, gli utenti dovranno premere un pulsante Esegui per caricare la dashboard. Ad esempio, un dashboard come questo verrà eseguito automaticamente all'apertura:

- dashboard: sales_overview
  auto_run: true

Indipendentemente dall'impostazione auto_run, gli utenti devono sempre fare clic sul pulsante Esegui dopo aver modificato i valori del filtro. In questo modo, si evitano ricaricamenti indesiderati quando un utente mette in pausa durante una modifica del filtro o vuole modificare più filtri contemporaneamente.

crossfilter_enabled

Il parametro crossfilter_enabled consente di attivare o disattivare i filtri incrociati per una dashboard. Quando questo parametro è impostato su true, gli utenti che visualizzano la dashboard possono creare filtri incrociati sulla dashboard facendo clic su determinati punti dati.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

Il parametro filters_bar_collapsed consente di impostare la barra dei filtri della dashboard come compressa o espansa predefinita per una dashboard. Quando questo parametro è impostato su true, la barra dei filtri è compressa per impostazione predefinita. I visualizzatori della dashboard possono espandere la barra dei filtri facendo clic sull'icona dei filtri. L'impostazione predefinita è false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

Il parametro filters_location_top ti consente di posizionare la barra dei filtri della dashboard in alto o a destra. Se questo parametro è impostato su true, la barra dei filtri viene visualizzata nella parte superiore della dashboard; se è impostato su false, la barra dei filtri viene visualizzata a destra della dashboard. L'impostazione predefinita è true.

- dashboard: sales_data
  filters_location_top: false

filters

Questa sezione si riferisce al parametro filters che fa parte di una dashboard.

filters può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è riportato nella pagina della documentazione relativa agli elementi del grafico a colonne.

filters può essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametro filters.

Il parametro filters avvia la sezione di LookML in cui definisci i filtri della dashboard. I filtri vengono visualizzati nella parte superiore della dashboard e consentono agli utenti di modificare i dati alla base degli elementi della dashboard.

Affinché un filtro influisca su un elemento, quest'ultimo deve essere configurato per "ascoltare" quel filtro utilizzando il parametro listen. Questo parametro si applica a tutti i tipi di elementi, tranne type: text e type: button. Per un esempio rappresentativo di come funziona listen, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard LookML.

Nota: per gli elementi del dashboard che utilizzano il parametro merged_queries, ogni query di origine può ascoltare uno o più filtri del dashboard. All'interno di una definizione di query unita, puoi utilizzare il parametro listen per definire la logica di filtro per ogni query di origine in modo indipendente, indipendentemente dal numero di query di origine nell'elemento dei risultati uniti. Se una query non ha un parametro listen, non sarà interessata da alcun filtro della dashboard.

Quando i filtri vengono applicati a un elemento in questo modo, è importante che il tipo di filtro corrisponda al tipo di dimensione o misura che rileva il filtro (per maggiori dettagli, consulta Creazione di dashboard LookML). I filtri hanno il seguente formato:

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

Questa sezione si riferisce al parametro name che fa parte di un filtro del dashboard.

name può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è riportato nella pagina della documentazione relativa agli elementi del grafico a colonne.

Ogni dichiarazione name crea un nuovo filtro del dashboard e gli assegna un nome. Il nome verrà utilizzato come riferimento nel parametro listen degli elementi che devono essere interessati dal filtro. Il parametro listen si applica a tutti i tipi di elementi, ad eccezione di type: text, e i dettagli sul suo utilizzo sono disponibili nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo di come funziona listen, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard LookML.

filters:
- name: order_date

title (per i filtri)

Questa sezione si riferisce al parametro title che fa parte di un filtro del dashboard.

title può essere utilizzato anche nell'ambito di una dashboard, come descritto nella sezione title (per la dashboard) di questa pagina.

title può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è disponibile nella pagina di documentazione Parametri del grafico a colonne per le dashboard LookML.

Il parametro title consente di modificare la modalità di visualizzazione del nome di un filtro nella parte superiore di una dashboard. Se non specificato, il titolo viene impostato automaticamente sul nome del filtro.

Considera questo esempio:

filters:
- name: order_date
  title: "Order Date(s)"

Se lo hai fatto, anziché visualizzare il filtro come Data ordine, lo vedrai come Data/e ordine.

type

Questa sezione si riferisce al parametro type che fa parte di un filtro del dashboard.

type può essere utilizzato anche come parte di un elemento della dashboard, come descritto nella pagina della documentazione dedicata al parametro type (per le dashboard LookML).

type può essere utilizzato anche nell'ambito di un'unione, come descritto nella pagina della documentazione dedicata al parametro type.

type può essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.

type può essere utilizzato anche come parte di una misura, come descritto nella pagina della documentazione Tipi di misure.

Il parametro type specifica il tipo di input che verrà inserito nel filtro. Sebbene sia possibile inserire qualsiasi tipo di input (ad esempio una data) nel filtro type: string_filter, una maggiore specificità fornisce all'utente un widget di filtro più personalizzato. I quattro tipi di filtri sono:

• field_filter: in genere dovrebbe essere la scelta predefinita quando puoi specificare una dimensione o una misura sottostante. L'utilizzo di type: field_filter e l'associazione del filtro a un campo type:string fanno sì che il filtro suggerisca possibili valori di filtro.
• number_filter: consente all'input utente un valore numerico/intero o un'espressione.
• date_filter: consente all'input utente un valore o un'espressione di data.
• string_filter: consente all'utente di input utente testo in formato libero.

field_filter

Suggerisce opzioni tra cui scegliere e modifica la presentazione agli utenti in base al campo sottostante specificato.

Questo dovrebbe essere il tipo di filtro da utilizzare nelle situazioni in cui vuoi fornire suggerimenti agli utenti mentre interagiscono con il filtro. La dimensione da cui verranno estrapolati i suggerimenti è definita utilizzando i parametri explore e field e deve essere un campo di type: string per generare suggerimenti per i filtri.

I suggerimenti potrebbero non funzionare se il campo proviene da una tabella derivata, se sql_always_where viene utilizzato nell'esplorazione o se il campo è una misura.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

number_filter

Non fornisce suggerimenti, consente all'utente di inserire un valore o un'espressione intero/numerico.

filters:
- name: order_value
  type: number_filter

date_filter

Non fornisce suggerimenti, consente all'utente di inserire un valore o un'espressione di data.

filters:
- name: order_date
  type: date_filter

string_filter

Non fornisce suggerimenti, consente all'utente di inserire testo in formato libero.

filters:
- name: customer_name
  type: string_filter

default_value

Il parametro default_value consente di specificare un valore predefinito da utilizzare per un filtro. Questo valore può essere utile agli utenti suggerendo un punto di partenza ragionevole.

Assicurati che il valore predefinito corrisponda al tipo di filtro utilizzato. Ad esempio:

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: string_filter
  default_value: "John Doe"

Puoi utilizzare le espressioni di filtro per creare valori predefiniti. La pagina della documentazione Espressioni di filtro di Looker descrive questo aspetto in modo più dettagliato.

Quando utilizzi sia il parametro default_value sia il parametro ui_config, le espressioni di filtro devono essere compatibili con il valore assegnato al parametro secondario type di ui_config e con i tipi di dati che supportano il valore type.

Puoi anche utilizzare le variabili Liquid _localization e _user_attributes per valori di filtro predefiniti flessibili.

allow_multiple_values

Il parametro allow_multiple_values consente di controllare se gli utenti possono selezionare un singolo valore di filtro o più valori di filtro. Se questo parametro è impostato su true (valore predefinito), gli utenti possono selezionare più valori per il filtro. Quando questo parametro è impostato su false, gli utenti possono selezionare un solo valore di filtro.

Ad esempio:

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

Il parametro required ti consente di richiedere agli utenti di fornire un valore per il filtro per eseguire la dashboard. Per impostazione predefinita, i filtri non richiedono valori. Se un filtro che non richiede un valore viene lasciato vuoto, i dati non vengono limitati dal campo del filtro. Se un filtro che richiede un valore viene lasciato vuoto, la dashboard non verrà eseguita.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

Il parametro secondario ui_config di filters consente di configurare le impostazioni dei filtri per una dashboard LookML. Queste impostazioni includono i tipi di controlli filtro utilizzati, il posizionamento dei controlli filtro e i valori di filtro possibili.

Ad esempio:

  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

Per saperne di più sulla configurazione dei filtri con la UI, consulta la pagina della documentazione Aggiunta e modifica dei filtri delle dashboard definiti dall'utente.

type

Il parametro secondario type di ui_config ti consente di specificare i tipi di controlli filtro visualizzati.

A seconda del valore inserito per type, i controlli filtro possono essere a selezione singola o multipla.

I valori supportati da type dipendono dal tipo di dati LookML type assegnato al campo su cui stai filtrando.

STR = Compatibile con il tipo di dati string	DIST = Compatibile con il tipo di dati distance
NUM = Compatibile con il tipo di dati number e le misure numeriche	DUR = Compatibile con il tipo di dati duration
TIER = Compatibile con il tipo di dati tier	D&T = Compatibile con la maggior parte dei tipi di dati relativi a data e ora
ZIP = Compatibile con il tipo di dati zipcode	LOC = Compatibile con il tipo di dati location
S/N = Compatibile con il tipo di dati yesno	PAR = Compatibile con il parametro parameter

Valore	Descrizione	Tipi di dati supportati
Selezione multipla
button_group	Il filtro mostra un gruppo di pulsanti, uno per ogni valore specificato con il parametro options.	STR NUM TIER ZIP Y/N DIST DUR
checkboxes	Il filtro mostra le caselle di controllo, una per ogni valore specificato con il parametro options.	STR NUM TIER ZIP Y/N DIST DUR
tag_list	Il filtro mostra un menu a discesa che elenca ogni valore possibile specificato utilizzando il parametro options.	STR NUM TIER ZIP DIST DUR
range_slider	Per i campi numerici, il filtro mostra un cursore che consente agli utenti di impostare un intervallo di numeri come valore del filtro. I parametri secondari min e max di options vengono utilizzati per specificare i valori minimi e massimi possibili per il filtro, mentre l'intervallo predefinito può essere specificato utilizzando il parametro default_value.	NUM DIST DUR
Selezione singola
button_toggles	Il filtro mostra un gruppo di pulsanti, uno per ogni valore specificato con il parametro options.	STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons	Il filtro mostra i pulsanti di opzione, con un pulsante per qualsiasi valore e un pulsante per ogni valore specificato con il parametro options.	STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu	Il filtro mostra un menu a discesa che elenca ogni valore possibile specificato utilizzando il parametro options. Il menu a discesa offre anche agli utenti la possibilità di selezionare Qualsiasi valore.	STR NUM TIER ZIP Y/N DIST DUR PAR
slider	Per i campi numerici, il filtro mostra un cursore che consente agli utenti di scegliere un filtro scorrendo tra i valori minimo e massimo possibili, specificati utilizzando il parametro options.	NUM DIST DUR
Date e ore
day_picker	Il filtro consente agli utenti di scegliere una data specifica in base alla quale applicare il filtro.	Data e ora Il controllo di un solo giorno può essere utilizzato con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma i visualizzatori possono selezionare solo singole date con questo tipo di controllo.
day_range_picker	Il filtro consente agli utenti di selezionare una data di inizio e una data di fine per filtrare un intervallo di date.	Data e ora: il controllo intervallo di date può essere utilizzato con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma i visualizzatori possono selezionare solo intervalli di date con questo tipo di controllo.
date_time_range_input	Il filtro consente all'utente di filtrare in base a un intervallo di date e ore.	Data e ora Il controllo intervallo di date e ore può essere utilizzato con la maggior parte dei tipi basati sul tempo e i visualizzatori devono selezionare sia le opzioni di data che di ora con questo tipo di controllo.
relative_timeframes	Il filtro consente all'utente di filtrare in base a un intervallo di date personalizzato o di scegliere tra i preset di intervallo di tempo, ad esempio Oggi, Ultimi 7 giorni o Ultimi 90 giorni.	Data e ora: il controllo del periodo di tempo può essere utilizzato con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma gli spettatori non possono selezionare le opzioni di tempo con questo tipo di controllo.
Altro
advanced	Il filtro presenta opzioni per l'applicazione di uno o più filtri o filtri di corrispondenze avanzate. Per saperne di più sui controlli avanzati, consulta la sezione Utilizzo dei controlli avanzati in questa pagina.	STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

Nota: alcuni periodi di tempo e tipi basati sul tempo vengono interpretati come tipi di dati diversi quando Looker crea le opzioni di controllo. Due esempi sono il periodo di tempo yesno, che viene interpretato come un tipo di dati yesno e pertanto supporta i valori supportati dal tipo yesno, e il periodo di tempo hour_of_day, che viene interpretato come un tipo di dati number e pertanto supporta i valori supportati dal tipo number.

display

Puoi utilizzare il parametro secondario display di ui_config per impostare la posizione di un filtro della dashboard. Puoi posizionare un filtro assegnando uno dei seguenti valori a display:

• inline: Il filtro viene visualizzato direttamente nella barra superiore della dashboard.
• popover: nella barra superiore della dashboard viene visualizzato un valore di riepilogo. Fai clic sul valore per visualizzare il filtro completo.
• overflow: nella barra superiore della dashboard viene visualizzato un pulsante Altro con un indicatore numerico del numero di filtri di overflow presenti; gli utenti possono fare clic sul pulsante per visualizzare i filtri di overflow e i relativi valori.

Alcuni tipi di filtri possono essere visualizzati solo in determinati modi. Ad esempio, i filtri di type: day_picker possono essere visualizzati solo come inline o overflow. Se assegni a un filtro un valore display non valido per type, il filtro verrà visualizzato come inline o popover, a seconda di quale sia valido. Per saperne di più, consulta la pagina della documentazione Aggiunta e modifica dei filtri delle dashboard definite dall'utente.

Per informazioni sul posizionamento dei filtri della dashboard utilizzando la UI, consulta la pagina della documentazione Aggiunta e modifica dei filtri definiti dall'utente.

options

Il parametro secondario facoltativo options di ui_config consente di specificare i valori che un utente può scegliere per aggiornare temporaneamente i valori dei filtri della dashboard quando gli utenti visualizzano una dashboard LookML. Se non specifichi alcun valore per options, Looker estrae i primi valori dal database.

Ad esempio, puoi impostare San Francisco, New York e Tokyo come valori possibili per un filtro nel campo users.city nel seguente modo:

ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

Se il sottoparametro type di ui_config è impostato su range_slider o slider, puoi utilizzare i sottoparametri min e max di options:

• min: imposta il valore minimo possibile per un filtro.
• max: imposta il valore massimo possibile per un filtro.

Ad esempio:

ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

Per i filtri della dashboard di type: field_filter, devi definire un modello da cui il filtro estrae i suggerimenti. Il parametro model specifica il modello che contiene il campo che vuoi utilizzare.

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

Questa sezione si riferisce al parametro explore che fa parte di un filtro del dashboard.

explore può essere utilizzato anche nell'ambito di un modello, come descritto nella pagina della documentazione dedicata al parametro explore.

explore può essere utilizzato anche come parte di un elemento del dashboard. Un esempio rappresentativo del suo utilizzo è riportato nella pagina della documentazione relativa agli elementi del grafico a colonne.

Per i filtri della dashboard di type: field_filter, devi definire un campo da cui il filtro estrae i suggerimenti. Il parametro explore specifica quale esplorazione contiene il campo che vuoi utilizzare.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

Per i filtri della dashboard di type: field_filter, devi definire un campo da cui il filtro estrae i suggerimenti. Il parametro field specifica il campo che vuoi utilizzare. È importante utilizzare il nome del campo con ambito completo. In altre parole, utilizza view_name.field_name, non solo field_name.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

Per i filtri della dashboard di type: field_filter, puoi restringere i suggerimenti per il filtro in base a ciò che l'utente inserisce per un altro filtro di type: field_filter.

Nell'esempio seguente, i suggerimenti forniti per il filtro State si baseranno sui valori del filtro Order ID. Qualsiasi valore selezionato per il filtro Order ID avrà valori users.state associati e questi valori saranno i valori suggeriti per il filtro State. Per saperne di più, consulta la pagina della documentazione Aggiungere e modificare i filtri delle dashboard definiti dall'utente.

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

embed_style

Il parametro embed_style avvia la sezione di LookML in cui personalizzi l'aspetto di una dashboard incorporata. embed_style e i relativi parametri sono supportati solo nelle dashboard incorporate e vengono ignorati se la dashboard non è incorporata.

Dopo aver apportato modifiche a embed_style, devi eseguire il deployment di LookML in produzione per visualizzare le impostazioni di embed_style nella dashboard LookML incorporata.

Per i seguenti attributi del dashboard incorporato che specificano un colore, il valore del colore può essere una stringa esadecimale come #2ca6cd o una stringa di colore denominata CSS come mediumblue.

Le personalizzazioni della dashboard incorporata hanno il seguente formato:

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

Imposta il colore dello sfondo di una dashboard incorporata.

embed_style:
  background_color: "#ffffff"

show_title

Specifica se il titolo della dashboard incorporata è visibile agli utenti.

embed_style:
  show_title: false

title_color

Imposta il colore del titolo di una dashboard incorporata.

embed_style:
  title_color: "#008000"

show_filters_bar

Specifica se i filtri della dashboard incorporata sono visibili agli utenti.

Questo parametro influisce solo sull'aspetto estetico della dashboard, non sulla capacità di un utente di accedere ai dati. Se nascondi la barra dei filtri, gli utenti possono comunque modificare i filtri in altri modi. Per informazioni su come configurare criteri di controllo dell'accesso ai dati sicuri, consulta la pagina della documentazione Controllo dell'accesso e gestione delle autorizzazioni.

embed_style:
  show_filters_bar: true

tile_background_color

Imposta il colore dello sfondo di tutti i riquadri di una dashboard incorporata.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Imposta il colore del testo su tutti i riquadri di una dashboard incorporata.

embed_style:
  tile_text_color: "crimson"

elements

Questa sezione si riferisce al parametro elements che fa parte di un dashboard.

elements può essere utilizzato anche come parte di una riga del dashboard, come descritto nella sezione elements per le righe di questa pagina.

Il parametro elements avvia la sezione di LookML in cui definisci gli elementi che comporranno una dashboard. Esistono molti parametri che possono definire l'aspetto di un elemento del dashboard. Sono descritti in modo più dettagliato nella pagina Parametri degli elementi della dashboard.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

Considera il numero e la complessità degli elementi che aggiungi a una dashboard LookML. Più elementi richiedono più risorse del browser, il che aumenta il tempo di rendering della dashboard. Allo stesso modo, gli elementi che visualizzano grandi quantità di dati possono influire sulle prestazioni della dashboard. Se il rendering diventa un problema, valuta la possibilità di ridurre la complessità delle query degli elementi della dashboard o di creare più dashboard con meno elementi.