Parameter für Säulendiagramme für LookML-Dashboards

Auf dieser Seite werden die Optionen zum Erstellen eines LookML-Dashboard-Elements vom Typ type: looker_column mit LookML-Dashboard-Parametern in einer dashboard.lkml-Datei beschrieben.

Informationen zum Erstellen eines Säulendiagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Säulendiagrammoptionen.

Nutzungsbeispiel

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

## QUERY PARAMETERS
model: model_name
explore: explore_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, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
  dashboard_filter_name: dimension_or_measure_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

## PLOT PARAMETERS
stacking: normal | percent | ''
show_dropoff: true | false
ordering: none | asc | desc
column_spacing_ratio: number between 0 and 1
column_group_spacing_ratio: number between 0 and 1
hide_legend: true | false
legend_position: center | left | right
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
  show_hide: show | hide
  first_last: first | last
  num_rows: 'N'

## SERIES PARAMETERS
colors: [css_color, css_color, …]
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
   series_name: column | line | area | scatter
   # Possibly more series visualization assignments
show_view_names: true | false

## VALUE PARAMETERS
show_value_labels: true | false
show_null_labels: true | false
label_color: [css_color, css_color, …]
font_size: Npx
label_rotation: N
label_value_format: 'value formatting string'
show_totals_labels: true | false
hidden_series: [series_name, series_name, …]
show_silhouette: true | false
totals_color: css_color

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
x_axis_reversed: true | false
show_x_axis_label: true | false
x_axis_label: desired x-axis label
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
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 ein Element
title (für Elemente)	Ändert die Art und Weise, wie ein Elementname für Nutzer angezeigt wird
type (für Elemente)	Bestimmt den Typ der Visualisierung, die im Element verwendet werden soll
height (für Elemente)	Definiert die Höhe eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
width (für Elemente)	Definiert die Breite eines Elements in Einheiten von tile_size für layout: tile- und layout: static-Dashboards
top	Definiert die Position eines Elements von oben nach unten in Einheiten von tile_size für layout: static-Dashboards
left	Definiert die Position eines 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	Leitet einen Abschnitt von LookML ein, mit dem eine Notiz für ein Element definiert wird. Dieser Parameter hat die Unterparameter text, state und display.
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.
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
pivots	Definiert die Dimensionen, die für die Abfrage des Elements pivotiert werden sollen
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
listen	Definiert die Filter, die für die Abfrage des Elements geändert werden können, wenn filters (für Dashboard) erstellt wurden
query_timezone	Definiert die Zeitzone, die beim Ausführen der Abfrage verwendet werden soll
merged_queries	Definiert eine Abfrage mit zusammengeführten Ergebnissen
Diagrammparameter
stacking	Stapelt Reihen übereinander, um ein gestapeltes Diagramm zu erstellen
show_dropoff	Fügt Pfeile hinzu, die die prozentuale Änderung zwischen Datenpunkten anzeigen
ordering	Legt die Reihenfolge der Reihenwerte in einem gestapelten oder gestapelten Prozentdiagramm fest
column_spacing_ratio	Legt den Abstand zwischen Spalten innerhalb einer Gruppe fest
column_group_spacing_ratio	Legt den Abstand zwischen Spaltengruppen auf einen Wert zwischen 0 und 1 fest
hide_legend	Blendet die Diagrammlegende aus
legend_position	Gibt an, ob die Legende links, in der Mitte oder rechts im Diagramm angezeigt wird
hidden_fields	Gibt alle Felder an, die in der Abfrage verwendet, aber im Diagramm ausgeblendet werden sollen
limit_displayed_rows	Blendet Zeilen in einer Visualisierung basierend auf ihrer Position in den Ergebnissen ein oder aus
limit_displayed_rows_values	Gibt an, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden sollen. Dieser Parameter enthält die Unterparameter show_hide, first_last und num_rows.
Reihenparameter
colors	Legt die Farben der Diagrammreihen basierend auf der Reihenfolge fest, in der die Reihen angezeigt werden.
series_colors	Legt die Farben der Diagrammreihen basierend auf dem Namen der Reihe fest.
series_labels	Ändert die Art und Weise, wie ein Reihenname für Nutzer angezeigt wird
series_types	Kombiniert Visualisierungstypen, indem der Typ für jede Reihe definiert wird
show_view_names	Blendet Ansichtsnamen in Diagrammlabels aus
Wertparameter
show_value_labels	Zeigt Labels neben Datenpunkten an.
show_null_labels	Bestimmt, ob Null-Labels in einem Diagramm angezeigt werden sollen, wenn Labels angezeigt werden
label_color	Gibt eine durch Kommas getrennte Liste von Farbwerten an
font_size	Legt die Schriftgröße der Wertelabels fest.
label_rotation	Wenn stacking auf den Standardwert ('') festgelegt ist, wird die Drehung der Wertlabels auf einen Wert zwischen -360 und 360 festgelegt.
label_value_format	Gibt die Formatierung im Excel-Stil für Wertelabels an
show_totals_labels	Wenn stacking auf normal festgelegt ist, wird angegeben, ob für jede gestapelte Gruppe von Datenpunkten in einem Diagramm Summen angezeigt werden.
hidden_series	Blendet eine Diagrammreihe aus, wenn das Element geladen wird
show_silhouette	Wenn stacking auf normal festgelegt ist, wird eine leicht schattierte Darstellung einer deaktivierten Reihe angezeigt.
totals_color	Wenn stacking auf normal festgelegt ist, wird die Farbe der Labels für die Gesamtsummen angegeben.
Parameter für die X-Achse
x_axis_scale	Gibt an, wie die Skala der X-Achse berechnet wird
x_axis_reversed	Gibt die Richtung der X-Achse an
show_x_axis_label	Blendet das Label der X-Achse aus
x_axis_label	Definiert ein benutzerdefiniertes Label für die X-Achse
show_x_axis_ticks	Zeigt Teilstriche auf der X-Achse an
x_axis_gridlines	Verlängert die Gitterlinien von der X-Achse
x_axis_label_rotation	Dreht die Labels der X-Achse um eine bestimmte Anzahl von Grad
x_axis_datetime_label	Gibt einen Formatstring für die Labels der X-Achse an, wenn es sich um Datumsangaben handelt.
x_axis_zoom	Gibt an, ob das Zoomen entlang der X-Achse zulässig ist
Y-Achsenparameter
y_axis_gridlines	Erweitert die Gitternetzlinien von der Y-Achse.
y_axis_reversed	Hiermit wird die Richtung der X-Achse festgelegt.
reference_lines	Fügt einem Diagramm Referenzlinien hinzu.
y_axis_zoom	Gibt an, ob das Zoomen entlang der Y-Achse zulässig ist. Deaktiviert, wenn x_axis_zoom: false.
Erweiterte Konfigurationsparameter für Visualisierungen
advanced_viz_config	Akzeptiert ein HighCharts-JSON-Snippet, mit dem mehrere Visualisierungseinstellungen überschrieben werden können

