LookML-Dashboard-Parameter

Dashboards können auf zwei Arten erstellt werden. Benutzerdefinierte Dashboards werden über die Looker-Benutzeroberfläche erstellt. Eine Beschreibung finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen. Dashboards können auch mit LookML erstellt und ihre allgemeinen Einstellungen wie auf dieser Seite beschrieben geändert werden.

Auf dieser Seite werden die LookML-Dashboard-Parameter beschrieben, die sich auf das gesamte Dashboard auswirken.

Ein LookML-Dashboard enthält auch Elemente, also Datenvisualisierungen, Textkacheln und Schaltflächen im Dashboard. Auf der Seite Parameter für Dashboard-Elemente finden Sie Links zu den Referenzseiten für die einzelnen Elementtypen.

Nutzungsbeispiel

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  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 | string_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
    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.

Parameterdefinitionen

Parametername Beschreibung
dashboard Dashboard erstellen
preferred_viewer Dieser Parameter wird ignoriert.
title (für Dashboard) Ändern, wie ein Dashboard-Name für Nutzer angezeigt wird
description (für Dashboard) Fügen Sie eine Beschreibung hinzu, die im Bereich „Dashboard-Details“ oder in einem Ordner in der Listenansicht angezeigt werden kann.
enable_viz_full_screen Legen Sie fest, ob Betrachter von Dashboards Dashboard-Kacheln im Vollbildmodus und in der erweiterten Ansicht sehen können.
extends Das LookML-Dashboard auf einem anderen LookML-Dashboard basieren.
extension Das Dashboard muss durch ein anderes Dashboard erweitert werden.
layout Definieren Sie, wie die Elemente im Dashboard platziert werden.
tabs Hinzugefügt in Version 26.4 Mit dieser Funktion werden Dashboard-Tabs hinzugefügt, um Elemente in einem Dashboard zu organisieren. Muss in Verbindung mit dem Parameter tab_name für Elemente verwendet werden, um anzugeben, auf welchem Tab ein Element angezeigt wird.
rows Leiten Sie einen Abschnitt von LookML ein, mit dem die Elemente definiert werden, die in die einzelnen Zeilen eines layout: grid-Dashboards aufgenommen werden sollen.
elements (für Zeilen) Definieren Sie die Elemente, die in eine Zeile eines layout: grid-Dashboards aufgenommen werden sollen.
height (für Zeilen) Definieren Sie die Höhe einer Zeile für ein layout: grid-Dashboard.
tile_size Definieren Sie die Größe einer Kachel für ein layout: tile-Dashboard.
width (für Dashboard) Definieren Sie die Breite des Dashboards für ein layout: static-Dashboard.
refresh (für Dashboard) Legen Sie das Intervall fest, in dem Dashboardelemente automatisch aktualisiert werden.
auto_run Bestimmt, ob Dashboards beim ersten Öffnen oder beim Neuladen automatisch ausgeführt werden.
Filterparameter
crossfilter_enabled Aktivieren oder deaktivieren Sie die Kreuzfilterung für ein Dashboard.
filters_bar_collapsed Legen Sie fest, ob die Dashboard-Filterleiste für ein Dashboard standardmäßig ein- oder ausgeblendet sein soll.
filters_location_top Legen Sie die Position der Dashboard-Filterleiste für ein Dashboard auf Oben oder Rechts fest.
filters (für Dashboard) Leitet einen Abschnitt von LookML ein, mit dem Dashboardfilter definiert werden.
name (für Filter) Filter erstellen.
title (für Filter) Ändern, wie ein Filtername für Nutzer angezeigt wird
type (für Filter) Bestimmen Sie den zu verwendenden Filtertyp.
default_value Standardwert für einen Filter festlegen
allow_multiple_values Benutzer auf einen einzigen Filterwert beschränken.
required Nutzer müssen einen Filterwert eingeben, um das Dashboard auszuführen.
ui_config Konfigurieren Sie die Filtersteuerelemente, die Nutzern beim Aufrufen eines LookML-Dashboards zur Verfügung stehen. Hat die Unterparameter type, display und options.
model (für Filter) Geben Sie das Modell an, das das zugrunde liegende Feld eines type: field_filter-Filters enthält.
explore (für Filter) Geben Sie das Explore an, das das zugrunde liegende Feld eines type: field_filter-Filters enthält.
field Geben Sie das zugrunde liegende Feld eines type: field_filter-Filters an.
listens_to_filters Vorschläge für Dashboard-Filter von field_filter werden basierend auf den Eingaben des Nutzers für einen anderen Dashboard-Filter von type: field_filter eingeschränkt.
Parameter für eingebettete Dashboards
embed_style Leitet einen Abschnitt von LookML ein, mit dem eingebettete Dashboard-Anpassungen definiert werden.
background_color Hintergrundfarbe eines eingebetteten Dashboards festlegen
show_title Geben Sie an, ob der Dashboard-Titel in einem eingebetteten Dashboard sichtbar sein soll.
title_color Hiermit legen Sie die Farbe des Titels eines eingebetteten Dashboards fest.
show_filters_bar Geben Sie an, ob die Filterleiste in einem eingebetteten Dashboard sichtbar ist.
tile_background_color Hintergrundfarbe von Kacheln in einem eingebetteten Dashboard festlegen
tile_text_color Textfarbe für Kacheln in einem eingebetteten Dashboard festlegen
Elementparameter
elements (für Dashboard) Leitet einen Abschnitt von LookML ein, mit dem Dashboard-Elemente definiert werden.

