link

Utilisation

view: view_name {
  dimension: field_name {
    link: {
      label: "desired label name"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more links
  }
}
Hiérarchie
view
Type de champ
link
Types de champs possibles
Dimension, Mesure

Acceptation
Différents paramètres

Définition

Le paramètre link vous permet d'ajouter des liens Web à des dimensions et à des mesures afin que les utilisateurs puissent facilement accéder au contenu associé directement depuis Looker. La forme d'un paramètre link est la suivante :

dimension: field_name {
  link: {
    label: "desired label name"
    url: "desired_url"
    icon_url: "url_of_an_image_file"
  }
  # Possibly more links
}

Le paramètre link comporte plusieurs paramètres enfants :

  • label est le nom du lien que vous souhaitez afficher pour les utilisateurs.
  • url correspond à l'URL vers laquelle vous souhaitez rediriger les utilisateurs. Vous pouvez utiliser des variables Liquid pour rendre les liens dynamiques, comme décrit dans la section Utiliser des variables Liquid avec link sur cette page.
  • icon_url est une URL, accessible au navigateur de l'utilisateur, qui contient un fichier image. Les utilisateurs peuvent ainsi comprendre plus facilement, en un coup d'œil, où le lien les mènera. Le paramètre icon_url n'est pas obligatoire si vous ne souhaitez pas ajouter d'icône. Si vous avez besoin de logos d'entreprise, essayez d'effectuer une recherche Google à l'aide du modèle http://www.google.com/s2/favicons?domain=[company website of interest] pour trouver des images au format .ico.

Exemple

Une entreprise d'e-commerce souhaite que ses employés puissent contacter l'assistance de l'entrepôt directement à partir du contenu Looker, par exemple un Look affichant les commandes en attente du mois dernier. Le Look contient les ID de commande et l'ID utilisateur du client associé à chaque commande.

Vous pouvez ajouter un lien à la dimension ID de commande pour que l'utilisateur qui consulte le Look puisse effectuer cette action :


dimension: id {
  primary_key: yes
  type: number
  sql: ${TABLE}.id ;;
  link: {
    label: "Contact Warehouse Support"
    url: "mailto:warehouse@altostrat.com"
  }
}

Dans le Look, l'utilisateur verra le lien Contacter l'assistance Warehouse parmi les options du menu de liens, accessible en cliquant sur le menu à trois points pour l'une des valeurs du champ ID de commande.

En cliquant sur le nom du lien, l'utilisateur est redirigé vers le contenu associé. Dans ce cas, un nouvel onglet s'ouvre avec un brouillon d'e-mail vide adressé à l'adresse e-mail spécifiée.

Lorsqu'un utilisateur clique sur un lien, Looker l'ouvre dans un nouvel onglet de navigateur ou dans le même onglet (ou iframe, pour les requêtes intégrées) :

  • Les liens absolus, tels que https://example.looker.com, s'ouvriront dans un nouvel onglet du navigateur.
  • Les liens relatifs, tels que /dashboards/456, s'ouvrent dans le même onglet de navigateur ou le même iFrame. Une fois le lien ouvert, l'utilisateur peut cliquer sur Retour dans le navigateur pour revenir à la requête d'origine.

Pour accéder aux liens, un utilisateur doit disposer de l'autorisation explore ou see_drill_overlay.

Le paramètre link est compatible avec les variables Liquid pour rendre le contenu encore plus interactif au niveau des lignes et des valeurs. LookML accepte deux types de tags d'utilisation Liquid : les tags d'entrée de valeur {{ }} et les tags de logique conditionnelle {% %}.

Parmi les deux, {{ }}, en association avec les variables Liquid value et _filters['view_name.field_name'], est le plus souvent utilisé avec link. En effet, les balises {{ }} saisissent directement les valeurs d'entrée à l'endroit où elles sont placées, par exemple dans une URL.

Consultez les exemples sur cette page pour découvrir comment utiliser les balises Liquid {{ }} avec les variables value et _filters['view_name.field_name'] afin de rendre le contenu interactif avec link.

Créer des liens vers des contenus externes

Supposons, par exemple, que vous disposiez d'une dimension artist_name et que vous souhaitiez que l'utilisateur ait la possibilité d'effectuer une recherche Google pour cet artiste directement depuis Looker. Vous pouvez utiliser la variable Liquid value pour ajouter cette option à une dimension, comme suit :

dimension: artist_name {
  link: {
    label: "Google"
    url: "http://www.google.com/search?q={{ value }}"
    icon_url: "http://google.com/favicon.ico"
  }
}

Lorsqu'un utilisateur clique sur le menu à trois points pour une valeur du champ Nom de l'artiste, Looker affiche le menu Liens, qui inclut le lien créé dans l'exemple LookML. Le lien ouvre un nouvel onglet de navigateur vers une recherche Google pour l'artiste sélectionné. Le nom de l'artiste sélectionné est inséré dans l'URL à l'emplacement de {{ value }}.

Ce modèle peut être reproduit pour d'autres sites Web externes auxquels le navigateur d'un utilisateur a accès, tels que les systèmes de gestion des tickets, les systèmes de gestion des clients et d'autres outils professionnels, afin de faciliter la navigation entre les applications Web.

Créer des liens vers du contenu dans Looker

En plus des sites externes, vous pouvez utiliser le paramètre link pour rediriger les utilisateurs vers d'autres explorations, Looks ou tableaux de bord Looker pertinents pour une expérience d'analyse personnalisée. Vous pouvez également appliquer les mêmes exemples aux liens du paramètre LookML html pour les champs.

Pour commencer, vous devez obtenir l'URL d'une exploration, d'une présentation ou d'un tableau de bord existant que vous souhaitez associer. Vous pouvez ensuite remplacer des éléments spécifiques de l'URL, tels que les valeurs et les noms de filtres, par des balises {{ }} contenant les variables value et _filters['view_name.field_name']. Les variables insèrent les valeurs sélectionnées par l'utilisateur dans les éléments d'URL qu'elles remplacent. La structure de base des URL de contenu est la suivante :

  • Explorer : /explore/YOUR_MODEL_NAME/YOUR_EXPLORE_NAME?fields=view_name.field_name1,view_name.field_name2...
    • Pour obtenir l'URL d'exploration des explorations existantes, sélectionnez l'option d'icône en forme de roue dentée URL développée.
    • Les filtres "Explorer" s'affichent dans les URL sous la forme f[view_name.field_name]. Pour obtenir un exemple, consultez la section Associer une exploration.
  • Look : /looks/YOUR_LOOK_NUMBER

  • Tableau de bord défini par l'utilisateur : /dashboards/YOUR_DASHBOARD_NUMBER?FILTER_NAME_1=VALUE&FILTER_NAME_2=VALUE

    • Pour obtenir l'URL d'un tableau de bord existant, copiez l'URL du navigateur à partir de la page du tableau de bord.

  • Tableau de bord LookML : /dashboards/YOUR_MODEL::YOUR_DASHBOARD

    • Pour obtenir l'URL d'un tableau de bord LookML existant, copiez l'URL du navigateur à partir de la page du tableau de bord.

Les filtres de tableau de bord pour les tableaux de bord définis par l'utilisateur et LookML s'affichent dans les URL sous la forme filter_name, où filter_name correspond au nom donné au filtre placé dans le tableau de bord. Pour obtenir un exemple, consultez la section Transmettre une valeur de filtre existante à un contenu associé.

Les éléments des URL, tels que les valeurs et les noms des filtres, sont encodés au format URL avec des caractères spéciaux, tels que ? pour indiquer le début d'une chaîne de requête, & pour séparer les éléments et %20 pour les espaces. Pour obtenir un exemple, consultez la section Encodage des URL pour les autres opérateurs de comparaison.

Une fois que vous avez l'URL du contenu vers lequel vous souhaitez créer un lien, vous pouvez utiliser Liquid pour insérer la valeur d'un champ dans n'importe quel élément de l'URL, à l'aide des variables value ou _filters['view_name.field_name'] et des balises {{ }}. Pour en savoir plus sur les composants d'une URL de requête, consultez le post de la communauté Looker Using URLs and query parameters (Utiliser des URL et des paramètres de requête).

Nous avons une dimension appelée Ville. Nous souhaitons que les utilisateurs puissent accéder à une autre exploration existante, avec des métriques sur les villes et un filtre Ville. Nous souhaitons que l'exploration associée soit filtrée en fonction de la ville sélectionnée par l'utilisateur.

Pour ce faire :

  1. Obtenez l'URL de l'exploration existante vers laquelle effectuer l'analyse.
  2. Ajoutez un paramètre link à la dimension Ville :
  dimension: city {
  type: string
  sql: ${TABLE}.city ;;
  link: {
    label: "City Metrics Explore"
    url: "/explore/ecommerce_model/order_items_explore?fields=users.city,orders.count,users.count&f[users.city]=&sorts=orders.count+desc&limit=500"
  }
  }

Ici, l'URL a été raccourcie à limit=500, ce qui limite les résultats de l'exploration à 500 lignes, pour plus de clarté. Vous pouvez inclure le reste de l'URL, qui inclut généralement l'encodage d'URL des paramètres de visualisation, si nécessaire.

  1. Insérez le tag et la variable Liquid {{ value }} à l'endroit où vous souhaitez insérer la valeur dans l'URL. Dans ce cas, nous voulons placer la valeur à l'emplacement de l'élément de filtre, f[users.city]=, dans la chaîne d'URL pour que l'exploration soit filtrée en fonction de la ville sélectionnée par l'utilisateur :
dimension: city {
  type: string
  sql: ${TABLE}.city ;;
  link: {
    label: "City Metrics Explore"
    url: "/explore/ecommerce_model/order_items_explore?fields=users.city,orders.count,users.count&f[users.city]={{ value }}&sorts=orders.count+desc&limit=500"
  }
}

La dimension Ville affichera alors un menu à trois points contenant l'option Explorer les métriques de ville.

Lorsqu'un utilisateur clique sur le lien, il est redirigé vers l'explorateur de métriques sur les villes, filtré par la ville sélectionnée.

Vous pouvez également conserver les valeurs de filtre existantes lorsque vous créez un lien vers du contenu Looker, comme illustré dans l'exemple suivant.

Exemple : Transmettre une valeur de filtre existante à un contenu associé

_filters['view_name.field_name'] est une autre variable Liquid acceptée par le paramètre link. Cette variable reprend les valeurs existantes saisies pour un filtre et les transmet à une exploration, un tableau de bord ou un Look associés.

Dans les URL de contenu, vous pouvez voir où les valeurs de filtre sont spécifiées et les remplacer par votre variable _filters['view_name.field_name']. Pour en savoir plus sur les composants d'une URL de requête, consultez le post de la communauté Looker Utiliser des URL et des paramètres de requête.

Voici un exemple de dimension qui utilise la variable _filters['view_name.field_name'] dans son paramètre link pour transmettre une valeur de filtre existante pour un champ appelé users.state :

dimension: name {
  link: {
    label: "Business Pulse By State Dashboard"
    url: "/dashboards/694?State={{ _filters['users.state'] | url_encode }}"
  }
}

Dans cet exemple, si un utilisateur filtre une requête par la dimension users.state, le tableau de bord associé est automatiquement filtré par les mêmes états choisis dans la requête d'origine. Dans cet exemple, l'inclusion du filtre Liquid url_encode convertit les chaînes non sécurisées pour les URL en chaînes encodées en pourcentage. Cela permet de s'assurer que les valeurs de filtre contenant des caractères spéciaux, comme des espaces ou des virgules, peuvent être transmises au tableau de bord associé.

Par exemple, supposons qu'un utilisateur ait filtré une requête par l'État de Californie. Lorsque l'utilisateur clique sur le menu à trois points à côté d'une valeur du champ Nom, le menu Liens affiche un lien vers le tableau de bord Business Pulse par État. Lorsque l'utilisateur cliquera sur ce lien, le tableau de bord Business Pulse by State (Tendances commerciales par État) sera déjà filtré sur l'État de Californie.

Vous pouvez également transmettre des valeurs de filtre aux Looks et aux explorations associés :

dimension: name {
    link: {
      label: "Average Order Profit Look"
      url: "/looks/249?&f[users.state]={{ _filters['users.state'] | url_encode }}"
    }
    link: {
      label: "User Facts Explore Explore"
      url: "/explore/ecommerce/users?fields=users.id,users.name&f[users.state]={{ _filters['users.state'] | url_encode }}"
    }
  }

Vous pouvez transmettre plusieurs filtres en les séparant par &, comme dans les URL suivantes :

dimension: name {
  link: {
    label: "Business Pulse By State Dashboard"
    url: "/dashboards/694?State={{ _filters['users.state'] | url_encode }}&Date={{ _filters['orders.date'] | url_encode }}"
  }
  link: {
    label: "Average Order Profit Look"
    url: "/looks/249?&f[users.state]={{ _filters['users.state'] | url_encode }}&f[orders.date]={{ _filters['orders.date'] | url_encode }}"
  }
}

Pour savoir comment créer des filtres de tableau de bord, consultez les pages de documentation Créer des tableaux de bord LookML et Ajouter et modifier des filtres de tableaux de bord définis par l'utilisateur.

Si votre administrateur Looker a activé la fonctionnalité Analyse visuelle, vous pouvez personnaliser la visualisation affichée dans les calques d'analyse des explorations et des looks à l'aide du paramètre link et des variables Liquid. Les tableaux de bord sont compatibles avec l'analyse visuelle à l'aide du paramètre link sans qu'il soit nécessaire d'activer la fonctionnalité Analyse visuelle.

Voici un exemple de configuration d'une visualisation d'analyse pour un graphique à nuage de points :


  measure: count {
    type: count_distinct
    sql: ${id} ;;
    drill_fields: [created_date, total_sale_price]
    link: {
      label: "Drill as scatter plot"
      url: "
      {% assign vis_config = '{\\"type\\": \\"looker_scatter\\"}' %}
        \{\{ link \}\}&vis_config=\{\{ vis_config | encode_uri \}\}&toggle=dat,pik,vis&limit=5000"
    }
  }

Pour obtenir d'autres exemples de personnalisation des visualisations d'analyse, consultez la page des bonnes pratiques Exploration des données plus efficace.

Éléments à prendre en compte lorsque vous associez du contenu Looker

Dans certains cas, vous devrez peut-être inclure des opérateurs de comparaison de filtres autres que égal à, inclure plusieurs filtres ou échapper les virgules dans les liens vers le contenu Looker. Les sections suivantes fournissent plus d'informations sur ces cas d'utilisation.

Encodage d'URL pour d'autres opérateurs de comparaison

Si vous souhaitez inclure un opérateur de comparaison autre que égal à (=) dans un filtre associé, vous pouvez le faire en encodant l'opérateur en URL.

Par exemple, si vous souhaitez appliquer un filtre order_id à un Look associé pour inclure les valeurs inférieures à (<) au champ order_id associé à la valeur sur laquelle vous cliquez, vous devez encoder partiellement le caractère de l'opérateur (%3C dans ce cas) et l'ajouter à l'URL :

f[orders.order_id]=%3C{{ other_orders.order_id._value }}
Inclure plusieurs filtres

Vous pouvez appliquer plusieurs filtres aux Looks, aux tableaux de bord et aux explorations associés en utilisant une esperluette (&) pour séparer chaque filtre :

dimension: name {
  link: {
    label: "Drill Look"
    url:"/looks/looknumber?&f[users.state]={{ value }}[users.region]={{ users.region._value }}&f[users.age]={{ _filters['users.age'] | url_encode }}"
  }
}
Échapper les virgules

Vous pouvez échapper les virgules dans les valeurs associées à l'aide de la variable filterable_value, alors que vous utiliseriez normalement la variable value.

Le lien suivant permet d'accéder à une exploration qui filtrera les résultats en fonction de la valeur users.city sélectionnée :

dimension: city {
    type: string
    sql: ${TABLE}.city ;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]={{ value }}"
    }
}

