Parameter konfigurasi yang dapat diganti

Parameter konfigurasi yang dapat diganti memberikan opsi untuk mengizinkan editor laporan mengubah nilai default dalam sumber data. Menetapkan parameter konfigurasi sebagai dapat diganti akan membuat sumber data lebih fleksibel, dan memberi pengguna cara untuk membuat template laporan yang dapat dikonfigurasi pengguna.

Misalnya, konektor yang menyediakan data cuaca dapat menyertakan parameter lokasi yang memungkinkan pelihat laporan meminta laporan cuaca dari lokasi yang berbeda dengan default.

Dokumen ini menjelaskan cara menentukan parameter yang dapat diganti, diaktifkan untuk modifikasi, dan bagaimana parameter value dapat diubah oleh pengguna laporan. Untuk mempelajari lebih lanjut cara parameter digunakan di Looker Studio, lihat Parameter sumber data.

Peran

Peran pengguna yang dirujuk di seluruh dokumen:

Role	Definisi
Developer konektor	Pengguna yang telah membuat konektor komunitas.
Pemilik sumber data	Pengguna yang membuat dan memiliki sumber data.
Editor laporan	Pengguna dengan akses mode edit ke laporan.
Penampil laporan	Pengguna dengan akses mode tampilan ke laporan.

Menentukan parameter yang dapat diganti

Developer konektor menentukan parameter konfigurasi dalam fungsi getConfig() konektor komunitas. Untuk menentukan parameter konfigurasi sebagai konektor yang dapat diganti akan memanggil setAllowOverride(true).

Catatan: Parameter juga dapat ditentukan sebagai bagian dari kueri kustom BigQuery.

Contoh berikut menentukan 2 parameter yang dapat diganti: zipcode dan units serta 1 parameter yang tidak dapat diganti: days-to-forcecast.

function getConfig(request) {
  var config = cc.getConfig();

  // A
  config
      .newTextInput()
      .setId("zipcode")
      .setName("ZIP Code")
      .setAllowOverride(true);

  // B
  config
    .newSelectSingle()
    .setId("units")
    .setName("Units")
    .addOption(
        config
          .newOptionBuilder()
          .setLabel("Metric")
          .setValue("metric")
    )
    .addOption(
      config
        .newOptionBuilder()
        .setLabel("Imperial")
        .setValue("imperial")
    )
    .setAllowOverride(true);

  // C
  config
    .newTextInput()
    .setId("days-to-forecast")
    .setName("Days to forecast")
      .setAllowOverride(false);


  return config.build();
}

Catatan: Nilai default untuk allowOverride adalah false. Jika tidak ingin mengaktifkan penggantian untuk parameter, Anda dapat menghilangkan panggilan ke setAllowOverride().

Kapan harus menghindari penentuan parameter sebagai dapat diganti

Sebaiknya pelajari cara kerja Konektor, Sumber Data, dan Laporan dengan meninjau Cara Looker Studio terhubung ke data Anda.

Hindari menentukan parameter sebagai dapat diganti dalam kasus berikut:

1. Saat nilai parameter memengaruhi skema.
   • Jika pengguna mengubah parameter value dan skema data baru yang ditampilkan berbeda dengan yang ditetapkan dalam sumber data, laporan apa pun yang bergantung pada sumber data tersebut dapat rusak karena kolom tidak ada.
2. Apakah nilai parameter mengontrol data sensitif. Misalnya, Pemilihan akun.
   • Jangan menetapkan parameter sebagai dapat diganti jika Anda ingin mencegah tampilan atau pembagian data sensitif secara tidak sengaja.

Mengaktifkan parameter untuk pengguna laporan

Pemilik sumber data mengontrol parameter yang dapat diganti yang diizinkan untuk dimodifikasi oleh editor laporan. Demikian pula, editor laporan mengontrol parameter yang dapat diubah oleh viewer laporan.

Izinkan pengedit laporan mengubah nilai parameter

Pemilik sumber data mengontrol parameter yang diizinkan untuk diubah dalam laporan. Hal ini dikonfigurasi selama pembuatan atau pengeditan sumber data dan hanya berlaku untuk parameter yang telah ditetapkan sebagai dapat diganti oleh Developer konektor. Jika diaktifkan, editor laporan akan dapat Mengubah parameter dalam laporan.

Dalam contoh berikut, konektor memiliki 2 parameter yang ditetapkan sebagai dapat diganti: zipcode dan units. Pemilik sumber data hanya mengizinkan zipcode untuk diubah dalam laporan. Dalam laporan, editor laporan memiliki opsi untuk mengubah nilai parameter zipcode.

Izinkan pembaca laporan mengubah nilai parameter

Editor laporan mengontrol parameter yang dapat diubah oleh pembaca laporan. Nilai parameter ini kemudian dapat diubah melalui URL laporan oleh pelihat laporan.

Catatan: Kontrol editor laporan terhadap izin parameter untuk diubah dibatasi untuk parameter yang diizinkan oleh pemilik sumber data.

