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

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	Sie können festlegen, ob Betrachter von Dashboards Dashboard-Kacheln im Vollbildmodus und in erweiterten Ansichten 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.
rows	Leitet 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 Neuladen automatisch ausgeführt werden.
Filterparameter
crossfilter_enabled	Kreuzfilterung für ein Dashboard aktivieren oder deaktivieren
filters_bar_collapsed	Hinzugefügt: 21.16 Legen Sie fest, ob die Filterleiste eines Dashboards standardmäßig eingeklappt oder ausgeklappt sein soll.
filters_location_top	Hinzugefügt: 22.08. Legen Sie für ein Dashboard die Position der Dashboard-Filterleiste 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 Typ des zu verwendenden Filters.
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	Schränken Sie die Vorschläge für Dashboard-Filter von field_filter basierend auf den Eingaben des Nutzers für einen anderen Dashboard-Filter von type: field_filter ein.
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.

Hinweis :Wenn Sie den Wert des dashboard-Parameters eines LookML-Dashboards für ein Dashboard ändern, das aus dem Ordner LookML-Dashboards verschoben wurde, wird das LookML-Dashboard automatisch wieder in den Ordner LookML-Dashboards verschoben.

preferred_viewer

Wichtig :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 als Standard-Dashboard-Erfahrung von Looker oder als Legacy-Dashboard auswählen.

title (für Dashboard)

In diesem Abschnitt wird auf den Parameter title verwiesen, der Teil eines Dashboards ist.

title kann auch als Teil eines Dashboardfilters verwendet werden. Das wird auf dieser Seite im Abschnitt title (für Filter) beschrieben.

title kann auch als Teil eines beliebigen Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite Säulendiagrammelemente.

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 Verkaufsübersicht, sondern als 1) Verkaufsübersicht angezeigt.

description (für Dashboard)

In diesem Abschnitt wird auf den Parameter description verwiesen, der Teil eines Dashboards ist.

description kann auch als Teil eines Explores verwendet werden, wie auf der Dokumentationsseite zum Parameter description (für Explores) beschrieben.

description kann auch als Teil eines Felds verwendet werden, wie auf der Dokumentationsseite zum Parameter description (für Felder) beschrieben.

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.

Wenn Sie ein Objekt erweitern, müssen Sie beachten, dass Lokalisierungsregeln auch für Ihre Erweiterungen gelten. Wenn Sie ein Objekt erweitern und dann neue Labels oder Beschreibungen definieren, sollten Sie Lokalisierungsdefinitionen in den Gebietsschema-Zeichenfolgendateien Ihres Projekts angeben. Weitere Informationen finden Sie auf der Dokumentationsseite Ihr LookML-Modell lokalisieren.

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:

• newspaper: Dashboard-Elemente werden in einem Raster mit 24 Spalten angezeigt. Die Standardgröße für ein Element ist eine Breite von 8 Spalten und eine Höhe von 6 Zeilen. Elemente lassen sich anhand dieses Rasters konfigurieren. Die Konfiguration erfolgt über die Elementparameter width, height, row und col. Diese Layoutoption wird verwendet, wenn ein benutzerdefiniertes Dashboard in ein LookML-Dashboard konvertiert wird. Sie ist auch das Standardlayout, wenn ein neues LookML-Dashboard über die Looker-IDE erstellt wird. Außerdem sind newspaper und grid die einzigen Layouts, die die Konvertierung eines LookML-Dashboards in ein benutzerdefiniertes Dashboard unterstützen.

• grid: Dashboard-Elemente werden mit dynamischen Breiten angezeigt, die auf einer Reihe von Zeilen basieren, die Sie mit dem Parameter rows und seinen Unterparametern elements und height definieren. newspaper und grid sind die einzigen Layouts, die die Konvertierung eines LookML-Dashboards in ein benutzerdefiniertes Dashboard unterstützen.

