Parameter für Wasserfalldiagramme für LookML-Dashboards

Auf dieser Seite wird gezeigt, wie Sie ein LookML-Dashboard-Element vom Typ type: looker_waterfall mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei hinzufügen und anpassen.

Informationen zum Erstellen eines Wasserfalldiagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Wasserfalldiagramm-Optionen.

Nutzungsbeispiel

Ein N gibt an, dass ein numerischer Wert erforderlich ist. Einfache Anführungszeichen kennzeichnen beschreibenden Text und sollten nicht in Live-Code enthalten sein.

## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_waterfall
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note_state: collapsed | expanded
note_display: above | below | hover
note_text: 'note text'

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_name, …]
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
hidden_fields: [view_name.field_name, view_name.field_name, …]
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## SERIES PARAMETERS
up_color: "hex string" | 'CSS named color string'
down_color: "hex string" | 'CSS named color string'
total_color: "hex string" | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Parameterdefinitionen

Parametername	Beschreibung
Grundlegende Parameter
name (für Elemente)	Erstellt das Element
title (für Elemente)	Ändert die Art und Weise, wie der Elementname für Nutzer angezeigt wird
type (für Elemente)	Bestimmt den Visualisierungstyp, der im Element verwendet werden soll.
height (für Elemente)	Definiert die Höhe des Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
width (für Elemente)	Definiert die Breite des Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards.
top	Definiert die Position des Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards.
left	Definiert die Position des Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.
row	Definiert die Position eines Elements von oben nach unten in Zeileneinheiten für layout: newspaper-Dashboards
col	Definiert die Position eines Elements von links nach rechts in Spalteneinheiten für layout: newspaper-Dashboards
refresh (für Elemente)	Legt das Intervall fest, in dem das Element automatisch aktualisiert wird
note_state	Gibt an, ob die Notiz minimiert oder maximiert wird, wenn sie zu groß ist, um in einer einzelnen Zeile innerhalb der Breite des Elements dargestellt zu werden.
note_display	Definiert, wo die Notiz auf dem Element angezeigt wird
note_text	Gibt den Text an, der in der Notiz angezeigt wird
Suchparameter
model	Definiert das Modell, das für die Abfrage des Elements verwendet werden soll
explore (für Elemente)	Definiert das Explore, das für die Abfrage des Elements verwendet werden soll
fields	Definiert die Felder, die für die Abfrage des Elements verwendet werden sollen. Dies kann anstelle von dimensions und measures verwendet werden.
dimensions	Definiert die Dimensionen, die für die Abfrage des Elements verwendet werden sollen
measures	Definiert die Messwerte, die für die Abfrage des Elements verwendet werden sollen.
sorts	Definiert die Sortierungen, die für die Abfrage des Elements verwendet werden sollen
fill_fields	Definiert die Dimensionen, für die die Option Dimension ausfüllen verwendet wird.
limit	Definiert die Zeilenbegrenzung, die für die Abfrage des Elements verwendet werden soll.
filters (für Elemente)	Definiert die Filter, die für die Abfrage des Elements nicht geändert werden können.
filter_expression	Definiert einen benutzerdefinierten Filter, der für die Abfrage des Elements nicht geändert werden kann.
listen	Definiert die Filter, die für die Abfrage des Elements geändert werden können, wenn filters (für das Dashboard) erstellt wurden.
hidden_fields	Gibt Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen.
query_timezone	Definiert die Zeitzone, die beim Ausführen der Abfrage verwendet werden soll.
merged_queries	Definiert eine Abfrage mit zusammengeführten Ergebnissen
Parameter für Reihen
up_color	Legt die Farbe der Balken mit positiven Werten im Diagramm fest.
down_color	Legt die Farbe der Balken für negative Werte im Diagramm fest.
total_color	Legt die Farbe des Balkens für den Gesamtwert im Diagramm fest.
color_application	Wendet eine Farbkollektion und ‑palette auf das Diagramm an.
Wertparameter
show_value_labels	Zeigt Labels für jeden Datenbalken an
label_color	Gibt einen Farbwert für Labels an.
Parameter der X-Achse
x_axis_scale	Gibt an, wie die Skalierung der X-Achse berechnet wird.
show_x_axis_label	Blendet die Beschriftung der X-Achse ein oder aus
show_x_axis_ticks	Werte auf der x-Achse anzeigen
x_axis_zoom	Gibt an, ob das Zoomen entlang der X-Achse zulässig ist.
Parameter für die Y-Achse
show_y_axis_labels	Blendet die Beschriftung der Y-Achse ein oder aus
show_y_axis_ticks	Werte auf der y-Achse anzeigen
y_axis_gridlines	Erweitert die Gitternetzlinien der y-Achse
y_axis_zoom	Gibt an, ob das Zoomen entlang der Y-Achse zulässig ist. Deaktiviert, wenn x_axis_zoom: false.
Parameter für die erweiterte Visualisierungskonfiguration
advanced_viz_config	Akzeptiert ein HighCharts-JSON-Snippet, mit dem mehrere Visualisierungseinstellungen überschrieben werden können.

