Dashboard-Parameter

Dashboards können auf zwei Arten erstellt werden. Benutzerdefinierte Dashboards werden über die Looker-Benutzeroberfläche erstellt und auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen beschrieben. Dashboards können auch mit LookML erstellt und deren Gesamteinstellungen wie auf dieser Seite beschrieben geändert werden.

Ein Dashboard hat mehrere Einstellungen, die sich auf das gesamte Dashboard auswirken. Diese werden hier beschrieben. Es enthält auch eine Gruppe von Datenvisualisierungen, die als Elemente bezeichnet werden. Die LookML für diese Elemente wird auf den Dokumentationsseiten für jeden einzelnen Elementtyp beschrieben.

Nutzungsbeispiel

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "desired dashboard title"
  description: "desired dashboard description"
  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: "desired 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

Parameter mit dem Label NICHT UNTERSTÜTZT VON LEGACY werden nur angewendet, wenn ein Dashboard mit der Standard-Dashboard-Oberfläche gerendert wird, entweder durch Verwendung von preferred_viewer: dashboards-next oder durch Konvertieren eines alten LookML-Dashboards in ein benutzerdefiniertes Dashboard und anschließendes Upgrade des benutzerdefinierten Dashboards.

Parametername	Beschreibung
dashboard	Dashboard erstellen
preferred_viewer	Wählen Sie aus, ob ein Dashboard als Dashboard oder als altes Dashboard gerendert werden soll.
title (für Dashboard)	Ändern, wie ein Dashboard-Name für Nutzer angezeigt wird
description (für Dashboard)	Fügen Sie eine Platzhalterbeschreibung hinzu, die verwendet werden soll, wenn das Dashboard in ein benutzerdefiniertes Dashboard konvertiert wird.
extends	Basis des LookML-Dashboards auf einem anderen LookML-Dashboard
extension	Das Dashboard muss durch ein anderes Dashboard erweitert werden.
layout	Definieren Sie, wie das Dashboard Elemente platziert.
rows	Starten Sie einen Abschnitt von LookML, um die Elemente zu definieren, die in jede Zeile 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 Dashboard-Elemente automatisch aktualisiert werden sollen.
auto_run	Sie können festlegen, ob Dashboards beim ersten Öffnen oder erneuten Laden automatisch ausgeführt werden.
Filterparameter
crossfilter_enabled	NACH UNTERSTÜTZUNG DURCH LEGACY Aktivieren oder deaktivieren Sie die Kreuzfilterung für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet.
filters_bar_collapsed	HINZUGEFÜGT 21.16 NACH LEGACY UNTERSTÜTZT Legen Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet, minimiert oder maximiert fest.
filters_location_top	HINZUGEFÜGT WIRD 22.8 VIELE UNTERSTÜTZT Stelle die Dashboard-Filterleiste für ein Dashboard, das ebenfalls preferred_viewer: dashboards-next verwendet, als oben oder rechts ein.
filters (für Dashboard)	Starten Sie einen Abschnitt von LookML, um Dashboard-Filter zu definieren.
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, welcher Filtertyp verwendet werden soll.
default_value	Legen Sie gegebenenfalls einen Standardwert für einen Filter fest.
allow_multiple_values	Beschränken Sie Nutzer auf einen einzelnen Filterwert.
required	Legen Sie fest, dass Nutzer einen Filterwert eingeben müssen, um das Dashboard auszuführen.
ui_config	NACH UNTERSTÜTZUNG Konfigurieren Sie die Filtersteuerungen, die verfügbar sind, wenn Nutzer ein LookML-Dashboard aufrufen, das im neuen Dashboard gerendert wird, wobei preferred_viewer auf dashboards-next (kein altes Dashboard mit preferred_viewer auf dashboards) gesetzt ist und die Unterparameter type, display und options hat.
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 die Option „Erkunden“ an, die 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 anhand der Eingaben des Nutzers für weitere Dashboard-Filter von type: field_filter eingrenzen
Eingebettete Dashboard-Parameter
embed_style	Beginnen Sie einen Abschnitt von LookML, um Anpassungen für eingebettete Dashboards festzulegen.
background_color	Legen Sie die Hintergrundfarbe eines eingebetteten Dashboards fest.
show_title	Geben Sie an, ob der Dashboard-Titel auf einem eingebetteten Dashboard sichtbar ist.
title_color	Die Farbe des Titels eines eingebetteten Dashboards.
show_filters_bar	Geben Sie an, ob die Filterleiste in einem eingebetteten Dashboard sichtbar ist.
tile_background_color	Lege die Kachelhintergrundfarbe eines eingebetteten Dashboards fest.
tile_text_color	Lege die Kacheltextfarbe eines eingebetteten Dashboards fest.
Elementparameter
elements (für Dashboard)	Starten Sie einen Abschnitt von LookML, um Dashboard-Elemente zu definieren.