• static: Dashboardelemente werden in der Reihenfolge angezeigt, in der sie in der LookML-Datei aufgeführt sind. Jedes Dashboard-Element muss manuell mit den Parametern top und left positioniert werden. Diese Parameter gelten für alle Elementtypen. Details zur Verwendung finden Sie auf den Dokumentationsseiten für die einzelnen Visualisierungstypen. Repräsentative Beispiele für die Funktionsweise von top und left finden Sie auf der Dokumentationsseite Säulendiagrammparameter für LookML-Dashboards. static unterstützt keine Konvertierung von LookML-Dashboards in benutzerdefinierte Dashboards.

• tile: Dashboardelemente werden in der Reihenfolge angezeigt, in der sie in der LookML-Datei aufgeführt sind. Die Breite des Dashboards ist dynamisch und richtet sich nach der Breite des Browsers. Die Dashboard-Elemente werden dynamisch im Browser positioniert, um den verfügbaren Platz auszufüllen. tile unterstützt keine Konvertierung von LookML-Dashboards in benutzerdefinierte Dashboards.

rows

Bei layout: grid-Dashboards wird mit dem Parameter rows der Abschnitt von LookML eingeleitet, 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

In diesem Abschnitt wird auf den Parameter width verwiesen, der Teil eines Dashboards ist.

width kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Säulendiagrammelemente.

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 1.200 verwendet.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

In diesem Abschnitt wird auf den Parameter refresh verwiesen, der Teil eines Dashboards ist.

refresh kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Säulendiagrammelemente.

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 beim ersten Öffnen oder beim Neuladen ausgeführt 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 Einstellung für auto_run 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 verhindern, 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 Betrachter des Dashboards 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 festgelegt 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

In diesem Abschnitt wird auf den Parameter filters verwiesen, der Teil eines Dashboards ist.

filters kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Säulendiagrammelemente.

filters kann auch als Teil einer Messung verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter 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 eingerichtet 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.

Hinweis :Bei Dashboard-Elementen, für die der Parameter merged_queries verwendet wird, kann für jede Quellabfrage ein oder mehrere Dashboard-Filter festgelegt werden. In einer Definition für eine zusammengeführte Abfrage können Sie mit dem Parameter listen die Filterlogik für jede Quellabfrage unabhängig von der Anzahl der Quellabfragen im Element mit den zusammengeführten Ergebnissen definieren. Wenn eine Abfrage keinen listen-Parameter hat, ist sie nicht von Dashboardfiltern betroffen.

Wenn Filter auf diese Weise auf ein Element angewendet werden, muss der Filtertyp mit dem Dimensions- oder Messwerttyp übereinstimmen, der auf den Filter reagiert (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

In diesem Abschnitt wird auf den Parameter name verwiesen, der Teil eines Dashboard-Filters ist.

name kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Säulendiagrammelemente.

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)

In diesem Abschnitt wird auf den Parameter title verwiesen, der Teil eines Dashboard-Filters ist.

title kann auch als Teil eines Dashboards verwendet werden, wie im Abschnitt title (für Dashboard) auf dieser Seite beschrieben.

title kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite Säulendiagramm-Parameter für LookML-Dashboards.

Mit dem Parameter title können Sie ändern, wie ein Filtername Nutzern oben auf einem Dashboard 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(s) angezeigt.

type

In diesem Abschnitt wird auf den Parameter type verwiesen, der Teil eines Dashboard-Filters ist.

type kann auch als Teil eines Dashboardelements verwendet werden. Dies wird auf der Dokumentationsseite zum Parameter type (für LookML-Dashboards) beschrieben.

type kann auch als Teil eines Joins verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter type.

type kann auch als Teil einer Dimension verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen.

type kann auch als Teil eines Messwerts verwendet werden, wie auf der Dokumentationsseite Messwerttypen beschrieben.

Mit dem Parameter type wird der Typ der Eingabe angegeben, 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 mit einem type:string-Feld verknüpfen, 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