Grundlegende Parameter

Wenn Sie ein LookML-Dashboard-Element 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 das Erscheinungsbild und die Position eines Elements in einem Dashboard aus.

name

In diesem Abschnitt geht es um den Parameter name, der Teil eines Dashboard-Elements ist.

name kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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 referenziert, wenn Sie layout: grid-Dashboards verwenden, oder im Parameter group von untergeordneten Elementen, wenn Sie Elemente in einer Kachelgruppe (type: group) organisieren.

- name: orders_by_date

title

In diesem Abschnitt geht es um den Parameter title, der Teil eines Dashboard-Elements ist.

title kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

title kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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

Betrachten Sie dieses Beispiel:

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

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

type

In diesem Abschnitt geht es um den Parameter type, der Teil eines Dashboard-Elements ist.

type kann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

type kann auch als Teil eines Joins verwendet werden, wie auf der Dokumentationsseite für den Parameter type (für Joins) beschrieben.

type kann auch als Teil einer Dimension verwendet werden, wie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen beschrieben.

type kann auch als Teil einer Measure verwendet werden, wie auf der Dokumentationsseite Measure-Typen beschrieben.

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 | button | group

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

height

In diesem Abschnitt geht es um den Parameter height, der Teil eines Dashboard-Elements ist.

height kann auch als Teil einer Dashboard-Zeile verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

Für Dashboards mit tile- oder static-Layouts

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

Im folgenden Code werden beispielsweise tile_size: 100 und height: 4 angegeben, sodass das orders_by_date-Element 400 Pixel hoch ist.

- dashboard: sales_overview
  tile_size: 100
  ...

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

Für Dashboards mit newspaper-Layout

Der Parameter height definiert die Höhe eines Elements in Einheiten von row für layout: newspaper-Dashboards.

Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen oder etwa 300 Pixel. Die Mindesthöhe beträgt 1 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.

Mit dem folgenden Code wird beispielsweise ein Element auf eine Höhe von 12 Zeilen festgelegt, also doppelt so hoch wie andere Elemente, für die die Standardeinstellung gilt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

width

In diesem Abschnitt geht es um den Parameter width, der Teil eines Dashboard-Elements ist.

width kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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, sodass das orders_by_date-Element 400 Pixel breit ist.

- 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 Zeitungsformat hat standardmäßig eine Breite von 24 Spalten.

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

top

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

Im folgenden Code werden beispielsweise tile_size: 100 und top: 4 angegeben, wodurch die Oberkante des orders_by_date-Elements 400 Pixel vom oberen Rand des Dashboards entfernt positioniert wird.

- 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 werden beispielsweise tile_size: 100 und left: 4 angegeben, wodurch der linke Rand des orders_by_date-Elements 400 Pixel von der linken Seite des Dashboards entfernt positioniert wird.

- dashboard: sales_overview
  tile_size: 100
  ...

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

row

Bei layout: newspaper-Dashboards definiert der Parameter row die Zeile, in der sich der obere Rand eines Elements befindet. Wenn das Element mithilfe des Parameters group in einer Kachelgruppe platziert wird, definiert row die Zeilenposition des Elements relativ zum oberen Rand des Gruppencontainers (row: 0).

Ein Dashboard beginnt mit Zeile 0 oben im Dashboard. Bei einem Dashboard mit Zeitungslayout beträgt die Standardhöhe eines Elements 6 Zeilen. Das bedeutet, dass die Dashboard-Elemente oben im Dashboard (row: 0) 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 festgelegt, vorausgesetzt, die Elemente sind auf die Standardhöhe eingestellt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Bei layout: newspaper-Dashboards definiert der Parameter col die Spalte, in der sich der linke Rand des Elements befindet. Wenn das Element mit dem Parameter group in einer Kachelgruppe platziert wird, definiert col die Spaltenposition des Elements relativ zum linken Rand des Gruppencontainers (col: 0).

Dashboards sind in 24 Spalten unterteilt. Ein Dashboard beginnt mit Spalte 0 auf der linken Seite des Dashboards. Ein Dashboard mit Zeitungs-Layout hat standardmäßig eine Elementbreite von 8 Spalten. Das bedeutet, dass die Dashboard-Elemente links im Dashboard (col: 0) standardmäßig die Spalten 0–7 einnehmen.

Mit dem folgenden Code wird beispielsweise ein Element in der dritten Spalte der Elemente im Dashboard festgelegt:

- dashboard: sales_overview
  layout: newspaper
  ...

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

refresh

In diesem Abschnitt geht es um den Parameter refresh, der Teil eines Dashboard-Elements ist.

refresh kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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

- name: orders_by_date
  refresh: 2 hours

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

note

Sie können Elementen wie folgt beschreibende Notizen hinzufügen:

- name: element_name
  note:
    text: 'note text'
    state: collapsed | expanded
    display: above | below | hover

note hat die Unterparameter text, state und display.

text

Der Unterparameter text gibt den Text an, der in der Notiz angezeigt wird. Der Text kann lokalisiert werden.

state

Der Unterparameter state bestimmt, ob die Notiz collapsed oder expanded wird, wenn sie zu groß ist, um in eine einzelne Zeile innerhalb der Breite des Elements zu passen. Wenn Sie collapsed auswählen und die Notiz zu lang ist, endet sie mit anklickbaren Auslassungspunkten (...), über die die vollständige Notiz gelesen werden kann.

display

Mit dem Unterparameter display wird festgelegt, wo die Notiz auf einem Element angezeigt wird. Mit above wird die Notiz oben in einem Element platziert, mit below unten in einem Element und mit hover muss der Nutzer den Mauszeiger auf das Element bewegen, um die Notiz zu sehen.

Suchparameter

Wenn Sie ein LookML-Dashboard-Element definieren, müssen Sie mindestens Werte für die Abfrageparameter model und explore angeben. Außerdem muss mindestens ein Feld mit dem Parameter dimensions oder measures angegeben werden. Sie können auch die anderen Abfrageparameter verwenden, um die Darstellung der Daten in einem Dashboard-Element zu steuern.

model

Der Parameter model definiert das Modell, das für die Elementabfrage verwendet werden soll. Wenn nicht angegeben, 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 in der Manifestdatei für Ihr Projekt eine Konstante definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für model festzulegen. Mit einer Konstante können Sie den Namen eines Modells an einer Stelle 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 geht es um den Parameter explore, 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 Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

Mit dem Parameter explore wird der Explore definiert, der für die Elementabfrage verwendet werden soll.

- name: orders_by_date
  explore: order

Der Parameter explore akzeptiert LookML-Konstanten. Sie können in der Manifestdatei für Ihr Projekt eine Konstante definieren und dann die Syntax "@{constant_name}" verwenden, um die Konstante als Wert für explore festzulegen. Mit einer Konstante können Sie den Namen eines Explores an einer Stelle definieren. Das ist besonders nützlich, wenn Sie den Namen eines Explores aktualisieren, der 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.

