Utilisation
explore: explore_name {
always_filter: {
filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
|
Hiérarchie
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 en modifiant sa condition dans le menu déroulant des conditions. Vos utilisateurs peuvent également supprimer toutes les valeurs du filtre, ce qui revient à 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 les utilisateurs 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 référencer 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, selon le 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 une valeur par défaut correspondant aux sept jours précédents) et le champ booléen (type: yesno) Is Complete (Est terminée) (avec une valeur par défaut sensible à la casse de "No") :
explore: order {
always_filter: {
filters: [created_date: "7 days", is_complete: "No"]
}
}
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 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 valeurs de filtre booléennes dans always_filter sont sensibles à la casse
Lorsque vous filtrez un champ type: yesno dans le paramètre always_filter, l'expression de filtre booléen est sensible à la casse et doit être en majuscules ("Yes" ou "No"). Cela diffère du sous-paramètre filters pour les mesures, qui n'est pas sensible à la casse pour les valeurs booléennes.
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 à permettre aux utilisateurs de 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 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, elle sera utilisée par défaut dans l'exploration. Si vous ne déclarez pas de valeur avec always_filter, la valeur par défaut du filtre dans l'exploration est "est n'importe quelle 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 vignettes de tableau de bord précédemment enregistrées qui sont basées sur la explore.