always_filter

Nutzung

explore: explore_name {
  always_filter:  {
    filters:  [field_name: "filter expression", field_name: "filter expression", ...]
  }
}

Hierarchie Modelldatei explore 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 im Parameter always_filter angegebenen Filter können nicht aus dem Explore entfernt werden. Nutzer können den Filter jedoch ändern, indem sie die Werte des Filters oder die Bedingung des Filters im Drop-down-Menü für die Bedingung ändern. Nutzer können auch alle Werte aus dem Filter entfernen, was den gleichen Effekt hat wie das Entfernen des Filters.

Wenn Sie für ein Explore Filter festlegen möchten, die nicht geändert oder entfernt werden können, verwenden Sie stattdessen einen der folgenden Parameter:

• Mit sql_always_where können Sie Filter konfigurieren, die für alle Nutzer gleich sind und nicht angezeigt oder geändert werden können.
• Mit access_filter können Sie Filter konfigurieren, die für jeden Nutzer spezifisch sind und nicht angezeigt oder geändert werden können.

Im always_filter Parameter kann das Feld, auf das im filters Unterparameter verwiesen wird, eine Dimension, ein Messwert, ein Filter oder ein Parameter sein. Wenn Sie auf eine Dimension oder einen Messwert verweisen müssen, der Teil einer verknüpften Ansicht und nicht Teil dieses Explore 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 customer.id Filter bezieht sich auf das id Feld aus customer. Dieses Beispiel zeigt auch, dass Sie mehrere Filter hinzufügen können.

Für jedes field_name: "filter expression" Paar kann der Filterausdruck ein absoluter Wert sein. Sie können aber auch Looker-Filterausdrücke verwenden, je nach Feldtyp, nach dem Sie filtern.

Beispiele

Konfigurieren Sie einen Standardfilter für das Explore für das 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 Bestelldatum (mit dem Standardwert der letzten sieben Tage):

explore: order {
  always_filter: {
    filters: [created_date: "7 days"]
  }
}

Konfigurieren Sie einen Standardfilter für das Explore für das Feld Bestell-ID (Standardwert „123“), das Feld Bestellort (Standardwert „Chicago“) und das Feld Alter des Kunden (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

Nutzer können einen mit always_filter angegebenen Filter nicht entfernen

Nutzer können zwar die Bedingung oder den Standardwert für ihre Abfrage ändern, aber einen Filter, der mit always_filter hinzugefügt wurde, nicht entfernen. Wenn Sie Filter für ein Explore vorab laden möchten, die Nutzer vollständig entfernen können, erstellen Sie eine Abfrage mit vorgeschlagenen Filtern und geben Sie sie dann für Nutzer frei, 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, geben Sie in den Filterwerten "-EMPTY" an:

always_filter: {
  filters: [products.category: "-EMPTY"]
}

Der Parameter always_filter überschreibt eine default_value-Filtereinstellung

Der always_filter Parameter überschreibt die default_value Einstellung für das Feld. Wenn Sie mit always_filter einen Wert deklarieren, ist dieser Wert der Standardwert im Explore. Wenn Sie mit always_filter keinen Wert deklarieren, ist „ist ein beliebiger Wert“ der Standardwert für den Filter im Explore.

always_filter wirkt sich auf vorhandene Looks und Dashboard-Kacheln aus

Wenn Sie die always_filter-Parameter zu einer vorhandenen explore-Definition hinzufügen, wird die Gruppe von Filtern mit den Standardwerten zu allen Looks, Explores oder Dashboard-Kacheln hinzugefügt, die auf dieser explore basieren. Das gilt auch für zuvor gespeicherte Looks und Dashboard-Kacheln, die auf der explore basieren.