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 die 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
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  enabled_dashboard_agents: true | false
  default_dashboard_agent: agent_name
  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
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    vis_filter: 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
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 Definieren Sie, ob Dashboard-Betrachter Dashboard-Kacheln im Vollbildmodus und in erweiterten Ansichten sehen können.
enabled_dashboard_agents [Vorschau] Hier legen Sie fest, ob Dashboard-Betrachter mithilfe eines Dashboard-Agents mit dem LookML-Dashboard interagieren können.
default_dashboard_agent [Vorschau] Geben Sie den Standard-Dashboard-Agenten an, der für Konversationsanfragen im Dashboard verwendet werden soll.
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: 26.4 Mit dieser Version werden Dashboard-Tabs eingeführt, mit denen sich Elemente in einem Dashboard organisieren lassen. Muss in Verbindung mit dem Parameter tab_name für Elemente verwendet werden, um anzugeben, auf welchem Tab ein Element angezeigt wird.
rows Leitet einen Abschnitt von LookML ein, mit dem die Elemente definiert werden, 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.
auto_run Bestimmen Sie, 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 Legen Sie fest, ob die Filterleiste eines Dashboards 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 Nutzern angezeigt wird
type (für Filter) Legen Sie den Typ des zu verwendenden Filters fest.
default_value Standardwert für einen Filter festlegen
allow_multiple_values Sie können Nutzer 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) Optional: 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 basierend auf den Eingaben des Nutzers für einen anderen Dashboard-Filter von type: field_filter eingrenzen.
vis_filter Sie können einen Filter so konfigurieren, dass er direkt auf einer Visualisierungskachel und nicht in der Dashboard-Filterleiste angezeigt wird.
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 ist.
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 der 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. Die maximale Anzahl an Zeichen beträgt 255. Zulässige Zeichen sind Buchstaben (A–Z), Ziffern (0–9), Bindestriche (-) und Unterstriche (_). In der Regel ist es am besten, 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 (verworfen)

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

title (für 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 Sales Overview (Vertriebsübersicht), sondern als 1) Sales Overview (1) Vertriebsübersicht) angezeigt.

description (für 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 Listen von Dashboards 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.

enabled_dashboard_agents

Mit dem Parameter enabled_dashboard_agents können Sie festlegen, ob Dashboard-Betrachter über einen Dashboard-Agent mit dem LookML-Dashboard interagieren können.

Dieser Parameter wird nur wirksam, wenn die Einstellung Conversational Analytics für Ihre Looker-Instanz auf der Administratorseite Gemini in Looker aktiviert ist.

Für diesen Parameter sind die Werte true (Chat aktiviert) und false (Chat deaktiviert) zulässig. Wenn dieser Parameter in der LookML-Dashboard-Datei fehlt, wird auf der API-Ebene standardmäßig true verwendet.

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

Mit dem Parameter default_dashboard_agent wird der Name des Standard-Dashboard-Agents angegeben, der dem LookML-Dashboard zugeordnet werden soll. Der angegebene Agent muss mit dem LookML-Parameter agent deklariert werden.

Wenn Zuschauer eine Unterhaltung mit dem Dashboard beginnen, werden die Einstellungen des Standard-Agents auf die Unterhaltung angewendet, z. B. der Denkmodus und die Anzeige von Debugging-Informationen.

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

Wenn enabled_dashboard_agents gleich true ist und default_dashboard_agent nicht angegeben ist, können Nutzer weiterhin mit dem Dashboard chatten, ohne benutzerdefinierte Anweisungen zu verwenden.

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 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. Für den Parameter extension ist nur der Wert required zulässig. 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. Folgende Werte sind zulässig:

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 eingeleitet, in dem Sie definieren, welche Elemente in welche Zeilen eingefügt werden sollen und wie hoch die einzelnen Zeilen sein sollen. In 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 Namen von Dashboard-Elementen 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, belegen sie jeweils 50% des verfügbaren Platzes. Wenn Sie vier Elemente in eine Zeile einfügen, belegen sie jeweils 25% des verfügbaren Platzes.

height

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

tile_size

Bei layout: tile- und layout: static-Dashboards wird die Kachelgröße verwendet, um die Größe und Position von Elementen festzulegen. tile_size wird in Pixeln definiert. 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

Für layout: static-Dashboards wird mit dem Parameter width die Gesamtbreite des Dashboards in Pixeln definiert, die Sie 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 in einer Zeile definieren. Die Einstellung width sorgt dafür, dass das Dashboard auf dem Bildschirm zentriert bleibt. Wenn Sie keine Breite festlegen, wird standardmäßig 1.200 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, werden bestimmte Dashboards möglicherweise zu einer Belastung für Ihre Datenbank.

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 beim Öffnen automatisch ausgeführt:

- 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 eine Pause bei einer Filteränderung einlegt 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 ist. 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 oben oder rechts in einem Dashboard 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 und ermöglichen es Nutzern, die Daten für die Dashboard-Elemente zu ändern.

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.

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 finden Sie unter LookML-Dashboards erstellen).

Filter haben das folgende Format:

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

name

