LookML-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 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, d. h. die Datenvisualisierungen, Text-Tiles, Schaltflächen und Tile-Gruppen im Dashboard. Auf der Seite Dashboard-Elementparameter 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.
  group:
  # Optional - for organizing elements into a tile group. Must be declared for each child element individually.

Parameterdefinitionen

Parametername Beschreibung
dashboard Dashboard erstellen
title (für Dashboard) Ändern Sie, wie ein Dashboard-Name für Nutzer angezeigt wird.
description (für Dashboard) Fügen Sie eine Beschreibung hinzu, die im Bereich Dashboard-Details oder in einem Ordner in der Listenansicht angezeigt werden kann.
enable_viz_full_screen Legen Sie fest, ob Dashboard-Betrachter Dashboard-Kacheln im Vollbildmodus und in erweiterten Ansichten sehen können.
enabled_dashboard_agents Legen Sie fest, ob Dashboard-Betrachter über einen Dashboard-Agenten mit dem LookML-Dashboard chatten können.
default_dashboard_agent Geben Sie den Standard-Dashboard-Agenten an, der für konversationelle Abfragen im Dashboard verwendet werden soll.
extends Das LookML-Dashboard auf einem anderen LookML-Dashboard basieren lassen.
extension Das Dashboard muss durch ein anderes Dashboard erweitert werden.
layout Definieren Sie, wie die Elemente im Dashboard angeordnet werden sollen.
tabs Hinzugefügt in Version 26.4 Dashboard-Tabs zum Organisieren von Elementen auf einem Dashboard hinzugefügt. 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 die einzelnen Zeilen eines layout: grid-Dashboards eingefügt werden sollen.
elements (für Zeilen) Definieren Sie die Elemente, die in eine Zeile eines layout: grid-Dashboards eingefügt werden sollen.
height (für Zeilen) Definiert die Höhe einer Zeile für ein layout: grid-Dashboard.
tile_size Definiert 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 die Filterleiste des Dashboards standardmäßig als minimiert oder maximiert für ein Dashboard fest.
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 Dashboard-Filter definiert werden.
name (für Filter) Filter erstellen.
title (für Filter) Ändern Sie, wie ein Filtername für Nutzer angezeigt wird.
type (für Filter) Bestimmen Sie den Typ des zu verwendenden Filters.
default_value Legen Sie einen Standardwert für einen Filter fest.
allow_multiple_values Benutzer auf einen einzelnen Filterwert beschränken.
required Legen Sie fest, dass Nutzer einen Filterwert eingeben müssen, um das Dashboard auszuführen.
ui_config Konfigurieren Sie die Filtersteuerelemente, die verfügbar sind, wenn Nutzer ein LookML-Dashboard aufrufen. 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 Anpassungen für eingebettete Dashboards definiert werden.
background_color Legen Sie eine Hintergrundfarbe für ein eingebettetes Dashboard fest.
show_title Geben Sie an, ob der Dashboard-Titel in einem eingebetteten Dashboard sichtbar ist.
title_color Legen Sie die Farbe des Titels eines eingebetteten Dashboards fest.
show_filters_bar Geben Sie an, ob die Filterleiste in einem eingebetteten Dashboard sichtbar sein soll.
tile_background_color Legen Sie die Hintergrundfarbe der Kacheln eines eingebetteten Dashboards fest.
tile_text_color Legen Sie die Textfarbe für Kacheln eines eingebetteten Dashboards fest.
Elementparameter
elements (für Dashboard) Leitet einen Abschnitt von LookML ein, mit dem Dashboard-Elemente definiert werden.
group (für Elemente) Dashboard-Elemente in einer Kachelgruppe organisieren, indem Sie den Namen eines type: group-Elements angeben.

dashboard

Mit dem Parameter dashboard wird ein neues Dashboard deklariert und ein Name für das Dashboard angegeben. Die maximale Anzahl von Zeichen beträgt 255. 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 ein Dashboard etwas anzeigt, muss mindestens ein Element mit dem Parameter elements hinzugefügt werden.

