Parametri della dashboard

Le dashboard possono essere create in due modi. Le dashboard definite dall'utente vengono create tramite l'interfaccia utente di Looker e sono descritte in modo dettagliato nella pagina della documentazione Creazione di dashboard definite dall'utente. Le dashboard possono anche essere create usando LookML e le relative impostazioni generali possono essere modificate come spiegato in questa pagina.

Una dashboard ha diverse impostazioni che interessano l'intera dashboard, descritte di seguito. Contiene anche un gruppo di visualizzazioni di dati, chiamate elementi. Il codice LookML per questi elementi è descritto nelle pagine della documentazione per ogni singolo tipo di elemento.

Esempio di utilizzo

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "desired dashboard title"
  description: "desired dashboard description"
  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: "desired 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

I parametri con l'etichetta NON SUPPORTATO DA LEGACY hanno effetto solo quando una dashboard viene visualizzata tramite l'esperienza predefinita delle dashboard, utilizzando preferred_viewer: dashboards-next o convertindo una dashboard LookML legacy in una dashboard definita dall'utente e poi aggiornando la dashboard definita dall'utente.

Nome parametro	Descrizione
dashboard	Creare una dashboard.
preferred_viewer	Scegli se eseguire il rendering di una dashboard come dashboard o come dashboard precedente.
title (per la dashboard)	Cambia la visualizzazione del nome della dashboard per gli utenti.
description (per la dashboard)	Aggiungi una descrizione segnaposto da utilizzare se la dashboard viene convertita in una dashboard definita dall'utente.
extends	Basa la dashboard LookML su un'altra dashboard LookML.
extension	Richiedi che la dashboard venga estesa da un'altra.
layout	Definisci il modo in cui la dashboard inserirà gli elementi.
rows	Avvia una sezione di LookML per definire gli elementi da inserire 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 una dashboard layout: grid.
tile_size	Definire le dimensioni di un riquadro per una dashboard layout: tile.
width (per la dashboard)	Definisci la larghezza della dashboard per layout: static.
refresh (per la dashboard)	Imposta l'intervallo in cui gli elementi della dashboard verranno aggiornati automaticamente.
auto_run	Stabilisci se le dashboard vengono eseguite automaticamente quando vengono aperte o ricaricate inizialmente.
Filtra parametri
crossfilter_enabled	NON SUPPORTATO DA LEGACY Attiva o disattiva il filtro incrociato per una dashboard che utilizza anche preferred_viewer: dashboards-next.
filters_bar_collapsed	AGGIUNTO 21.16 NON SUPPORTATO DA LEGACY Imposta la barra dei filtri della dashboard come predefinita compressa o espansa per una dashboard che utilizza anche preferred_viewer: dashboards-next.
filters_location_top	AGGIUNTO 22.8 NON SUPPORTATO DA LEGACY Imposta la posizione della barra dei filtri della dashboard su in alto o a destra per una dashboard che utilizza anche preferred_viewer: dashboards-next.
filters (per la dashboard)	Avvia una sezione di LookML per definire i filtri della dashboard.
name (per i filtri)	Crea un filtro.
title (per i filtri)	Cambia la modalità di visualizzazione del nome di un filtro per gli utenti.
type (per i filtri)	Determina il tipo di filtro da utilizzare.
default_value	Imposta un valore predefinito per un filtro, se vuoi.
allow_multiple_values	Limita gli utenti a un singolo valore di filtro.
required	Richiedi agli utenti di inserire un valore di filtro per eseguire la dashboard.
ui_config	NON SUPPORTATO DA LEGACY Configura i controlli filtro disponibili quando gli utenti visualizzano una dashboard LookML visualizzata nella nuova esperienza della dashboard, con preferred_viewer impostato su dashboards-next (non una dashboard legacy, con preferred_viewer impostato su dashboards). Ha i sottoparametri type, display e options.
model (per i filtri)	Specifica il modello contenente 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 altri filtri della dashboard di type: field_filter.
Parametri delle dashboard incorporate
embed_style	Avvia una sezione di LookML per definire le personalizzazioni della dashboard incorporata.
background_color	Imposta il colore di sfondo di una dashboard incorporata.
show_title	Specifica se il titolo della dashboard è visibile su 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 dello sfondo dei riquadri di una dashboard incorporata.
tile_text_color	Imposta il colore del testo del riquadro di una dashboard incorporata.
Parametri elemento
elements (per la dashboard)	Avvia 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, è consigliabile inserire ogni dashboard LookML in un proprio file LookML, ma è possibile dichiarare più dashboard in un unico file.