dashboard

Mit dem Parameter dashboard wird ein neues Dashboard deklariert und ein Name für das Dashboard angegeben. Es sind maximal 255 Zeichen zulässig. Zulässige Zeichen sind Buchstaben (A–Z), Ziffern (0–9), Bindestriche (-) und Unterstriche (_). In der Regel empfiehlt es sich, jedes LookML-Dashboard in einer eigenen LookML-Datei zu platzieren. Es ist jedoch möglich, mehrere Dashboards in einer einzigen Datei zu deklarieren.

- dashboard: sales_overview

Damit etwas angezeigt werden kann, muss einem Dashboard mindestens ein Element mit dem Parameter elements hinzugefügt werden.

preferred_viewer

Dieser Parameter wird ignoriert.

Vor der Einstellung von Legacy-Dashboards in Looker 23.6 konnten Sie mit dem Parameter preferred_viewer das Format zum Aufrufen und Herunterladen eines Dashboards entweder als Standard-Dashboard-Erfahrung von Looker oder als Legacy-Dashboard auswählen.

title (für das Dashboard)

Mit dem Parameter title können Sie ändern, wie ein Dashboard-Name Nutzern in Ordnern und oben im Dashboard angezeigt wird. Wenn nichts festgelegt wurde, wird der Name des Dashboards standardmäßig als Titel verwendet. Der Titeltext kann lokalisiert werden.

Betrachten Sie dieses Beispiel:

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

Wenn Sie das getan haben, wird das Dashboard nicht als Umsatzübersicht, sondern als 1) Umsatzübersicht angezeigt.

description (für das Dashboard)

Mit dem Parameter description können Sie einem LookML-Dashboard eine Beschreibung hinzufügen.

Der Inhalt des Parameters description wird im Feld Beschreibung des Bereichs „Dashboard-Details“ eines LookML-Dashboards angezeigt.

Die Beschreibung wird unter dem Dashboard-Titel in den Dashboard-Listen angezeigt, wenn sie in einem Ordner in der Listenansicht aufgerufen werden. Wenn keine Beschreibung angegeben ist, wird in der Liste nur der Dashboardtitel angezeigt.

Der Beschreibungstext kann lokalisiert werden.

enable_viz_full_screen

Dieser Parameter wird nur wirksam, wenn die Einstellung Vollbildvisualisierungen von einem Looker-Administrator aktiviert wird. Die Einstellung Vollbildvisualisierung ist standardmäßig aktiviert.