dimensions

Der Parameter dimensions definiert die Dimension oder Dimensionen, 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 hinzu, wenn die Abfrage 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

Mit dem Parameter measures wird der Messwert oder werden die Messwerte definiert, 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 hinzu, wenn die Abfrage 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 das Sortierverhalten für die Abfrage des Elements. Geben Sie zuerst das primäre Sortierfeld und dann alle sekundären Sortierfelder an. Verwenden Sie die Syntax view_name.field_name, um die Dimension oder den Messwert anzugeben, nach der bzw. dem sortiert werden soll.

Wenn Sie den Parameter sorts weglassen, verwendet das Element die Standardsortierreihenfolge von Looker. Für aufsteigende Sortierungen ist kein Suffix erforderlich, für absteigende Sortierungen ist das Suffix desc erforderlich.

Im folgenden Beispiel wird eine einzelne Sortierung definiert:

- name: orders_by_date
  sorts: order.order_date desc

Im folgenden Beispiel werden mehrere Sortierungen definiert:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Wenn Sie Dimensionen pivotieren, können Sie die Abfrageergebnisse sortieren, indem Sie den Namen des Messwerts, die Sortierrichtung und die nullbasierte Indexnummer der Zielspalte in der Datentabelle angeben. Im folgenden Beispiel wird nach der ersten Pivot-Spalte mit dem Index 0 sortiert:

- name: orders_by_category
  sorts: [orders.count desc 0]

Wenn Sie nach der Zeilensumme sortieren möchten, geben Sie den Index der Summenspalte an. Mit dem folgenden Element wird beispielsweise nach der Zeilensumme sortiert. Dazu wird der Index 2 verwendet, der die Summenspalte für eine Abfrage mit zwei Pivot-Spalten darstellt:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

Mit dem Parameter pivots werden die Dimensionen definiert, die für die Elementabfrage pivotiert werden sollen. Verwenden Sie die Syntax view_name.dimension_name, um die Dimension anzugeben. Fügen Sie pivots nicht hinzu, wenn die Abfrage keine hat.

## single pivot example
- name: orders_by_date
  pivots: customer.gender

## multiple pivot example
- name: orders_by_date
  pivots: [customer.gender, customer.age_tier]

limit

Der Parameter limit definiert die Zeilenbegrenzung, die 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 geht es um den Parameter filters, der Teil eines Dashboard-Elements ist.

filters kann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.

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

Mit dem Parameter filters werden die nicht änderbaren 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

Jeder Filter kann einen Looker-Filterausdruck oder eine Wertkonstante akzeptieren. Sie können auch die Liquid-Variablen _localization oder _user_attributes im Filterausdruck für flexible Filterwerte verwenden.

listen

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

Die Syntax für listen lautet:

- 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 an, gefolgt von einem Doppelpunkt und einem Verweis auf das Feld, 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. Anschließend können Sie den vom Nutzer eingegebenen Wert 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
    ...

Wenn der Filter, auf den gelauscht wird, mit dem Parameter vis_filter: true konfiguriert ist, wird das Filter-Steuerelement in einer Filterleiste direkt oben auf der Visualisierungskachel und nicht in der oberen Dashboard-Filterleiste angezeigt.

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

query_timezone

Der Parameter query_timezone gibt die Zeitzone an, 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 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 Parameter merged_queries des Elements und verwenden Sie den Unterparameter join_fields, um anzugeben, wie die Ergebnisse zusammengeführt werden sollen.

Im folgenden LookML-Beispielcode wird ein Element mit zusammengeführten Ergebnissen vom Typ type: looker_grid erstellt. In diesem Beispiel wird der Parameter merged_queries verwendet, um ein Dashboard-Element zu erstellen, das Daten aus zwei separaten Abfragen in einem einzigen Tabellendiagramm kombiniert:

- 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 kombiniert das Dashboard-Element Daten aus zwei Quellabfragen, die auf dem Explore users im Modell ecommerce basieren. Die Primärabfrage 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 basierend auf übereinstimmenden Werten in den Feldern users.state und users.city zusammengeführt.

Der Parameter listen wendet einen State-Filter auf beide Abfragen an. So können Dashboard-Betrachter die in der Dashboard-Tile angezeigten Abfrageergebnisse verfeinern, indem sie einen bestimmten Bundesstaat auswählen.

Beispiel: Unternehmensdaten zusammenführen

