filtro_siempre

Uso

explore: explore_name {
always_filter: {
filters: [field_name: "filter expression", field_name: "filter expression", ...]
}
}
Jerarquía
always_filter
Valor predeterminado
Ninguna

Acepta
Un nombre de campo y una expresión de filtro de Looker

Definición

always_filter le permite exigir a los usuarios que incluyan un conjunto determinado de filtros que usted define. También debes definir un valor predeterminado para los filtros. Aunque los usuarios pueden cambiar el valor predeterminado de su consulta, no pueden quitar el filtro por completo.

El campo al que se hace referencia en el subparámetro filters puede ser dimension, measure, filter o parameter. Si necesitas hacer referencia a una dimensión o medida que es parte de una vista unida en lugar de parte de esta exploración, usa view_name.field_name. Por ejemplo:

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

Aquí, el filtro id hace referencia al campo id de order. El filtro customer.id hace referencia al campo id de customer. En este ejemplo, también se demuestra que puedes requerir varios filtros.

En el subparámetro value, especifica los valores predeterminados mediante las expresiones de filtro de Looker.

Ejemplos

Fuerza al usuario a usar un filtro de ID de pedido (con un valor predeterminado de "123"):

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

Forzar al usuario a usar un filtro de Fecha de creación del pedido (con un valor predeterminado de los siete días anteriores):

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

Fuerza al usuario a usar un filtro de ID de pedido (valor predeterminado de "123"), un filtro de Ciudad de pedido (valor predeterminado de "Chicago") y un filtro de Edad del cliente (valor predeterminado de 18 o mayor).

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

Desafíos habituales

Los usuarios no pueden quitar un filtro especificado por always_filter

La IU de Explorar no permite que los usuarios quiten un filtro que agregó always_filter. Si quieres precargar filtros para un elemento Explorar de una manera que permita a los usuarios quitarlos por completo, considera crear una consulta que incluya filtros sugeridos y, luego, compartir la consulta con los usuarios a fin de que puedan usar la consulta y sus filtros como punto de partida.

Deja un valor predeterminado en blanco

Si deseas crear un filtro obligatorio con un valor predeterminado en blanco, especifica
"-EMPTY" en los valores del filtro:

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

El parámetro always_filter anula una configuración de filtro default_value

always_filter anula la configuración default_value para el campo. Si declaras un valor con always_filter, ese valor será el predeterminado en Explorar. Si no declaras un valor con always_filter, "es cualquier valor" es el filtro predeterminado en Explorar.

Qué debes saber

always_filter afecta el aspecto existente y los mosaicos del panel

Cuando se agrega always_filter a una definición existente de explore, se agrega el conjunto de filtros con los valores predeterminados a cualquier mosaico de aspecto, exploración o panel en función de ese explore, incluidos los mosaicos guardados anteriormente y los mosaicos del panel basados en explore.

Si desea filtros que los usuarios no puedan cambiar, considere sql_always_where

Si quieres que Explorar tenga filtros iguales para todos y que no se puedan cambiar de ninguna manera, puedes usar sql_always_where.

Si desea filtros específicos del usuario que estos no puedan cambiar, considere usar access_filter

Si quieres que Explorar tenga filtros específicos para cada usuario y que no se puedan cambiar de ninguna manera, puedes usar access_filter.