always_filter

Utilisation

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

Hiérarchie Fichier de modèle explore always_filter

Valeur par défaut Aucun Acceptation Un nom de champ et une expression de filtre Looker

Définition

Le paramètre always_filter vous permet d'obliger les utilisateurs à inclure un ensemble de filtres pour une exploration. Une fois que vous avez défini les filtres et leurs valeurs par défaut à l'aide du paramètre always_filter, l'exploration affiche automatiquement les paramètres de filtre que vous avez configurés.

Les filtres que vous spécifiez dans le paramètre always_filter ne peuvent pas être supprimés de l'exploration. Toutefois, vos utilisateurs peuvent modifier le filtre en changeant ses valeurs ou sa condition dans le menu déroulant des conditions. Vos utilisateurs peuvent également supprimer toutes les valeurs du filtre, ce qui a le même effet que de supprimer le filtre.

Si vous souhaitez qu'une exploration comporte des filtres qui ne peuvent pas être modifiés ni supprimés, utilisez plutôt l'un des paramètres suivants :

• Pour configurer des filtres identiques pour tous, qui ne peuvent être ni vus ni modifiés, vous pouvez utiliser sql_always_where.
• Pour configurer des filtres spécifiques à chaque utilisateur, qui ne peuvent être ni vus ni modifiés, vous pouvez utiliser access_filter.

Dans le paramètre always_filter, le champ référencé dans le sous-paramètre filters peut être une dimension, une mesure, un filtre ou un paramètre. Si vous devez faire référence à une dimension ou à une mesure qui fait partie d'une vue jointe plutôt que de cette exploration, utilisez view_name.field_name. Exemple :

explore: order {
  always_filter: {
    filters: [id: "123", customer.id: "789"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Ici, le filtre id fait référence au champ id de order. Le filtre customer.id fait référence au champ id de customer. Cet exemple montre également que vous pouvez ajouter plusieurs filtres.

Pour chaque paire field_name: "filter expression", l'expression de filtre peut être une valeur absolue ou vous pouvez utiliser des expressions de filtre Looker, en fonction du type de champ sur lequel vous filtrez.

Exemples

Configurez un filtre par défaut pour l'exploration sur le champ ID de commande (avec une valeur par défaut de "123") :

explore: order {
  always_filter: {
    filters: [id: "123"]
  }
}

Configurez un filtre par défaut pour l'exploration sur le champ Date de création de la commande (avec une valeur par défaut des sept derniers jours) :

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

Configurez un filtre par défaut pour l'exploration sur le champ ID de la commande (valeur par défaut "123"), le champ Ville de la commande (valeur par défaut "Chicago") et le champ Âge du client (valeur par défaut "supérieur ou égal à 18") :

explore: order {
  always_filter: {
    filters: [id: "123", city: "Chicago", customer.age: ">=18"]
  }
  join: customer {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Éléments à prendre en compte

Les utilisateurs ne peuvent pas supprimer un filtre spécifié par always_filter

Les utilisateurs peuvent modifier la condition ou la valeur par défaut de leur requête, mais ils ne peuvent pas supprimer un filtre ajouté par always_filter. Si vous souhaitez précharger des filtres pour une exploration de manière à ce que les utilisateurs puissent les supprimer complètement, envisagez de créer une requête incluant des filtres suggérés, puis de partager la requête avec les utilisateurs afin qu'ils puissent l'utiliser, ainsi que ses filtres, comme point de départ.

Définir une valeur par défaut vide

Si vous souhaitez créer un filtre par défaut avec une valeur par défaut vide, vous pouvez le faire en spécifiant "-EMPTY" dans les valeurs du filtre :

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

Le paramètre always_filter remplace un paramètre de filtre default_value.

Le paramètre always_filter remplace le paramètre default_value pour le champ. Si vous déclarez une valeur avec always_filter, cette valeur sera la valeur par défaut dans Explorer. Si vous ne déclarez pas de valeur avec always_filter, la valeur par défaut du filtre dans Explorer est "est une valeur".

always_filter affecte les Looks et les vignettes de tableau de bord existants

L'ajout du paramètre always_filter à une définition explore existante ajoute l'ensemble de filtres avec les valeurs par défaut à toutes les présentations, explorations ou vignettes de tableau de bord basées sur cette explore, y compris les présentations et les vignettes de tableau de bord précédemment enregistrées basées sur la explore.