Grundlegende Parameter

Wenn Sie ein LookML-Dashboardelement definieren, müssen Sie mindestens Werte für die grundlegenden Parameter name und type angeben. Andere grundlegende Parameter wie title, height und width wirken sich auf die Darstellung und Position des Elements in einem Dashboard aus.

name

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

name kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit jeder name-Deklaration wird ein neues Dashboard-Element erstellt und ihm ein Name zugewiesen. Elementnamen müssen eindeutig sein. Namen werden manchmal im Parameter elements angegeben, wenn Sie layout: grid-Dashboards verwenden.

- name: orders_by_date

title

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

title kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

title kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter title können Sie ändern, wie der Name eines Elements für Nutzer angezeigt wird. Wenn nichts angegeben ist, wird standardmäßig das Element name als Titel verwendet.

Betrachten Sie dieses Beispiel:

- name: sales_overview
  title: '1) Sales Overview'

Wenn Sie dieses Format verwendet haben, wird das Element nicht als Umsatzübersicht, sondern als 1) Umsatzübersicht angezeigt.

type

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

type kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

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

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

type kann auch als Teil eines Messwerts verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Messwerttypen.

Der Parameter type bestimmt den Visualisierungstyp, der im Element verwendet werden soll.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Eine Übersicht über die verschiedenen Arten von LookML-Dashboard-Elementen finden Sie auf der Dokumentationsseite type (für LookML-Dashboards).

height

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

height kann auch als Teil einer Dashboard-Zeile verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Für Dashboards mit tile- oder static-Layouts

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von tile_size (in Pixeln) für layout: tile- und layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, wodurch das Element orders_by_date eine Höhe von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Für Dashboards mit newspaper-Layout

Mit dem Parameter height wird die Höhe eines Elements in Einheiten von Zeile für layout: newspaper-Dashboards definiert.

Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen oder etwa 300 Pixel. Die Mindesthöhe beträgt eine Zeile für Dashboards, bei denen der Parameter preferred viewer auf dashboards-next festgelegt ist. Die Mindesthöhe beträgt 2 Zeilen für Dashboards, bei denen der Parameter preferred viewer auf dashboards festgelegt ist.

Im folgenden Code wird beispielsweise ein Element auf 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die der Standardwert festgelegt ist:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

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

width kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter width definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards.

Im folgenden Code werden beispielsweise tile_size: 100 und width: 4 angegeben, wodurch das orders_by_date-Element eine Breite von 400 Pixeln erhält.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Der Parameter width definiert die Breite eines Elements in Spalteneinheiten für layout: newspaper-Dashboards.

Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Breite von 24 Spalten.

Mit dem folgenden Code wird die Breite des Elements beispielsweise auf die Hälfte der Breite des Dashboards festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Mit dem Parameter top wird die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards definiert.

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben. Dadurch wird der obere Rand des Elements orders_by_date 400 Pixel vom oberen Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Der Parameter left definiert die Position eines Elements von links nach rechts in Einheiten von tile_size für layout: static-Dashboards.

Im folgenden Code wird beispielsweise tile_size: 100 und left: 4 angegeben. Dadurch wird der linke Rand des Elements orders_by_date 400 Pixel vom linken Rand des Dashboards entfernt positioniert.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Bei layout: newspaper-Dashboards wird mit dem Parameter row die Zeile definiert, in der die obere Kante eines Elements platziert wird.

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungs-Layout ist die Standardhöhe eines Elements 6 Zeilen. Die Dashboard-Elemente oben auf einem Dashboard (row: 0) würden also standardmäßig die Zeilen 0 bis 5 einnehmen.

