Beachten Sie, dass Sie sich gerade die Looker-Dokumentation ansehen. Die Looker Studio-Dokumentation finden Sie unter https://support.google.com/looker-studio.

Diese Seite wurde von der Cloud Translation API übersetzt.

Visualisierungen mit dem Diagrammkonfigurationseditor anpassen

Sie können den Diagrammkonfigurationseditor verwenden, um Formatierungsoptionen für Looker-Visualisierungen anzupassen, die die HighCharts API verwenden. Dazu gehören die meisten kartesischen Diagramme, unter anderem Säulendiagramme, Balkendiagramme und Liniendiagramme.

Vorbereitung

Für den Zugriff auf den Diagrammkonfigurationseditor benötigen Sie die Berechtigung can_override_vis_config.

Visualisierung anpassen

So passen Sie eine Visualisierung mit dem Diagrammkonfigurationseditor an:

Zeigen Sie eine Visualisierung in einem Explore an oder bearbeiten Sie eine Visualisierung in einem Look oder Dashboard.
Öffnen Sie das Menü Bearbeiten in der Visualisierung.
Klicken Sie auf dem Tab Plot (Diagramm) auf die Schaltfläche Edit Chart Configuration (Diagrammkonfiguration bearbeiten). Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.
- Der Bereich Diagrammkonfiguration (Quelle) enthält die ursprüngliche JSON-Datei Ihrer Visualisierung und kann nicht bearbeitet werden.
- Der Bereich Diagrammkonfiguration (Überschreibung) enthält die JSON-Datei, die die Quell-JSON-Datei überschreiben soll. Wenn Sie das Dialogfeld Konfiguration des Diagramms bearbeiten zum ersten Mal öffnen, füllt Looker den Bereich mit einer Standard-JSON-Datei aus. Sie können mit dieser JSON-Datei beginnen oder sie löschen und eine gültige HighCharts-JSON-Datei eingeben.
Wählen Sie den Bereich Diagrammkonfiguration (Überschreiben) aus und geben Sie eine gültige HighCharts-JSON-Datei ein. Die neuen Werte überschreiben alle Werte im Bereich Diagrammkonfiguration (Quelle).
- Im Abschnitt Beispiele dieses Artikels finden Sie Beispiele für gültige HighCharts-JSON-Datei.
- Looker akzeptiert alle gültigen JSON-Werte. Looker akzeptiert keine Funktionen, Datumsangaben oder undefinierten Werte.
Klicken Sie auf <> (Code formatieren), damit Looker die JSON-Datei richtig formatieren kann.
Klicken Sie auf Vorschau, um die Änderungen zu testen.
Klicken Sie auf Übernehmen, um die Änderungen zu übernehmen. Die Visualisierung wird mit den benutzerdefinierten JSON-Werten angezeigt.

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

Wenn Sie die Standardvisualisierungsoptionen bearbeiten möchten, entfernen Sie zuerst alle Änderungen, die Sie im Diagrammkonfigurationseditor vorgenommen haben, und ersetzen Sie diese später. Führen Sie insbesondere die folgenden Schritte aus:

Klicken Sie auf dem Tab Plot (Diagramm) auf die Schaltfläche Edit Chart Configuration (Diagrammkonfiguration bearbeiten). Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.
Kopieren Sie den Text im Bereich Diagrammkonfiguration (Überschreiben).
Klicken Sie auf die Schaltfläche Diagramm-Überschreibungen löschen, um alle Änderungen zu löschen.
Klicken Sie auf Anwenden.
Bearbeiten Sie Ihre Visualisierung mit den Standard-Visualisierungsoptionen.
Klicken Sie auf dem Tab Plot (Diagramm) auf die Schaltfläche Edit Chart Configuration (Diagrammkonfiguration bearbeiten). Looker zeigt das Dialogfeld Diagrammkonfiguration bearbeiten an.
Geben Sie im Bereich Diagrammkonfiguration (Überschreiben) eine gültige HighCharts-JSON-Datei ein. Sie können den Text, den Sie in Schritt 2 kopiert haben, als Vorlage verwenden. Testen Sie Ihre Änderungen aber mithilfe der Schaltfläche Vorschau, um Konflikte zu vermeiden.
Klicken Sie auf Anwenden.

Bedingte Formatierung mit `series formatters`

Der Diagrammkonfigurationseditor akzeptiert die meisten gültigen HighCharts-JSON-Dateien. Es akzeptiert auch das Attribut series formatters, das nur in Looker vorhanden ist. Jede Reihe kann mehrere Formatierer haben, um verschiedene Stilregeln zu kombinieren.

Für das Attribut series formatters sind zwei Attribute zulässig: select und style.

Geben Sie im Attribut select einen logischen Ausdruck ein, der angibt, welche Datenwerte formatiert werden sollen.
Geben Sie JSON-Daten in das Attribut style ein, um anzugeben, wie die Datenwerte formatiert werden sollen.