preferred_viewer (verworfen)

Vor der Einstellung von alten Dashboards in Looker 23.6 konnten Sie mit dem Parameter preferred_viewer das Format für die Anzeige und den Download eines Dashboards entweder als Standard-Dashboard-Erfahrung von Looker oder als altes Dashboard auswählen.

title (für Dashboard)

Mit dem Parameter title können Sie ändern, wie ein Dashboard-Name für Nutzer 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 tun, wird das Dashboard nicht als Sales Overview, sondern als 1) Sales Overview 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 Dashboard-Listen angezeigt, wenn sie in einem Ordner in der Listenansicht angezeigt werden. Wenn keine Beschreibung angegeben ist, wird in der Liste nur der Dashboard-Titel angezeigt.

Der Beschreibungstext kann lokalisiert werden.

enable_viz_full_screen

Dieser Parameter wird nur wirksam, wenn die Einstellung für Vollbildvisualisierungen von einem Looker-Administrator aktiviert wurde. Die Einstellung Vollbild-Visualisierung ist standardmäßig aktiviert.

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

Für diesen Parameter sind die Werte true (Vollbildmodus und erweiterte Ansicht verfügbar) und false (Vollbildmodus und erweiterte Ansicht 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-Agenten mit dem LookML-Dashboard chatten können.

Dieser Parameter wird nur wirksam, wenn die Einstellung Dashboard-Agenten für Ihre Looker-Instanz auf der Seite „Verwaltung“ Gemini in Looker aktiviert ist.

Dieser Parameter akzeptiert true (Chat aktiviert) und false (Chat deaktiviert). Wenn dieser Parameter in der LookML-Dashboard-Datei weggelassen wird, wird auf der API-Ebene standardmäßig true verwendet.

- dashboard: sales_overview
  enabled_dashboard_agents: true

default_dashboard_agent

Der Parameter default_dashboard_agent gibt den Namen des Standard-Dashboard-Agenten an, der mit dem LookML-Dashboard verknüpft werden soll. Der angegebene Agent muss mit dem LookML-Parameter agent deklariert werden.

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

- dashboard: sales_overview
  default_dashboard_agent: sales_overview_agent

Wenn enabled_dashboard_agents auf true gesetzt ist und default_dashboard_agent nicht angegeben ist, können Nutzer weiterhin mit dem Dashboard chatten, wobei die Standardeinstellungen ohne benutzerdefinierte Anweisungen verwendet werden.

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. Der Parameter extends akzeptiert den Namen eines anderen LookML-Dashboards.

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 für andere 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 die Erweiterung für das Dashboard nicht erforderlich.

layout

Mit dem Parameter layout wird die Layoutmethode festgelegt, die Looker beim Positionieren von Dashboard-Elementen verwendet. Folgende Werte sind zulässig:

tabs

Tabs zum Organisieren von Elementen in Dashboards hinzugefügt. tabs definiert die Anzahl, die Namen und die Labels der Tabs, die auf 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 leitet der Parameter rows den LookML-Abschnitt ein, in dem Sie festlegen, welche Elemente in welche Zeilen eingefügt werden sollen, sowie die Höhe der einzelnen Zeilen. 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 Liste von Dashboard-Elementnamen angegeben werden, 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 in einer Zeile platzieren, belegen sie jeweils 50 % des verfügbaren Platzes. Wenn Sie vier Elemente in einer Zeile platzieren, nimmt jedes 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 ist die Einheit, die zum Festlegen der Größe und Position von Elementen verwendet wird, die Tile-Größe. Sie definieren tile_size in Pixeln. Der Standardwert ist 160. Beispiel:

- dashboard: sales_overview
  layout: tile
  tile_size: 100

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

width

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

- dashboard: sales_overview
  layout: static
  width: 800

refresh

Mit dem Parameter refresh kann ein Dashboard in regelmäßigen Abständen automatisch neu geladen werden, um aktuelle Daten abzurufen. Das ist oft hilfreich, wenn ein Dashboard ständig angezeigt wird, z. B. auf einem Fernseher im Büro. Beachten Sie, dass das Dashboard in einem Browserfenster geöffnet sein muss, 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 (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, können bestimmte Dashboards Ihre Datenbank belasten.

auto_run

Der Parameter auto_run bestimmt, ob ein Dashboard ausgeführt wird, wenn es zum ersten Mal geöffnet oder neu geladen wird. Der Standardwert ist true. Wenn dieser Parameter auf false gesetzt 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 auto_run müssen Nutzer nach dem Ändern von Filterwerten immer auf die Schaltfläche Ausführen klicken. So können Sie vermeiden, dass es zu unerwünschten Aktualisierungen kommt, wenn ein Benutzer während einer Filteränderung eine Pause 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 gesetzt ist, können Dashboard-Betrachter durch Klicken auf bestimmte Datenpunkte Kreuzfilter im Dashboard erstellen.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

Mit dem Parameter filters_bar_collapsed können Sie die Dashboard-Filterleiste für ein Dashboard 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 ist false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

Mit dem Parameter filters_location_top können Sie die Filterleiste des Dashboards oben oder rechts im 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 ist true.

- dashboard: sales_data
  filters_location_top: false

filters

Mit dem Parameter filters wird der LookML-Abschnitt gestartet, in dem Sie Dashboard-Filter definieren. Filter werden oben im Dashboard angezeigt und ermöglichen es Nutzern, die Daten hinter Dashboard-Elementen zu ändern.

Damit ein Filter auf ein Element angewendet wird, muss das Element so eingerichtet sein, dass es mit dem Parameter listen auf diesen Filter „hört“. Dieser Parameter gilt für alle Elementtypen außer type: text, type: button und type: group. 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 reagiert. 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. 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, type: button und type: group. 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 für Nutzer 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 (mehrere) angezeigt werden.

type

Der Parameter type gibt den Typ der Eingabe an, die in den Filter eingefügt wird. type: field_filter sollte im Allgemeinen Ihre Standardauswahl sein, da der Filter direkt mit einer zugrunde liegenden Dimension oder einem zugrunde liegenden Measure verbunden wird und dem Nutzer ein maßgeschneidertes Filter-Widget zur Verfügung steht. Es gibt folgende Filtertypen:

  • field_filter: Sollte im Allgemeinen die 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, eine Zahl, einen ganzzahligen Wert oder einen Ausdruck einzugeben.
  • date_filter: Ermöglicht dem Nutzer, einen Datumswert oder einen Ausdruck einzugeben.

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

field_filter

Schlägt Optionen zur Auswahl vor und ändert die Darstellung für Nutzer basierend auf dem von Ihnen angegebenen zugrunde liegenden Feld.

Dies sollte Ihr bevorzugter Filtertyp sein, wenn Sie Nutzern Vorschläge machen möchten, während sie mit dem Filter interagieren. Die Dimension, aus der Vorschläge abgerufen werden, wird mit den Parametern explore und field definiert und muss ein Feld vom Typ type: string sein, damit Filtervorschläge generiert werden können.

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

Das folgende Beispiel zeigt LookML für einen field_filter-Typ:

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 Eingabe von Freiformtext ohne Drop-down-Liste mit Vorschlägen verwenden möchten, verwenden Sie type: field_filter und konfigurieren Sie dann den Steuerungstyp mit ui_config: type: advanced (siehe UI-Konfiguration).

Das folgende Beispiel zeigt einen Filter, der die Eingabe von Freiformtext ohne Vorschläge verwendet:

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 einen Ganzzahl- oder Zahlenwert 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 einen 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 für Nutzer hilfreich sein, da er einen sinnvollen Ausgangspunkt darstellt.

Achten Sie darauf, dass der Standardwert dem verwendeten Filtertyp entspricht. 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"

Sie können Filterausdrücke verwenden, um Standardwerte zu erstellen. Auf der Dokumentationsseite Looker-Filterausdrücke wird dies ausführlicher 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 zugewiesen wurde, sowie mit den Datentypen, 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 gesetzt 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 und wird leer gelassen, werden die Daten einfach nicht durch das Filterfeld eingeschränkt. Ist für einen Filter ein Wert erforderlich, wird das Dashboard nicht ausgeführt, wenn der Filter keine Eingabe enthält.

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. Dazu gehören die verwendeten Arten von Filtersteuerungen, 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

Weitere Informationen zum Konfigurieren von Filtern über die 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 Arten von Filtersteuerungen angeben, die angezeigt werden.

Je nach dem Wert, den Sie für type eingeben, können Filtersteuerungen eine Einfach- oder Mehrfachauswahl sein.

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 Datentypen für Datum und Uhrzeit
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 zeigt eine Gruppe von Schaltflächen an, wobei für jeden mit dem Parameter options angegebenen Wert eine Schaltfläche vorhanden ist. STR NUM TIER ZIP Y/N DIST DUR
checkboxes Der Filter enthält Kästchen, wobei für jeden mit dem Parameter options angegebenen Wert ein Kästchen angezeigt wird. STR NUM TIER ZIP Y/N DIST DUR
tag_list Im Filter wird eine Drop-down-Liste 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 zeigt eine Gruppe von Schaltflächen an, wobei für jeden mit dem Parameter options angegebenen Wert eine Schaltfläche vorhanden ist. STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons Der Filter zeigt Optionsfelder an, mit einem Feld für Beliebiger Wert und einem Feld für jeden Wert, der mit dem Parameter options angegeben wurde. STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu Der Filter zeigt ein Drop-down-Menü mit allen möglichen Werten an, 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 wechseln, die mit dem Parameter options angegeben werden. 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 einen einzelnen Tag kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können mit dieser Art von Steuerung jedoch nur einzelne Tage auswählen.
day_range_picker Mit dem Filter können Nutzer ein Startdatum 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, die diese Art von Steuerung haben.
date_time_range_input Mit dem Filter können Nutzer nach einem Zeitraum und einer Uhrzeit filtern. D&T: Die Steuerung für Datums- und Zeitbereiche 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 nach einem benutzerdefinierten Zeitraum filtern oder aus vordefinierten Zeiträumen wie Heute, Letzte 7 Tage oder Letzte 90 Tage auswählen. D&T Die Zeitraumsteuerung kann mit den meisten Zeiträumen und zeitbasierten Typen verwendet werden. Betrachter können mit dieser Art von Steuerung jedoch keine Zeitoptionen auswählen.
Sonstiges
advancedDer Filter bietet Optionen zum Anwenden eines oder mehrerer Filter oder Filter für erweiterte Übereinstimmungen.

Weitere Informationen zu erweiterten Einstellungen finden Sie im Abschnitt Erweiterte Einstellungen 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 angezeigt werden. Beispielsweise können Filter vom Typ type: day_picker nur als inline oder overflow angezeigt werden. Wenn Sie einem Filter einen display-Wert zuweisen, der für diesen type ungü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 Nutzer ein LookML-Dashboard aufrufen. 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 im Feld users.city so 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 gesetzt ist, können Sie die Unterparameter min und max von options verwenden:

  • min: Legt den kleinstmöglichen Wert für einen Filter fest.
  • max: Legt 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 definiert der Parameter model das Modell des Felds, das Sie verwenden möchten. Der Parameter model ist optional und standardmäßig auf das Modell festgelegt, 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 Dashboard-Filter vom Typ type: field_filter müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Der Parameter explore gibt an, 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 Dashboard-Filter vom Typ type: field_filter müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Mit dem Parameter field wird angegeben, welches Feld Sie verwenden möchten. Es ist wichtig, den vollständigen 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 die Vorschläge für den Filter basierend auf den Eingaben des Nutzers für einen anderen Filter vom Typ type: field_filter einschränken.

Im folgenden Beispiel basieren die Vorschläge für den Filter State auf den Werten des Filters Order ID. Für alle Werte, die für den Filter Order ID ausgewählt werden, gibt es zugehörige users.state-Werte. Diese Werte werden als Vorschläge für den Filter State angezeigt. 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

vis_filter

Mit dem Parameter vis_filter können Sie einen Filter als Filter auf Visualisierungsebene konfigurieren, der direkt auf 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 Tile angezeigt, die auf ihn reagiert (konfiguriert mit dem Parameter listen im Dashboard-Element). Der Standardwert ist false. Dadurch wird der Filter als Standardfilter auf Dashboard-Ebene in der oberen Filterleiste angezeigt. Die Einstellung 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 auf Visualisierungs-Tiles.

embed_style

Mit dem Parameter embed_style wird der LookML-Abschnitt 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 angezeigt werden.

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

Anpassungen für eingebettete Dashboards haben das folgende Format:

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

Legt die Hintergrundfarbe eines eingebetteten Dashboards fest.

embed_style:
  background_color: "#ffffff"

show_title

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

embed_style:
  show_title: false

title_color

Legt die Farbe des Titels eines eingebetteten Dashboards fest.

embed_style:
  title_color: "#008000"

show_filters_bar

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

embed_style:
  show_filters_bar: true

tile_background_color

Legt die Hintergrundfarbe aller Tiles in einem eingebetteten Dashboard fest.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

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

embed_style:
  tile_text_color: "crimson"

elements

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

- dashboard: sales_overview
  layout: tile
  tabs:
  - name: Tab 1
    label: Tab 1
  - name: Tab 2
    label: Tab 2
  - name: Tab 3
    label: Tab 3
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]
    tab_name: Tab 1

group

Organisiert Dashboard-Elemente in einer Tile-Gruppe auf einem LookML-Dashboard. Wenn Sie Tile-Gruppen in einem LookML-Dashboard verwenden möchten, muss Ihr Looker-Administrator die Funktion in der Vorabversion Dashboard-Tile-Gruppen aktivieren und das Dashboard muss die Dashboard-Layoutmethode newspaper verwenden.

So erstellen Sie eine Tile-Gruppe und fügen ihr in LookML Elemente hinzu:

  1. Definieren Sie im Abschnitt elements einen Kachelgruppencontainer mit type: group und geben Sie die zugehörigen Werte für name, title, row, col, width und height (und optional tab_name, title_hidden und aria_description) an. Elemente von type: group sind visuelle Container und akzeptieren keine Abfrageparameter wie model, explore oder listen.
  2. Fügen Sie jedem Dashboard-Element, das Sie in der Tile-Gruppe platzieren möchten, den Parameter group hinzu und legen Sie als Wert den name des type: group-Elements fest.

Beachten Sie beim Organisieren von Elementen in einer Kachelgruppe Folgendes:

  • Bei Elementen, die in einer Kachelgruppe platziert sind, definieren die Parameter row und col die Position des Elements relativ zur oberen linken Ecke (row: 0, col: 0) des Gruppencontainers und nicht des Dashboard-Canvas.
  • Bei Dashboards mit Tabs muss die tab_name eines untergeordneten Elements mit der tab_name der übergeordneten Gruppe übereinstimmen.
  • Looker unterstützt keine verschachtelten Tile-Gruppen (Platzieren eines type: group-Elements in einer anderen Tile-Gruppe).
- dashboard: sales_overview
  layout: newspaper
  elements:
  - name: revenue_metrics_group
    title: "Revenue Metrics"
    type: group
    row: 0
    col: 0
    width: 24
    height: 8
  - name: total_revenue
    title: "Total Revenue"
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.total_revenue]
    group: revenue_metrics_group
    row: 0
    col: 0
    width: 8
    height: 6