Benutzerdefinierte Kurzinfos

Sie können die Kurzinfos anpassen, die angezeigt werden, wenn Nutzer den Mauszeiger auf Elemente in Looker-Visualisierungen bewegen. Mit benutzerdefinierten Kurzinfos können Sie mehr Kontext bereitstellen, zusätzliche Messwerte anzeigen und die Informationen anpassen, die Ihren Nutzern präsentiert werden. Mit der Labs-Funktion „Benutzerdefinierte Kurzinfos“ können Sie Kurzinfos im Editor für die Visualisierung von explorativen Daten konfigurieren. Dazu verwenden Sie eine Kombination aus UI-Einstellungen und einem HTML-Editor, der Liquid-Vorlagen unterstützt.

Auf dieser Seite finden Sie eine Anleitung zum Aktivieren und Verwenden der Labs-Funktion „Benutzerdefinierte Kurzinfos“ in Ihrer Looker (Original)-Instanz. Diese Seite enthält die folgenden Abschnitte:

Feedback geben oder Support erhalten

Sie können Feedback geben oder Support anfordern, indem Sie dieses Formular für Probleme mit benutzerdefinierten Looker-Kurzinfos in der Vorschau ausfüllen und einreichen.

Anforderungen an Nutzer und Instanzen

Damit Sie die Labs-Funktion für benutzerdefinierte Kurzinfos aktivieren und verwenden können, müssen die folgenden Anforderungen erfüllt sein:

  • Auf Ihrer Looker (Original)-Instanz muss Looker 26.0 oder höher ausgeführt werden und sie muss von Looker gehostet werden.
  • Sie benötigen die Administratorrolle, um die Labs-Funktion Benutzerdefinierte Kurzinfos zu aktivieren.
  • Wenn Sie benutzerdefinierte Kurzinfos in Explores erstellen möchten, benötigen Sie die Berechtigung explore und Zugriff auf das zugrunde liegende LookML-Modell.

Beschränkungen

Für die Labs-Funktion Benutzerdefinierte Kurzinfos gelten die folgenden Einschränkungen:

  • Benutzerdefinierte Kurzinfos werden nur für Tabellendiagramme, Diagramme mit einem einzelnen Wert und kartesische Diagramme unterstützt. Benutzerdefinierte Kurzinfos werden für Kreis-, Boxplot- und Wasserfalldiagramme nicht unterstützt.
  • Für benutzerdefinierte Kurzinfos kann nur auf Felder verwiesen werden, die in einer Explore-Abfrage enthalten sind.
  • In Kurzinfos kann nur derselbe Detaillierungsgrad wie in einem bestimmten Feld angezeigt werden. Wenn Nutzer detailliertere Daten als im Kurzinfo-Fenster sehen möchten, müssen sie die Funktion Aufschlüsseln verwenden.
  • Benutzerdefinierte Kurzinfos werden auf Visualisierungsebene gespeichert. Sie können nicht auf der Ebene „Erkunden“ gespeichert werden.
  • Wenn Sie ein Feld aus einer Explore-Abfrage mit einem benutzerdefinierten Kurzinfo entfernen, kann ein Nutzer diese Kurzinfo weiterhin sehen, wenn die Explore-Abfrage für ihn freigegeben ist und er das Feld wieder zur Explore-Abfrage hinzufügt.
  • Der gerenderte HTML-Code in benutzerdefinierten Kurzinfos unterliegt den HTML-Bereinigungsregeln von Looker.
  • Möglicherweise werden nicht alle Liquid-Variablen für benutzerdefinierte Kurzinfos unterstützt.
  • Durch Anpassungen von Kurzinfos wird jedes Design überschrieben, das entweder auf ein internes (nicht eingebettetes) Dashboard oder ein eingebettetes Dashboard angewendet wird.

Benutzerdefinierte Kurzinfos aktivieren

Die Labs-Funktion für benutzerdefinierte Kurzinfos ist standardmäßig aktiviert.

Wenn die Labs-Funktion Benutzerdefinierte Kurzinfos zuvor deaktiviert wurde, können Looker-Administratoren sie mit den folgenden Schritten aktivieren:

  1. Klicken Sie in Looker im Hauptnavigationsmenü auf Admin.
  2. Klicken Sie im Bereich Allgemein auf die Option Labs, um die Seite Labs zu öffnen.
  3. Aktivieren Sie die Labs-Funktion, indem Sie den Schalter Benutzerdefinierte Kurzinfos auf „Ein“ stellen.

Benutzerdefinierte Kurzinfos verwenden

Wenn Sie die entsprechenden Berechtigungen haben, können Sie die Kurzinfo für eine Reihe in Ihrer Explore-Visualisierung anpassen. So passen Sie den Kurzinfo-Text an:

  1. Öffnen oder erstellen Sie eine Explore-Abfrage und wählen Sie einen unterstützten Visualisierungstyp aus.
  2. Klicken Sie auf dem Tab Visualisierung unter „Erkunden“ auf Bearbeiten, um den Visualisierungseditor zu öffnen.
  3. Wählen Sie den Tab Serien aus.
  4. Suchen Sie im Bereich Anpassungen nach der Reihe, der Sie die Kurzinfo hinzufügen möchten. Wenn es mehrere Reihen gibt, maximieren Sie die Reihe, der Sie eine Kurzinfo hinzufügen möchten.
  5. Aktivieren Sie den Schalter Benutzerdefinierter Kurzinfo-Text, um die Funktion für benutzerdefinierte Kurzinfo-Texte für die jeweilige Reihe zu aktivieren.
  6. Im Bereich Benutzerdefinierte Kurzinfo können Sie das grundlegende Erscheinungsbild der Kurzinfo mit den folgenden Optionen anpassen:
    • Schriftgröße: Legt die Schriftgröße der Quickinfo fest.
    • Schriftfamilie: Legt die Schriftfamilie der Quickinfo-Schriftart fest.
    • Hintergrundfarbe des Kurzinfos: Legt die Hintergrundfarbe des Kurzinfos fest.
    • Schriftfarbe: Legt die Schriftfarbe des Tooltips fest.
    • Rahmenradius: Legt fest, wie stark die Ecken des Tooltips abgerundet werden. Je höher die Zahl, desto runder die Tooltip-Kanten.
    • Rahmen mit Schatten: Legt den Schatten des Tooltips fest.
    • Textausrichtung: Hiermit wird die Ausrichtung der Quickinfo-Schriftart festgelegt.
  7. Zusätzlich oder alternativ zu den vorherigen Optionen können Sie erweiterte Formatierungsoptionen anwenden, indem Sie auf Tooltip-Inhalt bearbeiten klicken, um den HTML-Editor Tooltip-Inhalt bearbeiten zu öffnen.

  8. Im Editor Tooltip-Inhalt bearbeiten können Sie HTML und Liquid-Variablen verwenden, um den Tooltip zu strukturieren und mit Daten zu füllen.

    • Verwenden Sie Standard-HTML-Tags, um die Quickinfo-Inhalte zu formatieren (z. B. <div>, <span>, <strong>, <table>,<ul>, <ol>). Das gerenderte HTML unterliegt den HTML-Bereinigungsregeln von Looker.
    • Möglicherweise werden nicht alle Liquid-Variablen für benutzerdefinierte Kurzinfos unterstützt.

  9. Während Sie den Inhalt des benutzerdefinierten Kurzinfos bearbeiten, können Sie eine Vorschau des Kurzinfos aufrufen, indem Sie auf Vorschau klicken (oder die Tastenkombination „Befehlstaste + Eingabetaste“ für Mac oder „Strg + Eingabetaste“ für PC verwenden) und den Mauszeiger auf die Datenpunkte im Vorschaufenster der Visualisierung bewegen.

  10. Klicken Sie im HTML-Editor auf Speichern und speichern Sie dann den Explore-Bericht als Look oder als Dashboard-Kachel, um die Änderungen beizubehalten.

Beispiele

Die folgenden Beispiele veranschaulichen Anwendungsfälle für verschiedene Stufen der Anpassung von Kurzinfos:

Benutzerdefinierte Kurzinfo mit mehreren Messwertwerten

Benutzerdefinierte Kurzinfos können hilfreich sein, wenn Sie Nutzern mehr Kontext zu einem Datenpunkt in einer Visualisierung geben möchten. In einem Diagramm mit einem einzelnen Wert wird beispielsweise nur der Wert einer Kennzahl angezeigt. Mit einer benutzerdefinierten Kurzinfo können Sie mehr Daten präsentieren und Ihren Nutzern mehr Kontext zu den Daten im Diagramm bieten.

In diesem Beispiel wird in einem Einzelwertdiagramm mit dem Titel „Anzahl der Bestellungen im Jahr 2025“ der Wert für Anzahl der Bestellungen für das Land der Nutzer „USA“ angezeigt. Das Diagramm basiert auf einer Explore-Abfrage, die auch Anzahl der Artikel in Bestellungen enthält. Der Wert für Anzahl der Bestellpositionen wird jedoch nicht im Diagramm angezeigt.

Der folgende HTML-Code wird im Editor Tooltip-Inhalt bearbeiten für die Reihe Anzahl der Bestellungen eingegeben. Damit wird der Inhalt so festgelegt, dass der Wert Anzahl der Artikel in der Bestellung im Kurzinfo enthalten ist:

<div style="padding: 5px; font-family: Arial, sans-serif; font-size: 13px;">
  <div>
    <strong>Order Items Count:</strong> {{ order_items.count }}
  </div>
  <div>
    <strong>Orders Count:</strong> {{ orders.count }}
  </div>
</div>

In der Kurzinfo für das Einzelwertdiagramm „Anzahl der Bestellungen“ wird der Wert „Anzahl der Bestellartikel“ von 54.340 € und der Wert „Anzahl der Bestellungen“ von 39.189 angezeigt.

Nutzer können die Werte für beide Felder, Anzahl der Bestellungen und Anzahl der Bestellartikel, sehen und erhalten so mehr Kontext für die Daten, die im Diagramm angezeigt werden.