Mit dem Parameter enable_viz_full_screen können Sie festlegen, ob Dashboard-Betrachter Dashboard-Kacheln im Vollbildmodus und in der erweiterten Ansicht sehen können. Sie entspricht der Dashboard-Einstellung Vollbildmodus für Visualisierungen zulassen.

Für diesen Parameter sind die Werte true (Vollbildmodus und erweiterte Ansichten verfügbar) und false (Vollbildmodus und erweiterte Ansichten nicht verfügbar) zulässig. Der Standardwert ist true.

extends

Wie auf der Dokumentationsseite Code mit „extends“ wiederverwenden beschrieben, können Sie mit dem Parameter extends ein LookML-Dashboard auf einem anderen LookML-Dashboard basieren lassen und dabei möglicherweise einige Einstellungen hinzufügen oder überschreiben. Für den Parameter extends kann der Name eines anderen LookML-Dashboards angegeben werden.

extension

Wie auf der Dokumentationsseite Code mit „extends“ wiederverwenden beschrieben, gibt der Parameter extension an, dass das Dashboard unbedingt durch ein anderes Dashboard erweitert werden muss. Dieses Dashboard ist für andere Nutzer nie sichtbar, kann aber als Vorlage zum Erstellen anderer Dashboards verwendet werden, die für andere Nutzer sichtbar sind. Der Parameter extension akzeptiert nur den Wert required. Wenn der Parameter extension nicht enthalten ist, ist keine Erweiterung für das Dashboard erforderlich.

layout

Mit dem Parameter layout wird die Layoutmethode festgelegt, die Looker zum Positionieren von Dashboard-Elementen verwendet. Es werden die folgenden Werte akzeptiert:

tabs

Es werden Tabs zum Organisieren von Elementen in Dashboards hinzugefügt. Mit tabs werden die Anzahl, Namen und Labels der Tabs definiert, die in Dashboards angezeigt werden. Elemente werden auf Dashboard-Tabs mit dem Parameter tab_name organisiert.

- 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

Gibt an, auf welchem Dashboard-Tab ein Element angezeigt wird. tab_name muss für jedes einzelne Element angegeben werden.

- 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

Bei layout: grid-Dashboards wird mit dem Parameter rows der Abschnitt von LookML gestartet, in dem Sie definieren, welche Elemente in welche Zeilen eingefügt werden sollen und wie hoch die einzelnen Zeilen sein sollen. Innerhalb jeder Zeile haben alle Elemente dieselbe Breite. Wenn Sie ein Element in diesem Abschnitt nicht auflisten, wird es nicht im Dashboard angezeigt.

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

Für den Parameter elements kann eine durch Kommas getrennte Liste von Dashboard-Elementnamen angegeben werden. Mit jeder elements-Deklaration wird eine neue Zeile im Dashboard erstellt. Alle Elemente, die in einer Zeile platziert werden, haben dieselbe Breite. Wenn Sie also zwei Elemente in einer Zeile platzieren, nehmen sie jeweils 50% des verfügbaren Platzes ein. Wenn Sie vier Elemente in eine Zeile einfügen, nehmen sie jeweils 25% des verfügbaren Platzes ein.

height

Der Parameter height definiert die Höhe einer Zeile in Pixeln. Der Standardwert ist 300.

tile_size

Bei layout: tile- und layout: static-Dashboards wird die Kachelgröße als Einheit für die Größe und Position von Elementen verwendet. Sie definieren tile_size in Pixeln. Der Standardwert ist 160. Beispiel:

- dashboard: sales_overview
  layout: tile
  tile_size: 100

In diesem Fall ist ein Dashboard-Element mit height: 5 und width: 3 500 Pixel hoch und 300 Pixel breit. Die Parameter height und width gelten für alle Elementtypen. Details zu ihrer Verwendung finden Sie auf den Dokumentationsseiten für die einzelnen Visualisierungstypen. Ein repräsentatives Beispiel für die Funktionsweise von height und width finden Sie auf der Dokumentationsseite Säulendiagrammparameter für LookML-Dashboards.

width