Angenommen, Sie möchten eine zusammengeführte Abfrage erstellen, die Informationen zu Unternehmen aus zwei verschiedenen Explores kombiniert: company_info und companies. Sie möchten die Abfragen zu den Feldern ipo.stock_symbol, companies.name und companies.contact_email aus jedem Explore zusammenführen, um eine Abfrage zu erstellen, die Ergebnisse für den Unternehmensnamen, die E-Mail-Adresse des Unternehmenskontakts, das Jahr des Börsengangs, das Aktiensymbol, die Anzahl der Mitarbeiter und die 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

Das vorherige Beispiel für ein zusammengeführtes Abfrageelement zeigt, wie Sie mit dem Parameter filters hartcodierte Filter direkt in jeder Quellabfrage anwenden. Beispiel: Die Filter companies.contact_email: "-NULL" und ipo.valuation_amount: NOT NULL in der Primärabfrage beschränken die Ergebnisse auf Unternehmen mit gültigen Kontakt-E‑Mail-Adressen und Bewertungen. 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 der einzelnen Quellabfragen. Angenommen, Sie haben einen Dashboard-Filter mit dem Namen Industry, den Sie auf Dashboard-Ebene 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 den Definitionen der Quellabfragen der zusammengeführten Abfrage so hinzu:

listen:
  Industry: companies.industry

Im folgenden Beispielcode wird der Filter Industry beiden Quellabfragen im Element für zusammengeführte Ergebnisse 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 Dashboard-Filter 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 definieren, unabhängig von der Anzahl der Quellabfragen in Ihrem Element mit zusammengeführten Ergebnissen. Wenn eine Abfrage keinen listen-Parameter hat, wird sie von keinen Dashboard-Filtern beeinflusst.

Diagrammparameter

Die meisten der in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Abschnitt „Diagramm“ des Visualisierungseditors für Säulendiagramme.

stacking

Mit dem Parameter stacking wird festgelegt, wie Reihen in einem Diagramm visuell gruppiert werden.

• normal: Balken, Linien und Punkte werden wie in einem normalen gestapelten Säulendiagramm übereinander gestapelt.

• percent: Balken, Linien und Punkte werden gestapelt, um das Diagramm zu 100 % zu füllen. Die Werte auf der y-Achse werden als Prozentsätze festgelegt.

• '': Balken, Linien und Punkte werden nicht gestapelt, sondern gruppiert.

stacking: normal | percent | ''

## default value: ''

show_dropoff

Mit dem Parameter show_dropoff wird die Darstellung der Pfeile für die prozentuale Änderung im Diagramm ein- oder ausgeschaltet. Für jede Reihe wird mit diesen Pfeilen der Prozentsatz des vorherigen Werts von links nach rechts angezeigt.

show_dropoff: true | false

## default value: false

ordering

Mit dem Parameter ordering können Sie die einzelnen Segmente eines gestapelten oder gestapelten Prozentdiagramms nach der Größe der einzelnen Segmente sortieren.

• none (oder kein Wert angegeben): Die Reihenwerte werden entsprechend ihrer Position in der Datentabelle sortiert.
• asc: Die kleinsten Werte der Reihe werden unten positioniert, wobei die Werte nach oben hin zunehmen.
• desc: Die größten Werte werden unten positioniert, wobei die Werte nach oben hin kleiner werden.

column_spacing_ratio

Mit dem Parameter column_spacing_ratio wird der Abstand zwischen Spalten innerhalb einer Gruppe festgelegt. Diese Option ist für Diagramme verfügbar, bei denen stacking auf die Standardeinstellung „Gruppiert“ festgelegt ist, die in LookML mit '' angegeben wird. Dieser Parameter akzeptiert Werte zwischen 0 und 1. 0 ist mit dem Mindestabstand zwischen Spalten innerhalb einer Gruppe verknüpft und 1 mit dem maximalen Abstand zwischen Spalten innerhalb einer Gruppe.

column_space_ratio: number between 0 and 1

column_group_spacing_ratio

Mit dem Parameter column_group_spacing_ratio wird der Abstand zwischen Spaltengruppen festgelegt. Dieser Parameter akzeptiert Werte zwischen 0 und 1. 0 ist mit dem Mindestabstand zwischen Spaltengruppen verknüpft und 1 mit dem maximalen Abstand zwischen Spaltengruppen.

column_group_spacing_ratio: number between 0 and 1

hide_legend

Durch diese Deklaration wird die Legende in der Visualisierung ausgeblendet.

hide_legend: true | false

## default value: false

legend_position

Wenn hide_legend auf false festgelegt ist und mehr als eine Reihe vorhanden ist, können Sie mit dem Parameter legend_position angeben, ob die Legende links, in der Mitte oder rechts im Diagramm angezeigt werden soll.

