Link

Nutzung

view: view_name {
  dimension: field_name {
    link: {
      label: "desired label name"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more links
  }
}
Hierarchie
view
Feldtyp
link
Mögliche Feldtypen
Dimension, Messung

Akzeptiert
Verschiedene Parameter

Definition

Mit dem Parameter link können Sie Weblinks zu Dimensionen und Messungen hinzufügen und so Nutzern ermöglichen, entsprechende Inhalte direkt in Looker aufzurufen. Die Form eines link-Parameters ist:

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

Der Parameter link hat mehrere untergeordnete Parameter:

  • label ist der Name des Links, der Nutzern angezeigt werden soll.
  • url ist die URL, zu der der Link führen soll. Sie können Liquid-Variablen verwenden, um die Links dynamisch zu gestalten. Weitere Informationen finden Sie im Abschnitt Liquid-Variablen mit link verwenden auf dieser Seite.
  • icon_url ist eine URL, die für den Browser des Nutzers zugänglich ist und eine Bilddatei enthält. So können Nutzer auf einen Blick erkennen, wohin der Link führt. Der Parameter icon_url ist nicht erforderlich, wenn Sie kein Symbol verwenden möchten. Wenn Sie Unternehmenslogos benötigen, können Sie in der Google Suche nach dem Muster http://www.google.com/s2/favicons?domain=[company website of interest] suchen, um Bilder im .ico-Format zu finden.

Beispiel

Ein E‑Commerce-Unternehmen möchte, dass Mitarbeiter den Lagersupport direkt über Looker-Inhalte kontaktieren können, z. B. über einen Look mit ausstehenden Bestellungen aus dem letzten Monat. Der Look enthält Bestell-IDs und die Nutzer-ID des Kunden, der mit jeder Bestellung verknüpft ist.

Sie können der Dimension Bestell-ID einen Link hinzufügen, um diese Aktion für den Nutzer verfügbar zu machen, der den Look ansieht:


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

Im Look wird der Link Lagersupport kontaktieren unter den Optionen im Linkmenü angezeigt. Das Menü wird aufgerufen, indem Sie auf das Dreipunkt-Menü für einen der Werte des Felds Bestell-ID klicken.

Wenn der Nutzer auf den Linknamen klickt, wird er zum verknüpften Inhalt weitergeleitet. In diesem Fall ist das ein neuer Tab mit einem leeren E‑Mail-Entwurf, der an die angegebene E‑Mail-Adresse adressiert ist.

Wenn ein Nutzer auf einen Link klickt, wird er in Looker entweder in einem neuen Browsertab oder im selben Tab (oder Iframe für eingebettete Abfragen) geöffnet:

  • Absolute Links wie https://example.looker.com werden in einem neuen Browsertab geöffnet.
  • Relative Links wie /dashboards/456 werden im selben Browsertab oder Iframe geöffnet. Nachdem der Link geöffnet wurde, kann der Nutzer im Browser auf Zurück klicken, um zur ursprünglichen Abfrage zurückzukehren.

Ein Nutzer benötigt entweder die explore oder see_drill_overlay Berechtigung, um auf Links zuzugreifen.

Der link Parameter unterstützt Liquid-Variablen, um Inhalte noch interaktiver zu gestalten, bis hin zur Zeilen- und Werteebene. LookML unterstützt zwei Arten von Liquid-Tags: Tags für die Werteingabe {{ }} und Tags für die bedingte Logik {% %}.

Von den beiden wird {{ }} in Verbindung mit den value und _filters['view_name.field_name'] Liquid-Variablen am häufigsten mit link verwendet. Das liegt daran, dass {{ }} Tags Werte direkt an der Stelle eingeben, an der sie platziert sind, z. B. in einer URL.

In den Beispielen auf dieser Seite wird gezeigt, wie Sie Liquid {{ }} Tags mit den value und _filters['view_name.field_name'] Variablen verwenden, um Inhalte mit link interaktiv zu gestalten.

Mit externen Inhalten verknüpfen

Angenommen, Sie haben eine Dimension artist_name und möchten, dass der Nutzer direkt in Looker eine Google-Suche nach diesem Künstler ausführen kann. Mit der value Liquid-Variablen können Sie diese Option einer Dimension wie folgt hinzufügen:

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

Wenn ein Nutzer auf das Dreipunkt-Menü für einen Wert des Felds Künstlername klickt, wird in Looker das Menü Links angezeigt, das den im LookML-Beispiel erstellten Link enthält. Der Link öffnet einen neuen Browsertab mit einer Google-Suche nach dem ausgewählten Künstler. Der ausgewählte Künstlername wird in die URL eingefügt, an der sich {{ value }} befindet.

Dieses Muster kann für andere externe Websites wiederholt werden, auf die der Browser eines Nutzers Zugriff hat, z. B. Ticketverwaltungssysteme, Kundenverwaltungssysteme und andere geschäftliche Tools, um die Navigation zwischen Webanwendungen zu erleichtern.

Mit Inhalten in Looker verknüpfen

Neben externen Websites können Sie mit dem Parameter link Nutzer auch zu anderen relevanten Looker-Explores, -Looks oder -Dashboards weiterleiten, um die Aufschlüsselung anzupassen. Sie können dieselben Beispiele auch auf Links im LookML html Parameter für Felder anwenden.

Zuerst müssen Sie die URL eines vorhandenen Explores, Looks oder Dashboards abrufen, mit dem Sie eine Verknüpfung erstellen möchten. Anschließend können Sie bestimmte Elemente der URL, z. B. Filterwerte und ‑namen, durch {{ }}-Tags ersetzen, die value und _filters['view_name.field_name'] Variablen enthalten. Die Variablen fügen die vom Nutzer ausgewählten Werte in die URL-Elemente ein, die sie ersetzen. Die grundlegende Struktur von Inhalts-URLs ist wie folgt:

  • Explore: /explore/YOUR_MODEL_NAME/YOUR_EXPLORE_NAME?fields=view_name.field_name1,view_name.field_name2...
  • Look: /looks/YOUR_LOOK_NUMBER

  • Benutzerdefiniertes Dashboard: /dashboards/YOUR_DASHBOARD_NUMBER?FILTER_NAME_1=VALUE&FILTER_NAME_2=VALUE

    • Sie können die URL für ein vorhandenes Dashboard abrufen, indem Sie die Browser-URL auf der Dashboard-Seite kopieren.

  • LookML-Dashboard: /dashboards/YOUR_MODEL::YOUR_DASHBOARD

    • Sie können die URL für ein vorhandenes LookML-Dashboard abrufen, indem Sie die Browser-URL auf der Dashboard-Seite kopieren.

Dashboardfilter für benutzerdefinierte und LookML-Dashboards werden in URLs als filter_name angezeigt, wobei filter_name der Name ist, der dem Filter auf dem Dashboard gegeben wurde. Ein Beispiel finden Sie im Abschnitt Vorhandenen Filterwert an verknüpfte Inhalte übergeben.

Elemente von URLs wie Filterwerte und ‑namen werden URL-codiert mit Sonderzeichen, z. B. ? für den Beginn eines Abfragestrings, & zum Trennen von Elementen und %20 für Leerzeichen. Ein Beispiel finden Sie im Abschnitt URL-Codierung für andere Vergleichsoperatoren.

Sobald Sie die URL des Inhalts haben, mit dem Sie eine Verknüpfung erstellen möchten, können Sie mit Liquid den Wert eines Felds in ein beliebiges Element der URL einfügen. Verwenden Sie dazu die value oder _filters['view_name.field_name'] Variablen und {{ }} Tags. Weitere Informationen zu den Teilen einer Abfrage-URL finden Sie im Looker Community-Beitrag URLs und Abfrageparameter verwenden.

Wir haben eine Dimension namens Ort. Nutzer sollen auf ein anderes vorhandenes Explore mit Ortsmesswerten und einem Ort-Filter zugreifen können. Das verknüpfte Explore soll nach dem vom Nutzer ausgewählten Ort gefiltert werden.

Gehen Sie dazu folgendermaßen vor:

  1. Rufen Sie die URL des vorhandenen Explores ab, zu dem Sie eine Aufschlüsselung durchführen möchten.
  2. Fügen Sie der Dimension Ort einen link-Parameter hinzu:
  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"
  }
  }

