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 Nom de champ et 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 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. Ils 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 l'un des paramètres suivants :

• Pour configurer des filtres identiques pour tous et qui ne peuvent être ni vus ni modifiés, vous pouvez utiliser sql_always_where.
• Pour configurer des filtres spécifiques à chaque utilisateur et 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 Order ID (ID de commande) (avec la valeur par défaut "123") :

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

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

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

Configurez un filtre par défaut pour l'exploration sur le champ Order ID (ID de commande) (valeur par défaut "123"), le champ Order City (Ville de la commande) (valeur par défaut "Chicago") et le champ Customer Age (Âge du client) (valeur par défaut supérieure ou égale à 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 qui a été 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 qui inclut 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 de 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 du champ. Si vous déclarez une valeur avec always_filter, cette valeur sera la valeur par défaut dans l'exploration. Si vous ne déclarez pas de valeur avec always_filter, "is any value" (est n'importe quelle valeur) est la valeur par défaut du filtre dans l'exploration.

always_filter affecte les présentations et les vignettes de tableau de bord existantes

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 enregistrées précédemment qui sont basées sur l'explore.