legend_position: center | left | right

## default value: false

hidden_fields

Der Parameter hidden_fields gibt an, welche Felder in der Abfrage verwendet, aber im Diagramm ausgeblendet werden. Alle ausgeblendeten Felder werden im Datentabellenbereich eines Explores angezeigt.

hidden_fields: [inventory_items.count, distribution_centers.id]

limit_displayed_rows

Mit dem Parameter limit_displayed_rows können Sie Zeilen in einer Visualisierung basierend auf ihrer Position in den Ergebnissen ein- oder ausblenden. Wenn in Ihrer Visualisierung beispielsweise ein gleitender Durchschnitt über 7 Tage angezeigt wird, können Sie die ersten 6 Zeilen ausblenden. Wenn Sie hier true festlegen, können Sie die Werte und Positionen in der Visualisierung, für die dies gilt, mit dem Parameter limit_displays_rows_values und seinen Unterparametern angeben.

limit_displayed_rows: true
limit_displayed_rows_values:
  show_hide: hide | show
  first_last: first | last
  num_rows: '10'

limit_displayed_rows_values

Verwenden Sie den Parameter limit_displayed_rows_values und die zugehörigen Unterparameter show_hide, first_last und num_rows mit limit_displayed_rows, um anzugeben, welche Zeilen in einer Visualisierung ein- oder ausgeblendet werden sollen. Ein Anwendungsbeispiel finden Sie im Abschnitt limit_displayed_rows.

show_hide

Mit dem Unterparameter show_hide wird festgelegt, ob bestimmte Zeilen in der Visualisierung ausgeblendet werden sollen. Legen Sie für show_hide den Wert show fest, um nur eine begrenzte Anzahl von Zeilen in der Visualisierung anzuzeigen, und für show_hide den Wert hide, um bestimmte Zeilen aus der Visualisierung auszuschließen.

first_last

Mit dem Unterparameter first_last wird festgelegt, ob die auszublendenden oder anzuzeigenden Zeilen die ersten oder letzten Zeilen im Ergebnissatz sind. Wenn Sie first_last auf first festlegen, werden die ersten Zeilen ein- oder ausgeblendet. Wenn Sie first_last auf last festlegen, werden die letzten Zeilen ein- oder ausgeblendet.

num_rows

Mit dem Unterparameter num_rows wird die Anzahl der Zeilen festgelegt, die ausgeblendet oder angezeigt werden sollen. Wenn Sie beispielsweise num_rows: '10' eingeben, werden entweder die ersten oder die letzten 10 Zeilen des Ergebnisses in der Visualisierung ein- oder ausgeblendet.

Reihenparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Abschnitt Reihe des Visualisierungseditors für Säulendiagramme.

colors

Der Parameter colors gibt eine Liste von Farben für die Reihe an. Die erste Farbe in der Liste entspricht der ersten Datenreihe. Wenn es mehr Datenreihen als aufgeführte Farben gibt, werden die Farben von vorn wiederholt.

colors: [blue, orange, yellow, red, purple]

Für alle Diagrammattribute, die eine Farbe angeben, kann der Farbwert ein Hex-String wie #2ca6cd oder ein CSS-Farbnamensstring wie mediumblue sein.

series_colors

Legen Sie die Farben der Reihen anhand des Reihennamens mit name: value-Paaren fest.

Bei einem Pivot-Diagramm sind die Reihennamen die Pivot-Namen.

series_colors:
  'Yes': skyblue
  'No': '#000000'

Bei einem Diagramm mit mehreren Messwerten sind die Reihennamen die Namen der Messwertfelder.

series_colors:
  inventory_items.count: crimson
  orders.count: green

Wenn der Name der Reihe nicht in series_colors aufgeführt ist, wird im Diagramm standardmäßig die Liste der Farben verwendet, die in colors angegeben ist. Wenn colors nicht festgelegt ist, wird das Standardfarbschema für das Diagramm verwendet.

series_labels

Legen Sie die Labels einer oder mehrerer Reihen basierend auf dem Reihennamen mithilfe von name: label-Paaren fest.

Bei einem Pivot-Diagramm sind die Reihennamen die Pivot-Namen.

series_labels:
  'Yes': iOS Users
  'No': Android Users

Bei einem Diagramm mit mehreren Messwerten sind die Reihennamen die Namen der Messwertfelder.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

series_types

Mit dem Parameter series_type können Sie verschiedene kartesische Diagrammtypen in derselben Visualisierung verwenden. Mit diesem Parameter können Sie jeder Reihe, die Sie ändern möchten, einen Diagrammtyp zuweisen. Die Typoptionen sind line, column, bar, area und scatter.

