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 all'interno delle dashboard. Puoi creare link a contenuti 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 del riquadro dell'elemento del pulsante. L'altezza è espressa in unità di righe per le layout: newspaper dashboard
width (per gli elementi) Definisce la larghezza del riquadro dell'elemento del pulsante. La larghezza è espressa in unità di colonne per le layout: newspaper dashboard
row Definisce la posizione dall'alto verso il basso del riquadro dell'elemento del pulsante in unità di righe per le dashboard layout: newspaper
col Definisce la posizione da sinistra a destra del riquadro dell'elemento del pulsante in unità di colonne per le dashboard layout: newspaper
Parametro del pulsante
rich_content_json Un oggetto JSON che contiene coppie chiave-valore con informazioni sul pulsante

Parametri di base

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

I parametri height, width, row e col si applicano al riquadro dell'elemento del 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, come descritto nella pagina della documentazione relativa 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 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, come descritto nella pagina della documentazione relativa ai parametri della dashboard.

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

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

type può essere utilizzato anche come parte di una misura, come descritto nella pagina della documentazione relativa ai 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

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione relativa a 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, come descritto nella pagina della documentazione relativa ai parametri della dashboard.

Il parametro height definisce l'altezza del riquadro dell'elemento del pulsante in unità di righe.

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 del pulsante potrebbe influire su altri elementi della dashboard, ma non sull'altezza del pulsante stesso.

Ad esempio, il seguente codice imposta l'altezza del riquadro 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 come parte di una dashboard, come descritto nella pagina della documentazione relativa ai parametri della dashboard.

Il parametro width definisce la larghezza del riquadro dell'elemento del pulsante in unità di colonne.

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

Ad esempio, il seguente codice imposta il riquadro di un pulsante sulla metà della larghezza della dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Se c'è spazio all'interno del riquadro di un pulsante, la larghezza del pulsante aumenterà per adattarsi a una lunga stringa di testo, 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 in cui viene posizionato il bordo superiore del riquadro dell'elemento del pulsante.

Una dashboard inizia con la riga 0 nella parte superiore della dashboard. 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) occuperanno per impostazione predefinita le righe da 0 a 5.

Nell'esempio seguente, il codice imposta il riquadro di un pulsante in modo che venga posizionato nella seconda riga di elementi della dashboard, presupponendo 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 in cui viene posizionato il bordo sinistro del riquadro dell'elemento del pulsante.

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

Ad esempio, il seguente codice imposta un elemento in modo che venga posizionato 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.

Il seguente esempio di utilizzo 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"
 }'

Il seguente esempio di utilizzo 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. La larghezza del pulsante si espande per adattarsi al testo fino a raggiungere il limite impostato dal width parametro, a quel punto il testo verrà troncato.

description

description definisce il testo che viene visualizzato come suggerimento quando tieni il cursore sopra il pulsante. Se non viene fornita alcuna descrizione, per impostazione predefinita viene visualizzato 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 del riquadro dell'elemento del 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 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 è riempito dal 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 il valore predefinito è il primo colore della raccolta di colori categorici predefinita dell'istanza 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 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 Looker possono contenere parametri di filtro che impostano i filtri della dashboard su valori specifici.