Jede Zeile ist 50 Pixel hoch. Die Standardhöhe des Elements von 6 Zeilen beträgt also 300 Pixel.

Mit dem folgenden Code wird beispielsweise ein Element in der zweiten Zeile der Elemente im Dashboard platziert, sofern die Elemente auf der Standardhöhe festgelegt sind:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Bei layout: newspaper-Dashboards wird mit dem Parameter col die Spalte definiert, an der der linke Rand des Elements platziert wird.

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 links im Dashboard. Bei einem Dashboard mit Zeitungs-Layout wird standardmäßig eine Elementbreite von 8 Spalten verwendet. Die Dashboard-Elemente auf der linken Seite eines Dashboards (col: 0) belegen also standardmäßig die Spalten 0 bis 7.

Mit dem folgenden Code wird beispielsweise festgelegt, dass ein Element in der dritten Spalte der Elemente im Dashboard platziert werden soll:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

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

refresh kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Mit dem Parameter refresh kann ein Element 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:

- name: orders_by_date
  refresh: 2 hours

Seien Sie vorsichtig, wenn Sie kurze Aktualisierungsintervalle festlegen. Wenn die Abfrage, die dem Element zugrunde liegt, ressourcenintensiv ist, können bestimmte Elemente Ihre Datenbank stärker als gewünscht belasten.

note_state

Mit dem Parameter note_state wird definiert, ob eine Notiz minimiert oder maximiert wird, wenn sie zu groß ist, um in einer einzelnen Zeile innerhalb der Breite des Elements dargestellt zu werden. Wenn Sie collapsed auswählen und die Notiz zu lang ist, endet sie mit klickbaren Auslassungspunkten (...), über die Sie die vollständige Notiz lesen können. Wenn Sie expanded auswählen und die Notiz lang ist, wird sie auf mehrere Zeilen verteilt.

note_display

Mit dem Parameter note_display wird festgelegt, wo eine Anmerkung für ein Element angezeigt wird. Mit above wird die Anmerkung oben in einem Element platziert, mit below unten in einem Element und mit hover muss der Nutzer den Mauszeiger auf ein ?-Symbol bewegen, um die Anmerkung zu sehen.

note_text

Der Parameter note_text gibt den Text an, der in einer Elementanmerkung angezeigt wird.

Suchparameter

Wenn Sie ein LookML-Dashboard-Element definieren, müssen Sie Werte für mindestens die Abfrageparameter model und explore angeben. Außerdem muss mindestens ein Feld mit dem Parameter dimensions, dem Parameter measures oder dem Parameter fields angegeben werden. Mit den anderen Abfrageparametern können Sie auch die Art und Weise steuern, wie Daten in einem Dashboard-Element dargestellt werden.

model

Mit dem Parameter model wird das Modell für die Elementabfrage definiert. Wenn nichts angegeben ist, wird standardmäßig das Modell verwendet, in dem sich das Dashboard befindet.

- name: orders_by_date
  model: ecommerce

Der Parameter model akzeptiert LookML-Konstanten. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für model festzulegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Modells an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Modells aktualisieren, das von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

explore

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

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

explore kann auch als Teil eines Dashboardfilters verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

Der Parameter explore definiert das Explore, das für die Elementabfrage verwendet werden soll.

- name: orders_by_date
  explore: order

Der Parameter explore akzeptiert LookML-Konstanten. Sie können eine Konstante in der Manifestdatei für Ihr Projekt definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für explore festzulegen. Wenn Sie eine Konstante verwenden, können Sie den Namen eines Explores an einem Ort definieren. Das ist besonders nützlich, wenn Sie den Namen eines Explores aktualisieren, das von mehreren Dashboard-Elementen verwendet wird.

Weitere Informationen und ein Beispiel für die Verwendung von Konstanten mit LookML-Dashboards finden Sie auf der Dokumentationsseite zum Parameter constant.

fields

