Auf dieser Seite werden die Parameter beschrieben, die für LookML-Dashboard-Elemente vom Typ type: single_value in einer dashboard.lkml-Datei verwendet werden.
Informationen zum Erstellen eines Einzelwertdiagramms über die Looker-Benutzeroberfläche finden Sie auf der Dokumentationsseite Optionen für KPI-Diagramme (Einzelwert) oder auf der Dokumentationsseite Optionen für Einzelwertdiagramme (Legacy).
Grundlegende Parameter
Wenn Sie ein LookML-Dashboard-Element definieren, müssen Sie mindestens Werte für die Parameter name und type angeben. Andere grundlegende Parameter wie title, height und width wirken sich auf die Position und das Erscheinungsbild eines Elements in einem Dashboard aus.
name
In diesem Abschnitt geht es um den Parameter
name, der Teil eines Dashboard-Elements ist.
namekann 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.
titlekann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.
titlekann 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.
typekann auch als Teil eines Dashboard-Filters verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.
typekann auch als Teil eines Joins verwendet werden, wie auf der Dokumentationsseite für den Parametertype(für Joins) beschrieben.
typekann auch als Teil einer Dimension verwendet werden, wie auf der Dokumentationsseite Dimensionen, Filter und Parametertypen beschrieben.
typekann 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.
heightkann 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.
widthkann 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.
refreshkann 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.
explorekann auch als Teil eines Modells verwendet werden, wie auf der Dokumentationsseite zum Parameterexplorebeschrieben.
explorekann 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.
filterskann auch als Teil eines Dashboards verwendet werden, wie auf der Dokumentationsseite Dashboard-Parameter beschrieben.
filterskann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zum Parameterfiltersbeschrieben.
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.
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]
Stilparameter
In diesem Abschnitt werden die Parameter beschrieben, die den Optionen im Abschnitt Stil des Visualisierungseditors für KPI-Diagramme (Einzelwert) und Einzelwertdiagramme (alt) entsprechen.
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.
custom_color_enabled
Wenn Sie den Parameter custom_color_enabled auf true festlegen, können Sie eine benutzerdefinierte Farbe für eine Einzelwert-Visualisierung angeben. Verwenden Sie diesen Parameter mit dem Parameter custom_color.
custom_color_enabled: true | false
custom_color
Geben Sie eine benutzerdefinierte Farbe für den Text in einer Einzelwert-Visualisierung an.
custom_color: #2ca6cd | mediumblue
show_single_value_title
Wenn dieser Parameter auf true gesetzt ist, wird unter dem Wert der Abfrage ein Titel angezeigt. Sie können den Titel mit dem Parameter single_value_title angeben oder ändern.
show_single_value_title: true | false
single_value_title
Geben Sie einen Titel an, der mit dem Wert der Abfrage angezeigt werden soll. Der Titeltext kann lokalisiert werden.
single_value_title: Title
valueFormat
Geben Sie das Zahlen- oder Datumsformat für den Wert an. Der Parameter akzeptiert Formatierungen im Excel-Stil. Wenn keine Formatierung angegeben ist, wird der Wert im Format der zugrunde liegenden Dimension oder des zugrunde liegenden Measures angezeigt.
Vergleichsparameter
In diesem Abschnitt werden die Parameter beschrieben, die den Optionen im Abschnitt „Vergleich“ des Visualisierungseditors für KPI-Diagramme (Einzelwert) und Einzelwertdiagramme (Legacy) entsprechen.
show_comparison
Wenn der Parameter show_comparison auf true festgelegt ist, können Sie einem Dashboard-Element vom Typ type: single_value Vergleichsinformationen hinzufügen.
show_comparison: true | false
comparison_type
Mit dem Parameter comparison_type geben Sie an, wie das Vergleichsfeld in einem Dashboard-Element vom Typ type: single_value verwendet wird.
Sie können einen der folgenden Werte für den Parameter comparison_type angeben:
value: Der Wert des Vergleichsfelds wird unten in der Visualisierung angezeigt.change: Der Wert des Vergleichsfelds wird unten in der Visualisierung angezeigt. Wenn der Wert negativ ist, zeigt das Dreieck nach unten. Wenn der Wert positiv ist, zeigt das Dreieck nach oben.progress: Der Wert des Felds, das für die Visualisierung mit einem einzelnen Wert verwendet wird, wird durch den Wert des Vergleichsfelds geteilt. Dieser Prozentsatz wird als Fortschrittsanzeige dargestellt.progress_percentage: Der Wert des Felds, das für die Visualisierung mit einem einzelnen Wert verwendet wird, wird durch den Wert des Vergleichsfelds geteilt. Dieser Prozentsatz wird als Fortschrittsanzeige dargestellt. Der Balken ist mit dem Prozentsatz und dem Wert des Vergleichsfelds beschriftet.
comparison_type: value | change | progress | progress_percentage
show_comparison_label
Geben Sie an, ob ein Label mit dem Vergleichsfeld angezeigt werden soll. Standardmäßig ist das Label der Name des Vergleichsfelds.
show_comparison_label: true | false
comparison_label
Geben Sie das Label an, das mit dem Vergleichsfeld angezeigt werden soll. Der Text des Vergleichslabels kann lokalisiert werden.
show_comparison_label: true
comparison_label: Label
comparison_reverse_colors
Wenn comparison_type auf change festgelegt ist, können Sie comparison_reverse_colors auf true festlegen, damit negative Zahlen in einem Vergleichsfeld als grüner Text mit einem grünen Dreieck angezeigt werden, während positive Zahlen als roter Text mit einem roten Dreieck angezeigt werden.
comparison_type: change
comparison_reverse_colors: true | false