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 relative impostazioni generali possono essere modificate come descritto in questa pagina.

Questa pagina descrive i parametri della dashboard LookML che influiscono sull'intera dashboard.

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

Esempio di utilizzo

- dashboard: dashboard_name
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  enabled_dashboard_agents: true | false
  default_dashboard_agent: agent_name
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  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
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    vis_filter: 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
  tab_name:
  # Optional - for organizing elements onto tabs. Must be declared for each element individually.
  group:
  # Optional - for organizing elements into a tile group. Must be declared for each child element individually.

Definizioni dei parametri

Nome parametro Descrizione
dashboard Crea una dashboard.
title (per la dashboard) Modifica il modo in cui il nome di una dashboard viene visualizzato dagli utenti.
description (per la dashboard) Aggiungi una descrizione che può essere visualizzata nel riquadro Dettagli dashboard o in una cartella impostata su visualizzazione elenco.
enable_viz_full_screen Definisci se i visualizzatori della dashboard possono visualizzare i riquadri della dashboard nelle visualizzazioni a schermo intero ed espanse.
enabled_dashboard_agents Definisci se i visualizzatori della dashboard possono chattare con la dashboard LookML utilizzando un agente della dashboard.
default_dashboard_agent Specifica l'agente della dashboard predefinito da utilizzare per le query di conversazione sulla dashboard.
extends Basare la dashboard LookML su un'altra dashboard LookML.
extension Richiedi che la dashboard venga estesa da un'altra dashboard.
layout Definisci il modo in cui la dashboard posizionerà gli elementi.
tabs Aggiunta 26.4 Aggiunge schede della dashboard per organizzare gli elementi in una dashboard. Deve essere utilizzato insieme al parametro tab_name per gli elementi per specificare in quale scheda verrà visualizzato un elemento.
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 una dashboard layout: grid.
tile_size Definisci le dimensioni di un riquadro per una 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 le dashboard vengono eseguite automaticamente quando vengono aperte o ricaricate per la prima volta.
Filtra parametri
crossfilter_enabled Attiva o disattiva il filtro incrociato per una dashboard.
filters_bar_collapsed Imposta la barra dei filtri della dashboard come compressa o espansa per impostazione predefinita per una dashboard.
filters_location_top Imposta la posizione della barra dei filtri della dashboard su 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) Modifica 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 di 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) (Facoltativo) 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.
vis_filter Configura un filtro in modo che venga visualizzato direttamente in un riquadro di visualizzazione anziché nella barra dei filtri della dashboard.
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 degli elementi
elements (per la dashboard) Inizia una sezione di LookML per definire gli elementi della dashboard.
group (per gli elementi) Organizza gli elementi della dashboard in un gruppo di riquadri specificando il nome di un elemento type: group.

dashboard

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

- dashboard: sales_overview

Per visualizzare qualsiasi elemento, una dashboard richiede l'aggiunta di almeno un elemento utilizzando il parametro elements.

preferred_viewer (deprecato)

Prima del ritiro delle dashboard legacy in Looker 23.6, il parametro preferred_viewer 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)

Il parametro title consente di modificare il modo in cui il nome di una dashboard viene visualizzato dagli utenti nelle cartelle e nella parte superiore della dashboard. Se non specificato, il titolo predefinito è il nome della dashboard. Il testo del titolo può essere localizzato.

Considera questo esempio:

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

In questo caso, la dashboard non verrà visualizzata come Panoramica delle vendite, ma come 1) Panoramica delle vendite.

description (per la dashboard)

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 su visualizzazione elenco. Se non viene specificata una descrizione, l'elenco mostra 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 è attiva per impostazione predefinita.

Il parametro enable_viz_full_screen consente di impostare se i visualizzatori della dashboard possono vedere i riquadri della dashboard nelle visualizzazioni a schermo intero ed espanse. Equivale all'impostazione della 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.

enabled_dashboard_agents

Il parametro enabled_dashboard_agents ti consente di controllare se i visualizzatori della dashboard possono chattare con la dashboard LookML utilizzando un agente della dashboard.