Der Parameter fields definiert die Felder, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Felder anzugeben.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Wenn Sie den Parameter fields verwenden, müssen Sie die Parameter dimensions und measures nicht verwenden.

dimensions

Der Parameter dimensions definiert die Dimension(en), die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie dimensions nicht ein, wenn die Anfrage keine hat.

## single dimension example
- name: orders_by_date
  dimensions: order.order_date

## multiple dimension example
- name: orders_by_date
  dimensions: [order.order_date, customer.name]

measures

Der Parameter measures definiert den oder die Messwerte, die für die Elementabfrage verwendet werden sollen. Verwenden Sie die Syntax view_name.measure_name, um die Messung anzugeben. Fügen Sie measures nicht ein, wenn die Anfrage keine hat.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Der Parameter sorts definiert die Sortierungen, die für die Elementabfrage verwendet werden sollen. Die primäre Sortierung wird zuerst aufgeführt, dann die sekundäre usw. Verwenden Sie die Syntax view_name.field_name, um die Dimension oder den Messwert anzugeben. Geben Sie sorts nicht an, wenn Sie die Standardsortierreihenfolge von Looker verwenden möchten. Absteigende Sortierungen haben das Suffix desc, aufsteigende Sortierungen nicht.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

fill_fields

Der Parameter fill_fields definiert die Dimensionen, für die die Option Dimensionen auffüllen verwendet wird. Verwenden Sie die Syntax view_name.dimension_name, um die Dimensionen anzugeben.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

limit

Der Parameter limit definiert das Zeilenlimit, das für die Elementabfrage verwendet werden soll. Das Limit gilt für die Anzahl der Zeilen bevor Pivots angewendet werden.

- name: orders_by_date
  limit: 100

filters

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

filters kann auch als Teil eines Dashboards verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite Dashboard-Parameter.

filters kann auch als Teil einer Messung verwendet werden. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parameter filters.

Mit dem Parameter filters werden die unveränderlichen Filter definiert, die für die Abfrage des Elements verwendet werden sollen. Wenn Sie Filter verwenden möchten, die ein Nutzer im Dashboard ändern kann, sollten Sie die Filter mit filters für Dashboards einrichten und sie dann mit listen auf die Elemente anwenden.

Die Syntax für filters lautet:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Für jeden Filter kann ein Looker-Filterausdruck oder eine Wertkonstante angegeben werden. Sie können auch die Liquid-Variablen _localization oder _user_attributes im Filterausdruck verwenden, um flexible Filterwerte zu erhalten.

filter_expression

Mit dem Parameter filter_expression wird ein nicht änderbarer benutzerdefinierter Filter für die Abfrage des Elements definiert. Wenn Sie Filter verwenden möchten, die ein Nutzer im Dashboard ändern kann, sollten Sie die Filter mit filters für Dashboards einrichten und sie dann mit listen auf die Elemente anwenden.

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

Auf der Dokumentationsseite Looker-Filterausdrücke sind die Looker-Filterausdrücke aufgeführt.

listen

Mit Dashboard-Filtern können Betrachter die Daten, die in Dashboard-Elementen angezeigt werden, interaktiv eingrenzen. Definieren Sie Dashboard-Filter mit dem filters-Parameter für LookML-Dashboards. Verwenden Sie dann den Parameter listen, um Dashboardelemente mit dem Dashboardfilter zu verknüpfen.

Die Syntax für listen lautet so:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Fügen Sie einem Element den Parameter listen hinzu und geben Sie dann den Namen des Filters gefolgt von einem Doppelpunkt und einem Verweis auf das Feld an, auf das der Filter angewendet werden soll. Verwenden Sie dazu die Syntax view_name.field_name. Sie können beispielsweise einen Filter namens Datum erstellen, bei dem ein Nutzer ein Datum in das Filterfeld in der Benutzeroberfläche eingeben muss. Sie können den vom Nutzer eingegebenen Wert dann so auf das orders_by_date-Element anwenden:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Weitere Beispiele für die Verwendung des Parameters filters und des Parameters listen zum Anwenden von Dashboard-Filtern auf einzelne Dashboard-Elemente finden Sie unter LookML-Dashboards erstellen.

hidden_fields

