always_filter

Nutzung

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

Hierarchie Model File explore always_filter

Standardwert Keine Akzeptiert Einen Feldnamen und einen 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 die konfigurierten Filtereinstellungen automatisch im Explore angezeigt.

Die Filter, die Sie im Parameter always_filter angeben, können nicht aus dem Explore entfernt werden. Nutzer können den Filter jedoch ändern, indem sie die Werte oder die Bedingung des Filters 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 enthält, 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 die nicht angezeigt oder in irgendeiner Weise geändert werden können, können Sie sql_always_where verwenden.
• Wenn Sie Filter konfigurieren möchten, die für jeden Nutzer spezifisch sind und nicht angezeigt oder geändert werden können, verwenden Sie access_filter.

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 Teil einer verknüpften Ansicht und nicht Teil dieses Explores sind, 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. Sie können aber auch Looker-Filterausdrücke verwenden, je nachdem, nach welchem Feldtyp 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 „Letzte 7 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 keinen Filter entfernen, der durch always_filter angegeben wurde.

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

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, ist dieser Wert der Standardwert in Explore. Wenn Sie keinen Wert mit always_filter deklarieren, ist „ist ein beliebiger Wert“ der Standardfilter in Explore.

always_filter wirkt sich auf vorhandene Looks und Dashboard-Kacheln 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-Kacheln hinzugefügt, die auf dieser explore basieren. Das gilt auch für zuvor gespeicherte Looks und Dashboard-Kacheln, die auf der explore basieren.