Questo parametro ha effetto solo quando l'impostazione Dashboard agents è abilitata per la tua istanza di Looker nella pagina Amministrazione di Gemini in Looker.

Questo parametro accetta true (chat abilitata) e false (chat disabilitata). Se questo parametro viene omesso dal file della dashboard LookML, il valore predefinito è true a livello di API.

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

Il parametro default_dashboard_agent specifica il nome dell'agente della dashboard predefinito da associare alla dashboard LookML. L'agente specificato deve essere dichiarato utilizzando il parametro LookML agent.

Quando i visualizzatori avviano una conversazione con la dashboard, alla conversazione vengono applicate le impostazioni dell'agente predefinito, come la modalità di pensiero e la visualizzazione delle informazioni di debug.

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

Se enabled_dashboard_agents è true e default_dashboard_agent non è specificato, gli utenti possono comunque chattare con la dashboard utilizzando le impostazioni predefinite senza istruzioni personalizzate.

extends

Come descritto nella pagina della documentazione Riutilizzo del codice con extends, il parametro extends consente di basare una dashboard LookML su un'altra dashboard LookML, eventualmente aggiungendo o sostituendo alcune impostazioni. Il parametro extends accetta il nome di un'altra dashboard 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 agli altri utenti, ma può essere utilizzata come modello per creare altre dashboard visibili agli altri utenti. Il parametro extension accetta solo il valore required. Se il parametro extension non è incluso, l'estensione non è obbligatoria 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:

tabs

Aggiunge schede per organizzare gli elementi nelle dashboard. tabs definisce il numero, i nomi e le etichette delle schede visualizzate nelle dashboard. Gli elementi sono organizzati nelle schede della dashboard con il parametro tab_name.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4

tab_name

Specifica la scheda della dashboard in cui verrà visualizzato un elemento. tab_name deve essere specificato per ogni singolo elemento.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  - name: Tab 4
    label: Tab 4
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

rows

Per le 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 della 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, ciascuno occuperà il 50% dello spazio disponibile. Se inserisci 4 elementi in una riga, ciascuno 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 le dashboard layout: tile e layout: static, l'unità utilizzata per dimensionare e posizionare gli elementi è la dimensione del riquadro. Puoi definire 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 sono riportati 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 Parametri dei grafici a colonne per le dashboard LookML.

width

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

- dashboard: sales_overview
  layout: static
  width: 800

refresh

Il parametro refresh consente di ricaricare automaticamente una dashboard a intervalli regolari, recuperando così dati aggiornati. Questa opzione è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio sulla TV di un ufficio. Tieni presente che la dashboard deve essere aperta in una finestra del browser affinché questo parametro abbia effetto. Questa impostazione non viene eseguita in background per "pre-riscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere un numero qualsiasi (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é le dashboard possono contenere molte query, alcune delle quali possono richiedere un uso intensivo delle risorse, alcune dashboard potrebbero sovraccaricare il database.

auto_run

Il parametro auto_run determina se una dashboard verrà eseguita quando viene aperta o ricaricata per la prima volta. Il valore predefinito è true. Quando questo parametro è impostato su false, gli utenti dovranno 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 auto_run, gli utenti devono sempre fare clic su un pulsante Esegui dopo aver modificato i valori dei filtri. In questo modo, si evitano ricaricamenti indesiderati quando un utente fa una pausa durante la modifica di un 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, i visualizzatori della 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 per impostazione 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 consente di posizionare la barra dei filtri della dashboard in alto o a destra per una dashboard. Quando questo parametro è impostato su true, la barra dei filtri viene visualizzata nella parte superiore della dashboard; quando è 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

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" il filtro utilizzando il parametro listen. Questo parametro si applica a tutti i tipi di elementi, ad eccezione di type: text, type: button e type: group. Per un esempio rappresentativo del funzionamento di listen, consulta la pagina della documentazione Parametri dei grafici a colonne per le dashboard LookML.

Quando i filtri vengono applicati a un elemento in questo modo, il tipo di filtro deve corrispondere al tipo di dimensione o misura che ascolta 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
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  vis_filter: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