Mit der folgenden JSON-Datei wird beispielsweise jeder Datenwert orange eingefä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 ausführlicher 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 beispielsweise select: value > 0 verwenden, um ein Targeting auf alle positiven Werte vorzunehmen, oder value = 100, um nur Reihen mit einem Wert von 100 abzugleichen.
max: Verwenden Sie select: max, um ein Targeting auf den Reihenwert vorzunehmen, der den Höchstwert hat.
min: Verwenden Sie select: min, um ein Targeting auf den Reihenwert mit dem Mindestwert vorzunehmen.
percent_rank: Diese Variable wird mit einem angegebenen Perzentil auf den Reihenwert ausgerichtet. Sie können beispielsweise select: percent_rank >= 0.9 verwenden, um ein Targeting auf Reihenwerte im 90. Perzentil vorzunehmen.
name: Diese Variable gibt den Dimensionswert der Reihe zurück. Wenn Sie beispielsweise einen Bericht mit den Status „Verkaufte“, „Stornierte“ und „Zurückgegebene Bestellungen“ haben, können Sie select: name = Sold verwenden, um ein Targeting auf die Reihen vorzunehmen, in denen der Dimensionswert „Verkauft“ ist.
AND/OR Verwenden Sie AND und OR, um mehrere logische Ausdrücke zu kombinieren.

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

Das Attribut `style`

Mit dem Attribut style können Stile angewendet werden, die von HighCharts unterstützt werden. Sie können beispielsweise Reihenwerte mit style.color färben, Rahmenlinien mit style.borderColor einfärben und die Rahmenbreite der Reihe mit style.borderWidth festlegen. Eine vollständige Liste der Stiloptionen finden Sie unter Highcharts-Optionen für series.column.data.

Verwenden Sie für Linienvisualisierungen style.marker.fillColor und style.marker.lineColor anstelle von style.color. Eine vollständige Liste der Linienstiloptionen finden Sie unter Highcharts-Optionen für series.line.data.marker.

Informationen zur Farbformatierung im Editor für die Diagrammkonfiguration finden Sie im Beispiel Farbe für Maximalwerte, Mindestwerte und Perzentile einfärben.

Beispiele

Die folgenden Abschnitte enthalten Beispiele für einige häufige Anwendungsfälle für den Diagrammkonfigurationseditor. Eine vollständige Liste der Attribute, die Sie bearbeiten können, finden Sie in der Dokumentation zur HighCharts API.

Hintergrundfarbe und Textfarbe der Achse ändern
Farbe der Kurzinfo anpassen
Diagrammanmerkungen und Bildunterschriften hinzufügen
Vertikale Referenzbereiche hinzufügen
Höchst-, Mindest- und Perzentilwerte farblich kennzeichnen

Hintergrundfarbe und Textfarbe der Achse ändern

Die Hintergrundfarbe einer Visualisierung kann mit dem Attribut chart.backgroundColor geändert werden.

Analog können Sie die Textfarbe der Achsen in einer Visualisierung mit den folgenden Attributen ändern:

Im folgenden HighCharts-JSON wird die Hintergrundfarbe der Visualisierung in Lila und der Text der Achsentitel und -beschriftungen 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"
      }
    }
  }
}

Verwenden Sie die folgenden Attribute, um die Farbe der Kurzinfo anzupassen:

Mit der folgenden HighCharts-JSON-Datei wird die Hintergrundfarbe der Kurzinfo in Cyan und die Farbe des Texts der Kurzinfo in Schwarz geändert.

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

Verwenden Sie die folgenden Attribute, um den Inhalt der Kurzinfo anzupassen:

Die folgende HighCharts-JSON-Datei ändert das Format der Kurzinfo so, dass der Wert der x-Achse oben in der Kurzinfo in größerer Schriftart angezeigt wird, gefolgt von einer Liste aller Reihenwerte an dieser Stelle.

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 Monat und Jahr).
{#each points}{/each} ist eine Funktion, die den beigefügten 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 Dokumentation zu Highcharts-Vorlagen.

{
  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
  },
}

Diagrammanmerkungen und Bildunterschriften hinzufügen

Um eine Anmerkung hinzuzufügen, verwende das Attribut annotations. Um dem Diagramm eine Bildunterschrift hinzuzufügen, verwenden Sie das Attribut caption.

Um die Koordinaten eines Punkts abzurufen, klicken Sie oben im Dialogfeld Diagrammkonfiguration bearbeiten auf Punktmetadaten prüfen. Halten Sie dann den Mauszeiger über den Datenpunkt, den Sie annotieren möchten. Looker zeigt eine Punkt-ID an, die Sie im Attribut annotations.labels.point verwenden können.

Bei der folgenden HighCharts-JSON-Datei werden dem Diagramm zwei Anmerkungen hinzugefügt, um den Rückgang der Inventarelemente nach bestimmten Zeiträumen zu erklären. Außerdem wird unten im Diagramm eine Bildunterschrift hinzugefügt, die die Anmerkungen im Detail erklärt.

{
  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"
      },
    ]
  }]
}

Vertikale Referenzbänder hinzufügen

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

Im folgenden HighCharts-JSON wird ein vertikales Referenzband zwischen dem 24. November 2022 und dem 29. November 2022 hinzugefügt, um einen Verkaufszeitraum anzugeben. Darüber hinaus wird eine Bildunterschrift am unteren Rand des Diagramms hinzugefügt, um die Bedeutung der Gruppe zu erläutern.

Die Attribute to und from von xAxis.plotBands müssen den 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'
      }
    }]
  },
}

Höchst-, Mindest- und Perzentilwerte farbig darstellen

Auf der Seite Das Beste aus Looker-Visualisierungen herausholen: Anpassung der bedingten Formatierung in kartesischen Diagrammen finden Sie ein detailliertes Beispiel zum Einfärben der Höchst-, Mindest- und Perzentilwerte einer kartesischen Visualisierung.

Neue Visualisierungstypen erstellen

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