Misalnya, pertimbangkan konektor yang memiliki 2 parameter yang ditetapkan sebagai dapat diganti: zipcode dan units (gambar 1). Jika pemilik sumber data telah mengizinkan zipcode untuk diubah dalam laporan (gambar 2), editor laporan hanya akan dapat mengizinkan zipcode untuk diubah oleh pembaca laporan. Editor laporan tidak akan memiliki akses atau visibilitas sehingga parameter units dapat diubah oleh pelihat laporan.

Gambar 1: Konfigurasi konektor.

Gambar 2: Mengelola parameter.

Peringatan: Pembaca laporan akan dapat mengakses data apa pun yang dikontrol oleh parameter. Untuk menghindari pembagian data sensitif secara tidak sengaja, tinjau dan pastikan sumber data dan kredensial sumber data dikonfigurasi dengan benar sebelum mengizinkan perubahan parameter. Jika parameter memungkinkan akses ke data sensitif, pertimbangkan untuk menggunakan kredensial pelihat untuk memastikan pembaca laporan hanya dapat melihat datanya.

Parameter URL

Untuk mengizinkan pembaca laporan mengedit nilai parameter melalui URL laporan:

1. Edit laporan.
2. Pilih Aset -> Kelola parameter URL laporan.
3. Gunakan kotak centang Izinkan untuk diubah di URL laporan untuk mengizinkan atau melarang modifikasi nilai parameter dalam URL laporan. Perubahan akan disimpan secara otomatis.
4. Klik Tutup di kanan atas.

Memodifikasi parameter value

Editor laporan dapat mengubah parameter value menggunakan panel properti laporan, sedangkan pembaca laporan dapat mengubah parameter value melalui URL laporan.

Panel properti laporan

Untuk mempelajari cara editor laporan dapat menetapkan parameter value, baca artikel Mengubah parameter dalam laporan.

Parameter URL laporan

Untuk parameter yang diizinkan untuk diubah di URL laporan, nilai dapat ditetapkan melalui objek JSON yang dienkode URL yang ditambahkan ke URL laporan dalam mode tampilan.

Untuk membuat konfigurasi URL:

1. Mengumpulkan nama parameter

   1. Edit laporan.
   2. Pilih Aset -> Kelola parameter URL laporan.
   3. Catat nama parameter yang ingin Anda tetapkan melalui URL laporan.

   Misalnya, dalam gambar di bawah nama parameter adalah ds0.zipcode.

   

2. Membuat objek parameter

   Parameter ditentukan melalui objek JSON. Kunci untuk parameter value adalah nama parameter.

   {
     "parameterName": parameterValue
   }
   

   Jenis nilai parameter adalah salah satu dari STRING, NUMBER, atau BOOLEAN. Untuk parameter yang menerima beberapa nilai (yaitu, dropdown Multi-pilihan), gunakan array nilai.

   Misalnya, jika nama parameternya adalah ds0.zipcode, untuk menetapkan Kode Pos ke 94094, JSON-nya adalah sebagai berikut:

   {
     "ds0.zipcode": "94094"
   }
   

3. Mengenkode objek parameter URL

   Setelah Anda membuat objek parameter, gunakan JSON.stringify() untuk mengubahnya menjadi string, lalu gunakan [encodeURIComponent] untuk mengenkodenya ke URL.

   var params = {
     "ds0.zipcode": "94094"
   };
   var paramsAsString = JSON.stringify(params);
   var encodedParams = encodeURIComponent(paramsAsString)
   

   Ini menghasilkan string yang dienkode berikut:

   "%7B%22ds0.zipcode%22%3A%2294094%22%7D"
   

4. Membuat URL laporan

   Setelah memiliki objek parameter yang dienkode ke URL, tambahkan ke URL tampilan laporan menggunakan parameter kueri params.

   https://lookerstudio.google.com/reporting/REPORT_ID/page/PAGE_ID?params=%7B%22ds0.zipcode%22%3A%2294094%22%7D

   Pastikan Anda mengganti REPORT_ID dan PAGE_ID dengan nilai untuk laporan dan halaman Anda.

5. Gunakan URL

   URL laporan akan mengganti parameter seperti yang ditetapkan dalam objek parameter JSON berdasarkan Pewarisan parameter.

Contoh objek parameter

Objek parameter berikut menunjukkan cara menetapkan beberapa parameter. Contoh ini juga menggambarkan penetapan parameter value untuk berbagai jenis input.

• ds0.includeToday adalah input kotak centang
• ds0.units adalah input satu pilihan
• ds1.countries adalah input multi-pilihan
• ds1.labelName adalah input teks.

  {
    "ds0.includeToday": true,
    "ds0.units": "Metric",
    "ds1.countries": ["Canada", "Mexico"],
    "ds1.labelName": "Population"
  }

Pewarisan parameter

Nilai yang digunakan untuk parameter mengikuti urutan prioritas berdasarkan tempat parameter ditetapkan. Parameter yang ditetapkan pada lokasi dengan prioritas lebih tinggi akan menggantikan parameter yang ditetapkan di lokasi dengan prioritas lebih rendah. Urutan prioritas (dari terendah ke tertinggi) adalah:

1. Sumber data (default)
2. URL laporan
3. Panel properti laporan, dengan mengikuti aturan pewarisan parameter sumber data.