Parameter

Parameter memungkinkan Anda berinteraksi dengan data yang disediakan pengguna. Misalnya, Anda dapat membuat kolom kalkulasi yang menyertakan input dari orang yang menggunakan laporan Anda, atau meneruskan nilai kembali ke kueri SQL yang digunakan oleh sumber data Anda. Penggunaan parameter akan membuat laporan Anda lebih interaktif. Anda juga dapat menggunakan parameter untuk membuat template laporan.

Dalam artikel ini:

• Cara kerja parameter
• Membuat parameter
• Parameter dan Konektor komunitas
• Mengedit parameter yang ada
• Mengonfigurasi parameter
• Menetapkan nilai parameter
• Menggunakan parameter
• Menampilkan/menyembunyikan parameter di laporan
• Menyalin komponen dengan parameter
• Memperbaiki parameter tidak valid
• Referensi terkait

Cara kerja parameter

Parameter berfungsi seperti variabel dalam bahasa pemrograman. Parameter memiliki 3 kegunaan utama:

• Anda dapat menggunakan parameter di kolom kalkulasi untuk menampilkan hasil berdasarkan input pengguna.
• Anda dapat meneruskan parameter kembali ke kueri SQL kustom dalam sumber data BigQuery.
• Anda dapat meneruskan parameter kembali ke konektor komunitas.

Parameter bisa mendapatkan datanya dari sumber berikut:

• Dari nilai default yang ditentukan untuk parameter.
• Dari panel properti komponen.
• Dari kontrol yang ditempatkan pada laporan.
• Dari link ke laporan.

Anda akan menemukan parameter di bagian bawah daftar kolom dalam editor laporan dan sumber data. Parameter muncul sebagai kolom berwarna ungu.

Cara parameter membagikan data dalam laporan

Pengedit laporan dan sumber data Anda dapat mengakses data apa pun yang dikontrol oleh parameter.

Parameter memungkinkan pengedit laporan meminta data yang berbeda dari default. Sebelum mengaktifkan parameter untuk sumber data, pastikan Anda memahami pengaruh perubahan parameter terhadap data dalam laporan. Beberapa parameter mungkin hanya menampilkan data yang secara relatif "aman", seperti cuaca di lokasi baru. Namun, parameter lain dapat memungkinkan seseorang meminta set data yang benar-benar baru. Misalnya, parameter nomor akun atau nama tabel database akan berpotensi menampilkan data yang tidak bermaksud Anda bagikan, atau mungkin menampilkan skema berbeda, yang mungkin tidak kompatibel dengan diagram yang ada dalam laporan.

Membuat parameter

Anda dapat membuat parameter di tempat berikut:

Dalam sumber data

1. Edit sumber data.
2. Di kanan atas, klik TAMBAHKAN PARAMETER.
   Anda juga dapat membuat parameter saat mengedit laporan dengan memilih komponen lalu mengklik TAMBAHKAN PARAMETER di kanan bawah. Pastikan untuk memilih komponen berdasarkan sumber data yang diinginkan.
3. Konfigurasikan opsi parameter dan nilai default (lihat di bawah).

Saat mengedit laporan, Anda dapat menggunakan link +Tambahkan parameter di panel data untuk membuat parameter di sumber data yang dipilih.

Di konektor BigQuery

Anda dapat meneruskan parameter ke kueri SQL kustom di konektor BigQuery. Konektor BigQuery mendefinisikan beberapa parameter standar yang meneruskan tanggal mulai dan akhir laporan, serta alamat email pengguna, jika tersedia. Anda juga dapat meneruskan parameter kustom. Pelajari lebih lanjut.

Parameter dan Konektor komunitas

Konektor komunitas dapat menyertakan parameter yang dapat diganti, yang memungkinkan editor laporan mengubah nilai defaultnya di sumber data. Jika Anda dapat mengedit koneksi untuk sumber data yang dibuat dengan Konektor komunitas, Anda dapat menentukan parameter yang dapat diubah oleh editor laporan:

1. Edit sumber data.
2. Di kiri atas, klik EDIT KONEKSI.
3. Jika konektor menyediakan parameter yang dapat diedit, parameter muncul di bagian bawah halaman. Konektor yang memungkinkan Anda menentukan parameter kustom akan mencantumkan petunjuk pada halamannya.
4. Gunakan kotak centang Izinkan <nama parameter> untuk dimodifikasi dalam laporan untuk mengizinkan atau melarang pengeditan parameter dalam laporan.
5. Di kanan atas, klik HUBUNGKAN KEMBALI.

Setelah Anda membuat sumber data dari konektor komunitas, perubahan parameter di konektor tersebut tidak akan otomatis muncul dalam sumber data. Anda harus menghubungkan kembali sumber datanya untuk melihat parameter yang baru, dihapus, atau diubah.

Mengedit parameter yang ada

Untuk mengubah konfigurasi parameter yang ada:

1. Edit sumber data yang berisi parameter tersebut.
2. Temukan parameternya dalam daftar kolom.
3. Klik tanda @ di sebelah kanan nama parameter.
4. Buat perubahan, lalu di kanan bawah, klik SIMPAN.