- dashboard: sales_overview

Per visualizzare qualsiasi elemento, una dashboard deve contenere almeno un elemento tramite il parametro elements.

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

preferred_viewer

Il parametro preferred_viewer consente di scegliere il formato di visualizzazione e download di una dashboard. Accetta i seguenti valori:

• dashboards: il renderer basato su AngularJS per le dashboard legacy.

• dashboards-next: renderer basato su React per l'esperienza predefinita della dashboard.

Le dashboard LookML con preferred_viewer: dashboards che vengono convertite in dashboard definite dall'utente possono essere visualizzate utilizzando la nuova dashboard aggiornando la dashboard definita dall'utente.

title (per la dashboard)

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

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

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

Il parametro title consente di modificare il modo in cui il nome della dashboard verrà mostrato agli utenti nelle cartelle e nella parte superiore della dashboard. Se non viene specificato, il titolo viene impostato in modo predefinito sul nome della dashboard. Il testo del titolo può essere localizzato.

Considera questo esempio:

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

In questo caso, invece della dashboard viene visualizzata come Panoramica delle vendite, viene visualizzata 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 come parte di un'esplorazione, come descritto nella pagina della documentazione relativa al parametro description (per le esplorazioni).

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

A partire da Looker 21.20, i contenuti del parametro description verranno visualizzati nella casella di testo Description (Descrizione) del riquadro Dashboard Details (Dettagli dashboard) di una dashboard LookML.

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

La descrizione viene visualizzata sotto il titolo della dashboard negli elenchi di dashboard se visualizzata in una cartella. Se non viene specificata una descrizione, l'elenco mostra solo il titolo della dashboard.

Il testo della descrizione può essere localizzato.

extends

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

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

extension

Come descritto in questa pagina, il parametro extension indica che la dashboard deve essere estesa da un'altra. Questa dashboard non è mai visibile agli 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 viene incluso, non è necessaria l'estensione per la dashboard.

layout

Il parametro layout imposta il metodo di layout che verrà utilizzato da Looker per il posizionamento degli elementi della dashboard. Accetta i seguenti valori:

• newspaper: gli elementi della dashboard verranno visualizzati in una griglia di 24 colonne. Le dimensioni predefinite per un elemento sono una larghezza di 8 colonne e un'altezza di 6 righe. Gli elementi possono essere configurati lungo questa griglia, specificata dai parametri elemento 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, quando preferred_viewer è impostato su dashboards-next, newspaper è l'unico layout che supporta la conversione da una dashboard LookML a una dashboard definita dall'utente.

• grid: gli elementi della dashboard vengono visualizzati con larghezze dinamiche, in base a un insieme di righe definite da te con il parametro rows e i relativi sottoparametri elements e height. Quando preferred_viewer è impostato su dashboards-next, grid non supporta 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 della 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 vengono visualizzati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per esempi rappresentativi di come funzionano top e left, consulta la pagina della documentazione relativa ai parametri del grafico a colonne per le dashboard di LookML. Quando preferred_viewer è impostato su dashboards-next, 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 verranno posizionati in modo dinamico all'interno del browser per riempire lo spazio disponibile. Quando preferred_viewer è impostato su dashboards-next, tile non supporta la conversione da una dashboard LookML a una dashboard definita dall'utente.

rows

Per le dashboard layout: grid, il parametro rows avvia la sezione di LookML, in cui definisci gli elementi da inserire in quali righe e l'altezza di ogni riga. Ogni riga ha la stessa larghezza di ogni elemento. 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 prende un elenco di nomi degli elementi della dashboard, separati da virgole. Ogni dichiarazione elements crea una nuova riga nella dashboard. Gli elementi posizionati in una riga avranno tutti la stessa larghezza. Pertanto, se posizioni due elementi di seguito, questi occupano il 50% dello spazio disponibile. Se inserisci 4 elementi di seguito, ciascuno occupa il 25% dello spazio disponibile e così via.

