Parametri dei pulsanti per le dashboard LookML

I pulsanti sono supportati solo dalle dashboard LookML con le seguenti impostazioni:

Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: button con i parametri della dashboard LookML in un file dashboard.lkml. I pulsanti sono utili per inserire link nelle dashboard. Puoi creare link a contenuti di Looker, come Look e dashboard, o ad altri siti web.

Per informazioni sull'aggiunta di pulsanti a una dashboard tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Creazione di dashboard definite dall'utente.

Esempio di utilizzo


## BASIC PARAMETERS
type: button
name: text
height: N
width: N
row: N
col: N

## BUTTON PARAMETER
rich_content_json: '{
 "text": "button text",
 "description": "description",
 "newTab": true | false,
 "alignment": "left" | "right" | "center",
 "size": "small" | "medium" | "large",
 "style": "OUTLINED" | "FILLED" | "TRANSPARENT",
 "color": "hex string or css color",
 "href": "link"
 }'

Definizioni dei parametri

Nome parametro Descrizione
Parametri di base
type (per gli elementi) Determina il tipo di visualizzazione da utilizzare nell'elemento
name (per gli elementi) Crea un elemento
height (per gli elementi) Definisce l'altezza della casella del riquadro di un elemento pulsante. L'altezza è espressa in unità di righe per le dashboard layout: newspaper
width (per gli elementi) Definisce la larghezza della casella del riquadro di un elemento pulsante. La larghezza è espressa in unità di colonne per le dashboard layout: newspaper
row Definisce la posizione dall'alto verso il basso della casella del riquadro di un elemento pulsante in unità di righe per le dashboard layout: newspaper
col Definisce la posizione da sinistra a destra della casella del riquadro di un elemento pulsante in unità di colonne per le dashboard layout: newspaper
Parametro del pulsante
rich_content_json Un oggetto JSON contenente coppie chiave/valore con informazioni sul pulsante

Parametri base

Quando definisci un elemento della dashboard LookML di type: button, devi specificare i valori almeno per i parametri name e type.

I parametri height, width, row e col si applicano alla casella del riquadro di un elemento pulsante, non al pulsante stesso.

name

Questa sezione si riferisce al parametro name, che fa parte di un elemento della dashboard.

name può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci.

Il valore name assegnato al pulsante non verrà visualizzato nell'interfaccia utente della dashboard.

- name: orders_by_date

type

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

type può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai parametri della dashboard.

type può essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametro type (per i join).

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, descritta nella pagina della documentazione Tipi di misure.

Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall |
        looker_wordcloud | looker_boxplot | button | group

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione type (per le dashboard LookML).

height

Questa sezione si riferisce al parametro height, che fa parte di un elemento della dashboard.

height può essere utilizzato anche come parte di una riga della dashboard, descritta nella pagina della documentazione relativa ai parametri della dashboard.

Il parametro height definisce l'altezza della casella del riquadro di un elemento pulsante, in unità di row.

Per impostazione predefinita, i riquadri degli elementi dei pulsanti hanno un'altezza di 6 righe. L'altezza minima è di 1 riga. La modifica dell'altezza dell'elemento pulsante potrebbe influire su altri elementi della dashboard, ma non sull'altezza del pulsante stesso.

Ad esempio, il seguente codice imposta l'altezza della casella del pulsante su 12 righe:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Questa sezione si riferisce al parametro width, che fa parte di un elemento della dashboard.

width può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro width definisce la larghezza della casella del riquadro di un elemento pulsante, in unità di colonne.

La larghezza della casella del riquadro di un elemento pulsante è di 8 colonne per impostazione predefinita, ovvero un terzo della larghezza totale di una dashboard. La larghezza minima per la casella di un pulsante è 2.

Ad esempio, il seguente codice imposta la casella del riquadro di un pulsante su metà della larghezza della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

Se c'è spazio all'interno della casella del riquadro di un pulsante, la larghezza del pulsante aumenterà per contenere una stringa di testo lunga, definita in text. Tuttavia, la larghezza del pulsante non aumenterà oltre il valore impostato nel parametro width e, se necessario, la stringa definita in text verrà troncata sul pulsante.

row