Bei layout: static-Dashboards wird mit dem Parameter width die Gesamtbreite des Dashboards in Pixeln definiert, die Sie verwenden möchten. Mit dem Parameter width wird das Dashboard nicht auf eine bestimmte Größe beschränkt, wenn Sie ein zu großes Element oder zu viele Elemente in einer Zeile definieren. Die Einstellung width sorgt dafür, dass das Dashboard auf dem Bildschirm zentriert bleibt. Wenn Sie keine Breite festlegen, wird der Standardwert 1200 verwendet.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

Mit dem Parameter refresh kann ein Dashboard in regelmäßigen Abständen automatisch neu geladen werden, um aktuelle Daten abzurufen. Das ist oft hilfreich, wenn ein Dashboard ständig angezeigt wird, z. B. auf einem Fernseher im Büro. Das Dashboard muss in einem Browserfenster geöffnet sein, damit dieser Parameter wirksam wird. Diese Einstellung wird nicht im Hintergrund ausgeführt, um den Dashboard-Cache „vorzubereiten“.

Die Aktualisierungsrate kann eine beliebige Anzahl (ohne Dezimalstellen) von Sekunden, Minuten, Stunden oder Tagen sein. Beispiel:

- dashboard: sales_overview
  refresh: 2 hours

Seien Sie vorsichtig, wenn Sie kurze Aktualisierungsintervalle festlegen. Da Dashboards viele Abfragen enthalten können, von denen einige ressourcenintensiv sein können, kann es sein, dass bestimmte Dashboards Ihre Datenbank belasten.

auto_run

Mit dem Parameter auto_run wird festgelegt, ob ein Dashboard ausgeführt wird, wenn es zum ersten Mal geöffnet oder neu geladen wird. Der Standardwert ist true. Wenn dieser Parameter auf false festgelegt ist, müssen Nutzer auf die Schaltfläche Ausführen klicken, um das Dashboard zu laden. Ein Dashboard wie dieses wird beispielsweise automatisch ausgeführt, wenn es geöffnet wird:

- dashboard: sales_overview
  auto_run: true

Unabhängig von der auto_run-Einstellung müssen Nutzer immer auf die Schaltfläche Ausführen klicken, nachdem sie Filterwerte geändert haben. So können Sie unerwünschte Neuladevorgänge vermeiden, wenn ein Nutzer bei einer Filteränderung pausiert oder mehrere Filter gleichzeitig ändern möchte.

crossfilter_enabled

Mit dem Parameter crossfilter_enabled können Sie Kreuzfilter für ein Dashboard aktivieren oder deaktivieren. Wenn dieser Parameter auf true festgelegt ist, können Dashboard-Betrachter Kreuzfilter für das Dashboard erstellen, indem sie auf bestimmte Datenpunkte klicken.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

Mit dem Parameter filters_bar_collapsed können Sie festlegen, ob die Dashboard-Filterleiste standardmäßig minimiert oder maximiert sein soll. Wenn dieser Parameter auf true gesetzt ist, ist die Filterleiste standardmäßig minimiert. Betrachter von Dashboards können die Filterleiste maximieren, indem sie auf das Filtersymbol klicken. Die Standardeinstellung für diese Option ist false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

Mit dem Parameter filters_location_top können Sie die Dashboard-Filterleiste für ein Dashboard oben oder rechts platzieren. Wenn dieser Parameter auf true gesetzt ist, wird die Filterleiste oben im Dashboard angezeigt. Wenn er auf false gesetzt ist, wird die Filterleiste rechts im Dashboard angezeigt. Die Standardeinstellung für diese Option ist true.

- dashboard: sales_data
  filters_location_top: false

filters

Mit dem Parameter filters wird der Abschnitt von LookML eingeleitet, in dem Sie Dashboardfilter definieren. Filter werden oben im Dashboard angezeigt. Nutzer können damit die Daten ändern, die den Dashboard-Elementen zugrunde liegen.

