Menyesuaikan visualisasi menggunakan Editor Konfigurasi Diagram

Anda dapat menggunakan Editor Konfigurasi Diagram untuk menyesuaikan opsi pemformatan pada visualisasi Looker yang menggunakan HighCharts API. Hal ini mencakup sebagian besar diagram Kartesius, seperti diagram kolom, diagram batang, dan diagram garis, antara lain.

Prasyarat

Untuk mengakses Editor Konfigurasi Diagram, Anda harus memiliki izin can_override_vis_config.

Menyesuaikan visualisasi

Untuk menyesuaikan visualisasi dengan Editor Konfigurasi Diagram, ikuti langkah-langkah berikut:

  1. Melihat visualisasi di Jelajah, atau mengedit visualisasi di Look atau dasbor.
  2. Buka menu Edit dalam visualisasi.

  3. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.

    • Panel Konfigurasi Diagram (Sumber) berisi JSON asli visualisasi Anda dan tidak dapat diedit.

    • Panel Konfigurasi Diagram (Penggantian) berisi JSON yang akan mengganti JSON sumber. Saat Anda pertama kali membuka dialog Edit Chart Config, Looker akan mengisi panel dengan beberapa JSON default. Anda dapat memulai dengan JSON ini, atau Anda dapat menghapus JSON ini dan memasukkan JSON HighCharts yang valid.

  4. Pilih bagian Chart Config (Override) dan masukkan beberapa JSON HighCharts yang valid. Nilai baru akan menggantikan nilai apa pun di bagian Chart Config (Source).

    • Lihat bagian Contoh dalam artikel ini untuk mengetahui contoh JSON HighCharts yang valid.
    • Looker menerima nilai JSON yang valid. Looker tidak menerima fungsi, tanggal, atau nilai yang tidak ditentukan.

  5. Klik <> (Format code) untuk mengizinkan Looker memformat JSON Anda dengan benar.

  6. Klik Pratinjau untuk menguji perubahan Anda.

  7. Klik Terapkan untuk menerapkan perubahan. Visualisasi akan ditampilkan menggunakan nilai JSON kustom.

Setelah menyesuaikan visualisasi, Anda dapat menyimpannya. Jika Anda melihat visualisasi dalam eksplorasi, simpan Eksplorasi. Jika Anda mengedit Tampilan atau dasbor, klik Simpan.

Jika Anda mencoba melihat pratinjau kode yang berisi JSON tidak valid, Looker akan menampilkan pesan error Invalid JSON detected . Anda dapat membersihkan JSON yang tidak valid menggunakan opsi Autofix code di bagian bawah panel Chart Config (Override).

Jika Anda ingin mengedit opsi visualisasi default, hapus terlebih dahulu perubahan yang telah Anda buat di Editor Konfigurasi Diagram, lalu ganti nanti. Secara khusus, ikuti langkah-langkah berikut:

  1. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.
  2. Salin teks di panel Chart Config (Override).
  3. Klik tombol Clear Chart Overrides untuk menghapus semua perubahan.
  4. Klik Terapkan.
  5. Edit visualisasi Anda menggunakan opsi visualisasi default.
  6. Klik tombol Edit Chart Config di tab Plot. Looker akan menampilkan dialog Edit Chart Config.
  7. Masukkan beberapa JSON HighCharts yang valid di panel Chart Config (Override). Anda dapat menggunakan teks yang disalin di langkah 2 sebagai template, tetapi pastikan untuk menguji perubahan menggunakan tombol Pratinjau untuk memastikan tidak ada konflik.
  8. Klik Terapkan.

Format bersyarat dengan series formatters

Editor Konfigurasi Diagram menerima sebagian besar JSON HighCharts yang valid. Atribut ini juga menerima atribut series formatters, yang hanya ada di Looker. Setiap deret dapat memiliki beberapa pemformat untuk menggabungkan aturan gaya yang berbeda.

Atribut series formatters menerima dua atribut: select dan style.

  • Masukkan ekspresi logika di atribut select untuk menunjukkan nilai data yang akan diformat.
  • Masukkan beberapa JSON ke dalam atribut style untuk menunjukkan cara memformat nilai data.

Misalnya, JSON berikut akan mewarnai setiap nilai data dengan oranye jika lebih besar dari atau sama dengan 380:

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

Bagian berikut menjelaskan potensi nilai atribut select dan style secara lebih mendetail.

Atribut select

Anda dapat menggunakan nilai berikut dalam ekspresi select:

  • value: Variabel ini menampilkan nilai deret. Misalnya, Anda dapat menggunakan select: value > 0 untuk menargetkan semua nilai positif, atau value = 100 untuk hanya mencocokkan deret dengan nilai 100.
  • max: Gunakan select: max untuk menargetkan nilai deret yang memiliki nilai maksimum.
  • min: Gunakan select: min untuk menargetkan nilai deret yang memiliki nilai minimum.
  • percent_rank: Variabel ini menargetkan nilai deret dengan persentil yang ditentukan. Misalnya, Anda dapat menggunakan select: percent_rank >= 0.9 untuk menargetkan nilai deret dalam persentil ke-90.
  • name: Variabel ini menampilkan nilai dimensi deret. Misalnya, jika memiliki diagram yang menampilkan pesanan Terjual, Dibatalkan, dan Dikembalikan, Anda dapat menggunakan select: name = Sold untuk menargetkan deret dengan nilai dimensi Terjual.
  • AND/OR Gunakan AND dan OR untuk menggabungkan beberapa ekspresi logis.

Untuk melihat ekspresi ini diterapkan di Editor Konfigurasi Diagram, lihat contoh Memberi warna pada nilai maksimum, minimum, dan persentil.

