Looker enthält eine umfangreiche Liste integrierter Visualisierungstypen, mit denen Sie Ihre Daten auf verschiedene Arten darstellen können. Wenn Sie einen Diagrammtyp benötigen, der nicht zu den integrierten Visualisierungstypen von Looker gehört, bietet Looker mehrere Möglichkeiten, benutzerdefinierte JavaScript-Visualisierungen in Ihre Looker-Instanz einzufügen:
- Fügen Sie der Manifestdatei Ihres LookML-Projekts einen
visualization-Parameter hinzu, um benutzerdefinierte Visualisierungen direkt zu Ihrem LookML-Projekt hinzuzufügen. Weitere Informationen finden Sie auf der Dokumentationsseite zum Parametervisualization. - Installieren Sie eine Visualisierung aus dem Looker Marketplace. Wenn die Funktion Marketplace aktiviert ist, können Sie Visualisierungspakete aus dem Looker Marketplace installieren.
- Auf der Seite Visualisierungen im Bereich Plattform des Admin-Menüs von Looker können Sie benutzerdefinierte JavaScript-Visualisierungen aus dem Repository für benutzerdefinierte Visualisierungen von Looker installieren und verwalten.
Auf dieser Seite wird beschrieben, wie Sie benutzerdefinierte JavaScript-Visualisierungen über die Seite Visualisierungen im Looker-Bereich Administrator hinzufügen.
Liste benutzerdefinierter Visualisierungen aufrufen
Damit heruntergeladene Visualisierungen vollständig funktionieren, müssen Administratoren für kundengehostete Bereitstellungen die entsprechende Version des Chromium-Renderers installieren.
Auf der Seite Visualisierungen im Bereich Plattform des Looker-Menüs Admin werden alle benutzerdefinierten Visualisierungen aufgeführt, die Ihrer Looker-Instanz hinzugefügt wurden.
Die Liste enthält die folgenden Spalten:
- ID: Die eindeutige ID, die der benutzerdefinierten Visualisierung zugewiesen wird. Dieser Wert wird entweder im JavaScript-Code oder beim Hinzufügen oder Bearbeiten einer Visualisierung auf der Seite Verwaltung oder im Parameter
idder Visualisierung zugewiesen, wenn Sie eine Visualisierung über die LookML-Projektmanifestdatei hinzufügen. - Label: Der Name, der dem Visualisierungstyp im Looker-Visualisierungsmenü zugewiesen wird. Dieser Wert wird zugewiesen, wenn Sie eine Visualisierung über die Seite „Admin“ hinzufügen oder bearbeiten oder wenn Sie eine Visualisierung über die Manifestdatei des LookML-Projekts hinzufügen und dabei den Parameter
labelverwenden. - Main: Die URI des Haupt-JavaScript-Codes der Visualisierung. Dieser Wert wird zugewiesen, wenn Sie eine Visualisierung über die Seite „Admin“ hinzufügen oder bearbeiten oder wenn Sie eine Visualisierung über den Parameter
urlin der Manifestdatei des LookML-Projekts hinzufügen. - Aktionen: Schaltflächen zum Bearbeiten oder Löschen der Visualisierungskonfiguration. Diese Schaltflächen werden nicht für Visualisierungen angezeigt, die über die Manifestdatei des LookML-Projekts hinzugefügt wurden. Wenn Sie diese Visualisierungen bearbeiten möchten, rufen Sie die Manifestdatei des LookML-Projekts auf und bearbeiten Sie den Parameter
visualizationdirekt.
Benutzerdefinierte Visualisierung erstellen
Sie können Visualisierungen aus verschiedenen Quellen beziehen, um sie anzupassen und Ihrer Looker-Instanz hinzuzufügen. Dazu gehören:
- Looker unterhält eine Bibliothek mit benutzerdefinierten Visualisierungen zur öffentlichen Nutzung auf dieser Looker-GitHub-Seite. Eine Anleitung zur Verwendung der Visualization API von Looker zum Erstellen eigener Visualisierungstypen finden Sie auf dieser GitHub-Seite von Looker.
- Der eigenständige Looker Marketplace, in dem Sie nach Visualisierungen (sogenannten Plug-ins) suchen und auf deren Quellcode zugreifen können.
- Der Looker Marketplace, auf den Sie über Ihre Looker-Instanz zugreifen können. In diesem Marketplace können Sie Visualisierungen direkt in Ihrer Looker-Instanz suchen und installieren. Weitere Informationen zum Installieren von Visualisierungen aus dem Looker Marketplace finden Sie auf der Dokumentationsseite Looker Marketplace verwenden.
Neue benutzerdefinierte Visualisierung hinzufügen
Wenn Sie wissen, welche Visualisierung Sie Ihrer Instanz hinzufügen möchten, können Sie im Admin-Menü von Looker im Bereich Plattform auf der Seite Visualisierungen eine benutzerdefinierte Visualisierung hinzufügen. Klicken Sie dazu auf die Schaltfläche Visualisierung hinzufügen.
In Looker wird die Seite Neue Visualisierung angezeigt. So fügen Sie eine neue Visualisierung hinzu:
Geben Sie im Feld ID die eindeutige ID der Visualisierung ein, die im JavaScript der Visualisierung definiert ist.
Geben Sie im Feld Label den Namen der Visualisierung ein. Looker zeigt diesen Namen im Visualisierungsmenü von Looker in einem Explore an.
Geben Sie im Feld Main den URI der JavaScript-Hauptdatei der Visualisierung ein, um Looker auf Ihr JavaScript-Code-Repository zu verweisen.
Wenn auf der Website, auf der Ihr benutzerdefinierter Visualisierungscode gehostet wird, ein SRI-Hash (Subresource Integrity) zur Überprüfung verwendet wird, geben Sie den SRI-Hash in das Feld SRI-Hash ein. Dieses Feld finden Sie unter Erweiterte Optionen. Für die benutzerdefinierten Visualisierungs-Hosts von Looker wird kein SRI-Hash verwendet.
Geben Sie im Feld Abhängigkeiten die URIs aller anderen Dateien ein, von denen das JavaScript für die Visualisierung abhängt, und klicken Sie auf Hinzufügen. Sie können mehrere URIs durch Kommas getrennt eingeben oder mehrere URIs einzeln hinzufügen. Das Feld Abhängigkeiten finden Sie unter Erweiterte Optionen.
Klicken Sie auf Speichern.
Nachdem die Visualisierung hinzugefügt wurde, wird sie im Visualisierungsmenü in einem Explore mit der von Ihnen angegebenen Bezeichnung angezeigt. Sie können den neuen Visualisierungstyp wie jeden anderen vorhandenen Visualisierungstyp in Looker verwenden.
So rufen Sie benutzerdefinierte Visualisierungen über das Visualisierungsmenü auf:
Klicken Sie in der Menüleiste für Visualisierungen auf das Dreipunkt-Symbol
..., um auf die benutzerdefinierte Visualisierung zuzugreifen.Nachdem die Visualisierung ausgewählt wurde, wird ihr Name in der Menüleiste für Visualisierungen angezeigt.
Benutzerdefinierte Visualisierung bearbeiten
Wenn Sie eine vorhandene Visualisierung bearbeiten möchten, wählen Sie rechts neben der Visualisierung die Schaltfläche Bearbeiten aus. In Looker wird dieselbe Seite angezeigt, die Sie zum Hinzufügen einer Visualisierung verwenden (siehe Neue benutzerdefinierte Visualisierung hinzufügen), aber mit den relevanten Informationen. Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf Speichern.
Benutzerdefinierte Visualisierung löschen
Wenn Sie eine Visualisierung löschen möchten, klicken Sie im Admin-Menü von Looker im Bereich Plattform auf der Seite Visualisierungen rechts neben der Visualisierung auf die Schaltfläche Löschen und dann im Bestätigungsfeld auf OK.
Wenn Sie eine Visualisierung löschen, wird sie aus Looker entfernt. Das hat jedoch keine Auswirkungen auf das externe Code-Repository der Visualisierung.
Wenn Sie eine Visualisierung löschen, werden alle Looks oder Dashboards deaktiviert, in denen dieser Visualisierungstyp verwendet wird. Sie können das korrigieren, indem Sie die gelöschte Visualisierung mit derselben Visualisierungs-ID wieder hinzufügen.
Fehlerbehebung
Benutzerdefinierte Visualisierungen sind ein Community-Projekt. Das Supportteam von Looker kann keine Probleme mit benutzerdefinierten Visualisierungen oder Ihrem benutzerdefinierten Visualisierungscode beheben. Verwenden Sie zum Erfassen und Beheben von Fehlern GitHub-Probleme im Repository der benutzerdefinierten Visualisierung oder besuchen Sie die Looker-Community, um Anleitungen, Diskussionen und Tipps zu benutzerdefinierten Visualisierungen zu erhalten.