height

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

tile_size

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

- dashboard: sales_overview
  layout: tile
  tile_size: 100

In questo caso, un elemento della 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 vengono visualizzati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo del funzionamento di height e width, consulta la pagina della documentazione relativa ai parametri del grafico a colonne per le dashboard di 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 della dashboard. Un esempio rappresentativo del suo utilizzo viene fornito nella pagina della documentazione per gli elementi del grafico a colonne.

Per le dashboard layout: static, il parametro width definisce la larghezza totale della dashboard che intendi utilizzare in pixel. Il parametro width non limita la dashboard a una certa dimensione se definisci un elemento di dimensioni troppo grandi o troppi in una riga. L'impostazione width consente invece di mantenere la dashboard centrata 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 della dashboard. Un esempio rappresentativo del suo utilizzo è fornito nella pagina della documentazione relativa agli elementi del grafico a colonne.

Il parametro refresh consente a una dashboard di ricaricarsi automaticamente su base periodica, recuperando così i dati aggiornati. Spesso è utile nelle impostazioni in cui viene sempre visualizzata una dashboard, ad esempio sulla TV di un ufficio. Tieni presente che per ottenere questo effetto, la dashboard deve essere aperta in una finestra del browser. Questa impostazione non viene eseguita in background per "preparare" 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

Fai attenzione quando imposti intervalli di aggiornamento brevi. Poiché le dashboard possono contenere molte query, alcune delle quali potrebbero richiedere un uso intensivo delle risorse, alcune dashboard potrebbero sovraccaricare il database più del previsto.

auto_run

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

- dashboard: sales_overview
  auto_run: true

Indipendentemente dall'impostazione di auto_run, gli utenti devono sempre fare clic sul pulsante Esegui dopo aver modificato i valori del filtro. Ciò consente di evitare ricariche indesiderate quando un utente si mette in pausa durante una modifica del filtro o vuole modificare più filtri contemporaneamente.

crossfilter_enabled

Questo parametro si applica solo alle dashboard di LookML visualizzate tramite l'esperienza della dashboard predefinita di Looker impostando il parametro preferred_viewer su dashboards-next.

Il parametro crossfilter_enabled consente di attivare o disattivare i filtri incrociati per una dashboard che utilizza anche preferred_viewer: dashboards-next. Se questo parametro è impostato su true, i visualizzatori della dashboard possono creare filtri incrociati nella dashboard facendo clic su determinati punti dati.

- dashboard: sales_data
  preferred_viewer: dashboards-next
  crossfilter_enabled: true

crossfilter_enabled non verrà applicato alle dashboard di LookML utilizzando preferred_viewer: dashboards. Tuttavia, se una dashboard LookML che utilizza crossfilter_enabled e preferred_viewer: dashboards è stata convertita in una dashboard definita dall'utente e aggiornata, crossfilter_enabled avrà effetto sulla dashboard aggiornata.

filters_bar_collapsed

Questo parametro si applica solo alle dashboard di LookML visualizzate tramite l'esperienza della dashboard predefinita di Looker impostando il parametro preferred_viewer su dashboards-next.

Il parametro filters_bar_collapsed consente di impostare la barra dei filtri della dashboard come predefinita compressa o espansa per una dashboard che utilizza anche preferred_viewer: dashboards-next. Se 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. Il valore predefinito per questa impostazione è false.

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_bar_collapsed: true

filters_bar_collapsed non verrà applicato alle dashboard di LookML utilizzando preferred_viewer: dashboards. Tuttavia, se una dashboard LookML che utilizza filters_bar_collapsed e preferred_viewer: dashboards è stata convertita in una dashboard definita dall'utente e aggiornata, filters_bar_collapsed avrà effetto sulla dashboard aggiornata.

filters_location_top

Questo parametro si applica solo alle dashboard di LookML visualizzate tramite l'esperienza della dashboard predefinita di Looker impostando il parametro preferred_viewer su dashboards-next.