Hier wurde die URL zur besseren Übersicht auf limit=500 gekürzt, wodurch die Explore-Ergebnisse auf 500 Zeilen beschränkt werden. Sie können bei Bedarf den Rest der URL einfügen, der in der Regel die URL-Codierung der Visualisierungseinstellungen enthält.

  1. Fügen Sie das Liquid {{ value }} Tag und die Variable an der Stelle ein, an der Sie den Wert in die URL einfügen möchten. In diesem Fall möchten wir den Wert an der Stelle einfügen, an der sich das Filterelement f[users.city]= im URL-String für das Explore befindet, das nach dem vom Nutzer ausgewählten Ort gefiltert werden soll:
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"
  }
}

In der Dimension Ort wird dann ein Dreipunkt-Linkmenü mit der Option Explore „Ortsmesswerte“ angezeigt.

Wenn ein Nutzer auf den Link klickt, wird er zum Explore „Ortsmesswerte“ weitergeleitet, das nach dem ausgewählten Ort gefiltert ist.

Sie können auch vorhandene Filterwerte beibehalten, wenn Sie eine Verknüpfung zu Looker-Inhalten erstellen, wie im folgenden Beispiel beschrieben.

Beispiel: Vorhandenen Filterwert an verknüpfte Inhalte übergeben