Damit sich ein Filter auf ein Element auswirkt, muss das Element mit dem Parameter listen so konfiguriert sein, dass es auf diesen Filter „wartet“. Dieser Parameter gilt für alle Elementtypen außer type: text und type: button. Ein repräsentatives Beispiel für die Funktionsweise von listen finden Sie auf der Dokumentationsseite Säulendiagrammparameter für LookML-Dashboards.

Wenn Filter auf diese Weise auf ein Element angewendet werden, muss der Filtertyp mit dem Dimensions- oder Messwerttyp übereinstimmen, der auf den Filter wartet (Weitere Informationen). Filter haben das folgende Format:

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_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
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

Mit jeder name-Deklaration wird ein neuer Dashboardfilter erstellt und ihm ein Name zugewiesen. Der Name wird im Parameter listen von Elementen referenziert, die vom Filter betroffen sein sollen. Der Parameter listen gilt für alle Elementtypen außer type: text. Details zur Verwendung finden Sie auf den Dokumentationsseiten für die einzelnen Visualisierungstypen. Ein repräsentatives Beispiel für die Funktionsweise von listen finden Sie auf der Dokumentationsseite Säulendiagrammparameter für LookML-Dashboards.

filters:
- name: order_date

title (für Filter)

Mit dem Parameter title können Sie ändern, wie ein Filtername oben auf einem Dashboard für Nutzer angezeigt wird. Wenn nichts festgelegt wurde, wird der Name des Filters standardmäßig als Titel verwendet.

Betrachten Sie dieses Beispiel:

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

In diesem Fall würde der Filter nicht als Bestelldatum, sondern als Bestelldatum(e) angezeigt.

type

Der Parameter type gibt den Typ der Eingabe an, die in den Filter eingefügt wird. In den type: string_filter-Filter kann jede Art von Eingabe (z. B. ein Datum) geschrieben werden. Wenn Sie jedoch genauer sind, wird dem Nutzer ein besser angepasstes Filter-Widget zur Verfügung gestellt. Es gibt vier Arten von Filtern:

  • field_filter: Sollte in der Regel Ihre Standardauswahl sein, wenn Sie eine zugrunde liegende Dimension oder einen zugrunde liegenden Messwert angeben können. Wenn Sie type: field_filter verwenden und den Filter einem type:string-Feld zuordnen, werden mögliche Filterwerte vorgeschlagen.
  • number_filter: Ermöglicht dem Nutzer die Eingabe einer Zahl/eines Ganzzahlwerts oder eines Ausdrucks.
  • date_filter: Ermöglicht dem Nutzer die Eingabe eines Datumswerts oder ‑ausdrucks.
  • string_filter: Ermöglicht dem Nutzer die Eingabe von Freiformtext.

field_filter

Schlägt Optionen zur Auswahl vor und ändert die Darstellung für Nutzer basierend auf dem zugrunde liegenden Feld, das Sie angeben.

Dieser Filtertyp sollte Ihre erste Wahl sein, wenn Sie Nutzern während der Interaktion mit dem Filter Vorschläge machen möchten. Die Dimension, aus der Vorschläge abgerufen werden, wird mit den Parametern explore und field definiert und muss ein Feld von type: string sein, um Filtervorschläge zu generieren.

Vorschläge funktionieren möglicherweise nicht, wenn das Feld aus einer abgeleiteten Tabelle stammt, wenn sql_always_where im Explore verwendet wird oder wenn das Feld eine Messwert ist.

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

number_filter

Es werden keine Vorschläge gemacht. Der Nutzer kann einen Ganzzahl-, Zahlenwert oder Ausdruck eingeben.

filters:
- name: order_value
  type: number_filter

date_filter

Es werden keine Vorschläge gemacht. Der Nutzer kann einen Datumswert oder ‑ausdruck eingeben.

filters:
- name: order_date
  type: date_filter

string_filter

Es werden keine Vorschläge gemacht, der Nutzer kann Freiformtext eingeben.

filters:
- name: customer_name
  type: string_filter

default_value

Mit dem Parameter default_value können Sie einen Standardwert für einen Filter angeben. Dieser Wert kann Nutzern helfen, einen angemessenen Ausgangspunkt zu finden.