Mit jeder name-Deklaration wird ein neuer Dashboard-Filter erstellt und ihm ein Name zugewiesen. Auf den Namen wird im Parameter listen von Elementen verwiesen, 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 angegeben ist, wird standardmäßig der Name des Filters als Titel verwendet.

Betrachten Sie dieses Beispiel:

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

Wenn Sie das getan haben, wird der Filter nicht als Bestelldatum, sondern als Bestelldatum(s) angezeigt.

type

Mit dem Parameter type wird der Typ der Eingabe angegeben, die in den Filter eingefügt wird. type: field_filter sollte in der Regel Ihre Standardauswahl sein, da der Filter direkt mit einer zugrunde liegenden Dimension oder einem zugrunde liegenden Measure verknüpft wird und dem Nutzer ein benutzerdefiniertes Filter-Widget zur Verfügung gestellt wird. Es gibt folgende Filtertypen:

  • 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: Der Nutzer kann eine Zahl, einen Ganzzahlwert oder einen Ausdruck eingeben.
  • date_filter: Ermöglicht die Nutzereingabe eines Datumswerts oder eines Ausdrucks.

  • string_filter (eingestellt): Der Typ string_filter wird nicht mehr unterstützt, da die alte Dashboard-Oberfläche in Looker 23.6 eingestellt wurde. Weitere Informationen finden Sie in den Versionshinweisen. Wenn Sie einen Filter für die Freitext-Eingabe ohne Drop-down-Liste mit Vorschlägen verwenden möchten, sehen Sie sich das Beispiel mit field_filter an.

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 ein Messwert ist.

Im Folgenden finden Sie ein Beispiel für LookML für den Typ field_filter:

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

Wenn Sie einen Filter für die Freiformateingabe von Text ohne Drop-down-Liste mit Vorschlägen verwenden möchten, geben Sie type: field_filter ein und konfigurieren Sie dann den Steuerungstyp mit ui_config: type: advanced (siehe UI-Konfiguration).

Das folgende Beispiel zeigt einen Filter, für den Freiformtext ohne Vorschläge verwendet wird:

filters:
- name: customer_name
  type: field_filter
  explore: orders
  field: customer.name
  ui_config:
    type: advanced

number_filter

Es werden keine Vorschläge gemacht. Der Nutzer kann eine Ganzzahl, einen numerischen Wert oder einen 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

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: field_filter
  explore: orders
  field: customer.name
  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 Filterwert 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 keinen Wert, werden die Daten einfach nicht durch das Filterfeld eingegrenzt. Ist für einen Filter ein Wert erforderlich und er wird leer gelassen, 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 der Filtersteuerelemente 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

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 für die einfache oder mehrfache Auswahl verwendet werden.

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 Zeit-Datentypen
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, eine für jeden Wert, der mit dem Parameter options angegeben wurde. STR NUM TIER ZIP Y/N DIST DUR
checkboxes Im Filter werden Kästchen angezeigt, eines 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, eine für jeden Wert, der mit dem Parameter options angegeben wurde. 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 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 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 ein Enddatum auswählen, um nach einem Zeitraum zu filtern. D&T: Die Zeitraumsteuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können jedoch nur die Zeiträume auswählen, für die diese Art von Steuerung verfügbar ist.
date_time_range_input Mit dem Filter können Nutzer nach einem Zeitraum filtern. 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 Zeitrahmensteuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Zuschauer können jedoch keine Zeitoptionen mit dieser Art von Steuerung auswählen.
Sonstiges
advancedDer 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

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 ein Button Mehr mit einem numerischen Indikator für die Anzahl der Überlauf-Filter angezeigt. Nutzer können auf den Button 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, 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

Bei Dashboard-Filtern vom Typ type: field_filter wird mit dem Parameter model das Modell des Felds definiert, das Sie verwenden möchten. Der Parameter model ist optional. Standardmäßig wird das Modell verwendet, in dem das Dashboard enthalten ist.

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, welche 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

vis_filter

Mit dem Parameter vis_filter können Sie einen Filter als Filter auf Visualisierungsebene konfigurieren, der direkt in einzelnen Visualisierungs-Tiles und nicht in der oberen Dashboard-Filterleiste angezeigt wird.

Wenn vis_filter auf true festgelegt ist, wird der Filter in der Filterleiste oben auf jeder Kachel angezeigt, die ihn berücksichtigt (konfiguriert mit dem Parameter listen für das Dashboard-Element). Der Standardwert ist false. In diesem Fall wird der Filter als Standardfilter auf Dashboardebene in der oberen Filterleiste angezeigt. Das Festlegen von vis_filter: false ist für Standard-Dashboard-Filter nicht erforderlich.

Beispiel:

filters:
- name: order_date
  title: "Order Date"
  type: date_filter
  default_value: "last 30 days"
  vis_filter: true

Weitere Informationen zu Filtern auf Visualisierungsebene finden Sie auf der Dokumentationsseite Filter für Visualisierungskacheln.

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 Ihr 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-String mit einem Farbnamen 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 Filter des eingebetteten Dashboards 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, 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
  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