Il parametro filters_location_top consente di posizionare la barra dei filtri della dashboard in alto o a destra per una dashboard che utilizza anche preferred_viewer: dashboards-next. Se questo parametro è impostato su true, la barra dei filtri viene visualizzata nella parte superiore della dashboard; se è impostata su false, la barra dei filtri viene visualizzata a destra della dashboard. Il valore predefinito per questa impostazione è true.

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_location_top: false

filters_location_top non verrà applicato alle dashboard di LookML utilizzando preferred_viewer: dashboards. Tuttavia, se una dashboard LookML che utilizza filters_location_top e preferred_viewer: dashboards è stata convertita in una dashboard definita dall'utente e aggiornata, filters_location_top avrà effetto sulla dashboard aggiornata.

filters

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

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

filters può essere utilizzato anche come parte di una misura, descritto nella pagina della documentazione del 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 che si trovano dietro gli elementi della dashboard.

Affinché un filtro influisca su un elemento, deve essere impostato su "ascolta" per tale filtro utilizzando il parametro listen. Questo parametro si applica a tutti i tipi di elementi diversi da type: text e i dettagli sul suo utilizzo vengono visualizzati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo del funzionamento di listen, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard di LookML.

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

filters:
- name: filter_name
  title: "desired 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 della dashboard.

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

Ogni dichiarazione name crea un nuovo filtro della dashboard a cui assegna un nome. Il nome farà riferimento al parametro listen degli elementi che dovrebbero essere interessati dal filtro. Il parametro listen si applica a tutti i tipi di elementi, oltre a type: text, e i dettagli sul suo utilizzo vengono visualizzati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo del funzionamento di listen, consulta la pagina della documentazione Parametri del grafico a colonne per le dashboard di LookML.

filters:
- name: order_date

title (per i filtri)

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

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

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

Il parametro title consente di modificare il modo in cui il nome di un filtro viene visualizzato dagli utenti nella parte superiore di una dashboard. Se non specificato, il titolo viene impostato sul nome predefinito del filtro.

Considera questo esempio:

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

Se lo fai, invece del filtro visualizzato come Data ordine, verrà visualizzato come Data ordine.

type

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

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

type può essere utilizzato anche come parte di un join, descritto nella pagina della documentazione relativa al parametro del parametro type.

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

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

Il parametro type specifica il tipo di input che verrà inserito nel filtro. Anche se qualsiasi tipo di input (ad esempio una data) può essere scritto nel filtro type: string_filter, una maggiore specificità fornisce un widget filtri più personalizzato all'utente. Esistono quattro tipi di filtri:

• field_filter: in genere è la scelta predefinita, quando puoi specificare una dimensione o una misurazione di base. L'utilizzo di type: field_filter e l'associazione del filtro a un campo type:string fa sì che il filtro suggerisca possibili valori di filtro.
• number_filter: consente all'utente di inserire un numero o un'espressione o un valore intero.
• date_filter: consente all'utente di inserire un valore o un'espressione di data.
• string_filter: consente all'utente di inserire testo in formato libero.

field_filter

Suggerisce delle opzioni tra cui scegliere, cambia la presentazione agli utenti in base al campo sottostante specificato.

Questo dovrebbe essere il tipo di filtro adatto a te quando vuoi offrire suggerimenti agli utenti quando interagiscono con il filtro. La dimensione da cui verranno estratti i suggerimenti viene definita utilizzando i parametri explore e field e deve essere un campo di type: string per generare suggerimenti per i filtri.

Tieni presente che i suggerimenti potrebbero non funzionare se il campo proviene da una tabella derivata, se sql_always_where viene utilizzato in Esplora 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 numero/numero intero.

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 di far corrispondere il valore predefinito 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 documentazione delle espressioni del filtro Looker viene descritta in maggiore dettaglio.

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

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

allow_multiple_values

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

Per le dashboard LookML che utilizzano l'esperienza precedente della dashboard, con preferred_viewer impostato su dashboards, allow_multiple_values può essere applicato ai filtri di qualsiasi type.

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 consente di richiedere agli utenti di fornire un valore al filtro per eseguire la dashboard. Per impostazione predefinita, i filtri non richiedono valori. Se un filtro che non richiede alcun valore e viene lasciato vuoto, i dati non sono limitati dal campo del filtro. Se un filtro che richiede un valore e viene lasciato vuoto, la dashboard non verrà eseguita.

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

