Cara mengonfigurasi parameter global dalam skenario lompatan, langganan email, dan penyematan laporan - Quick BI

Quick BI menyediakan parameter global untuk mengonfigurasi variabel. Saat mengonfigurasi bagan, Anda dapat merujuk variabel global untuk menampilkan data yang berbeda kepada pengguna yang berbeda. Topik ini menjelaskan cara mengonfigurasi parameter global dalam skenario seperti lompatan, langganan email, dan penyematan laporan.

Informasi Latar Belakang

Sebagai contoh, tim penjualan yang melayani semua wilayah di Tiongkok harus melacak penjualan di lebih dari 30 provinsi, bersama dengan kota dan kabupaten di setiap provinsi secara real-time. Seiring dengan pertumbuhan bisnis yang terus berlanjut, tim tersebut harus mengelola jumlah data penjualan yang semakin meningkat. Di tengah kompleksitas dan volume data yang besar, Quick BI memberikan solusi yang memungkinkan penanggung jawab suatu wilayah hanya melihat data di wilayah tersebut. Hal ini meningkatkan efisiensi kerja dan mencegah kebocoran data bisnis sensitif.

Parameter global menyediakan titik masuk standar untuk laporan, memungkinkan pengguna laporan untuk secara dinamis mengubah kondisi filter bagan dan kontrol kueri dalam laporan dengan menyuntikkan parameter URL saat melihat pratinjau laporan, sehingga mengontrol hasil tampilan data internal bagan dari luar. Objek yang terpengaruh oleh parameter global mencakup dua jenis berikut:

Kontrol kueri: Setelah menerima parameter global, kontrol kueri langsung menggunakan kondisi yang disuntikkan oleh parameter global sebagai nilai default dan mengikatnya ke sub-komponen tertentu.
null
Bagan yang sebenarnya terpengaruh masih bergantung pada ruang lingkup aksi yang dipilih oleh sub-komponen terkait. Karena hanya nilai default yang diubah, pengguna laporan sebenarnya dapat mengubah nilai aktual sub-komponen untuk melepaskan diri dari kendali parameter global.
Bagan: Bagan yang terkait dengan parameter global pada dasarnya menambahkan fragmen AND ke kueri SQL akhir bagan (misalnya, and area = 'North China'). Proses ini diuraikan langsung oleh server berdasarkan konfigurasi parameter global, sehingga pengguna laporan tidak dapat mengubah hasil ini dan hanya dapat memverifikasi hasil data melalui sqlText yang dihasilkan pada akhirnya.

Petunjuk Konfigurasi Parameter Global

Titik masuk untuk konfigurasi parameter global terletak di bagian atas laporan. Saat membuat laporan baru, ikon parameter global disembunyikan dan hanya ditampilkan setelah disimpan. Halaman konfigurasi parameter global ditunjukkan di bawah ini.

Area	Deskripsi
①	Titik masuk konfigurasi parameter global. Konfigurasi parameter global bergantung pada model data komponen dalam laporan. Disarankan untuk mengonfigurasi ulang parameter global setelah setiap pembaruan model bagan.
②	Konfigurasikan variabel global. Nama bucket harus memenuhi persyaratan berikut: Nama tampilan dapat memiliki panjang maksimal 50 karakter. Hanya huruf Inggris, angka, dan garis bawah yang didukung. Anda dapat mengklik ikon untuk membuat beberapa parameter global.
③	Pilih kontrol dan bagan yang terkait dengan parameter. Ketika objek terkait adalah Query Control, Anda perlu memilih kondisi terkait dalam kontrol kueri. Jenis tampilan kondisi terkait kontrol kueri akan membatasi rentang jenis nilai yang dapat diterima oleh parameter global (misalnya, Anda tidak dapat menyuntikkan parameter global bertipe teks atau format tanggal tunggal ke dalam komponen bertipe rentang tanggal). Jika ada konflik dalam jenis tampilan kondisi terkait kontrol kueri, parameter global tidak dapat disimpan secara normal. Ketika objek terkait adalah Chart, sistem akan mengkategorikan bagan berdasarkan dataset. Ketika Anda memilih bidang dalam dataset dan memilih bagan target, kondisi yang disuntikkan oleh parameter global akan secara otomatis diisi ke dalam kueri SQL bagan yang dipilih. Ketika beberapa bidang dataset dipilih, jenis dan granularitas (tahun, bulan, hari, jam, menit, detik) dari bidang yang dipilih harus konsisten, jika tidak, konfigurasi parameter akan gagal. Jika Anda mengaitkan baik Query Controls maupun Charts, jenis kondisi terkait kontrol kueri harus sesuai dengan jenis bidang dataset bagan. Karena kondisi terkait kontrol kueri membatasi model nilai input, ketika menyuntikkan parameter global, Anda harus mencoba memenuhi persyaratan injeksi kondisi terkait kontrol kueri untuk memastikan bahwa baik kontrol kueri maupun bagan berfungsi. null Untuk memastikan akurasi dan efektivitas injeksi parameter, dalam penggunaan aktual, Anda harus mencoba memastikan bahwa setiap parameter memiliki tanggung jawab yang jelas dan tunggal. Berhati-hatilah saat mengaitkan parameter global dengan beberapa kontrol kueri atau mencampur kontrol kueri dan dataset. Jika kebutuhan bisnis aktual mengharuskannya, disarankan untuk menambahkan beberapa parameter untuk mengontrol kontrol kueri dan bagan secara terpisah. Pemilihan bidang: Kontrol kueri dan pemilihan jenis bidang bagan didukung waktu (jam, menit, dan detik belum didukung), teks (termasuk geografi, URL), jenis numerik, dan placeholder. Untuk metode konfigurasi placeholder, lihat Placeholder.
④	Pengaturan parameter. Parameter Name: Secara default, ini sesuai dengan nama parameter global yang telah ditetapkan. ID harus memenuhi persyaratan berikut: Nama tampilan dapat memiliki panjang maksimal 50 karakter. Hanya huruf Inggris, angka, dan garis bawah yang didukung. null Ketika Parameter Name tidak diisi atau ada konflik dalam konfigurasi parameter, halaman akan menampilkan pesan kesalahan, dan parameter global tidak dapat disimpan. Parameter Alias: Jika Anda memerlukan informasi petunjuk dalam bahasa Mandarin, Anda dapat mengaturnya di sini. Required Global Parameter: Pilih apakah parameter global wajib. Ketika dipilih, saat melihat laporan nanti, kontrol kueri dan bagan akan memeriksa apakah parameter yang sesuai memiliki nilai yang disuntikkan. Jika tidak ada nilai yang disuntikkan, kontrol kueri akan menggunakan nilai default yang ditetapkan dalam keadaan edit terlebih dahulu, sedangkan bagan akan menampilkan kegagalan pengambilan data (parameter global tidak boleh kosong). Allow Query Control To Change Input Value: Ketika dipilih, sub-kondisi terkait parameter dikunci secara default dalam keadaan pratinjau, artinya operator dan nilai sub-kondisi kontrol kueri tidak dapat diubah.