Mengonfigurasi parameter

Gunakan opsi ini untuk mengonfigurasi parameter dalam sumber data. Untuk parameter konektor BigQuery dan konektor komunitas, lihat artikel yang disebutkan di atas.

Nama parameter: Anda akan melihat nama ini dalam daftar kolom di laporan dan sumber data. Nama ini juga akan Anda gunakan untuk mereferensikan parameter dalam kolom kalkulasi.

ID Parameter: ditetapkan secara default. ID parameter digunakan secara internal oleh Looker Studio untuk mengidentifikasi parameter. Pelihat laporan tidak akan melihatnya.

Mengubah ID Parameter akan menimbulkan error pada komponen dan kolom kalkulasi yang menyertakan parameter tersebut.

Jenis data: parameter dapat menyimpan teks, angka, atau nilai Boolean (benar/salah).

Nilai yang diizinkan: menentukan nilai yang dapat dimasukkan oleh pengguna.

Untuk menentukan daftar nilai, pilih opsi tersebut, lalu masukkan nilai yang dapat diterima bersama dengan nama tampilan opsional. Klik Tambahkan opsi untuk menambahkan item lainnya ke daftar.

Untuk menentukan rentang nilai yang diizinkan, masukkan nilai minimum dan maksimum untuk rentang tersebut.

Nilai default: menentukan nilai awal untuk parameter.

Menetapkan nilai parameter

Anda dapat menetapkan nilai parameter dengan cara berikut:

Menetapkan nilai default untuk parameter

Anda dapat menetapkan nilai default untuk parameter saat membuatnya. Untuk menyesuaikan nilai default, ikuti langkah-langkah di atas untuk mengedit parameter.

Menggunakan kontrol untuk mendapatkan input dari pengguna

Kontrol adalah komponen yang memungkinkan orang berinteraksi dengan laporan. Untuk menyimpan input pengguna dalam parameter, tambahkan parameter tersebut ke properti Kolom kontrol dalam suatu kontrol:

1. Edit laporan.
2. Di bagian atas, klik Tambahkan kontrol.
3. Pilih jenis kontrol yang akan ditambahkan.
4. Di sebelah kanan, di panel properti, pilih tab PENYIAPAN.
5. Tambahkan parameter ke Kolom kontrol.

Pelajari kontrol lebih lanjut.

Mengganti nilai parameter default dalam komponen

Anda dapat mengganti nilai default untuk parameter dengan mengedit masing-masing komponen dalam laporan:

1. Edit laporan.
2. Pilih komponen berdasarkan sumber data yang berisi parameter tersebut.
3. Di bagian bawah tab DATA untuk komponen, edit nilai parameter default.

Anda juga dapat mengedit parameter pada tingkat laporan dan halaman:

1. Edit laporan.
2. Pilih File > Setelan Laporan atau Halaman > Setelan Halaman Saat Ini.
3. Edit nilai parameter.

Pewarisan parameter

Parameter mengikuti aturan pewarisan yang sama seperti properti filter. Secara khusus, parameter pada komponen berprioritas lebih tinggi menggantikan parameter pada komponen berprioritas lebih rendah. Urutan prioritas (dari terendah ke tertinggi) adalah:

1. Sumber data (default)
2. Laporan
3. Halaman
4. Grup
5. Diagram atau kontrol tunggal

Mengubah parameter melalui link laporan

Dengan menetapkan parameter melalui URL laporan, developer dan pengguna tingkat lanjut dapat membuat laporan yang dapat dikonfigurasi secara terprogram.

Parameter laporan Looker Studio dan nilainya yang sesuai diteruskan sebagai string JSON yang dienkode URL dan ditambahkan ke URL laporan menggunakan parameter kueri "params".

Pelajari lebih lanjut dalam Panduan Developer.

Mengelola parameter URL laporan

Parameter di laporan Anda secara default tidak dapat diedit melalui URL laporan.

Untuk memilih parameter yang dapat disesuaikan oleh pengguna laporan:

1. Edit laporan.
2. Pilih Aset > Kelola parameter URL laporan.
3. Di kolom Izinkan penyetelan melalui URL laporan, centang parameter yang ingin Anda izinkan.

Halaman ini juga menampilkan parameter URL untuk setiap parameter. Ini adalah nama yang akan Anda gunakan saat membuat objek parameter yang dienkode, bukan nama Parameter. Anda dapat mengedit nama ini dengan mengklik ikon pensil. Setiap parameter URL dalam laporan harus berbeda.

Mengedit nama parameter URL tidak memengaruhi cara parameter digunakan dalam laporan.

Menggunakan parameter

Setelah dibuat, Anda dapat menggunakan parameter dalam kolom kalkulasi dan komponen laporan seperti menggunakan dimensi dan metrik.

Menggunakan parameter dalam kolom kalkulasi

Anda dapat menggunakan parameter sama seperti menggunakan dimensi atau metrik dalam kolom kalkulasi.

Kolom kalkulasi dengan contoh parameter

Misalnya, Anda ingin memvisualisasikan perkiraan penjualan dengan memungkinkan seseorang memasukkan pengganda ke penjualan Anda dari kuartal lalu.

Pertama, buat parameter untuk menyimpan pengganda perkiraan:

1. Login ke Looker Studio.
2. Edit sumber data Anda.
3. Di kanan atas, klik TAMBAHKAN PARAMETER.
4. Beri nama parameter tersebut (misalnya, "Pengganda perkiraan").
5. Tetapkan Jenis data ke Angka.
6. Untuk memudahkan, biarkan opsi Nilai yang diizinkan ditetapkan ke Semua nilai.
   Anda dapat menggunakan opsi lain untuk memungkinkan pengguna memilih dari daftar nilai, atau membatasi pilihan mereka menurut rentang nilai tertentu.
7. Tetapkan Nilai default ke 1.
8. Klik Simpan.
9. Untuk kembali ke daftar kolom sumber data, klik SEMUA KOLOM di sebelah kiri.

Selanjutnya, buat kolom kalkulasi:

1. Di kanan atas, klik TAMBAHKAN KOLOM.
2. Beri nama kolom tersebut (misalnya, "Perkiraan penjualan dengan parameter").
3. Pada formula, kalikan kolom "Penjualan" dari sumber data Anda dengan parameter Pengganda perkiraan. Misalnya, jika sumber data Anda memiliki kolom yang disebut Pendapatan, masukkan:
   Pendapatan * Pengganda perkiraan
4. Klik Simpan.

Selanjutnya, tambahkan kontrol untuk mengumpulkan input pengguna:

1. Edit atau buat laporan.
2. Jika perlu, tambahkan sumber data Anda ke laporan.
3. Di bagian atas, klik Tambahkan kontrol.
4. Pilih kontrol Kotak input.
   Kontrol Kotak input memungkinkan Anda langsung mengetik nilai parameter. Jenis kontrol lain memungkinkan Anda memilih dari daftar, menggunakan penggeser, atau menentukan nilai Boolean dengan kotak centang.
5. Di sebelah kanan, di properti DATA, tambahkan parameter Pengganda perkiraan yang Anda buat sebelumnya.

Terakhir, visualisasikan kolom kalkulasi yang dibuatkan parameter dalam diagram.

1. Di bagian atas, klik  Tambahkan diagram.
2. Untuk memudahkan, pilih Kartu skor.
3. Di sebelah kanan, di properti DATA, tambahkan kolom kalkulasi Perkiraan penjualan dengan parameter sebagai Metrik.

Coba sekarang:

1. Di kanan atas, klik Lihat.
2. Masukkan angka dalam kontrol Pengganda perkiraan, lalu tekan Enter.
3. Anda akan melihat nilai dalam kartu skor berubah karena dikalikan dengan nilai yang Anda masukkan.

Menggunakan parameter dalam visualisasi

Anda dapat menambahkan parameter ke diagram, seperti dimensi atau metrik. Jika Anda menggunakan parameter angka sebagai metrik, nilainya akan digabungkan.

Menampilkan/menyembunyikan parameter di laporan

Anda dapat menampilkan atau menyembunyikan parameter yang telah Anda buat dalam sumber data:

1. Edit sumber data Anda.
2. Temukan parameternya.
3. Di sebelah kanan parameter, klik opsi .
4. Klik Tampilkan (jika parameter saat ini disembunyikan) atau Sembunyikan (jika parameter saat ini ditampilkan).

Jika disembunyikan, parameter akan dihapus dari daftar kolom di panel Data, dan akan menyebabkan error pada setiap komponen yang menggunakannya. Jika parameter digunakan dalam kolom kalkulasi, formulanya akan menggunakan nilai default parameter tersebut.

Menyalin komponen dengan parameter

Jika komponen disalin, nilai parameternya yang ditetapkan di panel properti juga akan disalin. Anda dapat mengganti parameter komponen yang disalin dengan mengedit komponen tersebut.

Memperbaiki parameter tidak valid

Jika konfigurasi parameter berubah dalam konektor, setiap diagram yang menggunakan parameter tersebut dapat rusak. Misalnya, developer konektor dapat menghapus kemampuan untuk mengganti nilai parameter, dan nilai yang Anda sediakan dalam laporan tidak lagi menampilkan data yang valid. Dalam kasus ini, Anda akan melihat pesan error di setiap diagram yang dipengaruhi oleh perubahan tersebut.

Untuk memperbaikinya, temukan komponen yang berisi parameter yang sekarang tidak valid. Kemudian, di bagian Parameter untuk properti DATA komponen tersebut, klik Perbaiki Nilai Tidak Valid.

Perhatikan bahwa parameter dapat ditetapkan pada tingkat laporan, halaman, dan grup, serta pada diagram tunggal, sehingga Anda mungkin perlu mencari error tersebut di beberapa tempat dan memperbaikinya.

Referensi terkait

Tentang kontrol