ui_config

Questo parametro si applica solo alle dashboard di LookML visualizzate tramite l'esperienza della dashboard predefinita di Looker impostando il parametro preferred_viewer su dashboards-next.

Il sottoparametro ui_config di filters ti consente di configurare le impostazioni di filtro che si applicano quando una dashboard LookML viene visualizzata come dashboard (non quando una dashboard LookML viene visualizzata come dashboard legacy), impostando il parametro preferred_viewer su dashboards-next. Tra queste sono inclusi i tipi di controlli da utilizzare, il posizionamento dei controlli e i possibili valori di filtro.

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

L'impostazione specificata con il sottoparametro ui_config non avrà effetto sulle dashboard di LookML utilizzando preferred_viewer: dashboards. Tuttavia, se una dashboard LookML che utilizza ui_config e preferred_viewer: dashboards è stata convertita in una dashboard definita dall'utente e aggiornata, ui_config avrà effetto sulla dashboard aggiornata.

Consulta la pagina di documentazione Aggiunta e modifica di filtri della dashboard definiti dall'utente per ulteriori informazioni sulla configurazione dei filtri con la UI.

type

Il sottoparametro type di ui_config consente di specificare i tipi di controlli filtro da mostrare quando gli utenti visualizzano una dashboard LookML come dashboard (non come dashboard precedente).

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

I valori supportati da type dipendono dai dati LookML type assegnati al campo in base al quale stai filtrando.