Der Standardwert muss dem Typ des verwendeten Filters entsprechen. Beispiel:

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: string_filter
  default_value: "John Doe"

Mit Filterausdrücken können Sie Standardwerte erstellen. Weitere Informationen finden Sie auf der Dokumentationsseite Looker-Filterausdrücke.

Wenn Sie sowohl den Parameter default_value als auch den Parameter ui_config verwenden, müssen Filterausdrücke mit dem Wert des Unterparameters type von ui_config und den Datentypen kompatibel sein, die den Wert type unterstützen.

Sie können auch die Liquid-Variablen _localization und _user_attributes für flexible Standardfilterwerte verwenden.

allow_multiple_values

Mit dem Parameter allow_multiple_values können Sie festlegen, ob Nutzer einen einzelnen oder mehrere Filterwerte auswählen können. Wenn dieser Parameter auf true (Standard) festgelegt ist, können Nutzer mehrere Werte für den Filter auswählen. Wenn dieser Parameter auf false festgelegt ist, können Nutzer nur einen Filterwert auswählen.

Beispiel:

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

Mit dem Parameter required können Sie festlegen, dass Nutzer einen Wert für den Filter angeben müssen, um das Dashboard auszuführen. Standardmäßig verlangen Filter keine Werte. Enthält ein Filter, für den kein Wert erforderlich ist, keinen Wert, werden die Daten einfach nicht durch das Filterfeld eingegrenzt. Ist für einen Filter ein Wert erforderlich und er bleibt leer, wird das Dashboard nicht ausgeführt.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

Mit dem Unterparameter ui_config von filters können Sie Filtereinstellungen für ein LookML-Dashboard konfigurieren. Zu diesen Einstellungen gehören die Typen der verwendeten Filtersteuerelemente, die Platzierung von Filtersteuerelementen und mögliche Filterwerte.

Beispiel:


  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

Weitere Informationen zum Konfigurieren von Filtern über die Benutzeroberfläche finden Sie unter Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

type

Mit dem Unterparameter type von ui_config können Sie die Arten von Filtersteuerelementen angeben, die angezeigt werden.

Je nach Wert, den Sie für type eingeben, können Filtersteuerungen eine Einzel- oder Mehrfachauswahl ermöglichen.