dashboard

Der Parameter dashboard deklariert ein neues Dashboard und gibt einen Namen für das Dashboard an. Es sind maximal 255 Zeichen zulässig. Zulässig 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 ein Dashboard angezeigt werden kann, muss mindestens ein Element über den Parameter elements hinzugefügt werden.

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

preferred_viewer

Mit dem Parameter preferred_viewer können Sie das Format zum Aufrufen und Herunterladen eines Dashboards auswählen. Folgende Werte sind zulässig:

• dashboards: Der AngularJS-basierte Renderer für alte Dashboards.

• dashboards-next: Der React-Renderer für das Standarddashboard.

LookML-Dashboards mit preferred_viewer: dashboards, die in benutzerdefinierte Dashboards konvertiert werden, können mit der neuen Dashboard-Oberfläche durch Upgrade des benutzerdefinierten Dashboards gerendert werden.

title (für Dashboard)

Dieser Abschnitt bezieht sich auf den Parameter title, der Teil eines Dashboards ist.

title kann auch als Teil eines Dashboard-Filters verwendet werden, der auf dieser Seite im Abschnitt title (für Filter) beschrieben wird.

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

Mit dem Parameter title können Sie festlegen, wie ein Dashboard-Name für Nutzer in Ordnern und oben im Dashboard angezeigt wird. Wenn keine Angabe erfolgt, wird standardmäßig der Name des Dashboards verwendet. Der Titeltext kann lokalisiert werden.

Betrachten Sie dieses Beispiel:

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

Wenn Sie das tun, wird anstelle des Dashboards Sales Overview (Verkaufsübersicht) 1) Sales Overview angezeigt.

description (für Dashboard)

Dieser Abschnitt bezieht sich auf den Parameter description, der Teil eines Dashboards ist.

description kann auch als Teil eines explorativen Analysetools verwendet werden, wie auf der Seite mit der Parameterdokumentation für description beschrieben.

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

Ab Looker 21.20 werden die Inhalte des Parameters description im Textfeld Beschreibung des Steuerfelds Dashboard-Details eines LookML-Dashboards angezeigt.

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

Die Beschreibung wird in einem Ordner unter den Dashboard-Titeln in den Dashboard-Listen angezeigt. Wenn keine Beschreibung angegeben ist, wird in der Liste nur der Dashboard-Titel angezeigt.

Der Beschreibungstext kann lokalisiert werden.

extends

Wie auf der Dokumentationsseite Wiederverwendung von Codes mit Erweiterung beschrieben, können Sie mit dem Parameter extends ein LookML-Dashboard auf einem anderen LookML-Dashboard erstellen und möglicherweise einige Einstellungen hinzufügen oder überschreiben. Der Parameter extends akzeptiert den Namen eines anderen LookML-Dashboards.

Beachten Sie bei der Erweiterung eines Objekts, 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-Stringdateien Ihres Projekts angeben. Weitere Informationen finden Sie auf der Dokumentation zur Lokalisierung Ihres LookML-Modells.

