Visualisierungen mit dem Diagramm-Konfigurationseditor anpassen

Mit dem Editor für Diagrammkonfigurationen können Sie Formatierungsoptionen für Looker-Visualisierungen anpassen, die die HighCharts API verwenden. Dazu gehören die meisten kartesischen Diagramme, z. B. Säulendiagramme, Balkendiagramme und Liniendiagramme.

Wenn die Gemini in Looker-Funktionen aktiviert sind, können Sie mit dem Visualisierungsassistenten JSON-Formatierungsoptionen aus textbasierten Prompts generieren, um die Anpassung von Looker-Visualisierungen zu beschleunigen.

Vorbereitung

Für den Zugriff auf den Editor für Diagrammkonfigurationen benötigen Sie die can_override_vis_config Berechtigung.

Visualisierung anpassen

So passen Sie eine Visualisierung mit dem Editor für Diagrammkonfigurationen an:

  1. Rufen Sie eine Visualisierung in einem Explore auf oder bearbeiten Sie eine Visualisierung in einem Look oder Dashboard.
  2. Öffnen Sie das Menü Bearbeiten in der Visualisierung.

  3. Klicken Sie auf dem Tab Diagramm auf die Schaltfläche Diagrammkonfiguration bearbeiten. Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.

    • Der Bereich Diagrammkonfiguration (Quelle) enthält das ursprüngliche JSON Ihrer Visualisierung und kann nicht bearbeitet werden.

    • Der Bereich Diagrammkonfiguration (Überschreibung) enthält das JSON, das das Quell-JSON überschreiben soll. Wenn Sie das Dialogfeld Diagrammkonfiguration bearbeiten zum ersten Mal öffnen, füllt Looker den Bereich mit Standard-JSON aus. Sie können dieses JSON verwenden oder löschen und ein beliebiges gültiges HighCharts-JSON eingeben.

  4. Wählen Sie den Bereich Diagrammkonfiguration (Überschreibung) aus und geben Sie gültiges HighCharts-JSON ein. Die neuen Werte überschreiben alle Werte im Bereich Diagrammkonfiguration (Quelle).

    • Beispiele für gültiges HighCharts-JSON finden Sie im Abschnitt Examples.
    • Looker akzeptiert alle gültigen JSON-Werte. Funktionen, Datumsangaben oder nicht definierte Werte werden nicht akzeptiert.

  5. Klicken Sie auf <> (Code formatieren), damit Looker Ihr JSON richtig formatieren kann.

  6. Klicken Sie auf Vorschau , um Ihre Änderungen zu testen.

  7. Klicken Sie auf Übernehmen , um die Änderungen zu übernehmen. Die Visualisierung wird mit den benutzerdefinierten JSON-Werten angezeigt.

Nachdem Sie die Visualisierung angepasst haben, können Sie sie speichern. Wenn Sie die Visualisierung in einem Explore aufgerufen haben, speichern Sie das Explore. Wenn Sie einen Look oder ein Dashboard bearbeitet haben, klicken Sie auf Speichern.

Wenn Sie versuchen, eine Vorschau von Code mit ungültigem JSON aufzurufen, wird in Looker die Fehlermeldung Invalid JSON detected angezeigt. Sie können ungültiges JSON mit der Code automatisch korrigieren Option unten im Bereich Diagrammkonfiguration (Überschreibung) bereinigen.

Wenn Sie die Standardoptionen für die Visualisierung bearbeiten möchten, entfernen Sie zuerst alle Änderungen, die Sie im Editor für Diagrammkonfigurationen vorgenommen haben, und ersetzen Sie sie später. Gehen Sie dazu so vor:

  1. Klicken Sie auf dem Tab Diagramm auf die Schaltfläche Diagrammkonfiguration bearbeiten. Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.
  2. Kopieren Sie den Text im Bereich Diagrammkonfiguration (Überschreibung).
  3. Klicken Sie auf die Schaltfläche Diagrammüberschreibungen löschen , um alle Änderungen zu löschen.
  4. Klicken Sie auf Übernehmen.
  5. Bearbeiten Sie die Visualisierung mit den Standardoptionen für die Visualisierung.
  6. Klicken Sie auf dem Tab Diagramm auf die Schaltfläche Diagrammkonfiguration bearbeiten. Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.
  7. Geben Sie gültiges HighCharts-JSON in den Bereich Diagrammkonfiguration (Überschreibung) ein. Sie können den in Schritt 2 kopierten Text als Vorlage verwenden. Testen Sie die Änderungen aber mit der Schaltfläche Vorschau, um Konflikte zu vermeiden.
  8. Klicken Sie auf Übernehmen.