null

Untuk memastikan validitas parameter, deteksi real-time dilakukan selama proses konfigurasi parameter global. Jika terjadi konflik dengan satu parameter, semua parameter global tidak dapat disimpan.
Proses konfigurasi parameter global bergantung pada konten laporan saat ini. Perubahan pada laporan dapat menyebabkan injeksi parameter global yang telah dikonfigurasi sebelumnya gagal. Oleh karena itu, disarankan untuk meninjau efektivitas konfigurasi parameter global setelah setiap perubahan laporan. Jika ada konflik dalam konfigurasi parameter global, sesuaikan isi parameter yang sesuai sesuai dengan petunjuk.

Skema

Skema Lompatan

Ambil lompatan dari daftar peringkat (informasi pesanan) ke tabel silang (informasi produk) sebagai contoh.

Masuk ke Konsol Quick BI.
Pergi ke halaman dashboard.
Di dashboard Rincian Pesanan Produk Taobao, buat tabel silang Informasi Produk dan konfigurasikan parameter global untuk tabel silang tersebut.
1. Di tab Data, pilih data penjualan sebagai dataset dan namai Taobao Product Order Details.
2. Tambahkan tabel silang ke dashboard, namai Product Information, dan klik Save di bilah menu di bagian atas dashboard.
3. Di bilah menu di bagian atas dashboard, klik ikon .
4. Di halaman Global Parameter Configuration, konfigurasikan parameter global sesuai contoh di bawah ini, lalu klik OK.
5. Di bilah menu di bagian atas dashboard, klik Save And Publish.
Di dashboard Rincian Penjualan Pesanan, buat daftar peringkat Informasi Pesanan dan atur untuk melompat ke tabel silang Informasi Produk.
1. Di tab Data halaman pengeditan dashboard, pilih data penjualan sebagai dataset dan namai Order Sales Details.
2. Tambahkan daftar peringkat ke dashboard seperti yang ditunjukkan di bawah ini dan namai Order Information.
3. Klik tab Analisis, dan di area Interaksi Data, klik ikon Jump Configuration .
4. Di halaman Jump, atur parameter seperti yang ditunjukkan di bawah ini dan klik OK.
  Untuk informasi lebih lanjut, lihat Lompatan.
5. Klik Order Number target di daftar peringkat Order Information, dan secara otomatis akan melompat ke dashboard Taobao Product Order Details dan menampilkan informasi produk untuk Order Number target.
  Gambar berikut menunjukkan halaman yang muncul.

Skema Langganan Email

Saat membuat tugas langganan email, Anda dapat menyuntikkan kondisi filter ke dalam bagan dalam laporan melalui parameter global. Berikut hanya memperkenalkan penggunaan parameter global dalam langganan email. Untuk informasi lebih lanjut, lihat Buat Tugas Langganan.

Di halaman Create Task langganan email, atur Content tugas langganan ke dashboard dengan parameter global yang telah dikonfigurasi.
Setelah diatur ke dashboard dengan parameter global yang telah dikonfigurasi, sistem akan secara otomatis memunculkan daftar parameter global yang sesuai. Parameter global awalnya belum dikonfigurasi dan tidak berlaku secara default.
Mengatur Parameter Value menjadi kosong dan tidak mengatur parameter adalah dua keadaan yang berbeda. Jika Parameter Value diatur menjadi kosong dan kontrol kueri terkait mengizinkan nilai kosong, nilai kondisi terkait akan diatur ulang menjadi kosong. Jika Parameter Value tidak diatur, itu tidak akan memengaruhi kontrol kueri dan bagan.
Klik ikon di kolom Operation untuk mengonfigurasi parameter global.
Konten item konfigurasi parameter akan secara otomatis cocok dengan jenis bidang terkait parameter. Saat mengaitkan bagan, konfigurasi parameter memungkinkan pengubahan bentuk kondisi. Saat mengaitkan kontrol kueri, hanya mengubah operator dan nilai yang diizinkan.
Setelah menyelesaikan konfigurasi parameter tugas langganan, Anda dapat memastikan bahwa parameter yang sesuai akan secara otomatis disuntikkan ke dalam kondisi filter laporan setiap kali tugas langganan dilakukan.

Skema Penyematan Laporan

Untuk informasi lebih lanjut, lihat Solusi Peningkatan Keamanan untuk Kontrol Izin Data Tersemat dan Transmisi Parameter dalam Laporan.