extension

Wie auf dieser Seite beschrieben, gibt der Parameter extension an, dass das Dashboard um ein anderes Dashboard muss erweitert werden. 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. Für den Parameter extension wird nur der Wert required akzeptiert. 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 bei der Positionierung von Dashboard-Elementen verwendet. Folgende Werte sind zulässig:

• newspaper: Dashboard-Elemente werden in einem Raster mit 24 Spalten angezeigt. Die Standardgröße eines Elements beträgt 8 Spalten und eine Höhe von 6 Zeilen. Die Elemente in diesem Raster sind konfigurierbar, angegeben durch die Elementparameter width, height, row und col. Diese Layoutoption wird verwendet, wenn ein benutzerdefiniertes Dashboard in ein LookML-Dashboard konvertiert wird. Sie wird außerdem als Standardlayout verwendet, wenn ein neues LookML-Dashboard über die Looker-IDE erstellt wird. Wenn preferred_viewer auf dashboards-next gesetzt ist, ist newspaper das einzige Layout, das die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard unterstützt.

• grid: Dashboard-Elemente werden mit dynamischer Breite angezeigt, basierend auf einer Reihe von Zeilen, die Sie mit dem Parameter rows und den zugehörigen Unterparametern elements und height definieren. Wenn preferred_viewer auf dashboards-next gesetzt ist, unterstützt grid die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.

• static: Dashboard-Elemente werden in der Reihenfolge angezeigt, in der sie in der LookML-Datei aufgeführt sind. Jedes Dashboard-Element muss mithilfe der Parameter top und left manuell positioniert werden. Diese Parameter gelten für alle Elementtypen. Details zu ihrer Verwendung werden auf den Dokumentationsseiten für die einzelnen Visualisierungstypen angezeigt. Beispiele für die Funktionsweise von top und left finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards. Wenn preferred_viewer auf dashboards-next gesetzt ist, unterstützt static die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.

• tile: Dashboard-Elemente 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 positionieren sich dynamisch innerhalb des Browsers, um den verfügbaren Platz zu füllen. Wenn preferred_viewer auf dashboards-next gesetzt ist, unterstützt tile die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.

rows

Bei layout: grid-Dashboards startet der Parameter rows den Abschnitt von LookML, in dem Sie definieren, welche Elemente in welche Zeilen aufgenommen werden sollen, und die Höhe jeder Zeile angeben. Innerhalb jeder Zeile hat jedes Element dieselbe Breite. Wenn Sie ein Element in diesem Abschnitt nicht auflisten, wird es nicht auf dem 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 wird eine Liste von Dashboard-Elementnamen verwendet, die durch Kommas getrennt sind. Mit jeder elements-Deklaration wird eine neue Zeile im Dashboard erstellt. Die Elemente, die in einer Zeile platziert werden, haben alle dieselbe Breite. Wenn Sie also zwei Elemente hintereinander platzieren, belegen sie jeweils 50% des verfügbaren Platzes. Wenn Sie vier Elemente in einer Zeile platzieren, belegen diese jeweils 25% des verfügbaren Platzes usw.

height

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

tile_size

Bei Dashboards vom Typ layout: tile und layout: static wird als Kachelgröße die Einheit verwendet, die zur Größenanpassung und Positionierung von Elementen verwendet wird. Sie definieren tile_size in Pixeln und 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 zur 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 zu Spaltendiagrammparametern für LookML-Dashboards.

width

Dieser Abschnitt bezieht sich auf den Parameter width, 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 Spaltendiagrammelemente.

Bei layout: static-Dashboards definiert der Parameter width die Gesamtbreite des Dashboards, die Sie in Pixel verwenden möchten. Der Parameter width schränkt das Dashboard nicht auf eine bestimmte Größe ein, wenn Sie ein zu großes Element oder zu viele Elemente hintereinander definieren. Stattdessen sorgt die Einstellung width 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

Dieser Abschnitt bezieht sich auf den Parameter refresh, der Teil eines Dashboards ist.

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

Mit dem Parameter refresh kann ein Dashboard in regelmäßigen Abständen automatisch neu geladen werden. Dadurch werden aktuelle Daten abgerufen. Das ist vor allem dann hilfreich, wenn ein Dashboard ständig angezeigt wird, zum Beispiel 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 vorzuwärmen.

Die Aktualisierungsrate kann eine beliebige Anzahl von Sekunden, Minuten, Stunden oder Tagen ohne Dezimalstellen 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 möglicherweise ressourcenintensiv sind, kann die Verwendung bestimmter Dashboards Ihre Datenbank stärker belasten als gewünscht.

auto_run

Der Parameter auto_run bestimmt, ob ein Dashboard beim ersten Öffnen oder erneuten Laden ausgeführt wird. Der Standardwert ist true. Wenn dieser Parameter auf „false“ gesetzt ist, müssen Nutzer eine Run-Schaltfläche drücken, um das Dashboard zu laden. Beispiel: Ein Dashboard wie dieses wird beim Öffnen automatisch ausgeführt:

- dashboard: sales_overview
  auto_run: true

Unabhängig von der Einstellung für auto_run müssen Nutzer nach dem Ändern von Filterwerten immer auf die Schaltfläche Ausführen klicken. So wird verhindert, dass unerwünschter Ladevorgang wiederholt wird, wenn ein Nutzer eine Filteränderung pausiert oder mehrere Filter gleichzeitig ändern möchte.

crossfilter_enabled

Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter preferred_viewer auf dashboards-next gesetzt wird.

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

- dashboard: sales_data
  preferred_viewer: dashboards-next
  crossfilter_enabled: true

crossfilter_enabled wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards angewendet. Wurde jedoch ein LookML-Dashboard mit crossfilter_enabled und preferred_viewer: dashboards in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard crossfilter_enabled in Kraft.

filters_bar_collapsed

Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter preferred_viewer auf dashboards-next gesetzt wird.

Mit dem Parameter filters_bar_collapsed können Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet, standardmäßig minimiert oder maximiert festlegen. Wenn dieser Parameter auf true gesetzt ist, ist die Filterleiste standardmäßig minimiert. Dashboard-Betrachter können die Filterleiste maximieren, indem sie auf das Filtersymbol klicken. Die Standardeinstellung für diese Einstellung ist false.

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_bar_collapsed: true

filters_bar_collapsed wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards angewendet. Wurde jedoch ein LookML-Dashboard mit filters_bar_collapsed und preferred_viewer: dashboards in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard filters_bar_collapsed in Kraft.

filters_location_top

Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter preferred_viewer auf dashboards-next gesetzt wird.

Mit dem Parameter filters_location_top können Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet, oben oder rechts platzieren. Wenn dieser Parameter auf true gesetzt ist, wird die Filterleiste oben im Dashboard angezeigt. Ist sie auf false gesetzt, wird die Filterleiste rechts im Dashboard angezeigt. Die Standardeinstellung für diese Einstellung ist true.

- dashboard: sales_data
  preferred_viewer: dashboards-next
  filters_location_top: false

filters_location_top wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards angewendet. Wurde jedoch ein LookML-Dashboard mit filters_location_top und preferred_viewer: dashboards in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard filters_location_top in Kraft.

filters

Dieser Abschnitt bezieht sich auf den Parameter filters, der Teil eines Dashboards ist.

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

filters kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zum Parameter filters beschrieben.

Der Parameter filters startet den Abschnitt von LookML, in dem Sie Dashboard-Filter definieren. Filter werden oben im Dashboard angezeigt und ermöglichen Nutzern, die Daten hinter Dashboard-Elementen zu ändern.

