Nutzung
explore: explore_name {
always_filter: {
filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
|
Hierarchie
always_filter |
Standardwert
Keine
Akzeptiert
Ein Feldname und ein Looker-Filterausdruck
|
Definition
Mit dem Parameter always_filter können Sie festlegen, dass Nutzer eine Reihe von Filtern für ein Explore einbeziehen müssen. Nachdem Sie die Filter und ihre Standardwerte mit dem Parameter always_filter definiert haben, werden im Explore automatisch die konfigurierten Filtereinstellungen angezeigt.
Die Filter, die Sie im Parameter always_filter angeben, können nicht aus dem Explore entfernt werden. Ihre Nutzer können den Filter jedoch ändern, indem sie die Filterwerte oder die Filterbedingung im Drop-down-Menü für Bedingungen ändern. Ihre Nutzer können auch alle Werte aus dem Filter entfernen. Das hat denselben Effekt wie das Entfernen des Filters.
Wenn Sie möchten, dass ein Explore Filter hat, die nicht geändert oder entfernt werden können, verwenden Sie stattdessen einen der folgenden Parameter:
- Wenn Sie Filter konfigurieren möchten, die für alle gleich sind und nicht gesehen oder geändert werden können, können Sie
sql_always_whereverwenden. - Wenn Sie Filter konfigurieren möchten, die für jeden Nutzer spezifisch sind und nicht angezeigt oder geändert werden können, können Sie
access_filterverwenden.
Im Parameter always_filter kann das Feld, auf das im Unterparameter filters verwiesen wird, eine Dimension, ein Messwert, ein Filter oder ein Parameter sein. Wenn Sie auf eine Dimension oder einen Messwert verweisen müssen, die bzw. der Teil einer verknüpften Ansicht und nicht Teil dieses Explores ist, verwenden Sie view_name.field_name. Beispiel:
explore: order {
always_filter: {
filters: [id: "123", customer.id: "789"]
}
join: customer {
sql_on: ${order.customer_id} = ${customer.id} ;;
}
}
Hier bezieht sich der Filter id auf das Feld id aus order. Der Filter customer.id bezieht sich auf das Feld id aus customer. In diesem Beispiel wird auch gezeigt, dass Sie mehrere Filter hinzufügen können.
Für jedes field_name: "filter expression"-Paar kann der Filterausdruck ein absoluter Wert sein oder Sie können Looker-Filterausdrücke verwenden, je nachdem, nach welchem Feldtyp Sie filtern.
Beispiele
Konfigurieren Sie einen Standardfilter für das Explore im Feld Bestell-ID (mit dem Standardwert „123“):
explore: order {
always_filter: {
filters: [id: "123"]
}
}
Konfigurieren Sie einen Standardfilter für das Explore für das Feld Order Created Date (mit einem Standardwert der letzten sieben Tage) und das boolesche Feld (type: yesno) Is Complete (mit einem Standardwert von "No", bei dem die Groß-/Kleinschreibung beachtet wird):
explore: order {
always_filter: {
filters: [created_date: "7 days", is_complete: "No"]
}
}
Konfigurieren Sie einen Standardfilter für das Explore für das Feld Bestell-ID (Standardwert „123“), das Feld Order City (Standardwert „Chicago“) und das Feld Customer Age (Standardwert größer oder gleich 18):
explore: order {
always_filter: {
filters: [id: "123", city: "Chicago", customer.age: ">=18"]
}
join: customer {
sql_on: ${order.customer_id} = ${customer.id} ;;
}
}
Wichtige Punkte
Bei booleschen Filterwerten in always_filter wird zwischen Groß- und Kleinschreibung unterschieden
Wenn Sie im Parameter always_filter nach einem type: yesno-Feld filtern, wird beim booleschen Filterausdruck zwischen Groß- und Kleinschreibung unterschieden und er muss großgeschrieben werden ("Yes" oder "No"). Dies unterscheidet sich vom Unterparameter filters für Messwerte, bei dem für boolesche Werte nicht zwischen Groß- und Kleinschreibung unterschieden wird.
Nutzer können einen von always_filter angegebenen Filter nicht entfernen.
Nutzer können zwar die Bedingung oder den Standardwert für ihre Abfrage ändern, aber einen von always_filter hinzugefügten Filter nicht entfernen. Wenn Sie Filter für ein Explore so vorab laden möchten, dass Nutzer die Filter vollständig entfernen können, können Sie eine Abfrage mit vorgeschlagenen Filtern erstellen und die Abfrage dann für Nutzer freigeben, damit sie die Abfrage und ihre Filter als Ausgangspunkt verwenden können.
Leeren Standardwert festlegen
Wenn Sie einen Standardfilter mit einem leeren Standardwert erstellen möchten, können Sie "-EMPTY" in den Filterwerten angeben:
always_filter: {
filters: [products.category: "-EMPTY"]
}
Der Parameter always_filter überschreibt eine default_value-Filtereinstellung.
Der Parameter always_filter überschreibt die Einstellung default_value für das Feld. Wenn Sie einen Wert mit always_filter deklarieren, wird dieser Wert als Standardwert im Explore verwendet. Wenn Sie keinen Wert mit always_filter deklarieren, wird im Explore standardmäßig „ist ein beliebiger Wert“ verwendet.
always_filter wirkt sich auf vorhandene Looks und Dashboard-Tiles aus
Wenn Sie den Parameter always_filter einer vorhandenen explore-Definition hinzufügen, wird die Gruppe von Filtern mit den Standardwerten allen Looks, Explores oder Dashboard-Tiles hinzugefügt, die auf dieser explore basieren. Dazu gehören auch zuvor gespeicherte Looks und Dashboard-Tiles, die auf der explore basieren.