STR = Kompatibel mit dem Datentyp string DIST = Kompatibel mit dem Datentyp distance
NUM = Kompatibel mit dem Datentyp number und numerischen Messwerten DUR = Kompatibel mit dem Datentyp duration
TIER = Kompatibel mit dem Datentyp tier D&T = Kompatibel mit den meisten Datums- und Uhrzeitdatentypen
ZIP = Kompatibel mit dem Datentyp zipcode LOC = Kompatibel mit dem Datentyp location
Y/N = Kompatibel mit dem Datentyp yesno PAR = Kompatibel mit dem Parameter parameter
WertBeschreibungUnterstützte Datentypen
Mehrfachauswahl
button_group Der Filter enthält eine Gruppe von Schaltflächen, wobei jede Schaltfläche einem Wert entspricht, der mit dem Parameter options angegeben wurde. STR NUM TIER ZIP Y/N DIST DUR
checkboxes Der Filter enthält Kästchen, wobei für jeden mit dem Parameter options angegebenen Wert ein Kästchen vorhanden ist. STR NUM TIER ZIP Y/N DIST DUR
tag_list Im Filter wird ein Drop-down-Menü mit allen möglichen Werten angezeigt, die mit dem Parameter options angegeben wurden. STR NUM TIER ZIP DIST DUR
range_slider Bei numerischen Feldern wird im Filter ein Schieberegler angezeigt, mit dem Nutzer einen Zahlenbereich als Filterwert festlegen können. Mit den Unterparametern min und max von options werden die minimalen und maximalen möglichen Werte für den Filter angegeben. Der Standardbereich kann mit dem Parameter default_value angegeben werden. NUM DIST DUR
Einfachauswahl
button_toggles Der Filter enthält eine Gruppe von Schaltflächen, eine für jeden Wert, der mit dem Parameter options angegeben wird. STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons Im Filter werden Optionsfelder angezeigt, mit einem Feld für Beliebiger Wert und einem Feld für jeden mit dem Parameter options angegebenen Wert. STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu Im Filter wird ein Drop-down-Menü mit allen möglichen Werten angezeigt, die mit dem Parameter options angegeben wurden. Im Drop-down-Menü können Nutzer auch Beliebiger Wert auswählen. STR NUM TIER ZIP Y/N DIST DUR PAR
slider Bei numerischen Feldern wird ein Schieberegler angezeigt, mit dem Nutzer einen Filter auswählen können, indem sie zwischen den minimalen und maximalen möglichen Werten hin- und herschieben. Diese Werte werden mit dem Parameter options angegeben. NUM DIST DUR
Datum und Uhrzeit
day_picker Mit dem Filter können Nutzer ein bestimmtes Datum auswählen, nach dem gefiltert werden soll. D&T: Die Steuerung für einzelne Tage kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können mit dieser Art von Steuerung jedoch nur einzelne Datumsangaben auswählen.
day_range_picker Mit dem Filter können Nutzer ein Start- und Enddatum auswählen, um einen Zeitraum zu filtern. D&T: Die Zeitraumsteuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können mit dieser Art von Steuerung jedoch nur Zeiträume auswählen.
date_time_range_input Mit dem Filter kann der Nutzer einen Zeitraum für Datum und Uhrzeit festlegen. Datum und Uhrzeit: Die Zeitraumsteuerung für Datum und Uhrzeit kann mit den meisten zeitbasierten Typen verwendet werden. Betrachter müssen bei dieser Art von Steuerung sowohl Datums- als auch Zeitoptionen auswählen.
relative_timeframes Mit dem Filter können Nutzer einen benutzerdefinierten Zeitraum festlegen oder aus vordefinierten Zeiträumen wie Heute, Letzte 7 Tage oder Letzte 90 Tage auswählen. D&T: Die Zeitrahmen-Steuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können mit dieser Art von Steuerung jedoch keine Zeitoptionen auswählen.
Sonstiges
advancedMit dem Filter können Sie einen oder mehrere Filter oder Filter für erweiterte Übereinstimmungen anwenden.

Weitere Informationen zu erweiterten Steuerelementen finden Sie im Abschnitt Erweiterte Steuerelemente verwenden auf dieser Seite. 		STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

Mit dem Unterparameter display von ui_config können Sie die Position eines Dashboard-Filters festlegen. Sie können einen Filter positionieren, indem Sie display einen der folgenden Werte zuweisen:

  • inline: Der Filter wird direkt in der oberen Dashboard-Leiste angezeigt.
  • popover: In der oberen Leiste des Dashboards wird ein Zusammenfassungswert angezeigt. Klicken Sie auf den Wert, um den vollständigen Filter einzublenden.
  • overflow: In der oberen Leiste des Dashboards wird eine Schaltfläche Mehr mit einem numerischen Indikator für die Anzahl der Überlauf-Filter angezeigt. Nutzer können auf die Schaltfläche klicken, um die Überlauf-Filter und die dazugehörigen Werte einzublenden.

Einige Filtertypen können nur auf bestimmte Weise dargestellt werden. Filter vom Typ type: day_picker können beispielsweise nur als inline oder overflow angezeigt werden. Wenn Sie einem Filter einen display-Wert zuweisen, der für diesen type nicht gültig ist, wird der Filter als inline oder popover angezeigt, je nachdem, welcher Wert gültig ist. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

Informationen zum Positionieren von Dashboard-Filtern über die Benutzeroberfläche finden Sie auf der Dokumentationsseite Benutzerdefinierte Filter hinzufügen und bearbeiten.

options

Mit dem optionalen Unterparameter options von ui_config können Sie die Werte angeben, aus denen ein Nutzer auswählen kann, um Dashboard-Filterwerte vorübergehend zu aktualisieren, wenn er ein LookML-Dashboard aufruft. Wenn Sie keine Werte für options angeben, ruft Looker die ersten Werte aus der Datenbank ab.