Damit sich ein Filter auf ein Element auswirkt, muss es für den Filter mit dem Parameter listen auf „listen“ gesetzt sein. Dieser Parameter gilt für alle Elementtypen außer type: text. Details zur Verwendung werden auf den Dokumentationsseiten für jeden einzelnen Visualisierungstyp angezeigt. Ein repräsentatives Beispiel für die Funktionsweise von listen finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.

Wenn Filter auf diese Weise auf ein Element angewendet werden, muss der Filter type mit der Dimension oder dem Messtyp übereinstimmen, der den Filter überwacht. Weitere Informationen finden Sie unter LookML-Dashboards erstellen. Filter haben folgende Form:

filters:
- name: filter_name
  title: "desired 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

Dieser Abschnitt bezieht sich auf den Parameter name, der Teil eines Dashboard-Filters ist.

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

Mit jeder name-Deklaration wird ein neuer Dashboard-Filter erstellt und ihm ein Name zugewiesen. Im Parameter listen von Elementen, auf die der Filter angewendet werden soll, wird auf den Namen verwiesen. Der Parameter listen gilt für alle Elementtypen außer type: text. Details zur Verwendung werden auf der Dokumentationsseite für jeden einzelnen Visualisierungstyp angezeigt. Ein repräsentatives Beispiel für die Funktionsweise von listen finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.

filters:
- name: order_date

title (für Filter)

Dieser Abschnitt bezieht sich auf den Parameter title, der Teil eines Dashboard-Filters ist.

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

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

Mit dem Parameter title können Sie ändern, wie ein Filtername für Nutzer oben in einem Dashboard angezeigt wird. Wenn keine Angabe erfolgt, wird standardmäßig der Name des Filters verwendet.

Betrachten Sie dieses Beispiel:

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

Wenn Sie dies tun, würde anstelle des Filters Bestelldatum als Bestelldatum angezeigt werden.

type

Dieser Abschnitt bezieht sich auf den Parameter type, der Teil eines Dashboard-Filters ist.

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

type kann auch als Teil eines Joins verwendet werden (siehe Dokumentation zum Parameter type).

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

type kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zu Messtypen beschrieben.

Der Parameter type gibt die Art der Eingabe an, die im Filter platziert wird. Obwohl jede Art von Eingabe (z. B. ein Datum) in den Filter type: string_filter geschrieben werden kann, bietet eine spezifischere Filterfunktion ein präziseres Filter-Widget für den Nutzer. Es gibt vier Arten von Filtern:

• field_filter: Sollte in der Regel die Standardauswahl sein, wenn Sie eine zugrunde liegende Dimension oder ein zugrunde liegendes Maß angeben können. Wenn Sie type: field_filter verwenden und den Filter mit dem Feld type:string verknüpfen, werden vom Filter mögliche Filterwerte vorgeschlagen.
• number_filter: Der Nutzer kann einen Zahlen- oder Ganzzahlwert oder -Ausdruck eingeben.
• date_filter: Der Nutzer kann einen Datumswert oder Ausdruck eingeben.
• string_filter: Der Nutzer kann Freitext eingeben.

field_filter

Es werden Vorschläge zur Auswahl angeboten und die Darstellung wird für Nutzer basierend auf dem von Ihnen angegebenen Feld geändert.

Das ist der richtige Filtertyp für Situationen, in denen Sie Nutzern, die mit dem Filter interagieren, Vorschläge machen möchten. Die Dimension, aus der Vorschläge abgerufen werden, wird mit den Parametern explore und field definiert. Es muss ein Feld von type: string sein, damit Filtervorschläge generiert werden können.

Beachten Sie, dass Vorschläge möglicherweise nicht funktionieren, wenn das Feld aus einer abgeleiteten Tabelle stammt, wenn sql_always_where im Feld „Erkunden“ verwendet wird oder das Feld ein 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- oder 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 Text im freien Format 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 für Nutzer hilfreich sein, indem ein sinnvoller Ausgangspunkt vorgeschlagen wird.

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"

