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.

Entwicklung einer benutzerdefinierten Visualisierung für den Looker Marketplace

Auf dieser Seite wird beschrieben, wie Sie einen benutzerdefinierten Visualisierungstyp erstellen, der dem Looker Marketplace hinzugefügt und von anderen Looker-Nutzern aufgerufen werden kann. Sie können auch eine benutzerdefinierte Visualisierung direkt in Ihrem Projekt erstellen, ohne sie für andere Looker-Kunden verfügbar zu machen.

Sie müssen Mitglied des Looker Partner Networks oder Looker-Kunde sein, um Inhalte im Looker Marketplace einreichen zu können.

Der Looker Marketplace ist ein zentraler Ort zum Suchen, Bereitstellen und Verwalten vieler Arten von Looker-Inhalten, wie Looker BlocksTM, Anwendungen, Visualisierungen und anderen Plug-ins.

Wenn die Looker-Funktion Marketplace aktiviert ist, können Looker-Kunden Looker Marketplace-Plug-ins installieren, die Visualisierungstypen enthalten, die der nativen Visualisierungsbibliothek von Looker hinzugefügt werden können.

So entwickeln Sie eine benutzerdefinierte Visualisierung und stellen sie allen Looker-Kunden über den Looker Marketplace zur Verfügung:

Entwickeln Sie eine Visualisierung.
Erstellen Sie ein Looker-Projekt für die Visualisierung.
Pushen Sie das Looker-Projekt in ein Git-Repository.
Funktionen der Visualisierung testen
Ihre Visualisierung an Looker senden

Visualisierungstyp entwickeln

Wählen Sie eine Visualisierungsart aus, die Sie entwickeln möchten. Prüfen Sie, ob diese Visualisierung bereits im Marketplace oder als native Looker-Visualisierung aufgeführt ist.

Entwickeln Sie Ihre benutzerdefinierte Visualisierung in JavaScript mithilfe der Looker Visualization API in Ihrer JavaScript-Umgebung.

Looker-Projekt für die Visualisierung erstellen

Erstellen Sie ein Looker-Projekt für Ihre benutzerdefinierte Visualisierung. Das Projekt sollte die folgenden Dateien enthalten:

LICENSE-Datei: Listet die Lizenz oder Lizenzen auf, unter denen die Visualisierung vertrieben wird. Dazu wird der folgende Text verwendet:
This Looker visualization is distributed with the following license:...
README.md-Datei: Enthält eine Beschreibung Ihrer Visualisierung, wie sie funktioniert, und weitere Informationen.
JavaScript-Datei (.js): Enthält eine komprimierte Version des JavaScript-Codes, mit dem Sie die Visualisierung erstellt haben. Im Marketplace sind JS-Dateien im Projekt enthalten, was eine ordnungsgemäße Versionsverwaltung und Paketverwaltung ermöglicht.
Manifestdatei (manifest.lkml): Gibt eine id (eindeutige Kennung) und eine label (in der Looker-Benutzeroberfläche für diese Visualisierung angezeigt) an. Beispiel:

    constant: vis_id {
        value: "default_id"
        export: override_optional
    }
    constant: vis_label {
        value: "default_label"
        export: override_optional
    }
    visualization: {
        id: "@{vis_id}"
        label: "@{vis_label}"
        file: "my_local.js"
        sri_hash: "my_sri_hash"
        dependencies: []
    }

Marketplace-Eintragsdatei (marketplace.json): Hiermit wird der Marketplace-Eintrag für die benutzerdefinierte Visualisierung konfiguriert. Sie enthält ein Label für die Darstellung der Visualisierung im Marketplace, den Speicherort der image_uri, einen Slogan, der den Anwendungsfall für die Visualisierung beschreibt, sowie die Marketplace-Feldkonstanten, die Nutzer bei der Installation eingeben. Beispiel:

{
  "label": "Gauge Visualization",
  "category_label": "plug-ins",
  "branding": {
    "image_uri": "https://marketplace-api.looker.com/visualization-screenshots/gauge_icon.png",
    "tagline": "Use the Gauge visualization to display a measure and progress to a goal."
  },
   "constants": {
        "vis_label": {
            "label": "Visualization Label",
            "description": "This label will appear in the visualization selector in the Looker Explore UI."
        },
        "vis_id": {
            "label": "Visualization Id",
            "description": "This must be a unique ID across all visualizations.",
            "value_constraint": "visualization"
        }
    }
}

Projekt per Push an Git übertragen

Hosten Sie die LookML-Datei Ihrer Visualisierung in einem öffentlich zugänglichen GitHub-Repository. Angenommen, Sie haben die Visualisierung in einem Looker-Projekt erstellt, gehen Sie so vor, um sie in ein neues Repository zu pushen:

Erstellen Sie ein öffentlich zugängliches GitHub-Repository.
Legen Sie die Repository-URL Ihres Looker-Projekts auf die URL Ihres GitHub-Repositories fest.
Folgen Sie den Git-Aufforderungen in Looker, um Ihren Code zu validieren, mit einem Commit zu versehen und für die Produktion bereitzustellen.

Funktionalität der Visualisierung testen

Testen Sie die neue Visualisierung, indem Sie sie auf ein geeignetes Explore oder einen geeigneten Look auf Ihrer Looker-Instanz anwenden:

Rufen Sie den Look oder das Explore auf.
Wenn du einen Look bearbeitest, klicke auf Bearbeiten.
Klicken Sie im Menü für den Visualisierungstyp auf das Dreipunkt-Menü, um das Drop-down-Menü mit den Visualisierungen zu öffnen.
Wählen Sie die benutzerdefinierte Visualisierung aus.
Klicken Sie auf Speichern, um die Änderung am Look zu speichern. Notieren Sie sich alle Dashboards, die von dieser Änderung betroffen sein könnten.

Looker benötigt folgende Funktionen in den im Looker Marketplace verfügbaren Visualisierungen:

Funktion	Erforderlich
Unterstützung für die Aufschlüsselung von Visualisierungen	Ja
Möglichkeit, die Farbpaletten von Looker zu übernehmen	Ja
Reaktionsfähigkeit an Browser und Bildschirmgröße	Ja
Einheitliche Schriftfamilie: `font-family`: `Helvetica`, `Arial`, `sans-serif`	Ja
Schriftgröße	Ja
Im Konfigurationsbereich für die Visualisierung können Sie zwischen Wertlabels und Achsenlabels wechseln.	Ja
Visualisierung von Pivot-Daten	Ja (falls zutreffend)
Aktualisierung der Visualisierung basierend auf der Nutzerinteraktivität mithilfe der Funktion `updateAsync` oder `is update function`	Ja
Fehlermeldungen werden gelöscht, z. B. Für diese Visualisierung sind eine Dimension und zwei Messwerte erforderlich.	Ja
Alle Optionen im Konfigurationsbereich für Visualisierungen führen zu einer offensichtlichen Änderung der Visualisierung.	Ja
Standardmäßig wird die `value`-Formatierung des Felds verwendet.	Ja (falls zutreffend)
Fehler wird geworfen, wenn eine Abfrage keine Ergebnisse zurückgibt	Ja

Visualisierung zur Überprüfung einreichen

Sobald Ihre Visualisierung zur Einreichung bereit ist, folgen Sie der Anleitung unter Inhalte im Looker Marketplace einreichen, um ergänzende Dokumente für Ihre Visualisierung zu erstellen, Ihre Visualisierung zur Überprüfung an das Looker-Team zu senden und sie im Looker Marketplace zu veröffentlichen.