S = Funziona con il tipo di dati [`string`](/looker/docs/2216/reference/param-dimension-filter-parameter-types#string)
N = Compatibile con il [`number`](/looker/docs/2216/reference/param-dimension-filter-filter-parameter-types#number)

DI -Duosità di -21 -N1

Valore	Descrizione	Tipi di dati supportati
Selezione multipla
button_group	Il filtro mostra un gruppo di pulsanti, con un pulsante per ogni valore specificato con il parametro options.	S N T ZC YN DI DU
checkboxes	Il filtro mostra caselle di controllo, con una casella di controllo per ogni valore specificato con il parametro options.	S N T ZC YN DI DU
tag_list	Il filtro mostra un elenco a discesa che elenca i possibili valori specificati utilizzando il parametro options.	S N T ZC DI DU
range_slider	Per i campi numerici, il filtro mostra un dispositivo di scorrimento che consente agli utenti di impostare un intervallo di numeri come valore del filtro. I sottoparametri min e max di options vengono utilizzati per specificare i valori minimo e massimo possibili per il filtro, mentre l'intervallo predefinito può essere specificato utilizzando il parametro default_value.	N DI DU
Selezione singola
button_toggles	Il filtro mostra un gruppo di pulsanti, con un pulsante per ogni valore specificato con il parametro options.	S N T ZC YN DI DU P
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.	S N T ZC YN DI DU P
dropdown_menu	Il filtro mostra un menu a discesa in cui sono elencati i possibili valori specificati utilizzando il parametro options. Il menu a discesa offre inoltre agli utenti la possibilità di selezionare Qualsiasi valore.	S N T ZC YN DI DU P
slider	Per i campi numerici, il filtro mostra un dispositivo di scorrimento che consente agli utenti di scegliere un filtro scorrendo tra i valori minimo e massimo possibili, che vengono specificati utilizzando il parametro options.	N DI DU
Date e ore
day_picker	Il filtro consente agli utenti di scegliere una determinata data in base alla quale filtrare.	DT^* È possibile utilizzare il controllo del singolo giorno con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma gli spettatori possono selezionare solo date singole 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 in base a un intervallo di date.	DT^*: è possibile utilizzare il controllo intervallo di date con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma i visualizzatori possono selezionare intervalli di date solo con questo tipo di controllo.
date_time_range_input	Il filtro consente all'utente di filtrare i dati in base a un intervallo di date e ore.	DT^*: il controllo intervallo di date e ore può essere utilizzato con la maggior parte dei tipi basati sul tempo e i visualizzatori devono selezionare le opzioni di data e ora con questo tipo di controllo.
relative_timeframes	Il filtro consente all'utente di filtrare i dati in base a un intervallo personalizzato di date oppure tra una preimpostazione di intervallo di tempo come Oggi, Ultimi 7 giorni, Ultimi 90 giorni e così via.	DT^* Il controllo del periodo di tempo può essere utilizzato con la maggior parte dei periodi di tempo e dei tipi basati sul tempo, ma i visualizzatori non possono selezionare le opzioni relative al tempo con questo tipo di controllo.
Altro
advanced	Il filtro presenta le opzioni per applicare uno o più filtri filtri o corrispondenze avanzate. Consulta la sezione Utilizzo dei controlli avanzati di questa pagina per scoprire di più sui controlli avanzati.	S N T ZC YN DT DI DU L P
^* Nota sui dati relativi a data e ora :alcuni periodi di tempo e tipi basati su data/ora vengono interpretati come tipi di dati diversi quando Looker crea opzioni di controllo per questi intervalli. Due esempi sono il periodo di tempo di 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 datinumber e pertanto supporta i valori supportati dal tipo number.

display

Puoi utilizzare il sottoparametro 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; gli utenti possono fare clic sul pulsante per visualizzare i filtri overflow e i relativi valori.

Alcuni tipi di filtri possono essere visualizzati soltanto 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, verrà visualizzato come inline o popover, a seconda di quale sia valido. Per scoprire di più, consulta la pagina della documentazione Aggiungere e modificare i filtri della dashboard definiti dall'utente.

Per informazioni sui filtri della dashboard per il posizionamento utilizzando l'interfaccia utente, consulta la pagina Aggiunta e modifica di filtri definiti dall'utente nella documentazione.

options

Il sottoparametro facoltativo di options di ui_config consente di specificare i valori che un utente può scegliere per aggiornare temporaneamente i valori di filtro della dashboard quando visualizza una dashboard LookML come una dashboard (non una dashboard precedente). 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 contenente il campo da 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 della dashboard.

explore può essere utilizzato anche come parte di un modello, descritto nella pagina della documentazione del parametro explore.

explore può essere utilizzato anche come parte di un elemento della dashboard. Un esempio rappresentativo del suo utilizzo è fornito 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 Explore 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 da utilizzare. È importante utilizzare il nome completo del campo. In altre parole, utilizza view_name.field_name, non soltanto 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.

Nel seguente esempio, i suggerimenti forniti per il filtro State si baseranno sui valori del filtro Order ID. Qualunque sia il valore selezionato per il filtro Order ID, quest'ultimo conterrà valori users.state associati, che verranno suggeriti per il filtro State. Per ulteriori informazioni, consulta la pagina Aggiunta e modifica di filtri della 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 puoi personalizzare l'aspetto di una dashboard incorporata. embed_style e i relativi parametri associati sono supportati solo nelle dashboard incorporate e vengono ignorati se quest'ultima non è incorporata.

Dopo aver apportato le modifiche a embed_style, devi eseguire il deployment del tuo codice LookML in produzione per vedere le tue impostazioni embed_style nella dashboard LookML incorporata.

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

Le personalizzazioni delle dashboard incorporate 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 riguarda solo l'aspetto estetico della dashboard, non la capacità di un utente di accedere ai dati. Nascondere la barra dei filtri NON impedisce agli utenti di modificare i filtri in altri modi. Per informazioni su come configurare i criteri di controllo dell'accesso sicuro ai dati, 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 in 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 dashboard.

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

Il parametro elements avvia la sezione di LookML in cui definisci gli elementi che formano una dashboard. Esistono molti parametri che possono definire l'aspetto di un elemento della 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]

Pensa al numero e alla complessità degli elementi che aggiungi a una dashboard di LookML. Più elementi richiedono più risorse del browser, aumentando il tempo di rendering nella dashboard. Analogamente, gli elementi che visualizzano grandi quantità di dati possono influire sulle prestazioni della dashboard. Se il rendering diventa un problema, valuta la possibilità di semplificare gli elementi o di creare più dashboard con meno elementi.