Sie können Filterausdrücke verwenden, um Standardwerte zu erstellen. Auf der Dokumentationsseite zu Looker-Filterausdrücken wird dies genauer beschrieben.

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

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

allow_multiple_values

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

Für LookML-Dashboards, die das alte Dashboard verwenden und deren preferred_viewer auf dashboards gesetzt ist, kann allow_multiple_values auf Filter aller type angewendet werden.

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. Wenn ein Filter keinen Wert erfordert und leer bleibt, werden die Daten nicht durch das Filterfeld eingeschränkt. Wenn ein Filter einen Wert erfordert und leer bleibt, wird das Dashboard nicht ausgeführt.

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

ui_config

Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter preferred_viewer auf dashboards-next gesetzt wird.

Mit dem Unterparameter ui_config von filters können Sie Filtereinstellungen konfigurieren, die angewendet werden, wenn ein LookML-Dashboard als Dashboard und nicht als altes Dashboard angezeigt wird. Legen Sie dazu den Parameter preferred_viewer auf dashboards-next fest. Zu diesen Einstellungen gehören die verwendeten Filtertypen, die Platzierung der Filtersteuerungen und die möglichen 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

Die Einstellung, die Sie mit dem Unterparameter ui_config angeben, wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards angewendet. Wurde jedoch ein LookML-Dashboard mit ui_config und preferred_viewer: dashboards in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard ui_config in Kraft.

Weitere Informationen zum Konfigurieren von Filtern mit der Benutzeroberfläche finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.

type

Mit dem Unterparameter type von ui_config können Sie die Filtersteuerungstypen angeben, die angezeigt werden, wenn Nutzer ein LookML-Dashboard als Dashboard (nicht als Legacy-Dashboard) aufrufen.

Je nach dem Wert, den Sie für type eingeben, können Filtersteuerungen als Einzelauswahl oder Mehrfachauswahl verwendet werden.

Welche Werte von type unterstützt werden, hängt von den LookML-Daten type ab, die dem Feld zugewiesen sind, nach dem Sie filtern.