Atribut style

Atribut style dapat digunakan untuk menerapkan gaya yang didukung HighCharts. Misalnya, Anda dapat mewarnai nilai deret menggunakan style.color, mewarnai batas deret menggunakan style.borderColor, dan menetapkan lebar batas deret menggunakan style.borderWidth. Untuk daftar opsi gaya yang lebih lengkap, lihat opsi Highcharts untuk series.column.data.

Untuk visualisasi garis, gunakan style.marker.fillColor dan style.marker.lineColor, bukan style.color. Untuk daftar opsi gaya garis yang lebih lengkap, lihat opsi Highcharts untuk series.line.data.marker.

Untuk melihat pemformatan warna yang diterapkan di Editor Konfigurasi Diagram, lihat contoh Memberi warna pada nilai maksimum, minimum, dan persentil.

Contoh

Bagian berikut memberikan contoh beberapa kasus penggunaan umum untuk Editor Konfigurasi Diagram. Untuk mengetahui daftar lengkap atribut yang dapat Anda edit, lihat dokumentasi HighCharts API.

Mengubah warna latar belakang dan warna teks sumbu

Untuk mengubah warna latar belakang visualisasi, gunakan atribut chart.backgroundColor.

Demikian pula, untuk mengubah warna teks sumbu dalam visualisasi, gunakan atribut berikut:

JSON HighCharts berikut mengubah warna latar belakang visualisasi menjadi ungu, dan teks judul dan label sumbu menjadi putih.

{
  chart: {
    backgroundColor: "purple"
  },

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

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

Menyesuaikan warna tooltip

Untuk menyesuaikan warna tooltip, gunakan atribut berikut:

JSON HighCharts berikut mengubah warna latar belakang tooltip menjadi cyan, dan mengubah warna teks tooltip menjadi hitam.

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

Menyesuaikan konten dan gaya tooltip

Untuk menyesuaikan konten tooltip, gunakan atribut berikut:

JSON HighCharts berikut mengubah format tooltip sehingga nilai sumbu x muncul di bagian atas tooltip dalam font yang lebih besar, diikuti dengan daftar semua nilai deret pada titik tersebut.

Contoh ini menggunakan fungsi dan variabel HighCharts berikut:

  • {key} adalah variabel yang menampilkan nilai sumbu x dari titik yang dipilih. (dalam contoh ini, bulan dan tahun).
  • {#each points}{/each} adalah fungsi yang mengulangi kode yang disertakan untuk setiap deret dalam diagram.
  • {series.name} adalah variabel yang menampilkan nama deret.
  • {y:.2f} adalah variabel yang menampilkan nilai sumbu y dari titik yang dipilih, yang dibulatkan ke dua tempat desimal.
    • {y} adalah variabel yang menampilkan nilai sumbu y dari titik yang dipilih.
    • {variable:.2f} membulatkan variable ke dua angka di belakang koma. Lihat dokumentasi template Highcharts untuk mengetahui contoh format nilai lainnya.
{
  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
  },
}

Menambahkan anotasi dan teks diagram

Untuk menambahkan anotasi, gunakan atribut annotations. Untuk menambahkan teks ke diagram, gunakan atribut caption.

Untuk mendapatkan koordinat titik, klik Periksa Metadata Titik di bagian atas dialog Edit Konfigurasi Diagram. Kemudian, tahan kursor di atas titik data yang ingin Anda anotasikan. Looker menampilkan ID titik, yang dapat Anda gunakan dalam atribut annotations.labels.point.

JSON HighCharts berikut menambahkan dua anotasi ke diagram untuk menjelaskan penurunan item inventaris setelah jangka waktu tertentu. Tindakan ini juga akan menambahkan teks ke bagian bawah diagram untuk menjelaskan anotasi secara lebih mendetail.

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

Menambahkan rentang referensi vertikal

Untuk menambahkan rentang referensi vertikal, gunakan atribut xAxis.plotBands.

JSON HighCharts berikut menambahkan band referensi vertikal antara 24 November 2022 dan 29 November 2022 untuk menunjukkan periode penjualan. Tindakan ini juga akan menambahkan teks ke bagian bawah diagram untuk menjelaskan signifikansi rentang.

Perhatikan bahwa atribut to dan from dari xAxis.plotBands harus sesuai dengan nilai data dalam diagram. Dalam contoh ini, karena data berbasis waktu, atribut menerima nilai stempel waktu Unix (1669680000000 untuk 29 November 2022 dan 1669248000000 untuk 24 November 2022). Format tanggal berbasis string seperti MM/DD/YYYY dan DD-MM-YY tidak didukung di atribut HighCharts to dan from.

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

Menambahkan garis putus-putus dan putus-putus

Untuk mengubah garis solid menjadi garis putus-putus atau garis putus, gunakan atribut series.dashStyle.

JSON HighCharts berikut mengubah atribut dashStyle dari deret Customers menjadi garis putus-putus, dan atribut dashStyle dari deret Sales menjadi garis putus-putus.

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

Mewarnai nilai maksimum, minimum, dan persentil

Lihat halaman Cookbook mendapatkan hasil maksimal dari visualisasi Looker: Penyesuaian format bersyarat dalam diagram Cartesius untuk mengetahui contoh mendalam tentang cara mewarnai nilai maksimum, minimum, dan persentil visualisasi Cartesius.

Membuat jenis visualisasi baru

Anda dapat menggunakan Editor Konfigurasi Diagram untuk membuat jenis visualisasi yang tidak disertakan dalam jenis visualisasi default Looker. Artikel berikut memberikan contoh beberapa visualisasi yang dapat Anda desain dengan Editor Konfigurasi Diagram: