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 di un elemento pulsante. L'altezza è in unità di righe per i dashboard layout: newspaper
width (per gli elementi) Definisce la larghezza del riquadro del riquadro di un elemento pulsante. La larghezza è 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 i dashboard layout: newspaper
Parametro Button
rich_content_json Un oggetto JSON contenente 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 del dashboard, come descritto nella pagina della documentazione Parametri del dashboard.

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

I riquadri dei pulsanti hanno un'altezza predefinita di 6 righe. L'altezza minima è di una 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 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 bordo superiore della casella del riquadro di un elemento pulsante.

Una dashboard inizia con la riga 0 nella parte superiore della dashboard. Per impostazione predefinita, i 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 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 bordo sinistro del riquadro dell'elemento pulsante.

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di 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) 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 Button

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.

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

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 popup al passaggio del mouse 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. alignment è impostato su center per impostazione predefinita.

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 viene impostato 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.

href

href imposta l'URL a cui indirizzare gli utenti quando fanno clic sul pulsante. I link ad altre dashboard di Looker possono contenere parametri di filtro che impostano i filtri della dashboard su valori specifici.

In un'esperienza incorporata, i link ai dashboard devono contenere embed/ nell'URL del link.