Mit dem Parameter hidden_fields wird angegeben, welche Felder in der Abfrage verwendet werden, aber im Diagramm ausgeblendet sind. Alle ausgeblendeten Felder werden im Datentabellenbereich eines Explores angezeigt.

hidden_fields: [inventory_items.count, distribution_centers.id]

query_timezone

Mit dem Parameter query_timezone wird die Zeitzone angegeben, in der die Abfrage ausgeführt wird. Die Zeitzonenoptionen finden Sie auf der Dokumentationsseite Werte für timezone. Wenn die Abfrage in der Zeitzone des Betrachters ausgeführt werden soll, können Sie den Wert als user_timezone zuweisen.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

Mit dem Parameter merged_queries können Sie die Ergebnisse mehrerer Abfragen in einem einzigen Dashboard-Element kombinieren. Definieren Sie jede Quellabfrage im merged_queries-Parameter des Elements und verwenden Sie den join_fields-Unterparameter, um anzugeben, wie die Ergebnisse zusammengeführt werden sollen.

Im folgenden Beispiel-LookML-Code wird ein -Element vom Typ „Zusammengeführte Ergebnisse“ von type: looker_grid erstellt. In diesem Beispiel wird mit dem Parameter merged_queries ein Dashboard-Element erstellt, in dem Daten aus zwei separaten Abfragen in einem einzigen Tabellendiagramm kombiniert werden:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

In diesem Beispiel werden im Dashboard-Element Daten aus zwei Quellabfragen kombiniert, die auf dem users-Explore im ecommerce-Modell basieren. Die primäre Abfrage enthält die Felder users.state, users.count und users.city und sortiert die Ergebnisse nach dem Feld users.count. Die zweite Quellabfrage enthält die Felder users.state und users.city und sortiert die Ergebnisse nach dem Feld users.state.

Mit dem Parameter join_field werden die Quellabfragen anhand übereinstimmender Werte in den Feldern users.state und users.city zusammengeführt.

Mit dem Parameter listen wird ein State-Filter auf beide Abfragen angewendet. So können Dashboard-Betrachter die in der Dashboard-Kachel angezeigten Abfrageergebnisse verfeinern, indem sie einen bestimmten Bundesstaat auswählen.

Beispiel: Unternehmensdaten zusammenführen

Angenommen, Sie möchten eine zusammengeführte Abfrage erstellen, in der Informationen zu Unternehmen aus zwei verschiedenen Explores kombiniert werden: company_info und companies. Sie möchten die Abfragen für die Felder ipo.stock_symbol, companies.name und companies.contact_email aus den einzelnen Explores zusammenführen, um eine Abfrage zu erstellen, die Ergebnisse für Unternehmensname, E-Mail-Adresse des Unternehmenskontakts, Jahr des Börsengangs, Aktiensymbol, Anzahl der Mitarbeiter und Anzahl der Stellen zurückgibt. Sie können das Element für die zusammengeführte Abfrage in LookML so definieren:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

Filter auf zusammengeführte Abfrageelemente anwenden

Im vorherigen Beispiel für ein zusammengeführtes Abfrageelement wird gezeigt, wie Sie hartcodierte Filter direkt in jeder Quellabfrage mit dem Parameter filters anwenden. Mit den Filtern companies.contact_email: "-NULL" und ipo.valuation_amount: NOT NULL in der primären Abfrage werden die Ergebnisse beispielsweise auf Unternehmen mit gültigen Kontakt-E-Mail-Adressen und Bewertungen beschränkt. Diese Filter auf Abfrageebene filtern die Daten vor dem Zusammenführen der Abfragen vor und können vom Nutzer nicht geändert werden.

Sie können auch Dashboard-Filter auf zusammengeführte Abfrageelemente anwenden. Verwenden Sie dazu den Parameter listen in der Definition jeder Quellabfrage. Angenommen, Sie haben einen Dashboardfilter mit dem Namen Industry, den Sie auf Dashboardebene mit dem Parameter filters für LookML-Dashboards definiert haben:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

Wenn Sie den Filter Industry auf das Feld companies.industry in beiden Quellabfragen anwenden möchten, fügen Sie den Parameter listen jeder der Quellabfragedefinitionen der zusammengeführten Abfrage so hinzu:

listen:
  Industry: companies.industry