Ogni dichiarazione name crea un nuovo filtro della dashboard e gli assegna un nome. Il nome verrà indicato 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, type: button e type: group. I dettagli sul suo utilizzo sono riportati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo del funzionamento di listen, consulta la pagina della documentazione Parametri dei grafici a colonne per le dashboard LookML.

filters:
- name: order_date

title (per i filtri)

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 predefinito è il nome del filtro.

Considera questo esempio:

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

In questo caso, il filtro non verrebbe visualizzato come Data ordine, ma come Data/e ordine.

type

Il parametro type specifica il tipo di input che verrà inserito nel filtro. type: field_filter dovrebbe essere in genere la scelta predefinita, in quanto collega il filtro direttamente a una dimensione o misura sottostante e fornisce all'utente un widget di filtro personalizzato. I tipi di filtro sono i seguenti:

  • field_filter: in genere, deve 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 fa sì che il filtro suggerisca i possibili valori di filtro.
  • number_filter: consente all'input utente un numero, un valore intero o un'espressione.
  • date_filter: consente all'input utente un valore di data o un'espressione.

  • string_filter (deprecato): il tipo string_filter non è più supportato da quando l'esperienza della dashboard precedente è stata ritirata in Looker 23.6 (per ulteriori informazioni, consulta le note di rilascio). Se vuoi un filtro di immissione di testo in formato libero senza un elenco a discesa di suggerimenti, consulta l'esempio che utilizza field_filter.

field_filter

Suggerisce le 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 estratti i suggerimenti viene definita utilizzando i parametri explore e field e deve essere un campo di type: string per generare suggerimenti di filtro.

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

Di seguito è riportato un esempio di LookML per un tipo field_filter:

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

Se vuoi un filtro di immissione di testo in formato libero senza un elenco a discesa di suggerimenti, utilizza type: field_filter e poi configura il tipo di controllo utilizzando ui_config: type: advanced (consulta Configurazione UI).

L'esempio seguente mostra un filtro che utilizza l'input di testo in formato libero senza suggerimenti:

filters:
- name: customer_name
  type: field_filter
  explore: orders
  field: customer.name
  ui_config:
    type: advanced

number_filter

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

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

default_value

Il parametro default_value consente di specificare un valore predefinito da utilizzare per un filtro. Questo valore può essere utile agli utenti perché suggerisce 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: field_filter
  explore: orders
  field: customer.name
  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 sottoparametro 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 ti consente di controllare se gli utenti possono selezionare un singolo valore di filtro o più valori di filtro. Quando 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 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 non richiede un valore e viene lasciato vuoto, i dati non vengono semplicemente 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 sottoparametro ui_config di filters consente di configurare le impostazioni dei filtri per una dashboard LookML. Queste impostazioni includono i tipi di controlli filtro utilizzati, la posizione dei controlli filtro 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

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

type

Il sottoparametro type di ui_config 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.

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
ValoreDescrizioneTipi 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. 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 elenco a discesa con ogni possibile valore 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, con un pulsante 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 possibile valore specificato utilizzando il parametro options. Il menu a discesa offre inoltre agli utenti l'opzione per selezionare Qualsiasi valore. STR NUM TIER ZIP Y/N DIST DUR PAR
slider Per i campi numerici, il filtro mostra un dispositivo di scorrimento che consente agli utenti di scegliere un filtro scorrendo tra i valori minimi e massimi 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. D&T Il controllo per un singolo 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 in base a un intervallo di date. D&T 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 gli intervalli di date che hanno questo tipo di controllo.
date_time_range_input Il filtro consente all'utente di filtrare in base a un intervallo di date e ore. D&T Il controllo intervallo di date e ore può essere utilizzato con la maggior parte dei tipi basati sul tempo e i visualizzatori devono selezionare entrambe le opzioni di data e 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 periodi di tempo preimpostati, ad esempio Oggi, Ultimi 7 giorni o Ultimi 90 giorni. D&T 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 di tempo con questo tipo di controllo.
Altro
advancedIl filtro presenta opzioni per l'applicazione di uno o più filtri o filtri di corrispondenza avanzata.

