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 di Looker, come Look e dashboard, o ad altri siti web.

Per informazioni sull'aggiunta di pulsanti a una dashboard tramite la UI 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 del riquadro di un elemento pulsante. L'altezza è in unità di righe per i dashboard layout: newspaper
width (per gli elementi) Definisce la larghezza 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 i 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 Button
rich_content_json Un oggetto JSON che contiene coppie chiave/valore con informazioni sul pulsante

Parametri di base

Quando definisci un elemento del 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 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 del dashboard.

name può essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione 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 del dashboard.

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

type può essere utilizzato anche nell'ambito di un'unione, come descritto nella pagina della documentazione relativa al parametro type (per le unioni).

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

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

Il parametro type 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 delle dashboard LookML, consulta la pagina di documentazione type (per le dashboard LookML).

height

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

height può essere utilizzato anche nell'ambito di una riga della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

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

Le caselle dei riquadri degli elementi pulsante hanno un'altezza predefinita di 6 righe. L'altezza minima è di 1 riga. La modifica dell'altezza dell'elemento pulsante può influire su altri elementi nel 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 del dashboard.

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

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

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

Ad esempio, il seguente codice imposta la casella del riquadro di un pulsante sulla metà della larghezza del 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 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 riquadro del bordo superiore di un elemento pulsante.

Una dashboard inizia con la riga 0 nella parte superiore della dashboard. Per impostazione predefinita, i pulsanti del cruscotto hanno un'altezza di 6 righe, il che significa che gli elementi del cruscotto nella parte superiore di un cruscotto (row: 0) occuperanno le righe da 0 a 5.

Nell'esempio seguente, il codice imposta la casella del riquadro di un pulsante in modo che venga posizionata nella seconda riga di elementi nella dashboard, supponendo che gli elementi siano impostati all'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 riquadro del bordo sinistro dell'elemento pulsante.

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

Parametro pulsante

Il parametro descritto in questa sezione può essere utilizzato per aggiungere contenuti a un elemento del 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 del cruscotto.

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"
 }'

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

description

description definisce il testo visualizzato come descrizione comando 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 verrà aperto 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 sulla dimensione della casella del riquadro dell'elemento pulsante o sul parametro height.

style

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

  • FILLED: il corpo del pulsante è riempito con il colore impostato in color. Il testo del pulsante è bianco. Questo è il valore predefinito.
  • OUTLINED: il pulsante ha un contorno intorno 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 è impostato per impostazione predefinita sul primo colore della raccolta di colori categoriali predefinita dell'istanza di Looker.

I valori di colore 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 verrà indirizzato il pulsante.

Scopri di più sulle dashboard a schede.

href

href imposta l'URL a cui verrà indirizzato l'utente. I link ad altre dashboard di Looker possono contenere parametri di filtro che impostano i filtri della dashboard su valori specifici.