Im folgenden Beispielcode wird der Filter Industry beiden Quellabfragen im zusammengeführten Ergebniselement aus dem vorherigen Beispiel hinzugefügt.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

Wenn ein Nutzer mit dem Dashboardfilter Industry interagiert, wird die entsprechende Quellabfrage im zusammengeführten Abfrageelement entsprechend gefiltert.

Tipp :Jede Quellabfrage kann auf einen oder mehrere Dashboard-Filter reagieren. So können Sie die Filterlogik für jede Quellabfrage unabhängig von der Anzahl der Quellabfragen im Element mit zusammengeführten Ergebnissen definieren. Wenn eine Abfrage keinen listen-Parameter hat, ist sie nicht von Dashboardfiltern betroffen.

Parameter für Reihen

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü „Reihen“ des Visualisierungseditors für Wasserfalldiagramme.

up_color

Legen Sie die Farbe der Balken mit positiven Werten im Diagramm fest. Der Farbwert kann ein in Anführungszeichen eingeschlossener Hexadezimalstring wie „#2ca6cd“ oder ein CSS-Farbstring wie mediumblue sein.

up_color: blue

Der Parameter up_color überschreibt den Parameter color_application, sofern dieser verwendet wird.

down_color

Legt die Farbe der Balken für negative Werte im Diagramm fest. Der Farbwert kann ein in Anführungszeichen eingeschlossener Hexadezimalstring wie „#2ca6cd“ oder ein CSS-Farbstring wie mediumblue sein.

down_color: "#ff0000"

Der Parameter down_color überschreibt den Parameter color_application, sofern dieser verwendet wird.

total_color

Legen Sie die Farbe des Balkens für den Gesamtwert im Diagramm fest. Der Farbwert kann ein in Anführungszeichen eingeschlossener Hexadezimalstring wie „#2ca6cd“ oder ein CSS-Farbstring wie mediumblue sein.

total_color: yellow

Der Parameter total_color überschreibt den Parameter color_application, sofern dieser verwendet wird.

color_application

Mit dem Parameter color_application und seinen Unterparametern collection_id und palette_id können Sie eine bestimmte Farbsammlung und ‑palette auf ein Dashboard-Element anwenden. Eine Übersicht über die nativen Farbkollektionen von Looker finden Sie auf der Dokumentationsseite Farbkollektionen.

Wenn Sie die Sammlungs-ID und die Paletten-ID für die gewünschte Palette haben, können Sie diese IDs in die Unterparameter collection_id und palette_id eingeben. Eine Sammlungs-ID oder eine Paletten-ID kann ein alphanumerischer Code sein oder auf dem Namen der Farbsammlung basieren. Für die nativen Sammlungen von Looker werden alphanumerische Codes verwendet. Sie sind instanzspezifisch und sehen so aus:

color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Für benutzerdefinierte Farbsammlungen werden Sammlungs- und Paletten-IDs basierend auf dem Namen der Farbsammlung verwendet, die instanzübergreifend übertragbar sind und so aussehen:

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Sie können auch über die Benutzeroberfläche nach den gewünschten Farben, Sammlungen oder Paletten suchen und den LookML-Code generieren, um sie Ihrem Dashboard hinzuzufügen. Rufen Sie einen benutzerdefinierten Inhalt auf (z. B. einen Look, ein Dashboard oder ein Explore) und wenden Sie die gewünschten Farben, die gewünschte Sammlung oder die gewünschte Palette über die Benutzeroberfläche auf die Visualisierung dieses Inhalts an. Anschließend können Sie der Anleitung zum Abrufen von Dashboard-LookML folgen, den generierten LookML-Code kopieren und in den Abschnitt color_application einfügen.

color_application und die Balken für positive, negative und Gesamtwert

Standardmäßig wird die erste Farbe der ausgewählten Palette auf die Balken mit positiven Werten im Wasserfalldiagramm angewendet, die zweite Farbe auf die Balken mit negativen Werten und die dritte Farbe auf den Balken mit der Gesamtsumme. Mit dem optionalen Unterparameter reverse wird die Anwendung auf die letzte, vorletzte bzw. drittletzte Farbe geändert.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