S = Funktioniert mit dem Datentyp [„String“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#string)
N = Funktioniert mit dem Datentyp [„Zahl“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#number) „Numerische Spalten“

DI = Funktioniert mit dem Datentyp [„Entfernung“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#distance)
DU = Funktioniert mit dem Datentyp [„Dauer“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#duration)
DRECHUNG

Wert	Beschreibung	Unterstützte Datentypen
Mehrfachauswahl
button_group	Der Filter zeigt eine Gruppe von Schaltflächen an – mit einer Schaltfläche für jeden Wert, der mit dem Parameter options angegeben wurde.	S N T ZC YN DI DU
checkboxes	Der Filter zeigt Kästchen an, wobei für jeden mit dem Parameter options angegebenen Wert ein Kästchen angeklickt ist.	S N T ZC YN DI DU
tag_list	Der Filter zeigt eine Drop-down-Liste mit allen möglichen Werten, die mit dem Parameter options angegeben wurden.	S N T ZC DI DU
range_slider	Bei numerischen Feldern enthält der Filter einen Schieberegler, 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.	N DI DU
Einfachauswahl
button_toggles	Der Filter zeigt eine Gruppe von Schaltflächen an – mit einer Schaltfläche für jeden Wert, der mit dem Parameter options angegeben wurde.	S N T ZC YN DI DU P
radio_buttons	Der Filter zeigt Optionsfelder mit einer Schaltfläche für beliebigen Wert und einer Schaltfläche für jeden mit dem Parameter options angegebenen Wert an.	S N T ZC YN DI DU P
dropdown_menu	Der Filter enthält ein Drop-down-Menü mit allen möglichen Werten, die mit dem Parameter options angegeben werden. Über das Drop-down-Menü haben Nutzer auch die Möglichkeit, Beliebiger Wert auszuwählen.	S N T ZC YN DI DU P
slider	Bei numerischen Feldern enthält der Filter einen Schieberegler, mit dem Nutzer einen Filter auswählen können. Dazu wechseln sie zwischen den minimalen und maximalen Werten, die mit dem Parameter options angegeben werden.	N DI DU
Datum und Uhrzeit
day_picker	Mit dem Filter können Nutzer ein bestimmtes Datum auswählen, nach dem gefiltert werden soll.	DT^* Das eintägige Steuerelement kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden. Allerdings können Betrachter mit diesem Steuerelement nur einzelne Daten auswählen.
day_range_picker	Mit dem Filter können Nutzer ein Start- und Enddatum auswählen, um nach einem bestimmten Zeitraum zu filtern.	DT^* Die Zeitraumsteuerung kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden, aber Betrachter können nur solche Zeiträume auswählen.
date_time_range_input	Mit dem Filter kann der Nutzer nach einem bestimmten Datum und einer bestimmten Uhrzeit filtern.	DT^* Die Datums- und Uhrzeitsteuerung kann für die meisten zeitbasierten Typen verwendet werden. Nutzer müssen bei dieser Art von Einstellung sowohl Datums- als auch Uhrzeitoptionen auswählen.
relative_timeframes	Mit dem Filter kann der Nutzer nach einem benutzerdefinierten Zeitraum filtern oder verschiedene Zeiträume auswählen, z. B. Heute, Letzte 7 Tage oder Letzte 90 Tage.	DT^* Die Steuerung des Zeitrahmens kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden, aber Betrachter können mit dieser Art von Steuerung keine Zeitoptionen auswählen.
Andere
advanced	Der Filter bietet Optionen zum Anwenden eines oder mehrerer Filter oder erweiterte Übereinstimmungen. Weitere Informationen zu erweiterten Steuerelementen finden Sie im Abschnitt Erweiterte Steuerelemente verwenden auf dieser Seite.	S N T ZC YN DT DI DU L P
^* Hinweis zu Datums- und Uhrzeitdaten: Einige Zeiträume und zeitbasierte Typen werden als unterschiedliche Datentypen interpretiert, wenn Looker Steuerelementoptionen für sie erstellt. Zwei Beispiele sind der yesno-Zeitraum, der als yesno-Datentyp interpretiert wird und daher die vom Typ yesno unterstützten Werte unterstützt. Der hour_of_day-Zeitraum wird als number-Datentyp interpretiert und unterstützt daher die vom number-Typ unterstützten Werte.

display

Sie können den Unterparameter display von ui_config verwenden, um die Position eines Dashboardfilters festzulegen. Sie können einen Filter positionieren, indem Sie display einen der folgenden Werte zuweisen:

• inline: Der Filter wird direkt in der oberen Leiste des Dashboards angezeigt.
• popover: In der oberen Leiste des Dashboards wird eine Zusammenfassung angezeigt. Klicken Sie auf den Wert, um den vollständigen Filter zu sehen.
• overflow: In der oberen Leiste des Dashboards wird die Schaltfläche Mehr mit einem numerischen Indikator für die Anzahl der Überlauffilter angezeigt. Nutzer können auf die Schaltfläche klicken, um die Überlauffilter und ihre Werte aufzurufen.

Einige Filtertypen können nur auf bestimmte Arten dargestellt werden. Beispielsweise kann ein Filter für type: day_picker nur als inline oder overflow angezeigt werden. Wenn Sie einem Filter einen display-Wert zuweisen, der für type nicht gültig ist, wird der Filter entweder 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 options-Unterparameter von ui_config können Sie die Werte festlegen, die ein Nutzer zur vorübergehenden Aktualisierung der Dashboard-Filterwerte verwenden kann, wenn Nutzer ein LookML-Dashboard als Dashboard ansehen (kein Legacy-Dashboard). Wenn Sie für options keine Werte angeben, ruft Looker die ersten Werte aus der Datenbank ab.

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

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

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

• min: Legen Sie den möglichen Mindestwert 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 Dashboard-Filter von type: field_filter müssen Sie ein Modell definieren, aus dem Vorschläge gefiltert werden. Der Parameter model gibt an, welches Modell das Feld enthält, das Sie verwenden möchten.

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

explore

Dieser Abschnitt bezieht sich auf den Parameter explore, der Teil eines Dashboard-Filters ist.

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

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

Für Dashboard-Filter von type: field_filter müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Der Parameter explore gibt an, welche Erkundung 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 Dashboard-Filter von type: field_filter müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Der Parameter field gibt an, welches Feld Sie verwenden möchten. Es ist wichtig, den voll ausgefüllten Feldnamen zu verwenden. Mit anderen Worten: Verwenden Sie 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

Für Dashboard-Filter von type: field_filter können Sie Vorschläge für den Filter anhand der Eingaben des Nutzers für einen weiteren Filter von type: field_filter eingrenzen.

Im folgenden Beispiel basieren die Vorschläge für den Filter State auf den Werten des Filters Order ID. Die für den Filter „Order ID“ ausgewählten Werte haben dann verknüpfte users.state-Werte. Diese werden dann als Werte für den Filter „State“ vorgeschlagen. Weitere Informationen finden Sie auf der Dokumentationsseite 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

Der Parameter embed_style startet den Abschnitt von LookML, in dem Sie die Darstellung eines eingebetteten Dashboards anpassen können. embed_style und die zugehörigen Parameter werden nur auf eingebetteten Dashboards unterstützt. Wenn das Dashboard nicht eingebettet ist, werden die Parameter ignoriert.

Nachdem Sie Änderungen an embed_style vorgenommen haben, müssen Sie LookML für die Produktion bereitstellen, damit Ihre embed_style-Einstellungen im eingebetteten LookML-Dashboard angezeigt werden.

Für die folgenden eingebetteten Dashboard-Attribute, die eine Farbe angeben, kann der Farbwert ein Hexadezimalstring wie #2ca6cd oder ein CSS-benannter Farbstring wie mediumblue sein.

Eingebettete Dashboard-Anpassungen haben folgende Form:

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 Hintergrundfarbe des 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 Aussehen des Dashboards aus und nicht darauf, ob ein Nutzer auf Daten zugreifen kann. Das Ausblenden der Filterleiste verhindert nicht, dass Nutzer Filter auf andere Weise ändern. Informationen zum Einrichten von Richtlinien für die sichere Datenzugriffssteuerung finden Sie auf der Dokumentationsseite Zugriffssteuerung und Berechtigungsverwaltung.

embed_style:
  show_filters_bar: true

tile_background_color

Legt die Hintergrundfarbe aller Kacheln in einem eingebetteten Dashboard fest.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Legt die Textfarbe auf allen Kacheln eines eingebetteten Dashboards fest.

embed_style:
  tile_text_color: "crimson"

elements

Dieser Abschnitt bezieht sich auf den Parameter elements, der Teil eines dashboard ist.

elements kann auch als Teil einer Dashboard-Zeile verwendet werden, die auf dieser Seite im Abschnitt elements für Zeilen beschrieben wird.

Der Parameter elements startet den Abschnitt von LookML, in dem Sie die Elemente definieren, aus denen ein Dashboard besteht. Es gibt viele Parameter, mit denen Sie die Darstellung eines Dashboard-Elements definieren können. Sie werden auf der Seite Parameter für das Dashboard-Element genauer beschrieben.

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

Denken Sie an 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. Ebenso können Elemente, die große Datenmengen rendern, die Dashboard-Leistung beeinträchtigen. Wenn das Rendering zu einem Problem wird, können Sie Elemente vereinfachen oder mehrere Dashboards mit weniger Elementen erstellen.