series_types:
  series_a_name: column
  series_b_name: line

Alle Reihen werden standardmäßig mit dem von Ihnen ausgewählten Diagrammtyp dargestellt. Sie können dann einzelne Reihen ändern.

show_view_names

Der Parameter show_view_names bestimmt, ob Ansichtsnamen in Diagrammlabels wie Achsen- und Spaltennamen angezeigt werden.

show_view_names: true | false

## default value: true

Wertparameter

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Abschnitt „Werte“ des Visualisierungseditors für Säulendiagramme.

show_value_labels

Der Wert eines Balkens, einer Linie oder eines Punkts wird neben dem Datenpunkt angezeigt.

show_value_labels: true | false

## default value: false

show_null_labels

Bestimmt, ob Labels für Nullspalten oder -balken angezeigt werden sollen, wenn show_value_labels auf true festgelegt ist.

show_null_labels: true | false

## default value: false

labelColor

Wenn labelColorEnabled auf true festgelegt ist, können Sie mit dem Parameter labelColor eine benutzerdefinierte Farbe für das Label und die Prozentsätze angeben. Labels, bei denen labelPosition auf inline festgelegt ist, werden in der ausgewählten Farbe angezeigt. Labels auf beiden Seiten des Diagramms werden etwa 40 % dunkler als die ausgewählte Farbe angezeigt.

labelColor: "#4FBC89"

font_size

Legen Sie die Schriftgröße der Wertelabels mit einer beliebigen gültigen CSS-Größe fest, z. B. 10px oder 12px.

font_size: 14px

label_rotation

Legt die Drehung der Wertelabels fest. Dieser Parameter akzeptiert Werte zwischen -360 und 360, die die Anzahl der Grad angeben, um die die Labels gedreht werden sollen. Dieser Parameter ist nur verfügbar, wenn stacking auf den Standardwert ('') festgelegt ist.

label_rotation: -45

label_value_format

Mit dem Parameter label_value_format wird die Formatierung angegeben, die auf einen Wert angewendet werden soll, unabhängig von der Formatierung, die auf die zugrunde liegende Dimension oder den zugrunde liegenden Messwert angewendet wird. Das Feld akzeptiert Formatierungen im Excel-Stil. Wenn label_value_format nicht angegeben ist, wird der Wert im Format der zugrunde liegenden Dimension oder des zugrunde liegenden Measures angezeigt.

Informationen zum Festlegen dieser Formate finden Sie auf der Dokumentationsseite Benutzerdefinierte Formatierung auf numerische Felder anwenden. Die Farbformatierung wird in Looker jedoch nicht unterstützt.

Die Formatierung im LookML-Dashboard-Parameter label_value_format entspricht der Formatierung im LookML-Parameter value_format. Beim LookML-Parameter value_format muss der Formatierungsstring jedoch in doppelte Anführungszeichen gesetzt werden.

label_value_format: '0.00'

show_totals_labels

Legen Sie fest, ob für jede gestapelte Gruppe von Datenpunkten in einem Diagramm Summen angezeigt werden sollen. Dieser Parameter ist nur verfügbar, wenn stacking auf normal gesetzt ist.

show_totals_labels: true | false

hidden_series

Mit dem Parameter hidden_series wird festgelegt, welche Reihen im Diagramm deaktiviert werden. Diese Reihen werden in der Diagrammlegende ausgegraut angezeigt. Nutzer können deaktivierte Reihen aktivieren, indem sie in der Diagrammlegende darauf klicken. Daher funktioniert hidden_series möglicherweise nicht wie gewünscht mit hide_legend: true.

Bei einem Pivot-Diagramm sind die Seriennamen die Pivot-Namen:

hidden_series: ['Yes', 'No']

Bei einem Diagramm mit mehreren Messwerten sind die Reihennamen die Namen der Messwertfelder:

hidden_series: [inventory_items.count, orders.count]

In Kombination mit dem Parameter show_silhouette können Sie angeben, ob deaktivierte Reihen im Diagramm selbst als leicht schattierte Darstellung angezeigt werden.

show_silhouette

Wenn der Parameter show_silhouette auf true und stacking auf normal gesetzt ist, wird eine deaktivierte Reihe als leicht schattierte Silhouette angezeigt.

show_silhouette: true | false

totals_color

Mit diesem Parameter wird die Farbe der Labels für die Gesamtsummen in einem Diagramm definiert. Der Parameter totals_color ist nur verfügbar, wenn stacking auf normal festgelegt ist.

totals_color: "#2ca6cd"

Parameter für die X-Achse

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

x_axis_scale