Die Parameter up_color, down_color und total_color überschreiben alle im Parameter color_application angegebenen Farben, wenn beide Arten von Farbparametern verwendet werden.

Wertparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü „Werte“ des Visualisierungseditors für Wasserfalldiagramme.

show_value_labels

Zeigen Sie den Wert eines Balkens, einer Linie oder eines Punkts neben dem Datenpunkt an.

show_value_labels: true | false

## default value: false

label_color

Der Parameter label_color akzeptiert einen Farbwert für die Labels. Der Farbwert kann als Hex-String, z. B. #2ca6cd, oder als CSS-String mit Farbnamen, z. B. mediumblue, formatiert werden.

label_color: [blue]

Parameter der X‑Achse

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im X des Visualisierungseditors für Wasserfalldiagramme.

x_axis_scale

Mit diesem Parameter wird festgelegt, wie die Skala der x-Achse berechnet wird.

• auto: Der Maßstab wird aus den zugrunde liegenden Daten abgeleitet. Dies ist die Standardeinstellung.
• ordinal: Die Daten werden als gleichmäßig verteilte, diskrete Einträge dargestellt.
• time: Die Daten werden als Zeit dargestellt und die Achse wird entsprechend beschriftet. Das funktioniert nicht, wenn die zugrunde liegenden Daten nicht in Datumsangaben umgewandelt werden können.

x_axis_scale: auto | ordinal | time

## default value: auto

show_x_axis_label

Mit diesem Parameter wird festgelegt, ob das Label der x-Achse angezeigt wird.

show_x_axis_label: true | false

## default value: true

show_x_axis_ticks

Mit diesem Parameter wird festgelegt, ob Werte auf der x-Achse angezeigt werden.

show_x_axis_ticks: true | false

## default value: true

x_axis_zoom

Mit diesem Parameter wird angegeben, ob Nutzer die X-Achse der Visualisierung vergrößern können. Wenn x_axis_zoom auf true gesetzt ist, ist das Zoomen möglich. Wenn x_axis_zoom auf false festgelegt ist, ist das Zoomen nicht verfügbar.

Wenn x_axis_zoom auf false gesetzt ist, wird y_axis_zoom deaktiviert.

x_axis_zoom: true | false

# default value: true

Parameter der Y-Achse

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Menü „Y“ des Visualisierungseditors für Wasserfalldiagramme.

show_y_axis_labels

Mit diesem Parameter wird festgelegt, ob das Y-Achsenlabel angezeigt wird.

show_y_axis_labels: true | false

## default value: true

show_y_axis_ticks

Mit diesem Parameter wird festgelegt, ob Werte auf der y-Achse angezeigt werden.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Mit diesem Parameter wird festgelegt, ob die Gitternetzlinien von der y-Achse aus verlängert werden.

y_axis_gridlines: true | false

## default value: true

y_axis_zoom

Mit diesem Parameter wird angegeben, ob Nutzer die Y-Achse der Visualisierung vergrößern können. Wenn y_axis_zoom auf true gesetzt ist, ist das Zoomen möglich.

Wenn y_axis_zoom auf false festgelegt ist, können Nutzer nicht in kleinere Abschnitte der y-Achse zoomen. Nutzer können jedoch weiterhin in kleinere Abschnitte der x-Achse zoomen, wenn der Parameter x_axis_zoom auf true festgelegt ist.

Wenn x_axis_zoom auf false festgelegt ist, wird y_axis_zoom deaktiviert.

y_axis_zoom: true | false

# default value: true

Erweiterte Visualisierungskonfiguration

Die in diesem Abschnitt beschriebenen Parameter entsprechen den optionalen Überschreibungen der Diagrammkonfiguration, die Sie auf ein Diagramm anwenden können, indem Sie im Visualisierungseditor im Bereich Diagramm auf die Schaltfläche Diagrammkonfiguration bearbeiten klicken.

advanced_vis_config

Dieser Parameter akzeptiert ein HighCharts-JSON-Snippet, das mehrere Visualisierungseinstellungen überschreibt und neue Möglichkeiten eröffnet. Auf der Dokumentationsseite Visualisierungen mit dem Chart Config Editor anpassen finden Sie Beispiele für die Verwendung von HighCharts-JSON für gängige Anwendungsfälle.

advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null