sempre_filtro

Utilizzo

Explore: Explore_name {
sempre_filtro: {
filtri: [nome_campo: "espressione di filtro", campo_nome: "espressione di filtro", ...]
}
}

Gerarchia File modello explore always_filter

Valore predefinito Nessuna Accetta Un nome di campo e un'espressione di filtro di Looker.

Definizione

always_filter ti consente di richiedere agli utenti di includere un determinato insieme di filtri da te definiti. Puoi anche definire un valore predefinito per i filtri. Anche se gli utenti possono modificare il valore predefinito per le query, non possono rimuovere completamente il filtro.

Il campo a cui viene fatto riferimento nel sottoparametro filters può essere una dimensione, una misura, un filtro o un parametro. Se devi fare riferimento a una dimensione o a una misurazione che fa parte di una vista unita anziché di questa esplorazione, utilizza view_name.field_name. Ad esempio:

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

Qui il filtro id si riferisce al campo id di order. Il filtro customer.id si riferisce al campo id di customer. Questo esempio mostra anche che è possibile richiedere più filtri.

Nel sottoparametro value, specifica i valori predefiniti utilizzando le espressioni del filtro Looker.

Esempi

Imponi all'utente di utilizzare un filtro ID ordine (con valore predefinito "123"):

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

Imponi all'utente di utilizzare un filtro Data di creazione dell'ordine (con un valore predefinito dei sette giorni precedenti):

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

Imponi all'utente di utilizzare un filtro ID ordine (valore predefinito "123"), un filtro Città ordine (valore predefinito "Chicago") e un filtro Età cliente (valore predefinito maggiore o uguale a 18):

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

Sfide comuni

Gli utenti non possono rimuovere un filtro specificato da always_filter

La UI Esplora non consente agli utenti di rimuovere un filtro aggiunto da always_filter. Se vuoi precaricare i filtri di un Explore (esplorazione) in modo da permettere agli utenti di rimuoverli completamente, crea una query che includa filtri suggeriti e poi condividi la query con gli utenti per utilizzarli come punto di partenza.

Impostazione di un valore predefinito vuoto

Se vuoi creare un filtro obbligatorio con un valore predefinito vuoto, specifica
"-EMPTY" nei valori del filtro:

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

Il parametro always_filter sostituisce un'impostazione di filtro default_value

always_filter sostituisce l'impostazione default_value per il campo. Se dichiari un valore con always_filter, questo sarà il valore predefinito in Esplora. Se non dichiari un valore con always_filter, "è qualsiasi valore" è il filtro predefinito in Esplora.

Aspetti da tenere presenti

always_filter influisce sui riquadri esistenti e sui Look

L'aggiunta di always_filter a una definizione explore esistente aggiunge l'insieme di filtri con i valori predefiniti a tutti i riquadri Look, Esplorazioni o dashboard basati su quel explore, inclusi i Look salvati in precedenza e i riquadri della dashboard basati su explore.

Se vuoi filtri che gli utenti non possono modificare, valuta sql_always_where

Se vuoi che un filtro Esplora abbia filtri uguali per tutti e che non possano essere modificati in nessun modo, puoi utilizzare sql_always_where.

Se vuoi filtri specifici dell'utente che gli utenti non possono modificare, valuta access_filter

Se vuoi che un filtro Esplora abbia filtri specifici per ogni utente e che non possano essere modificati in nessun modo, puoi utilizzare access_filter.