Dashboards können auf zwei Arten erstellt werden. Benutzerdefinierte Dashboards werden über die Looker-Benutzeroberfläche erstellt und auf der Dokumentationsseite Benutzerdefinierte Dashboards erstellen beschrieben. Dashboards können auch mit LookML erstellt und deren Gesamteinstellungen wie auf dieser Seite beschrieben geändert werden.
Ein Dashboard hat mehrere Einstellungen, die sich auf das gesamte Dashboard auswirken. Diese werden hier beschrieben. Es enthält auch eine Gruppe von Datenvisualisierungen, die als Elemente bezeichnet werden. Die LookML für diese Elemente wird auf den Dokumentationsseiten für jeden einzelnen Elementtyp beschrieben.
Nutzungsbeispiel
- dashboard: dashboard_name
preferred_viewer: dashboards | dashboards-next
title: "desired dashboard title"
description: "desired dashboard description"
extends: name_of_dashboard_being_extended
extension: required
layout: tile | static | grid | newspaper
rows:
- elements: [element_name, element_name, ...]
height: N
tile_size: N
width: N
refresh: N (seconds | minutes | hours | days)
auto_run: true | false
# DASHBOARD FILTER PARAMETERS
crossfilter_enabled: true | false
filters_bar_collapsed: true | false
filters_location_top: true | false
filters:
- name: filter_name
title: "desired filter title"
type: field_filter | number_filter | date_filter | string_filter
model: model_name
explore: explore_name
field: view_name.field_name
default_value: Looker filter expression
allow_multiple_values: true | false
required: true | false
ui_config:
type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
relative_timeframes | advanced
display: inline | popover | overflow
options:
min: N
max: N
- value options
listens_to_filters:
- filter_name
field: view_name.field_name
# EMBEDDED DASHBOARD PARAMETERS
embed_style:
background_color: "css_color"
show_title: true | false
title_color: "css_color"
show_filters_bar: true | false
tile_background_color: "css_color"
tile_text_color: "css_color"
# ELEMENTS PARAMETERS
elements:
# One or more element declarations
Parameterdefinitionen
Parameter mit dem Label NICHT UNTERSTÜTZT VON LEGACY werden nur angewendet, wenn ein Dashboard mit der Standard-Dashboard-Oberfläche gerendert wird, entweder durch Verwendung von preferred_viewer: dashboards-next
oder durch Konvertieren eines alten LookML-Dashboards in ein benutzerdefiniertes Dashboard und anschließendes Upgrade des benutzerdefinierten Dashboards.
Parametername | Beschreibung |
---|---|
dashboard |
Dashboard erstellen |
preferred_viewer |
Wählen Sie aus, ob ein Dashboard als Dashboard oder als altes Dashboard gerendert werden soll. |
title (für Dashboard) |
Ändern, wie ein Dashboard-Name für Nutzer angezeigt wird |
description (für Dashboard) |
Fügen Sie eine Platzhalterbeschreibung hinzu, die verwendet werden soll, wenn das Dashboard in ein benutzerdefiniertes Dashboard konvertiert wird. |
extends |
Basis des LookML-Dashboards auf einem anderen LookML-Dashboard |
extension |
Das Dashboard muss durch ein anderes Dashboard erweitert werden. |
layout |
Definieren Sie, wie das Dashboard Elemente platziert. |
rows |
Starten Sie einen Abschnitt von LookML, um die Elemente zu definieren, die in jede Zeile eines layout: grid -Dashboards aufgenommen werden sollen. |
elements (für Zeilen) |
Definieren Sie die Elemente, die in eine Zeile eines layout: grid -Dashboards aufgenommen werden sollen. |
height (für Zeilen) |
Definieren Sie die Höhe einer Zeile für ein layout: grid -Dashboard. |
tile_size |
Definieren Sie die Größe einer Kachel für ein layout: tile -Dashboard. |
width (für Dashboard) |
Definieren Sie die Breite des Dashboards für ein layout: static -Dashboard. |
refresh (für Dashboard) |
Legen Sie das Intervall fest, in dem Dashboard-Elemente automatisch aktualisiert werden sollen. |
auto_run |
Sie können festlegen, ob Dashboards beim ersten Öffnen oder erneuten Laden automatisch ausgeführt werden. |
Filterparameter | |
crossfilter_enabled |
NACH UNTERSTÜTZUNG DURCH LEGACY Aktivieren oder deaktivieren Sie die Kreuzfilterung für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet. |
filters_bar_collapsed |
HINZUGEFÜGT 21.16
NACH LEGACY UNTERSTÜTZT Legen Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next verwendet, minimiert oder maximiert fest. |
filters_location_top |
HINZUGEFÜGT WIRD 22.8
VIELE UNTERSTÜTZT Stelle die Dashboard-Filterleiste für ein Dashboard, das ebenfalls preferred_viewer: dashboards-next verwendet, als oben oder rechts ein. |
filters (für Dashboard) |
Starten Sie einen Abschnitt von LookML, um Dashboard-Filter zu definieren. |
name (für Filter) |
Filter erstellen. |
title (für Filter) |
Ändern, wie ein Filtername für Nutzer angezeigt wird |
type (für Filter) |
Bestimmen Sie, welcher Filtertyp verwendet werden soll. |
default_value |
Legen Sie gegebenenfalls einen Standardwert für einen Filter fest. |
allow_multiple_values |
Beschränken Sie Nutzer auf einen einzelnen Filterwert. |
required |
Legen Sie fest, dass Nutzer einen Filterwert eingeben müssen, um das Dashboard auszuführen. |
ui_config |
NACH UNTERSTÜTZUNG Konfigurieren Sie die Filtersteuerungen, die verfügbar sind, wenn Nutzer ein LookML-Dashboard aufrufen, das im neuen Dashboard gerendert wird, wobei preferred_viewer auf dashboards-next (kein altes Dashboard mit preferred_viewer auf dashboards ) gesetzt ist und die Unterparameter type , display und options hat. |
model (für Filter) |
Geben Sie das Modell an, das das zugrunde liegende Feld eines type: field_filter -Filters enthält. |
explore (für Filter) |
Geben Sie die Option „Erkunden“ an, die das zugrunde liegende Feld eines type: field_filter -Filters enthält. |
field |
Geben Sie das zugrunde liegende Feld eines type: field_filter -Filters an. |
listens_to_filters |
Vorschläge für Dashboard-Filter von field_filter anhand der Eingaben des Nutzers für weitere Dashboard-Filter von type: field_filter eingrenzen
|
Eingebettete Dashboard-Parameter | |
embed_style |
Beginnen Sie einen Abschnitt von LookML, um Anpassungen für eingebettete Dashboards festzulegen. |
background_color |
Legen Sie die Hintergrundfarbe eines eingebetteten Dashboards fest. |
show_title |
Geben Sie an, ob der Dashboard-Titel auf einem eingebetteten Dashboard sichtbar ist. |
title_color |
Die Farbe des Titels eines eingebetteten Dashboards. |
show_filters_bar |
Geben Sie an, ob die Filterleiste in einem eingebetteten Dashboard sichtbar ist. |
tile_background_color |
Lege die Kachelhintergrundfarbe eines eingebetteten Dashboards fest. |
tile_text_color |
Lege die Kacheltextfarbe eines eingebetteten Dashboards fest. |
Elementparameter | |
elements (für Dashboard) |
Starten Sie einen Abschnitt von LookML, um Dashboard-Elemente zu definieren. |
dashboard
Der Parameter dashboard
deklariert ein neues Dashboard und gibt einen Namen für das Dashboard an. Es sind maximal 255 Zeichen zulässig. Zulässig sind Buchstaben (A–Z), Ziffern (0–9), Bindestriche (-) und Unterstriche (_). In der Regel empfiehlt es sich, jedes LookML-Dashboard in einer eigenen LookML-Datei zu platzieren. Es ist jedoch möglich, mehrere Dashboards in einer einzigen Datei zu deklarieren.
- dashboard: sales_overview
Damit ein Dashboard angezeigt werden kann, muss mindestens ein Element über den Parameter elements
hinzugefügt werden.
preferred_viewer
Mit dem Parameter preferred_viewer
können Sie das Format zum Aufrufen und Herunterladen eines Dashboards auswählen. Folgende Werte sind zulässig:
dashboards
: Der AngularJS-basierte Renderer für alte Dashboards.dashboards-next
: Der React-Renderer für das Standarddashboard.
LookML-Dashboards mit preferred_viewer: dashboards
, die in benutzerdefinierte Dashboards konvertiert werden, können mit der neuen Dashboard-Oberfläche durch Upgrade des benutzerdefinierten Dashboards gerendert werden.
title
(für Dashboard)
Dieser Abschnitt bezieht sich auf den Parameter
title
, der Teil eines Dashboards ist.
title
kann auch als Teil eines Dashboard-Filters verwendet werden, der auf dieser Seite im Abschnitttitle
(für Filter) beschrieben wird.
title
kann auch als Teil eines beliebigen Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite zu Spaltendiagrammelementen.
Mit dem Parameter title
können Sie festlegen, wie ein Dashboard-Name für Nutzer in Ordnern und oben im Dashboard angezeigt wird. Wenn keine Angabe erfolgt, wird standardmäßig der Name des Dashboards verwendet. Der Titeltext kann lokalisiert werden.
Betrachten Sie dieses Beispiel:
- dashboard: sales_overview
title: "1) Sales Overview"
Wenn Sie das tun, wird anstelle des Dashboards Sales Overview (Verkaufsübersicht) 1) Sales Overview angezeigt.
description
(für Dashboard)
Dieser Abschnitt bezieht sich auf den Parameter
description
, der Teil eines Dashboards ist.
description
kann auch als Teil eines explorativen Analysetools verwendet werden, wie auf der Seite mit der Parameterdokumentation fürdescription
beschrieben.
description
kann auch als Teil eines Felds verwendet werden, wie auf der Dokumentationsseite zum Parameterdescription
(für Felder) beschrieben.
Mit dem Parameter description
können Sie einem LookML-Dashboard eine Beschreibung hinzufügen.
Die Beschreibung wird in einem Ordner unter den Dashboard-Titeln in den Dashboard-Listen angezeigt. Wenn keine Beschreibung angegeben ist, wird in der Liste nur der Dashboard-Titel angezeigt.
Der Beschreibungstext kann lokalisiert werden.
extends
Wie auf der Dokumentationsseite Wiederverwendung von Codes mit Erweiterung beschrieben, können Sie mit dem Parameter extends
ein LookML-Dashboard auf einem anderen LookML-Dashboard erstellen und möglicherweise einige Einstellungen hinzufügen oder überschreiben. Der Parameter extends
akzeptiert den Namen eines anderen LookML-Dashboards.
Beachten Sie bei der Erweiterung eines Objekts, dass Lokalisierungsregeln auch für Ihre Erweiterungen gelten. Wenn Sie ein Objekt erweitern und dann neue Labels oder Beschreibungen definieren, sollten Sie Lokalisierungsdefinitionen in den Gebietsschema-Stringdateien Ihres Projekts angeben. Weitere Informationen finden Sie auf der Dokumentation zur Lokalisierung Ihres LookML-Modells.
extension
Wie auf dieser Seite beschrieben, gibt der Parameter extension
an, dass das Dashboard um ein anderes Dashboard muss erweitert werden. Dieses Dashboard ist für andere Nutzer nie sichtbar, kann aber als Vorlage zum Erstellen anderer Dashboards verwendet werden, die für andere Nutzer sichtbar sind. Für den Parameter extension
wird nur der Wert required
akzeptiert. Wenn der Parameter extension
nicht enthalten ist, ist keine Erweiterung für das Dashboard erforderlich.
layout
Mit dem Parameter layout
wird die Layoutmethode festgelegt, die Looker bei der Positionierung von Dashboard-Elementen verwendet. Folgende Werte sind zulässig:
newspaper
: Dashboard-Elemente werden in einem Raster mit 24 Spalten angezeigt. Die Standardgröße eines Elements beträgt 8 Spalten und eine Höhe von 6 Zeilen. Die Elemente in diesem Raster sind konfigurierbar, angegeben durch die Elementparameterwidth
,height
,row
undcol
. Diese Layoutoption wird verwendet, wenn ein benutzerdefiniertes Dashboard in ein LookML-Dashboard konvertiert wird. Sie wird außerdem als Standardlayout verwendet, wenn ein neues LookML-Dashboard über die Looker-IDE erstellt wird. Wennpreferred_viewer
aufdashboards-next
gesetzt ist, istnewspaper
das einzige Layout, das die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard unterstützt.grid
: Dashboard-Elemente werden mit dynamischer Breite angezeigt, basierend auf einer Reihe von Zeilen, die Sie mit dem Parameterrows
und den zugehörigen Unterparameternelements
undheight
definieren. Wennpreferred_viewer
aufdashboards-next
gesetzt ist, unterstütztgrid
die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.static
: Dashboard-Elemente werden in der Reihenfolge angezeigt, in der sie in der LookML-Datei aufgeführt sind. Jedes Dashboard-Element muss mithilfe der Parametertop
undleft
manuell positioniert werden. Diese Parameter gelten für alle Elementtypen. Details zu ihrer Verwendung werden auf den Dokumentationsseiten für die einzelnen Visualisierungstypen angezeigt. Beispiele für die Funktionsweise vontop
undleft
finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards. Wennpreferred_viewer
aufdashboards-next
gesetzt ist, unterstütztstatic
die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.tile
: Dashboard-Elemente werden in der Reihenfolge angezeigt, in der sie in der LookML-Datei aufgeführt sind. Die Breite des Dashboards ist dynamisch und richtet sich nach der Breite des Browsers. Die Dashboard-Elemente positionieren sich dynamisch innerhalb des Browsers, um den verfügbaren Platz zu füllen. Wennpreferred_viewer
aufdashboards-next
gesetzt ist, unterstützttile
die Konvertierung von einem LookML-Dashboard in ein benutzerdefiniertes Dashboard nicht.
rows
Bei layout: grid
-Dashboards startet der Parameter rows
den Abschnitt von LookML, in dem Sie definieren, welche Elemente in welche Zeilen aufgenommen werden sollen, und die Höhe jeder Zeile angeben. Innerhalb jeder Zeile hat jedes Element dieselbe Breite. Wenn Sie ein Element in diesem Abschnitt nicht auflisten, wird es nicht auf dem Dashboard angezeigt.
- dashboard: sales_overview
layout: grid
rows:
- elements: [element_name, element_name, ...]
height: 200
- elements: [element_name, element_name, ...]
height: 300
elements
Für den Parameter elements
wird eine Liste von Dashboard-Elementnamen verwendet, die durch Kommas getrennt sind. Mit jeder elements
-Deklaration wird eine neue Zeile im Dashboard erstellt. Die Elemente, die in einer Zeile platziert werden, haben alle dieselbe Breite. Wenn Sie also zwei Elemente hintereinander platzieren, belegen sie jeweils 50% des verfügbaren Platzes. Wenn Sie vier Elemente in einer Zeile platzieren, belegen diese jeweils 25% des verfügbaren Platzes usw.
height
Der Parameter height
definiert die Höhe einer Zeile in Pixeln. Der Standardwert ist 300.
tile_size
Bei Dashboards vom Typ layout: tile
und layout: static
wird als Kachelgröße die Einheit verwendet, die zur Größenanpassung und Positionierung von Elementen verwendet wird. Sie definieren tile_size
in Pixeln und der Standardwert ist 160. Beispiel:
- dashboard: sales_overview
layout: tile
tile_size: 100
In diesem Fall ist ein Dashboard-Element mit height: 5
und width: 3
500 Pixel hoch und 300 Pixel breit. Die Parameter height
und width
gelten für alle Elementtypen. Details zur Verwendung finden Sie auf den Dokumentationsseiten für die einzelnen Visualisierungstypen. Ein repräsentatives Beispiel für die Funktionsweise von height
und width
finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.
width
Dieser Abschnitt bezieht sich auf den Parameter
width
, der Teil eines Dashboards ist.
width
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für die Verwendung finden Sie auf der Dokumentationsseite für Spaltendiagrammelemente.
Bei layout: static
-Dashboards definiert der Parameter width
die Gesamtbreite des Dashboards, die Sie in Pixel verwenden möchten. Der Parameter width
schränkt das Dashboard nicht auf eine bestimmte Größe ein, wenn Sie ein zu großes Element oder zu viele Elemente hintereinander definieren. Stattdessen sorgt die Einstellung width
dafür, dass das Dashboard auf dem Bildschirm zentriert bleibt. Wenn Sie keine Breite festlegen, wird der Standardwert „1200“ verwendet.
- dashboard: sales_overview
layout: static
width: 800
refresh
Dieser Abschnitt bezieht sich auf den Parameter
refresh
, der Teil eines Dashboards ist.
refresh
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für seine Verwendung finden Sie auf der Dokumentationsseite für Spaltendiagrammelemente.
Mit dem Parameter refresh
kann ein Dashboard in regelmäßigen Abständen automatisch neu geladen werden. Dadurch werden aktuelle Daten abgerufen. Das ist vor allem dann hilfreich, wenn ein Dashboard ständig angezeigt wird, zum Beispiel 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 vorzuwärmen.
Die Aktualisierungsrate kann eine beliebige Anzahl von Sekunden, Minuten, Stunden oder Tagen ohne Dezimalstellen sein. Beispiel:
- dashboard: sales_overview
refresh: 2 hours
Seien Sie vorsichtig, wenn Sie kurze Aktualisierungsintervalle festlegen. Da Dashboards viele Abfragen enthalten können, von denen einige möglicherweise ressourcenintensiv sind, kann die Verwendung bestimmter Dashboards Ihre Datenbank stärker belasten als gewünscht.
auto_run
Der Parameter auto_run
bestimmt, ob ein Dashboard beim ersten Öffnen oder erneuten Laden ausgeführt wird. Der Standardwert ist true. Wenn dieser Parameter auf „false“ gesetzt ist, müssen Nutzer eine Run-Schaltfläche drücken, um das Dashboard zu laden. Beispiel: Ein Dashboard wie dieses wird beim Öffnen automatisch ausgeführt:
- dashboard: sales_overview
auto_run: true
Unabhängig von der Einstellung für auto_run
müssen Nutzer nach dem Ändern von Filterwerten immer auf die Schaltfläche Ausführen klicken. So wird verhindert, dass unerwünschter Ladevorgang wiederholt wird, wenn ein Nutzer eine Filteränderung pausiert oder mehrere Filter gleichzeitig ändern möchte.
crossfilter_enabled
Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter
preferred_viewer
aufdashboards-next
gesetzt wird.
Mit dem Parameter crossfilter_enabled
können Sie Kreuzfilter für ein Dashboard aktivieren oder deaktivieren, das auch preferred_viewer: dashboards-next
verwendet. Wenn dieser Parameter auf true
gesetzt ist, können Dashboard-Betrachter Kreuzfilter auf dem Dashboard erstellen, indem sie auf bestimmte Datenpunkte klicken.
- dashboard: sales_data
preferred_viewer: dashboards-next
crossfilter_enabled: true
crossfilter_enabled
wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards
angewendet. Wurde jedoch ein LookML-Dashboard mit crossfilter_enabled
und preferred_viewer: dashboards
in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard crossfilter_enabled
in Kraft.
filters_bar_collapsed
Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter
preferred_viewer
aufdashboards-next
gesetzt wird.
Mit dem Parameter filters_bar_collapsed
können Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next
verwendet, standardmäßig minimiert oder maximiert festlegen. Wenn dieser Parameter auf true
gesetzt ist, ist die Filterleiste standardmäßig minimiert. Dashboard-Betrachter können die Filterleiste maximieren, indem sie auf das Filtersymbol klicken. Die Standardeinstellung für diese Einstellung ist false
.
- dashboard: sales_data
preferred_viewer: dashboards-next
filters_bar_collapsed: true
filters_bar_collapsed
wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards
angewendet. Wurde jedoch ein LookML-Dashboard mit filters_bar_collapsed
und preferred_viewer: dashboards
in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard filters_bar_collapsed
in Kraft.
filters_location_top
Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter
preferred_viewer
aufdashboards-next
gesetzt wird.
Mit dem Parameter filters_location_top
können Sie die Dashboard-Filterleiste für ein Dashboard, das auch preferred_viewer: dashboards-next
verwendet, oben oder rechts platzieren. Wenn dieser Parameter auf true
gesetzt ist, wird die Filterleiste oben im Dashboard angezeigt. Ist sie auf false
gesetzt, wird die Filterleiste rechts im Dashboard angezeigt. Die Standardeinstellung für diese Einstellung ist true
.
- dashboard: sales_data
preferred_viewer: dashboards-next
filters_location_top: false
filters_location_top
wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards
angewendet. Wurde jedoch ein LookML-Dashboard mit filters_location_top
und preferred_viewer: dashboards
in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard filters_location_top
in Kraft.
filters
Dieser Abschnitt bezieht sich auf den Parameter
filters
, der Teil eines Dashboards ist.
filters
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für seine Verwendung finden Sie auf der Dokumentationsseite für Spaltendiagrammelemente.
filters
kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zum Parameterfilters
beschrieben.
Der Parameter filters
startet den Abschnitt von LookML, in dem Sie Dashboard-Filter definieren. Filter werden oben im Dashboard angezeigt und ermöglichen Nutzern, die Daten hinter Dashboard-Elementen zu ändern.
Damit sich ein Filter auf ein Element auswirkt, muss es für den Filter mit dem Parameter listen
auf „listen“ gesetzt sein. Dieser Parameter gilt für alle Elementtypen außer type: text
. Details zur Verwendung werden auf den Dokumentationsseiten für jeden einzelnen Visualisierungstyp angezeigt. Ein repräsentatives Beispiel für die Funktionsweise von listen
finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.
Wenn Filter auf diese Weise auf ein Element angewendet werden, muss der Filter type
mit der Dimension oder dem Messtyp übereinstimmen, der den Filter überwacht. Weitere Informationen finden Sie unter LookML-Dashboards erstellen. Filter haben folgende Form:
filters:
- name: filter_name
title: "desired filter title"
type: field_filter | number_filter | date_filter | string_filter
model: model_name
explore: explore_name
field: view_name.field_name
default_value: Looker filter expression
allow_multiple_values: true | false
required: true | false
listens_to_filters:
- filter_name
field: view_name.field_name
name
Dieser Abschnitt bezieht sich auf den Parameter
name
, der Teil eines Dashboard-Filters ist.
name
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für seine Verwendung finden Sie auf der Dokumentationsseite für Spaltendiagrammelemente.
Mit jeder name
-Deklaration wird ein neuer Dashboard-Filter erstellt und ihm ein Name zugewiesen. Im Parameter listen
von Elementen, auf die der Filter angewendet werden soll, wird auf den Namen verwiesen. Der Parameter listen
gilt für alle Elementtypen außer type: text
. Details zur Verwendung werden auf der Dokumentationsseite für jeden einzelnen Visualisierungstyp angezeigt. Ein repräsentatives Beispiel für die Funktionsweise von listen
finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.
filters:
- name: order_date
title
(für Filter)
Dieser Abschnitt bezieht sich auf den Parameter
title
, der Teil eines Dashboard-Filters ist.
title
kann auch als Teil eines Dashboards verwendet werden, wie im Abschnitttitle
für das Dashboard auf dieser Seite beschrieben.
title
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für seine Verwendung finden Sie auf der Dokumentationsseite zu Spaltendiagrammparametern für LookML-Dashboards.
Mit dem Parameter title
können Sie ändern, wie ein Filtername für Nutzer oben in einem Dashboard angezeigt wird. Wenn keine Angabe erfolgt, wird standardmäßig der Name des Filters verwendet.
Betrachten Sie dieses Beispiel:
filters:
- name: order_date
title: "Order Date(s)"
Wenn Sie dies tun, würde anstelle des Filters Bestelldatum als Bestelldatum angezeigt werden.
type
Dieser Abschnitt bezieht sich auf den Parameter
type
, der Teil eines Dashboard-Filters ist.
type
kann auch als Teil eines Dashboard-Elements verwendet werden, das auf der Dokumentationsseite zum Parametertype
(für LookML-Dashboards) beschrieben wird.
type
kann auch als Teil eines Joins verwendet werden (siehe Dokumentation zum Parametertype
).
type
kann auch als Teil einer Dimension verwendet werden. Weitere Informationen dazu finden Sie auf der Dokumentationsseite zu Dimensionen, Filtern und Parametertypen.
type
kann auch als Teil einer Messung verwendet werden, wie auf der Dokumentationsseite zu Messtypen beschrieben.
Der Parameter type
gibt die Art der Eingabe an, die im Filter platziert wird. Obwohl jede Art von Eingabe (z. B. ein Datum) in den Filter type: string_filter
geschrieben werden kann, bietet eine spezifischere Filterfunktion ein präziseres Filter-Widget für den Nutzer. Es gibt vier Arten von Filtern:
field_filter
: Sollte in der Regel die Standardauswahl sein, wenn Sie eine zugrunde liegende Dimension oder ein zugrunde liegendes Maß angeben können. Wenn Sietype: field_filter
verwenden und den Filter mit dem Feldtype:string
verknüpfen, werden vom Filter mögliche Filterwerte vorgeschlagen.number_filter
: Der Nutzer kann einen Zahlen- oder Ganzzahlwert oder -Ausdruck eingeben.date_filter
: Der Nutzer kann einen Datumswert oder Ausdruck eingeben.string_filter
: Der Nutzer kann Freitext eingeben.
field_filter
Es werden Vorschläge zur Auswahl angeboten und die Darstellung wird für Nutzer basierend auf dem von Ihnen angegebenen Feld geändert.
Das ist der richtige Filtertyp für Situationen, in denen Sie Nutzern, die mit dem Filter interagieren, Vorschläge machen möchten. Die Dimension, aus der Vorschläge abgerufen werden, wird mit den Parametern explore
und field
definiert. Es muss ein Feld von type: string
sein, damit Filtervorschläge generiert werden können.
Beachten Sie, dass Vorschläge möglicherweise nicht funktionieren, wenn das Feld aus einer abgeleiteten Tabelle stammt, wenn sql_always_where
im Feld „Erkunden“ verwendet wird oder das Feld ein Messwert ist.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date # must be of the form view_name.dimension_name
number_filter
Es werden keine Vorschläge gemacht. Der Nutzer kann einen Ganzzahl- oder Zahlenwert oder Ausdruck eingeben.
filters:
- name: order_value
type: number_filter
date_filter
Es werden keine Vorschläge gemacht. Der Nutzer kann einen Datumswert oder Ausdruck eingeben.
filters:
- name: order_date
type: date_filter
string_filter
Es werden keine Vorschläge gemacht, der Nutzer kann Text im freien Format eingeben.
filters:
- name: customer_name
type: string_filter
default_value
Mit dem Parameter default_value
können Sie einen Standardwert für einen Filter angeben. Dieser Wert kann für Nutzer hilfreich sein, indem ein sinnvoller Ausgangspunkt vorgeschlagen wird.
Der Standardwert muss dem Typ des verwendeten Filters entsprechen. Beispiel:
filters:
- name: order_value
type: number_filter
default_value: "50 to 100"
- name: order_date
type: date_filter
default_value: "last 30 days"
- name: customer_name
type: string_filter
default_value: "John Doe"
Sie können Filterausdrücke verwenden, um Standardwerte zu erstellen. Auf der Dokumentationsseite zu Looker-Filterausdrücken wird dies genauer beschrieben.
Wenn Sie sowohl den Parameter default_value
als auch den Parameter ui_config
verwenden, müssen Filterausdrücke mit dem Wert kompatibel sein, der dem Unterparameter type
von ui_config
und den Datentypen zugewiesen wird, die den Wert type
unterstützen.
Für flexible Standardfilterwerte können Sie auch die Liquid-Variablen _localization
und _user_attributes
verwenden.
allow_multiple_values
Mit dem Parameter allow_multiple_values
können Sie festlegen, ob Nutzer einen oder mehrere Filterwerte auswählen können. Wenn dieser Parameter auf den Standardwert true
festgelegt ist, können Nutzer mehrere Werte für den Filter auswählen. Wenn dieser Parameter auf false
gesetzt ist, können Nutzer nur einen einzelnen Filterwert auswählen.
Für LookML-Dashboards, die das alte Dashboard verwenden und deren preferred_viewer
auf dashboards
gesetzt ist, kann allow_multiple_values
auf Filter aller type
angewendet werden.
Beispiel:
filters:
- name: Order ID
title: Order ID
type: field_filter
allow_multiple_values: true
required: false
model: thelookstore
explore: orders
field: orders.id
required
Mit dem Parameter required
können Sie festlegen, dass Nutzer einen Wert für den Filter angeben müssen, um das Dashboard auszuführen. Standardmäßig verlangen Filter keine Werte. Wenn ein Filter keinen Wert erfordert und leer bleibt, werden die Daten nicht durch das Filterfeld eingeschränkt. Wenn ein Filter einen Wert erfordert und leer bleibt, wird das Dashboard nicht ausgeführt.
filters:
- name: State
title: State
type: field_filter
required: true
ui_config
Dieser Parameter gilt nur für LookML-Dashboards, die mit der Standard-Dashboard-Ansicht von Looker gerendert werden, indem der Parameter
preferred_viewer
aufdashboards-next
gesetzt wird.
Mit dem Unterparameter ui_config
von filters
können Sie Filtereinstellungen konfigurieren, die angewendet werden, wenn ein LookML-Dashboard als Dashboard und nicht als altes Dashboard angezeigt wird. Legen Sie dazu den Parameter preferred_viewer
auf dashboards-next
fest. Zu diesen Einstellungen gehören die verwendeten Filtertypen, die Platzierung der Filtersteuerungen und die möglichen Filterwerte.
Beispiel:
filters:
- name: City
title: City
type: field_filter
default_value: San Francisco
allow_multiple_values: true
required: false
ui_config:
type: button_group
display: inline
options:
- San Francisco
- New York
- Tokyo
model: thelook
explore: order_items
field: users.city
Die Einstellung, die Sie mit dem Unterparameter ui_config
angeben, wird nicht auf LookML-Dashboards mit preferred_viewer: dashboards
angewendet. Wurde jedoch ein LookML-Dashboard mit ui_config
und preferred_viewer: dashboards
in ein benutzerdefiniertes Dashboard konvertiert und aktualisiert, tritt für das aktualisierte Dashboard ui_config
in Kraft.
Weitere Informationen zum Konfigurieren von Filtern mit der Benutzeroberfläche finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.
type
Mit dem Unterparameter type
von ui_config
können Sie die Filtersteuerungstypen angeben, die angezeigt werden, wenn Nutzer ein LookML-Dashboard als Dashboard (nicht als Legacy-Dashboard) aufrufen.
Je nach dem Wert, den Sie für type
eingeben, können Filtersteuerungen als Einzelauswahl oder Mehrfachauswahl verwendet werden.
Welche Werte von
type
unterstützt werden, hängt von den LookML-Datentype
ab, die dem Feld zugewiesen sind, nach dem Sie filtern.
N = Funktioniert mit dem Datentyp [„Zahl“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#number) „Numerische Spalten“
DU = Funktioniert mit dem Datentyp [„Dauer“](/looker/docs/2216/reference/param-dimension-filter-parameter-types#duration)
DRECHUNG
Wert | Beschreibung | Unterstützte Datentypen |
---|---|---|
Mehrfachauswahl | ||
button_group | Der Filter zeigt eine Gruppe von Schaltflächen an – mit einer Schaltfläche für jeden Wert, der mit dem Parameter options angegeben wurde. | S N T ZC YN DI DU |
checkboxes | Der Filter zeigt Kästchen an, wobei für jeden mit dem Parameter options angegebenen Wert ein Kästchen angeklickt ist. | S N T ZC YN DI DU |
tag_list | Der Filter zeigt eine Drop-down-Liste mit allen möglichen Werten, die mit dem Parameter options angegeben wurden. | S N T ZC DI DU |
range_slider | Bei numerischen Feldern enthält der Filter einen Schieberegler, mit dem Nutzer einen Zahlenbereich als Filterwert festlegen können. Mit den Unterparametern min und max von options werden die minimalen und maximalen möglichen Werte für den Filter angegeben. Der Standardbereich kann mit dem Parameter default_value angegeben werden. | N DI DU |
Einfachauswahl | ||
button_toggles | Der Filter zeigt eine Gruppe von Schaltflächen an – mit einer Schaltfläche für jeden Wert, der mit dem Parameter options angegeben wurde. | S N T ZC YN DI DU P |
radio_buttons | Der Filter zeigt Optionsfelder mit einer Schaltfläche für beliebigen Wert und einer Schaltfläche für jeden mit dem Parameter options angegebenen Wert an. | S N T ZC YN DI DU P |
dropdown_menu | Der Filter enthält ein Drop-down-Menü mit allen möglichen Werten, die mit dem Parameter options angegeben werden. Über das Drop-down-Menü haben Nutzer auch die Möglichkeit, Beliebiger Wert auszuwählen. | S N T ZC YN DI DU P |
slider | Bei numerischen Feldern enthält der Filter einen Schieberegler, mit dem Nutzer einen Filter auswählen können. Dazu wechseln sie zwischen den minimalen und maximalen Werten, die mit dem Parameter options angegeben werden. | N DI DU |
Datum und Uhrzeit | ||
day_picker | Mit dem Filter können Nutzer ein bestimmtes Datum auswählen, nach dem gefiltert werden soll. | DT* Das eintägige Steuerelement kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden. Allerdings können Betrachter mit diesem Steuerelement nur einzelne Daten auswählen. |
day_range_picker | Mit dem Filter können Nutzer ein Start- und Enddatum auswählen, um nach einem bestimmten Zeitraum zu filtern. | DT* Die Zeitraumsteuerung kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden, aber Betrachter können nur solche Zeiträume auswählen. |
date_time_range_input | Mit dem Filter kann der Nutzer nach einem bestimmten Datum und einer bestimmten Uhrzeit filtern. | DT* Die Datums- und Uhrzeitsteuerung kann für die meisten zeitbasierten Typen verwendet werden. Nutzer müssen bei dieser Art von Einstellung sowohl Datums- als auch Uhrzeitoptionen auswählen. |
relative_timeframes | Mit dem Filter kann der Nutzer nach einem benutzerdefinierten Zeitraum filtern oder verschiedene Zeiträume auswählen, z. B. Heute, Letzte 7 Tage oder Letzte 90 Tage. | DT* Die Steuerung des Zeitrahmens kann für die meisten Zeiträume und zeitbasierten Typen verwendet werden, aber Betrachter können mit dieser Art von Steuerung keine Zeitoptionen auswählen. |
Andere | ||
advanced | Der Filter bietet Optionen zum Anwenden eines oder mehrerer Filter oder erweiterte Übereinstimmungen. Weitere Informationen zu erweiterten Steuerelementen finden Sie im Abschnitt Erweiterte Steuerelemente verwenden auf dieser Seite. | S N T ZC YN DT DI DU L P |
* Hinweis zu Datums- und Uhrzeitdaten: Einige Zeiträume und zeitbasierte Typen werden als unterschiedliche Datentypen interpretiert, wenn Looker Steuerelementoptionen für sie erstellt. Zwei Beispiele sind der yesno -Zeitraum, der als yesno -Datentyp interpretiert wird und daher die vom Typ yesno unterstützten Werte unterstützt. Der hour_of_day -Zeitraum wird als number -Datentyp interpretiert und unterstützt daher die vom number -Typ unterstützten Werte. |
display
Sie können den Unterparameter display
von ui_config
verwenden, um die Position eines Dashboardfilters festzulegen. Sie können einen Filter positionieren, indem Sie display
einen der folgenden Werte zuweisen:
inline
: Der Filter wird direkt in der oberen Leiste des Dashboards angezeigt.popover
: In der oberen Leiste des Dashboards wird eine Zusammenfassung angezeigt. Klicken Sie auf den Wert, um den vollständigen Filter zu sehen.overflow
: In der oberen Leiste des Dashboards wird die Schaltfläche Mehr mit einem numerischen Indikator für die Anzahl der Überlauffilter angezeigt. Nutzer können auf die Schaltfläche klicken, um die Überlauffilter und ihre Werte aufzurufen.
Einige Filtertypen können nur auf bestimmte Arten dargestellt werden. Beispielsweise kann ein Filter für type: day_picker
nur als inline
oder overflow
angezeigt werden. Wenn Sie einem Filter einen display
-Wert zuweisen, der für type
nicht gültig ist, wird der Filter entweder inline
oder popover
angezeigt, je nachdem, welcher Wert gültig ist. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.
Informationen zum Positionieren von Dashboard-Filtern über die Benutzeroberfläche finden Sie auf der Dokumentationsseite Benutzerdefinierte Filter hinzufügen und bearbeiten.
options
Mit dem optionalen options
-Unterparameter von ui_config
können Sie die Werte festlegen, die ein Nutzer zur vorübergehenden Aktualisierung der Dashboard-Filterwerte verwenden kann, wenn Nutzer ein LookML-Dashboard als Dashboard ansehen (kein Legacy-Dashboard). Wenn Sie für options
keine Werte angeben, ruft Looker die ersten Werte aus der Datenbank ab.
So können Sie beispielsweise San Francisco
, New York
und Tokyo
als mögliche Werte für einen Filter im Feld users.city
festlegen:
ui_config:
type: button_group
display: inline
options:
- San Francisco
- New York
- Tokyo
Wenn der type
-Unterparameter von ui_config
auf range_slider
oder slider
festgelegt ist, können Sie die min
- und max
-Unterparameter von options
verwenden:
min
: Legen Sie den möglichen Mindestwert für einen Filter fest.max
: Legen Sie den maximal möglichen Wert für einen Filter fest.
Beispiel:
ui_config:
type: range_slider
display: inline
options:
min: 0
max: 500
model
Für Dashboard-Filter von type: field_filter
müssen Sie ein Modell definieren, aus dem Vorschläge gefiltert werden. Der Parameter model
gibt an, welches Modell das Feld enthält, das Sie verwenden möchten.
filters:
- name: State
title: State
type: field_filter
default_value: California
model: thelookstore
explore: users
field: users.state
explore
Dieser Abschnitt bezieht sich auf den Parameter
explore
, der Teil eines Dashboard-Filters ist.
explore
kann auch als Teil eines Modells verwendet werden. Dies wird auf der Dokumentationsseite zum Parameterexplore
beschrieben.
explore
kann auch als Teil eines Dashboard-Elements verwendet werden. Ein repräsentatives Beispiel für seine Verwendung finden Sie auf der Dokumentationsseite für Spaltendiagrammelemente.
Für Dashboard-Filter von type: field_filter
müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Der Parameter explore
gibt an, welche Erkundung das Feld enthält, das Sie verwenden möchten.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date
field
Für Dashboard-Filter von type: field_filter
müssen Sie ein Feld definieren, aus dem der Filter Vorschläge abruft. Der Parameter field
gibt an, welches Feld Sie verwenden möchten. Es ist wichtig, den voll ausgefüllten Feldnamen zu verwenden. Mit anderen Worten: Verwenden Sie view_name.field_name
und nicht nur field_name
.
filters:
- name: order_date
type: field_filter
explore: orders
field: orders.order_date
listens_to_filters
Für Dashboard-Filter von type: field_filter
können Sie Vorschläge für den Filter anhand der Eingaben des Nutzers für einen weiteren Filter von type: field_filter
eingrenzen.
Im folgenden Beispiel basieren die Vorschläge für den Filter State
auf den Werten des Filters Order ID
. Die für den Filter „Order ID
“ ausgewählten Werte haben dann verknüpfte users.state
-Werte. Diese werden dann als Werte für den Filter „State
“ vorgeschlagen. Weitere Informationen finden Sie auf der Dokumentationsseite Benutzerdefinierte Dashboard-Filter hinzufügen und bearbeiten.
filters:
- name: State
title: State
type: field_filter
model: thelookstore
explore: users
listens_to_filters:
- Order ID
field: users.state
embed_style
Der Parameter embed_style
startet den Abschnitt von LookML, in dem Sie die Darstellung eines eingebetteten Dashboards anpassen können. embed_style
und die zugehörigen Parameter werden nur auf eingebetteten Dashboards unterstützt. Wenn das Dashboard nicht eingebettet ist, werden die Parameter ignoriert.
Nachdem Sie Änderungen an embed_style
vorgenommen haben, müssen Sie LookML für die Produktion bereitstellen, damit Ihre embed_style
-Einstellungen im eingebetteten LookML-Dashboard angezeigt werden.
Für die folgenden eingebetteten Dashboard-Attribute, die eine Farbe angeben, kann der Farbwert ein Hexadezimalstring wie #2ca6cd
oder ein CSS-benannter Farbstring wie mediumblue
sein.
Eingebettete Dashboard-Anpassungen haben folgende Form:
embed_style:
background_color: "css_color"
show_title: true | false
title_color: "css_color"
show_filters_bar: true | false
tile_background_color: "css_color"
tile_text_color: "css_color"
background_color
Legt die Hintergrundfarbe des eingebetteten Dashboards fest.
embed_style:
background_color: "#ffffff"
show_title
Gibt an, ob der Titel des eingebetteten Dashboards für Nutzer sichtbar ist.
embed_style:
show_title: false
title_color
Legt die Farbe des Titels eines eingebetteten Dashboards fest.
embed_style:
title_color: "#008000"
show_filters_bar
Gibt an, ob die eingebetteten Dashboard-Filter für Nutzer sichtbar sind.
Dieser Parameter wirkt sich nur auf das Aussehen des Dashboards aus und nicht darauf, ob ein Nutzer auf Daten zugreifen kann. Das Ausblenden der Filterleiste verhindert nicht, dass Nutzer Filter auf andere Weise ändern. Informationen zum Einrichten von Richtlinien für die sichere Datenzugriffssteuerung finden Sie auf der Dokumentationsseite Zugriffssteuerung und Berechtigungsverwaltung.
embed_style:
show_filters_bar: true
tile_background_color
Legt die Hintergrundfarbe aller Kacheln in einem eingebetteten Dashboard fest.
embed_style:
tile_background_color: "lightyellow"
tile_text_color
Legt die Textfarbe auf allen Kacheln eines eingebetteten Dashboards fest.
embed_style:
tile_text_color: "crimson"
elements
Dieser Abschnitt bezieht sich auf den Parameter
elements
, der Teil einesdashboard
ist.
elements
kann auch als Teil einer Dashboard-Zeile verwendet werden, die auf dieser Seite im Abschnittelements
für Zeilen beschrieben wird.
Der Parameter elements
startet den Abschnitt von LookML, in dem Sie die Elemente definieren, aus denen ein Dashboard besteht. Es gibt viele Parameter, mit denen Sie die Darstellung eines Dashboard-Elements definieren können. Sie werden auf der Seite Parameter für das Dashboard-Element genauer beschrieben.
- dashboard: sales_overview
layout: tile
elements:
- name: order_count
type: single_value
model: ecommerce
explore: orders
measures: [orders.count]
Denken Sie an die Anzahl und Komplexität der Elemente, die Sie einem LookML-Dashboard hinzufügen. Je mehr Elemente Sie nutzen, desto mehr Browserressourcen werden benötigt. Dadurch erhöht sich die für das Rendering des Dashboards benötigte Zeit. Ebenso können Elemente, die große Datenmengen rendern, die Dashboard-Leistung beeinträchtigen. Wenn das Rendering zu einem Problem wird, können Sie Elemente vereinfachen oder mehrere Dashboards mit weniger Elementen erstellen.