Es werden Optionen zur Auswahl vorgeschlagen. Die Darstellung für Nutzer ändert sich je nach 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 Filtersteuerungen, die Platzierung von Filtersteuerungen 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 dem Wert, den Sie für type eingeben, können Filtersteuerungen eine Einzel- oder Mehrfachauswahl ermöglichen.

Die von type unterstützten Werte hängen von den LookML-Daten type ab, die dem Feld zugewiesen sind, nach dem Sie filtern.

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

Wert	Beschreibung	Unterstü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	Im Filter werden Kästchen angezeigt, und zwar für jeden Wert, der mit dem Parameter options angegeben wurde.	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, wobei jede Schaltfläche einem Wert entspricht, der mit dem Parameter options angegeben wurde.	STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons	Der Filter enthält Optionsfelder, darunter ein Feld für Beliebiger Wert und ein Feld für jeden Wert, der mit dem Parameter options angegeben wird.	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 im Filter ein Schieberegler angezeigt, mit dem Nutzer einen Filter auswählen können, indem sie zwischen den minimalen und maximalen möglichen Werten, die mit dem Parameter options angegeben werden, hin- und herschieben.	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 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 Zeitrahmensteuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Zuschauer können mit dieser Art von Steuerung jedoch keine Zeitoptionen auswählen.
Sonstiges
advanced	Der Filter bietet Optionen zum Anwenden von einem oder mehreren Filtern oder Filtern für erweiterte Übereinstimmungen. 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

Hinweis :Einige Zeiträume und zeitbasierte Typen werden als unterschiedliche Datentypen interpretiert, wenn Looker Steuerelemente dafür erstellt. Zwei Beispiele sind der yesno-Zeitraum, der als yesno-Datentyp interpretiert wird und daher die vom Typ yesno unterstützten Werte unterstützt, und der hour_of_day-Zeitraum, der als number-Datentyp interpretiert wird und daher die vom Typ number unterstützten Werte unterstützt.

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 die 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 entweder als inline oder als 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, werden die ersten Werte aus der Datenbank abgerufen.

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 niedrigsten mö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

In diesem Abschnitt wird auf den Parameter explore verwiesen, der Teil eines Dashboard-Filters ist.

explore kann auch als Teil eines Modells verwendet werden, wie auf der Dokumentationsseite zum Parameter explore beschrieben.

explore kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Säulendiagrammelemente.

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 eingrenzen, je nachdem, was der Nutzer für einen anderen Filter vom Typ type: field_filter eingibt.

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 übernommen 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 folgendes 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.

Dieser Parameter wirkt sich nur auf das Erscheinungsbild des Dashboards aus, nicht auf die Möglichkeit eines Nutzers, auf Daten zuzugreifen. Wenn Sie die Filterleiste ausblenden, können Nutzer die Filter trotzdem auf andere Weise ändern. Informationen zum Einrichten von Richtlinien zur sicheren Datenzugriffssteuerung finden Sie auf der Dokumentationsseite Zugriffssteuerung und Berechtigungsverwaltung.

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

In diesem Abschnitt wird auf den Parameter elements verwiesen, der Teil eines dashboard ist.

elements kann auch als Teil einer Dashboard-Zeile verwendet werden. Weitere Informationen finden Sie im Abschnitt elements für Zeilen auf dieser Seite.

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, mit denen Sie das Erscheinungsbild eines Dashboard-Elements definieren können. Sie werden auf der Seite Dashboard-Elementparameter ausführlicher beschrieben.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

Bedenken Sie die Anzahl und Komplexität der Elemente, die Sie einem LookML-Dashboard hinzufügen. Je mehr Elemente Sie nutzen, desto mehr Browserressourcen werden benötigt. Dadurch erhöht sich die für das Rendering des Dashboards benötigte Zeit. Auch Elemente, mit denen große Datenmengen gerendert werden, können sich auf die Dashboard-Leistung auswirken. Wenn das Rendern zum Problem wird, empfiehlt es sich, die Komplexität der Abfragen für Dashboard-Elemente zu verringern oder mehrere Dashboards mit weniger Elementen zu erstellen.