Eine weitere Liquid-Variable, die vom link Parameter unterstützt wird, ist _filters['view_name.field_name']. Diese Variable übernimmt die vorhandenen Werte, die für einen Filter eingegeben wurden, und übergibt sie an ein verknüpftes Explore, Dashboard oder Look.

In Inhalts-URLs können Sie sehen, wo die Filterwerte angegeben sind, und sie durch Ihre _filters['view_name.field_name'] Variable ersetzen. Informationen zu den Teilen einer Abfrage-URL finden Sie im Looker Community-Beitrag URLs und Abfrageparameter verwenden.

Hier ein Beispiel für eine Dimension, die die Variable _filters['view_name.field_name'] in ihrem Parameter link verwendet, um einen vorhandenen Filterwert für ein Feld namens users.state zu übergeben:

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

Wenn ein Nutzer in diesem Beispiel eine Abfrage nach der Dimension users.state filtert, wird das verknüpfte Dashboard automatisch nach denselben Bundesländern/Bundesstaaten gefiltert, die in der ursprünglichen Abfrage ausgewählt wurden. Durch die Einbeziehung des Liquid-Filters url_encode werden in diesem Beispiel URL-unsichere Strings in prozentcodierte Strings umgewandelt. So können Filterwerte, die Sonderzeichen wie Leerzeichen oder Kommas enthalten, an das verknüpfte Dashboard übergeben werden.

Angenommen, ein Nutzer hat eine Abfrage nach dem Bundesstaat/Bundesland „Kalifornien“ gefiltert. Wenn der Nutzer auf das Dreipunkt-Menü neben einem Wert für das Feld Name klickt, wird im Menü Links ein Link zum Dashboard Business Pulse nach Bundesstaat/Bundesland angezeigt. Wenn der Nutzer auf diesen Link klickt, ist das Dashboard Business Pulse nach Bundesstaat/Bundesland bereits nach dem Bundesstaat/Bundesland „Kalifornien“ gefiltert.

Dies funktioniert auch, um Filterwerte an verknüpfte Looks und Explores zu übergeben:

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 }}"
    }
  }

Sie können mehrere Filter übergeben, indem Sie & zwischen ihnen platzieren, z. B. in den folgenden URLs:

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 }}"
  }
}