Per saperne di più sui controlli avanzati, consulta la sezione Utilizzo dei controlli avanzati di questa pagina. 		STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

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 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 scoprire 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 di filtri definiti dall'utente.

options

Il sottoparametro facoltativo options di ui_config consente di specificare i valori tra cui un utente può scegliere per aggiornare temporaneamente i valori dei filtri della dashboard quando visualizza 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 come segue:


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, il parametro model definisce il modello del campo che vuoi utilizzare. Il parametro model è facoltativo e il valore predefinito è il modello in cui è inclusa la dashboard.

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

explore

Per i filtri della dashboard di type: field_filter, devi definire un campo da cui il filtro estrarrà 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 estrarrà 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. I valori selezionati per il filtro Order ID avranno valori users.state associati e questi valori saranno i valori suggeriti per il filtro State. Per saperne di più, consulta la pagina della documentazione Aggiunta e modifica dei filtri delle dashboard definite dall'utente.

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

vis_filter

Il parametro vis_filter consente di configurare un filtro come filtro a livello di visualizzazione che viene visualizzato direttamente nei singoli riquadri di visualizzazione anziché nella barra dei filtri della dashboard in alto.

Quando vis_filter è impostato su true, il filtro viene visualizzato nella barra dei filtri nella parte superiore di qualsiasi tile che lo ascolta (configurato utilizzando il parametro listen nell'elemento della dashboard). Il valore predefinito è false, che mostra il filtro come filtro standard a livello di dashboard nella barra dei filtri in alto. L'impostazione vis_filter: false non è necessaria per i filtri standard della dashboard.

Ad esempio:

filters:
- name: order_date
  title: "Order Date"
  type: date_filter
  default_value: "last 30 days"
  vis_filter: true

Per ulteriori informazioni sui filtri a livello di visualizzazione, consulta la pagina della documentazione Filtri sui riquadri di visualizzazione.

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 associati 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 applicate 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 di colore con nome 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.

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

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 della dashboard. Sono descritti in maggiore dettaglio nella pagina Parametri degli elementi della dashboard.

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

group

Organizza gli elementi della dashboard in un gruppo di riquadri su una dashboard LookML. Per utilizzare i gruppi di riquadri in una dashboard LookML, l'amministratore di Looker deve attivare la funzionalità in anteprima Dashboard Tile Groups e la dashboard deve utilizzare il metodo di layout della dashboard newspaper.

Per creare un gruppo di riquadri e aggiungervi elementi in LookML, segui questi passaggi:

  1. Definisci un contenitore di gruppi di riquadri nella sezione elements con type: group e specifica name, title, row, col, width e height (e, facoltativamente, tab_name, title_hidden e aria_description). Gli elementi di type: group sono contenitori visivi e non accettano parametri di ricerca come model, explore o listen.
  2. In ogni elemento della dashboard che vuoi inserire nel gruppo di riquadri, aggiungi il parametro group e imposta il suo valore su name dell'elemento type: group.

Quando organizzi gli elementi in un gruppo di riquadri, tieni presente quanto segue:

  • Per gli elementi posizionati all'interno di un gruppo di riquadri, i parametri row e col definiscono la posizione dell'elemento rispetto all'angolo in alto a sinistra (row: 0, col: 0) del container del gruppo anziché del canvas della dashboard.
  • Nelle dashboard con schede, l'elemento secondario tab_name deve corrispondere al gruppo principale tab_name.
  • Looker non supporta i gruppi di riquadri nidificati (inserimento di un elemento type: group all'interno di un altro gruppo di riquadri).
- dashboard: sales_overview
  layout: newspaper
  elements:
  - name: revenue_metrics_group
    title: "Revenue Metrics"
    type: group
    row: 0
    col: 0
    width: 24
    height: 8
  - name: total_revenue
    title: "Total Revenue"
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.total_revenue]
    group: revenue_metrics_group
    row: 0
    col: 0
    width: 8
    height: 6