Benutzerdefinierte Kurzinfo mit ausgeblendeten Werten in Tabellenform

Wie auf dieser Seite unter Einschränkungen beschrieben, können benutzerdefinierte Kurzinfos nur auf Felder verweisen, die in einer Explore-Abfrage enthalten sind. Möglicherweise möchten Sie jedoch nicht alle Explore-Felder in einem Diagramm darstellen. Mit einem benutzerdefinierten Kurzinfo-Fenster können Sie Nutzern Daten aus Feldern präsentieren, die in Visualisierungen ausgeblendet sind, ohne sie in ein Diagramm einzufügen.

In diesem Beispiel enthält eine Explore-Datentabelle die Messwerte Anzahl der Bestellungen und Anzahl der Bestellartikel, gruppiert nach den Dimensionen Bundesstaat der Nutzer und Bestellstatus. Der Entwickler möchte Nutzern eine kleine Tabelle präsentieren und blendet die Felder Bestellstatus und Anzahl der Bestellpositionen aus dem Tabellendiagramm aus. Der Entwickler möchte jedoch, dass Nutzer die Werte Orders Status und Order Items Count sehen, die mit einer bestimmten Orders Count verknüpft sind.

Der folgende HTML-Code wird im Editor Tooltip-Inhalte bearbeiten für die Reihe Anzahl der Bestellungen eingegeben. Damit wird festgelegt, dass die Werte für Bestellstatus und Anzahl der Artikel in der Bestellung im Tooltip als Tabelle dargestellt werden:

<div>
    <div>
        <table border="1">
          <!-- Table Body -->
          <tbody>
            <!-- Row 1 -->
            <tr>
              <td>
                <strong>Order status</strong>
              </td>
              <td>
                {{ orders.status }}
              </td>
            </tr>
            <!-- Row 2 -->
            <tr>
              <td>
                <strong>State</strong>
              </td>
              <td>
                {{ users.state }}
              </td>
            </tr>
            <!-- Row 3 -->
            <tr>
              <td>
                <strong>Count of orders</strong>
              </td>
              <td>
                {{ orders.count }}
              </td>
            </tr>
            <!-- Row 4 -->
            <tr>
              <td>
                <strong>Count of order items</strong>
              </td>
              <td>
                {{ order_items.count }}
              </td>
            </tr>
          </tbody>
        </table>
      </div>
  </div>

In einem Kurzinfo-Fenster für den Wert „Anzahl der Bestellungen“ in einem Tabellendiagramm werden die Werte für „Bundesstaat“, „Bestellstatus“, „Anzahl der Bestellungen“ und „Anzahl der Bestellartikel“ in einer zweispaltigen Tabelle angezeigt.

Nutzer können alle Daten der Explore-Abfrage sehen, ohne die zusätzlichen Felder, die im Tabellendiagramm angezeigt werden.

Benutzerdefinierter Kurzinfo-Text mit gängigen Liquid-Funktionen

Benutzerdefinierte Kurzinfos unterstützen gängige Liquid-Funktionen wie Piping und Downcast-Anweisungen. In diesem Beispiel wird ein Säulendiagramm mit der Anzahl der Bestellungen angezeigt, gruppiert nach Bestellstatus. Der Entwickler möchte das Kurzinfo so formatieren, dass Nutzer den Unterschied zwischen der Anzahl der Bestellungen für den Bestellstatus „ABGEBROCHEN“ und den Bestellstatus „ABGESCHLOSSEN“ schnell erkennen können.

Der folgende HTML- und Liquid-Code wird im Editor Tooltip-Inhalt bearbeiten für die Reihe Anzahl der Bestellungen eingegeben. Damit wird festgelegt, dass der Tooltip-Wert für Bestellungen mit dem Status „ABGEBROCHEN“ rot und für Bestellungen mit dem Status „ABGESCHLOSSEN“ grün angezeigt wird. Im Code werden eine Variablenausgabe und Piping verwendet, um die Richtigkeit des Strings zu gewährleisten und die angegebene bedingte Formatierung anzuwenden:

{% assign my_variable = orders.status | downcase | strip %}
{% if my_variable == "completed" %}
  <span style="color:green">{{orders.count}}</span>
{% else %}
  <span style="color:red">{{orders.count}}</span>
{% endif %}

Der Wert Anzahl der Bestellungen für die Spalte Bestellstatus „ABGESCHLOSSEN“ wird in der Kurzinfo in grüner Schrift angezeigt.

In einem Kurzinfo-Fenster wird der Wert „Anzahl der Bestellungen“ in der Spalte „Status der ABGESCHLOSSENEN Bestellungen“ grün angezeigt.

Der Wert Anzahl der Bestellungen für die Spalte Bestellstatus „ABGEBROCHEN“ wird in der Kurzinfo in rotem Text angezeigt.

In einem Kurzinfo-Fenster wird der Wert „Anzahl der Bestellungen“ in der Spalte „Status der ABGESCHLOSSENEN Bestellungen“ grün angezeigt.

Nutzer können im Säulendiagramm schnell zwischen stornierten und abgeschlossenen Bestellungen unterscheiden.