Informationen zum Erstellen von Dashboardfiltern finden Sie auf den Dokumentationsseiten LookML-Dashboards erstellen und Benutzerdefinierte Dashboardfilter hinzufügen und bearbeiten.

Wenn Ihr Looker-Administrator die Funktion Visuelle Aufschlüsselung aktiviert hat, können Sie die Visualisierung anpassen, die in den Aufschlüsselungs-Overlays von Explores und Looks angezeigt wird. Verwenden Sie dazu den Parameter link und Liquid-Variablen. Dashboards unterstützen die visuelle Aufschlüsselung mit dem link Parameter, ohne dass die Funktion Visuelle Aufschlüsselung aktiviert werden muss.

Hier ein Beispiel für die Festlegung einer Aufschlüsselungsvisualisierung auf ein Streudiagramm:


  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"
    }
  }

Weitere Beispiele für das Anpassen von Aufschlüsselungsvisualisierungen finden Sie auf der Best Practices-Seite Leistungsstärkere Datenaufschlüsselung.

Beim Verknüpfen mit Looker-Inhalten zu berücksichtigende Punkte

Es kann vorkommen, dass Sie neben gleich auch andere Vergleichsoperatoren für Filter verwenden, mehrere Filter einbeziehen oder Kommas in Links zu Looker-Inhalten maskieren müssen. In den folgenden Abschnitten finden Sie weitere Informationen zu diesen Anwendungsfällen.

URL-Codierung anderer Vergleichsoperatoren

Wenn Sie in einem verknüpften Filter einen anderen Vergleichsoperator als gleich (=) verwenden möchten, können Sie den Operator URL-codieren.

Wenn Sie beispielsweise einen order_id-Filter für einen verknüpften Look verwenden möchten, der Werte enthält, die kleiner als (<) das Feld order_id sind, das mit dem Wert verknüpft ist, auf den Sie klicken, codieren Sie das Operatorsymbol teilweise (%3C in diesem Fall) und fügen Sie es der URL hinzu:

f[orders.order_id]=%3C{{ other_orders.order_id._value }}
Mehrere Filter einbeziehen

Auf verknüpfte Looks, Dashboards und Explores können mehrere Filter angewendet werden. Trennen Sie die Filter dazu mit einem kaufmännischen Und (&):

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 }}"
  }
}
Kommas maskieren

Sie können Kommas in verknüpften Werten mit der Variablen filterable_value maskieren, wo Sie normalerweise die Variable value verwenden würden.

Der folgende Link führt zu einem Explore, das die Ergebnisse nach dem ausgewählten Wert users.city filtert:

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 }}"
    }
}

Wenn der Nutzer auf Santa Cruz, CA klickt, um eine Aufschlüsselung zu den nach dieser Stadt gefilterten Ergebnissen durchzuführen, werden alle Ergebnisse zurückgegeben, die entweder Santa Cruz oder CA enthalten.

Wenn filterable_value anstelle von value verwendet wird, wird das Komma maskiert:

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 }}"
    }
}

Die resultierende Aufschlüsselung gibt alle Ergebnisse zurück, die den gesamten Stringwert Santa Cruz, CA enthalten.

Wenn Sie einen Filterwert, der ein Komma enthält, in einer Aufschlüsselungs-URL fest codieren möchten, können Sie das Komma maskieren, indem Sie den Wert in doppelte Anführungszeichen setzen und diese dann mit einem umgekehrten Schrägstrich (\) maskieren:

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"
    }
}

Zusätzliche Ressourcen

Wichtige Punkte

Wenn eine Dimension einen link-Parameter enthält, der auf ein anderes Feld verweist, kann dieses zusätzliche Feld dem zugrunde liegenden SQL-Code einer Abfrage hinzugefügt werden, in der die Dimension verwendet wird. Wenn das referenzierte Feld nicht in der Visualisierung der Abfrage vorhanden ist und die Visualisierung ein Tabellendiagramm mit manuell neu angeordneten Spalten ist, kann sich die Spaltenreihenfolge in einigen heruntergeladenen Formaten ändern.