Il parametro row definisce la riga su cui è posizionato il bordo superiore della casella del riquadro di un elemento pulsante. Se il pulsante viene posizionato all'interno di un gruppo di riquadri utilizzando il parametro group, row definisce la posizione della riga del pulsante rispetto alla parte superiore del contenitore del gruppo (row: 0).

Una dashboard inizia con la riga 0 nella parte superiore. Per impostazione predefinita, gli elementi dei pulsanti della dashboard hanno un'altezza di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occupano per impostazione predefinita le righe 0-5.

Nell'esempio seguente, il codice imposta la casella di un pulsante in modo che venga posizionata nella seconda riga di elementi della dashboard, supponendo che gli elementi siano impostati sull'altezza predefinita:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Il parametro col definisce la colonna su cui è posizionato il bordo sinistro della casella del riquadro dell'elemento del pulsante. Se il pulsante è posizionato all'interno di un gruppo di riquadri utilizzando il parametro group, col definisce la posizione della colonna del pulsante rispetto al bordo sinistro del contenitore del gruppo (col: 0).

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di tipo giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperebbero per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna di elementi della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

Parametro del pulsante

Il parametro descritto in questa sezione può essere utilizzato per aggiungere contenuti a un elemento della dashboard LookML di type: button.

rich_content_json

rich_content_json è un oggetto JSON con diverse coppie chiave-valore che definiscono le caratteristiche del pulsante della dashboard.

L'esempio di utilizzo seguente mostra un pulsante della dashboard che consente di passare a un'altra dashboard.

rich_content_json: '{
 "text": "Go to Sales Dashboard",
 "description": "View sales from the last 18 months.",
 "newTab": true,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "href":"https://instance_name.looker.com/dashboards/152?State=California&Created+Fiscal+Quarter=2022"
 }'

L'esempio di utilizzo seguente mostra un pulsante della dashboard che consente di passare a una scheda della dashboard.

rich_content_json: '{
 "text": "Go to Users tab",
 "description": "View user data from the last 18 months.",
 "newTab": false,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "targetTabName":"Users"
 "href":""
 }'

text

text definisce il testo che verrà visualizzato sul pulsante nell'interfaccia utente della dashboard. Il pulsante si espande in larghezza per adattarsi al testo fino a raggiungere il limite impostato dal parametro width, dopodiché il testo verrà troncato.

description

description definisce il testo che viene visualizzato come tooltip quando passi il cursore sopra il pulsante. Se non viene fornita alcuna descrizione, per impostazione predefinita viene mostrato il link fornito in href.

newTab

newTab è un valore booleano che definisce se il link del pulsante si aprirà in una nuova scheda (true) o nella scheda corrente (false). Il valore predefinito di newTab è true.

alignment

alignment imposta l'allineamento del pulsante all'interno della casella del riquadro dell'elemento pulsante. Il valore predefinito di alignment è center.

dimensioni

size imposta le dimensioni del pulsante e del relativo testo su small, medium o large. Il valore di size non influisce sulle dimensioni della casella del riquadro dell'elemento del pulsante o sul parametro height.

style

style imposta lo stile del pulsante su uno dei seguenti valori:

  • FILLED: il corpo del pulsante viene riempito con il colore impostato in color. Il testo del pulsante è bianco. Questo è il valore predefinito.
  • OUTLINED: il pulsante ha un contorno attorno al bordo, ma il corpo è trasparente. Il colore del testo del pulsante è impostato da color.
  • TRANSPARENT: il corpo del pulsante è trasparente. Il colore del testo del pulsante è impostato da color.

color

color imposta il colore del pulsante o del testo del pulsante, a seconda dell'impostazione style. color viene impostato per impostazione predefinita sul primo colore della raccolta di colori categoriali predefinita dell'istanza di Looker.

I valori dei colori possono essere formattati come stringhe esadecimali, ad esempio #2ca6cd, o come nomi di colori CSS, ad esempio mediumblue.

targetTabName

Se la dashboard ha delle schede, targetTabName imposta la scheda della dashboard a cui il pulsante indirizzerà gli utenti.

Scopri di più sulle dashboard con schede.

href

href imposta l'URL a cui il pulsante indirizzerà gli utenti. I link ad altre dashboard di Looker possono contenere parametri di filtro che impostano i filtri della dashboard su valori specifici.