Sie können beispielsweise San Francisco, New York und Tokyo als mögliche Werte für einen Filter für das Feld users.city festlegen:


ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

Wenn der Unterparameter type von ui_config auf range_slider oder slider festgelegt ist, können Sie die Unterparameter min und max von options verwenden:

  • min: Legen Sie den kleinstmöglichen Wert für einen Filter fest.
  • max: Legen Sie den maximal möglichen Wert für einen Filter fest.

Beispiel:


ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

Für Dashboardfilter vom Typ type: field_filter müssen Sie ein Modell definieren, aus dem die Vorschläge für den Filter stammen. Mit dem Parameter model wird angegeben, in welchem Modell sich das Feld befindet, das Sie verwenden möchten.

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

explore

Für Dashboardfilter vom Typ type: field_filter müssen Sie ein Feld definieren, aus dem die Vorschläge für den Filter stammen. Mit dem Parameter explore wird angegeben, welches Explore das Feld enthält, das Sie verwenden möchten.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

Für Dashboardfilter vom Typ type: field_filter müssen Sie ein Feld definieren, aus dem die Vorschläge für den Filter stammen. Mit dem Parameter field wird angegeben, welches Feld Sie verwenden möchten. Es ist wichtig, den vollständig qualifizierten Feldnamen zu verwenden. Verwenden Sie also view_name.field_name und nicht nur field_name.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

Bei Dashboard-Filtern vom Typ type: field_filter können Sie Vorschläge für den Filter basierend auf den Eingaben des Nutzers für einen anderen Filter vom Typ type: field_filter eingrenzen.

Im folgenden Beispiel basieren die Vorschläge für den Filter State auf den Werten aus dem Filter Order ID. Für alle Werte, die für den Filter Order ID ausgewählt werden, sind users.state-Werte vorhanden. Diese Werte werden als Vorschläge für den Filter State angezeigt. Weitere Informationen finden Sie unter Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

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

embed_style

Mit dem Parameter embed_style wird der Abschnitt von LookML eingeleitet, in dem Sie das Erscheinungsbild eines eingebetteten Dashboards anpassen. embed_style und die zugehörigen Parameter werden nur in eingebetteten Dashboards unterstützt und ignoriert, wenn das Dashboard nicht eingebettet ist.

Nachdem Sie Änderungen an embed_style vorgenommen haben, müssen Sie Ihre LookML in der Produktion bereitstellen, damit die embed_style-Einstellungen im eingebetteten LookML-Dashboard berücksichtigt werden.

Für die folgenden Attribute eingebetteter Dashboards, die eine Farbe angeben, kann der Farbwert ein Hex-String wie #2ca6cd oder ein CSS-Farbstring wie mediumblue sein.

Anpassungen für eingebettete Dashboards haben das folgende Format:

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

Legt die Farbe des Hintergrunds eines eingebetteten Dashboards fest.

embed_style:
  background_color: "#ffffff"

show_title

Gibt an, ob der Titel des eingebetteten Dashboards für Nutzer sichtbar ist.

embed_style:
  show_title: false

title_color

Legt die Farbe des Titels eines eingebetteten Dashboards fest.

embed_style:
  title_color: "#008000"

show_filters_bar

Gibt an, ob die eingebetteten Dashboard-Filter für Nutzer sichtbar sind.

embed_style:
  show_filters_bar: true

tile_background_color

Legt die Farbe des Hintergrunds aller Kacheln in einem eingebetteten Dashboard fest.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Legt die Farbe des Texts auf allen Kacheln in einem eingebetteten Dashboard fest.

embed_style:
  tile_text_color: "crimson"

elements

Mit dem Parameter elements wird der Abschnitt von LookML eingeleitet, in dem Sie die Elemente definieren, aus denen ein Dashboard besteht. Es gibt viele Parameter, die das Erscheinungsbild eines Dashboard-Elements definieren können. Sie werden auf der Seite Dashboard-Elementparameter ausführlicher beschrieben.

- 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