Dieser Parameter bestimmt, wie die Skala der X-Achse berechnet wird.

• auto: Die Skala 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 konvertiert werden können.

x_axis_scale: auto | ordinal | time

## default value: auto

x_axis_reversed

Mit diesem Parameter wird die Richtung der X-Achse festgelegt. Wenn x_axis_reversed auf false festgelegt ist, steigen die Werte von links nach rechts. Wenn der Wert auf true gesetzt ist, nehmen die Werte von links nach rechts ab.

x_axis_reversed: true | false

show_x_axis_label

Mit diesem Parameter wird festgelegt, ob Labels auf der X-Achse angezeigt werden.

show_x_axis_label: true | false

## default value: true

x_axis_label

Dieser Parameter gibt ein Label für die x-Achse an. Sie können diesen Parameter verwenden, wenn show_x_axis_label auf true festgelegt ist.

x_axis_label: Order Date

show_x_axis_ticks

Mit diesem Parameter wird festgelegt, ob Wertlabels auf der X-Achse angezeigt werden.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Dieser Parameter bestimmt, ob Gitternetzlinien von der x-Achse aus verlängert werden.

x_axis_gridlines: true | false

## default value: false

x_axis_label_rotation

Der Parameter x_axis_label_rotation definiert die Drehung der Labels auf der x-Achse in Grad. Dieser Parameter akzeptiert Werte zwischen -360 und 360, die die Anzahl der Grad angeben, um die die Labels gedreht werden sollen.

x_axis_label_rotation: -45

x_axis_datetime_label

Dieser Parameter gibt einen Formatstring für die Labels der x-Achse an, wenn es sich um Datumsangaben handelt. Wenn x_axis_scale nicht auf time festgelegt ist, hat dies keine Auswirkungen.

x_axis_datetime_label: '%b %d'

Informationen zur Formatierung von Zeiten finden Sie auf der Dokumentationsseite Zeitformatierung für Diagramme.

x_axis_zoom

Mit diesem Parameter wird angegeben, ob Nutzer die X-Achse der Visualisierung heranzoomen können. Wenn x_axis_zoom auf true festgelegt ist, ist 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, ist y_axis_zoom deaktiviert.

x_axis_zoom: true | false

# default value: true

Y-Achsenparameter

In Bearbeitung: Wir arbeiten daran, diesen Abschnitt der Seite zu aktualisieren. In der Zwischenzeit können Sie sich auf der Dokumentationsseite Optionen für Säulendiagramme die entsprechenden Visualisierungsmenüoptionen für die Y-Achse ansehen.

Die in diesem Abschnitt beschriebenen Parameter entsprechen den Optionen im Y-Abschnitt des Visualisierungseditors für Säulendiagramme.

y_axis_gridlines

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

y_axis_gridlines: true | false

## default value: true

y_axis_reversed

Mit diesem Parameter wird die Richtung der Y-Achse festgelegt. Wenn y_axis_reversed auf false festgelegt ist, steigen die Werte auf der Achse nach oben. Wenn der Wert auf true gesetzt ist, nehmen die Werte auf der Achse nach unten hin ab.

## y_axis_reversed: true | false

# default value: false

reference_lines

Mit diesem Parameter wird ein Array von Werten zum Angeben von Referenzlinien und -bereichen festgelegt.

Informationen zum Einrichten von Referenzlinien finden Sie auf der Dokumentationsseite Dashboard-Referenzlinienparameter.

reference_lines:
   # reference line options

y_axis_zoom

Mit diesem Parameter wird angegeben, ob Nutzer die Y-Achse der Visualisierung heranzoomen können. Wenn y_axis_zoom auf true festgelegt ist, ist Zoomen möglich.

Wenn y_axis_zoom auf false festgelegt ist, können Nutzer nicht in kleinere Bereiche der Y-Achse hineinzoomen. Nutzer können jedoch möglicherweise weiterhin in kleinere Teile der X-Achse hineinzoomen, wenn der Parameter x_axis_zoom auf true festgelegt ist.

Wenn x_axis_zoom auf false gesetzt ist, ist y_axis_zoom deaktiviert.

y_axis_zoom: true | false

# default value: true

Erweiterte Konfigurationsparameter für Visualisierungen

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

advanced_vis_config

Dieser Parameter akzeptiert ein HighCharts-JSON-Snippet, das mehrere Visualisierungseinstellungen überschreibt und neue Funktionen ermöglicht. Beispiele für die Verwendung von HighCharts-JSON für gängige Anwendungsfälle finden Sie auf der Dokumentationsseite Visualisierungen mit dem Diagrammkonfigurationseditor anpassen.

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