Bedingte Formatierung mit series formatters

Der Editor für Diagrammkonfigurationen akzeptiert die meisten gültigen HighCharts-JSON-Daten. Außerdem wird das Attribut series formatters akzeptiert, das nur in Looker vorhanden ist. Jede Reihe kann mehrere Formatierer haben, um verschiedene Stilregeln zu kombinieren.

Das Attribut series formatters akzeptiert zwei Attribute: select und style.

  • Geben Sie im Attribut select einen logischen Ausdruck ein, um anzugeben, welche Datenwerte formatiert werden sollen.
  • Geben Sie im Attribut style JSON ein, um anzugeben, wie die Datenwerte formatiert werden sollen.

Mit dem folgenden JSON-Code wird beispielsweise jeder Datenwert orange gefärbt, wenn er größer oder gleich 380 ist:

{
  series: [{
    formatters: [{
      select: 'value >= 380',
      style: {
        color: 'orange'
      }
    }]
  }]
}

In den folgenden Abschnitten werden die möglichen Werte der Attribute select und style genauer beschrieben.

Das Attribut select

Sie können die folgenden Werte in einem select-Ausdruck verwenden:

  • value: Diese Variable gibt den Wert der Reihe zurück. Sie können diesen Wert in Vergleichen verwenden, wie in den folgenden Beispielen:
  • max: Verwenden Sie select: max, um den Reihenwert mit dem Höchstwert auszuwählen.
  • min: Verwenden Sie select: min, um den Reihenwert mit dem Mindestwert auszuwählen.
  • percent_rank: Diese Variable wählt den Reihenwert mit einem bestimmten Perzentil aus. Sie können beispielsweise select: percent_rank >= 0.9 verwenden, um Reihenwerte im 90. Perzentil auszuwählen.
  • name: Diese Variable gibt den Dimensionswert der Reihe zurück. Wenn Sie beispielsweise ein Diagramm mit den Bestellungen „Verkauft“, „Storniert“ und „Zurückgegeben“ haben, können Sie select: name = Sold verwenden, um die Reihe auszuwählen, in der der Dimensionswert „Verkauft“ ist.
  • AND/OR: Use AND and OR to combine multiple logical expressions.

Informationen zur Implementierung dieser Ausdrücke im Editor für Diagrammkonfigurationen finden Sie im Beispiel Höchst-, Mindest- und Perzentilwerte farblich hervorheben.

Das Attribut style

Mit dem Attribut style können Sie Stile anwenden, die von HighCharts unterstützt werden. Sie können beispielsweise Reihenwerte mit style.color farblich hervorheben, Reihenränder mit style.borderColor farblich hervorheben und die Rahmenbreite der Reihen mit style.borderWidth festlegen. Eine umfassendere Liste der Stiloptionen finden Sie unter den Highcharts-Optionen für series.column.data.

Verwenden Sie für Liniendiagramme style.marker.fillColor und style.marker.lineColor anstelle von style.color. Eine umfassendere Liste der Stiloptionen für Linien finden Sie unter den Highcharts-Optionen für series.line.data.marker.

Informationen zur Implementierung der Farbformatierung im Editor für Diagrammkonfigurationen finden Sie im Beispiel Höchst-, Mindest- und Perzentilwerte farblich hervorheben.

Feldmetadaten

Über das Drop-down-Menü Feldmetadaten können Sie den Reihennamen für ein beliebiges Feld in Ihrer Visualisierung kopieren. Sie können diesen Reihennamen mit dem Attribut series formatters verwenden, um Werte aus verschiedenen Reihen zu vergleichen. Ein Beispiel finden Sie im Abschnitt Reihen im Vergleich zu anderen Reihenwerten farblich hervorheben.

Beispiele

In den folgenden Abschnitten finden Sie Beispiele für einige gängige Anwendungsfälle für den Editor für Diagrammkonfigurationen. Eine vollständige Liste der Attribute, die Sie bearbeiten können, finden Sie in der HighCharts API-Dokumentation.

Hintergrundfarbe und Farbe des Achsentexts ändern

Verwenden Sie das chart.backgroundColor Attribut, um die Hintergrundfarbe einer Visualisierung zu ändern.

Verwenden Sie die folgenden Attribute, um die Textfarbe der Achsen in einer Visualisierung zu ändern:

Mit dem folgenden HighCharts-JSON wird die Hintergrundfarbe der Visualisierung in Lila und der Text der Achsentitel und ‑Labels in Weiß geändert.

{
  chart: {
    backgroundColor: "purple"
  },

  xAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  },

  yAxis: {
    labels: {
      style: {
        color: "white"
      }
    },
    title: {
      style: {
        color: "white"
      }
    }
  }
}

Farbe der Tooltips anpassen

Verwenden Sie die folgenden Attribute, um die Farbe des Tooltips anzupassen:

Mit dem folgenden HighCharts-JSON wird die Hintergrundfarbe des Tooltips in Cyan und die Farbe des Tooltip-Texts in Schwarz geändert.

{
  tooltip: {
    backgroundColor: "cyan",
    style: {
      color: "black"
    }
  }
}

Tooltip-Inhalt und ‑Stile anpassen

Verwenden Sie die folgenden Attribute, um den Inhalt des Tooltips anzupassen:

Mit dem folgenden HighCharts-JSON wird das Tooltip-Format so geändert, dass der Wert der X-Achse oben im Tooltip in einer größeren Schriftart angezeigt wird, gefolgt von einer Liste aller Reihenwerte an diesem Punkt.

In diesem Beispiel werden die folgenden HighCharts-Funktionen und ‑Variablen verwendet:

  • {key} ist eine Variable, die den Wert der X-Achse des ausgewählten Punkts zurückgibt. In diesem Beispiel sind das Monat und Jahr.
  • {#each points}{/each} ist eine Funktion, die den eingeschlossenen Code für jede Reihe im Diagramm wiederholt.
  • {series.name} ist eine Variable, die den Namen der Reihe zurückgibt.
  • {y:.2f} ist eine Variable, die den Wert der Y-Achse des ausgewählten Punkts zurückgibt, gerundet auf zwei Dezimalstellen.
    • {y} ist eine Variable, die den Wert der Y-Achse des ausgewählten Punkts zurückgibt.
    • {variable:.2f} rundet variable auf zwei Dezimalstellen. Weitere Beispiele für die Formatierung von Werten finden Sie in der Highcharts-Dokumentation zur Vorlagenerstellung.
{
  tooltip: {
    format: '<span style="font-size: 1.8em">{key}</span><br/>{#each points}<span style="color:{color}; font-weight: bold;">\u25CF {series.name}: </span>{y:.2f}<br/>{/each}',
    shared: true
  },
}

Diagramm-Annotationen und ‑Beschriftungen hinzufügen

Verwenden Sie das annotations Attribut, um eine Annotation hinzuzufügen. Verwenden Sie das caption Attribut, um dem Diagramm eine Beschriftung hinzuzufügen.

Wenn Sie die Koordinaten für einen Punkt abrufen möchten, klicken Sie oben im Dialogfeld Diagrammkonfiguration bearbeiten auf Punktmetadaten prüfen. Bewegen Sie dann den Mauszeiger auf den Datenpunkt, den Sie mit einer Annotation versehen möchten. Looker zeigt eine Punkt-ID an, die Sie im Attribut annotations.labels.point verwenden können.

Mit dem folgenden HighCharts-JSON werden dem Diagramm zwei Annotationen hinzugefügt, um einen Rückgang der Lagerartikel nach bestimmten Zeiträumen zu erklären. Außerdem wird unten im Diagramm eine Beschriftung hinzugefügt, in der die Annotationen genauer erläutert werden.

{
  caption: {
    text: 'Items go on clearance after 60 days, and are thrown away after 80 days. Thus we see large drops in inventory after these events.'
  },
  annotations: [{
    labels: [{
        point: "inventory_items.count-60-79",
        text: "Clearance sale"
      },
      {
        point: "inventory_items.count-80+",
        text: "Thrown away"
      },
    ]
  }]
}

Dynamische Annotationen hinzufügen

Sie können auch die Parameter annotationsSource und annotationsTarget verwenden, um Daten aus einem Feld als Annotation zu verwenden.

Die Feldnamen finden Sie im Drop-down-Menü Feldmetadaten. Das Feld annotationsTarget muss ein Maß sein.

Mit dem folgenden HighCharts-JSON wird der Wert aus dem Feld orders.annotations als Annotation für das Feld orders.count verwendet:

{
  annotations: [{
    labels: [{
      annotationsSource: 'orders.annotations',
      annotationsTarget: 'orders.count'
    }]
  }]
}

Vertikale Referenzbereiche hinzufügen

Verwenden Sie das xAxis.plotBands Attribut, um einen vertikalen Referenzbereich hinzuzufügen.

Mit dem folgenden HighCharts-JSON wird ein vertikaler Referenzbereich zwischen dem 24. November 2022 und dem 29. November 2022 hinzugefügt, um einen Verkaufszeitraum zu kennzeichnen. Außerdem wird unten im Diagramm eine Beschriftung hinzugefügt, in der die Bedeutung des Bereichs erläutert wird.

Die Attribute to und from von xAxis.plotBands müssen Datenwerten im Diagramm entsprechen. Da die Daten in diesem Beispiel zeitbasiert sind, akzeptieren die Attribute Unix-Zeitstempelwerte (1669680000000 für den 29. November 2022 und 1669248000000 für den 24. November 2022). Stringbasierte Datumsformate wie MM/TT/JJJJ und TT-MM-JJ werden in den HighCharts-Attributen to und from nicht unterstützt.

{
  caption: {
    text: 'This chart uses the HighCharts plotBands attribute to display a band around the Black Friday Cyber Monday sale period.'
  },
  xAxis: {
    plotBands: [{
      to: 1669680000000,
      from: 1669248000000,
      label: {
        text: 'BFCM Sale Period'
      }
    }]
  },
}

Gepunktete und gestrichelte Linien hinzufügen

Verwenden Sie das series.dashStyle-Attribut, um durchgezogene Linien in gepunktete oder gestrichelte Linien zu ändern.

Mit dem folgenden HighCharts-JSON wird das Attribut dashStyle der Reihe Customers in eine gestrichelte Linie und das Attribut dashStyle der Reihe Sales in eine gepunktete Linie geändert.

{
  series: [{
    name: 'Customers',
    dashStyle: 'Dash'
  }, {
    name: 'Sales',
    dashStyle: 'Dot'
  }]
}

Höchst-, Mindest- und Perzentilwerte farblich hervorheben

Ein ausführliches Beispiel zum farblichen Hervorheben der Höchst-, Mindest- und Perzentilwerte einer kartesischen Visualisierung finden Sie im Cookbook Getting the most out of Looker visualizations auf der Seite Conditional formatting customization in Cartesian charts.

Reihen im Vergleich zu anderen Reihenwerten farblich hervorheben

Ab Looker 25.0 können Sie mit dem Parameter formatters.select den aktuellen Datenwert mit Werten aus anderen Reihen vergleichen.

Betrachten wir beispielsweise eine Visualisierung, in der der durchschnittliche Verkaufspreis und der Median des Verkaufspreises für mehrere Städte angezeigt werden. Mit dem folgenden HighCharts-JSON wird die Farbe des durchschnittlichen Verkaufspreises in Grün geändert, wenn er größer oder gleich dem Median des Verkaufspreises ist, und andernfalls in Kastanienbraun:

{
  chart: {},
  series: [{
    name: 'Average Sale Price',
    formatters: [{
        select: 'value >= order_items.median_sale_price',
        style: {
          color: 'green',
          dataLabels: {
            color: 'green'
          }
        }
      },
      {
        select: 'value < order_items.median_sale_price',
        style: {
          color: 'maroon',
          dataLabels: {
            color: 'maroon'
          }
        }
      }
    ]
  }, {
    name: 'Median Sale Price'
  }]
}

Beachten Sie, dass die Zeile select: 'value >= order_items.median_sale_price' auf das Feld Median des Verkaufspreises im Format VIEW_NAME.FIELD_NAME verweist. Wenn Sie diesen Feldwert direkt kopieren möchten, klicken Sie im Dialogfeld Diagrammkonfiguration bearbeiten auf das Drop-down-Menü Feldmetadaten und wählen Sie den Feldnamen aus.

Reihenwerte mit dem Mittelwert oder Median vergleichen

Der Parameter formatters.select unterstützt das Keyword mean in Looker 25.0 und höher und das Keyword median in Looker 25.2 und höher. Mit diesen Keywords können Sie den aktuellen Datenwert mit dem arithmetischen Mittelwert oder Median der Reihe vergleichen.

Betrachten wir beispielsweise eine Visualisierung, in der der Bestellgewinn für jeden Monat des letzten Jahres angezeigt wird. Mit dem folgenden HighCharts-JSON wird die Farbe jedes Balkens in Grau geändert (dargestellt durch den Hex-Code #aaa), wenn der Bestellgewinn niedriger als der durchschnittliche Bestellgewinn ist:

{
  chart: {},
  series: [{
    name: 'Order Profit',
    formatters: [{
      select: 'value < mean',
      style: {
        color: '#aaa'
      }
    }]
  }]
}

Wenn Sie den Reihenwert mit dem Median anstelle des Mittelwerts vergleichen möchten, ändern Sie die Zeile select: 'value < mean' in select: 'value < median'.

Vorlagen zum Speichern und Freigeben von Konfigurationen verwenden

Sie können eine Konfiguration als Vorlage speichern, um sie in anderen Visualisierungen wiederzuverwenden oder als Ausgangspunkt für andere Nutzer freizugeben.

Vorlage speichern

Wenn Sie HighCharts-JSON im Editor für Diagrammkonfigurationen bearbeiten, können Sie Ihren Code so als Vorlage speichern:

  1. Klicken Sie im Dialogfeld „Editor für Diagrammkonfigurationen“ auf Als Vorlage speichern.
  2. Geben Sie Ihrer Vorlage einen eindeutigen Namen.
  3. Geben Sie eine Beschreibung ein, die anderen Nutzern erklärt, was Ihre Vorlage tut.
  4. Bearbeiten Sie den Code nach Bedarf und rufen Sie eine Vorschau auf.
  5. Klicken Sie auf Speichern , um den Code zu validieren.
  6. Beheben Sie alle Validierungsfehler.
  7. Klicken Sie noch einmal auf Speichern , um die Vorlage zu speichern.

Beachten Sie beim Erstellen einer Vorlage Folgendes:

  • Nutzer mit eingebetteten Inhalten können keine Vorlagen erstellen, bearbeiten oder anwenden.
  • Alle anderen Nutzer in Ihrer Instanz, die Zugriff auf den Editor für Diagrammkonfigurationen haben, können Ihre Vorlage sehen.
  • Nicht alle Vorlagen eignen sich für alle Visualisierungstypen. Geben Sie im Feld Beschreibung an, für welchen Visualisierungstyp Ihre Vorlage verwendet werden soll.

Vorlage anwenden

Sie können eine Vorlage auf Ihre aktuelle Visualisierung anwenden. Beachten Sie beim Anwenden einer Vorlage Folgendes:

  • Wenn Sie eine Vorlage anwenden, wird der gesamte Code überschrieben, den Sie im Editor für Diagrammkonfigurationen geschrieben haben.
  • Nicht alle Vorlagen eignen sich für alle Visualisierungstypen. Wenn der Autor einer Vorlage beispielsweise Code für ein Balkendiagramm geschrieben hat, kann dieser Code unterschiedliche Auswirkungen auf ein Liniendiagramm haben.

So wenden Sie eine Vorlage an:

  1. Klicken Sie im Dialogfeld „Editor für Diagrammkonfigurationen“ auf Gespeicherte Vorlagen.
  2. Klicken Sie auf eine Vorlage und dann auf Vorlage anwenden.
  3. Klicken Sie auf Weiter.

Looker wendet die Vorlage an und Sie können im Editor für Diagrammkonfigurationen weitere Änderungen vornehmen.

Vorlage löschen

So löschen Sie eine Vorlage:

  1. Klicken Sie im Dialogfeld „Editor für Diagrammkonfigurationen“ auf Gespeicherte Vorlagen.
  2. Klicken Sie auf das Dreipunkt-Menü neben der Vorlage, die Sie löschen möchten.
  3. Klicken Sie auf Löschen.

Wenn Sie alle Änderungen vorgenommen haben, klicken Sie im Dialogfeld „Gespeicherte Vorlagen“ auf die Schaltfläche X , um zum Dialogfeld „Editor für Diagrammkonfigurationen“ zurückzukehren.

Vorlage bearbeiten

So bearbeiten Sie eine Vorlage:

  1. Klicken Sie im Dialogfeld „Editor für Diagrammkonfigurationen“ auf Gespeicherte Vorlagen.
  2. Klicken Sie auf das Dreipunkt-Menü neben der Vorlage, die Sie bearbeiten möchten.
  3. Klicken Sie auf Bearbeiten.
  4. Wenn Sie alle Änderungen vorgenommen haben, klicken Sie auf Speichern.

Neue Visualisierungstypen erstellen

Mit dem Editor für Diagrammkonfigurationen können Sie Visualisierungstypen erstellen, die nicht in den Standardvisualisierungstypen von Looker enthalten sind. In den folgenden Artikeln finden Sie Beispiele für einige der Visualisierungen, die Sie mit dem Editor für Diagrammkonfigurationen entwerfen können: