Mengembangkan visualisasi kustom untuk Looker Marketplace

Halaman ini menjelaskan cara membuat jenis visualisasi kustom yang dapat ditambahkan ke Looker Marketplace dan diakses oleh pengguna Looker lainnya. Anda juga dapat membuat visualisasi kustom secara langsung di project tanpa menyediakannya bagi pelanggan Looker lainnya.

Perhatikan bahwa Anda harus menjadi anggota Jaringan Partner Looker atau pelanggan Looker agar dapat mengirimkan konten ke Looker Marketplace.

Looker Marketplace adalah lokasi sentral untuk menemukan, men-deploy, dan mengelola berbagai jenis konten Looker, seperti Looker BlocksTM, aplikasi, visualisasi, dan plugin lainnya.

Dengan mengaktifkan fitur Marketplace Looker, pelanggan Looker dapat menginstal plugin Looker Marketplace, yang mencakup jenis visualisasi untuk ditambahkan ke library visualisasi native Looker.

Untuk mengembangkan visualisasi kustom dan menyediakannya untuk semua pelanggan Looker melalui Looker Marketplace, ikuti langkah-langkah berikut:

  1. Mengembangkan visualisasi.
  2. Buat project Looker untuk visualisasi.
  3. Kirim project Looker ke repositori Git.
  4. Uji fungsionalitas visualisasi.
  5. Kirim visualisasi Anda ke Looker.

Mengembangkan jenis visualisasi

Identifikasi jenis visualisasi yang ingin Anda kembangkan. (Konfirmasi bahwa visualisasi ini belum tercantum di Marketplace atau sebagai visualisasi Looker native.)

Kembangkan visualisasi kustom Anda di JavaScript menggunakan Looker Visualization API dengan lingkungan JavaScript.

Membuat project Looker untuk visualisasi

Buat project Looker untuk mewakili visualisasi kustom Anda. Project harus berisi file berikut:

  • File LISENSI: Mencantumkan lisensi atau lisensi yang digunakan untuk distribusi visualisasi, menggunakan teks:

    This Looker visualization is distributed with the following license:...

  • File README.md: Memberikan deskripsi visualisasi Anda, cara kerjanya, dan informasi tambahan apa pun.

  • File JavaScript (.js): Berisi versi kode JavaScript yang dipadatkan yang Anda gunakan untuk menghasilkan visualisasi. Dengan Marketplace, file JS disertakan dalam project, sehingga memungkinkan pembuatan versi dan pengelolaan paket yang tepat.

  • File manifes (manifest.lkml): Menentukan id (ID unik) dan label (ditampilkan di UI Looker untuk visualisasi ini). Contoh:

    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: []
    }
  • File listingan (marketplace.json): Mengonfigurasi listingan Marketplace untuk visualisasi kustom dan menyertakan label untuk cara visualisasi akan muncul di Marketplace, lokasi image_uri, tagline yang menjelaskan kasus penggunaan untuk visualisasi, dan juga menentukan konstanta kolom Marketplace yang dimasukkan pengguna selama penginstalan. Contoh:
{
  "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"
        }
    }
}

Mengirim project ke Git

Hosting LookML visualisasi Anda di repositori GitHub yang dapat diakses secara publik. Dengan asumsi bahwa Anda telah membuat visualisasi di project Looker, ikuti langkah-langkah berikut untuk mendorongnya ke repositori baru:

  1. Buat repositori GitHub yang dapat diakses secara publik.
  2. Tetapkan URL Repositori project Looker Anda ke URL repositori GitHub Anda.
  3. Ikuti perintah Git di Looker untuk memvalidasi, melakukan commit, dan men-deploy kode ke produksi.

Menguji fungsionalitas visualisasi

Uji visualisasi baru dengan menerapkannya ke bagian Jelajahi atau Lihat yang sesuai di instance Looker Anda:

  1. Arahkan ke Lihat atau Jelajahi.
  2. Pada Tampilan, klik Edit untuk mengedit Tampilan tersebut.
  3. Klik menu tiga titik di menu jenis visualisasi untuk membuka daftar {i>drop-down<i} visualisasi.
  4. Pilih visualisasi kustom Anda.
  5. Klik Simpan untuk menyimpan perubahan pada Tampilan. Perhatikan dasbor yang mungkin terpengaruh oleh perubahan ini.

Looker memerlukan fungsi berikut dalam visualisasi yang tersedia dari Looker Marketplace:

Fungsi Diperlukan
Dukungan untuk melihat perincian visualisasi Ya
Kemampuan untuk mewarisi palet warna Looker Ya
Responsivitas terhadap ukuran layar dan browser Ya
Jenis font yang konsisten: font-family: Helvetica, Arial, sans-serif Ya
Ukuran font Ya
Kemampuan untuk mengaktifkan/menonaktifkan Label Nilai dan Label Sumbu di panel konfigurasi visualisasi Ya
Visualisasi data terpivot Ya (jika berlaku)
Visualisasi diperbarui berdasarkan interaktivitas pengguna menggunakan fungsi updateAsync atau is update function Ya
Menghapus pesan error (misalnya, Visualisasi ini memerlukan 1 dimensi dan 2 ukuran) Ya
Semua opsi dalam panel konfigurasi visualisasi membuat perubahan yang jelas pada visualisasi Ya
Penggunaan format value kolom secara default Ya (jika berlaku)
Error dilempar saat kueri tidak menampilkan hasil Ya

Mengirimkan visualisasi untuk ditinjau

Setelah visualisasi Anda siap dikirim, ikuti petunjuk di Mengirimkan konten ke Looker Marketplace untuk membuat dokumentasi pendukung visualisasi Anda, mengirim visualisasi ke tim Looker untuk ditinjau, dan memublikasikan visualisasi ke Looker Marketplace.