Si l'utilisateur clique sur Santa Cruz, CA pour afficher les résultats filtrés par cette ville, le résultat obtenu affichera tous les résultats contenant Santa Cruz ou CA.

Si filterable_value est utilisé à la place de value, la virgule sera échappée :

dimension: city {
    type: string
    sql: ${TABLE}.city ;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]={{ filterable_value }}"
    }
}

L'analyse détaillée renvoie tous les résultats qui contiennent la valeur de chaîne complète Santa Cruz, CA.

Si vous souhaitez coder en dur une valeur de filtre contenant une virgule dans une URL d'analyse, vous pouvez échapper la virgule en encapsulant la valeur entre guillemets doubles, puis en les échappant avec une barre oblique inverse (\) :

dimension: city {
    type: string
    sql: ${TABLE}.city;;
    link: {
        label: "Drill by City"
        url: "/explore/model_name/explore_name?fields=users.email,users.id&f[users.city]=\"Santa Cruz, CA\"&sorts=users.email"
    }
}

Autres ressources

  • Pour obtenir d'autres exemples d'exploration personnalisée avancée, consultez la page des bonnes pratiques Exploration des données plus efficace.
  • Pour obtenir d'autres exemples d'utilisation de {{ value }} dans les liens, consultez la page de documentation Variables Liquid.

Bon à savoir

Lorsqu'une dimension contient un paramètre link qui fait référence à un autre champ, ce champ supplémentaire peut être ajouté au code SQL sous-jacent d'une requête dans laquelle la dimension est utilisée. Si le champ référencé n'est pas présent dans la visualisation de la requête et que la visualisation est un tableau avec des colonnes réorganisées manuellement, l'ordre des colonnes dans certains formats téléchargés peut être affecté.