Parameter dasbor LookML

Dasbor dapat dibuat dengan salah satu dari dua cara berikut. Dasbor yang ditentukan pengguna dibuat menggunakan UI Looker, dan dijelaskan di halaman dokumentasi Membuat dasbor yang ditentukan pengguna. Dasbor juga dapat dibuat menggunakan LookML dan setelan keseluruhannya diubah seperti yang dibahas di halaman ini.

Halaman ini menjelaskan parameter dasbor LookML yang memengaruhi seluruh dasbor.

Dasbor LookML juga berisi elemen, yaitu visualisasi data, kartu teks, dan tombol pada dasbor. Lihat halaman Parameter elemen dasbor untuk melihat link ke halaman referensi bagi setiap jenis elemen.

Contoh penggunaan

- dashboard: dashboard_name
  preferred_viewer: dashboards | dashboards-next
  title: "chosen dashboard title"
  description: "chosen dashboard description"
  enable_viz_full_screen: true | false
  extends: name_of_dashboard_being_extended
  extension: required
  layout: tile | static | grid | newspaper
  rows:
    - elements: [element_name, element_name, ...]
      height: N
  tile_size: N
  width: N
  refresh: N (seconds | minutes | hours | days)
  auto_run: true | false

  # DASHBOARD FILTER PARAMETERS
  crossfilter_enabled: true | false
  filters_bar_collapsed: true | false
  filters_location_top: true | false
  filters:
  - name: filter_name
    title: "chosen filter title"
    type: field_filter | number_filter | date_filter | string_filter
    model: model_name
    explore: explore_name
    field: view_name.field_name
    default_value: Looker filter expression
    allow_multiple_values: true | false
    required: true | false
    ui_config:
      type: button_group | checkboxes | range_slider | tag_list | radio_buttons |
            button_toggles | dropdown_menu | slider | day_picker | day_range_picker |
            relative_timeframes | advanced
      display: inline | popover | overflow
      options:
        min: N
        max: N
      - value options
    listens_to_filters:
    - filter_name
      field: view_name.field_name

  # EMBEDDED DASHBOARD PARAMETERS
  embed_style:
    background_color: "css_color"
    show_title: true | false
    title_color: "css_color"
    show_filters_bar: true | false
    tile_background_color: "css_color"
    tile_text_color: "css_color"

  # ELEMENTS PARAMETERS
  elements:
  # One or more element declarations

Definisi parameter

Nama Parameter Deskripsi
dashboard Buat dasbor.
preferred_viewer Parameter ini diabaikan.
title (untuk dasbor) Mengubah cara nama dasbor ditampilkan kepada pengguna.
description (untuk dasbor) Tambahkan deskripsi yang dapat dilihat di panel Detail Dasbor atau di folder yang disetel ke tampilan daftar.
enable_viz_full_screen Tentukan apakah pelihat dasbor dapat melihat kartu dasbor dalam tampilan layar penuh dan yang diperluas.
extends Mendasarkan dasbor LookML pada dasbor LookML lain.
extension Mengharuskan dasbor diperluas oleh dasbor lain.
layout Tentukan cara dasbor akan menempatkan elemen.
rows Mulai bagian LookML untuk menentukan elemen yang harus masuk ke setiap baris dasbor layout: grid.
elements (untuk baris) Tentukan elemen yang harus masuk ke baris dasbor layout: grid.
height (untuk baris) Tentukan tinggi baris untuk dasbor layout: grid.
tile_size Tentukan ukuran kartu untuk dasbor layout: tile.
width (untuk dasbor) Tentukan lebar dasbor untuk dasbor layout: static.
refresh (untuk dasbor) Tetapkan interval saat elemen dasbor akan diperbarui secara otomatis.
auto_run Menentukan apakah dasbor dijalankan secara otomatis saat pertama kali dibuka atau dimuat ulang.
Parameter Filter
crossfilter_enabled Aktifkan atau nonaktifkan filter silang untuk dasbor.
filters_bar_collapsed Ditambahkan 21.16 Tetapkan kolom filter dasbor sebagai dikecilkan atau diperluas secara default untuk dasbor.
filters_location_top Ditambahkan 22,8 Tetapkan lokasi kolom filter dasbor sebagai atas atau kanan untuk dasbor.
filters (untuk dasbor) Mulai bagian LookML untuk menentukan filter dasbor.
name (untuk filter) Membuat filter.
title (untuk filter) Mengubah cara nama filter ditampilkan kepada pengguna.
type (untuk filter) Tentukan jenis filter yang akan digunakan.
default_value Menetapkan nilai default untuk filter.
allow_multiple_values Membatasi pengguna pada satu nilai filter.
required Mewajibkan pengguna memasukkan nilai filter untuk menjalankan dasbor.
ui_config Konfigurasi kontrol filter yang tersedia saat pengguna melihat dasbor LookML. Memiliki subparameter type, display, dan options.
model (untuk filter) Tentukan model yang berisi kolom pokok filter type: field_filter.
explore (untuk filter) Tentukan Eksplorasi yang berisi kolom pokok filter type: field_filter.
field Tentukan kolom pokok filter type: field_filter.
listens_to_filters Mempersempit saran untuk filter dasbor field_filter berdasarkan apa yang dimasukkan pengguna untuk filter dasbor type: field_filter lainnya.
Parameter Dasbor Sematan
embed_style Mulai bagian LookML untuk menentukan penyesuaian dasbor tersemat.
background_color Menetapkan warna latar belakang dasbor sematan.
show_title Tentukan apakah judul dasbor terlihat di dasbor yang disematkan.
title_color Menetapkan warna judul dasbor sematan.
show_filters_bar Tentukan apakah panel filter terlihat di dasbor sematan.
tile_background_color Menetapkan warna latar belakang kartu dasbor sematan.
tile_text_color Menetapkan warna teks kartu dasbor sematan.
Parameter Elemen
elements (untuk dasbor) Mulai bagian LookML untuk menentukan elemen dasbor.

dashboard

Parameter dashboard mendeklarasikan dasbor baru dan menentukan nama untuk dasbor. Jumlah karakter maksimum adalah 255; dan karakter yang diizinkan adalah huruf (A-Z), angka (0-9), tanda hubung (-), dan garis bawah (_). Biasanya, praktik terbaik adalah menempatkan setiap dasbor LookML dalam file LookML-nya sendiri, tetapi beberapa dasbor dapat dideklarasikan dalam satu file.

- dashboard: sales_overview

Untuk menampilkan apa pun, dasbor memerlukan setidaknya satu elemen yang ditambahkan menggunakan parameter elements.

preferred_viewer

Sebelum penghentian penggunaan dasbor lama di Looker 23.6, parameter preferred_viewer memungkinkan Anda memilih format untuk melihat dan mendownload dasbor sebagai dasbor default Looker atau sebagai dasbor lama.

title (untuk dasbor)

Bagian ini mengacu pada parameter title yang merupakan bagian dari dasbor.

title juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di bagian title (untuk filter) di halaman ini.

title juga dapat digunakan sebagai bagian dari elemen dasbor apa pun. Contoh representatif penggunaannya disediakan di halaman dokumentasi elemen diagram batang.

Parameter title memungkinkan Anda mengubah tampilan nama dasbor bagi pengguna di folder dan di bagian atas dasbor. Jika tidak ditentukan, judul defaultnya adalah nama dasbor. Teks judul dapat dilokalkan.

Perhatikan contoh berikut:

- dashboard: sales_overview
  title: "1) Sales Overview"

Jika Anda melakukannya, dasbor akan muncul sebagai 1) Ringkasan Penjualan, bukan Ringkasan Penjualan.

description (untuk dasbor)

Bagian ini mengacu pada parameter description yang merupakan bagian dari dasbor.

description juga dapat digunakan sebagai bagian dari Eksplorasi, seperti yang dijelaskan di halaman dokumentasi parameter description (untuk Eksplorasi).

description juga dapat digunakan sebagai bagian dari kolom, seperti yang dijelaskan di halaman dokumentasi parameter description (untuk kolom).

Parameter description memungkinkan Anda menambahkan deskripsi ke dasbor LookML.

Isi parameter description akan muncul di kolom Deskripsi pada panel Detail Dasbor dasbor LookML.

Deskripsi ditampilkan di bawah judul dasbor dalam daftar dasbor saat dilihat dalam folder yang disetel ke tampilan daftar. Jika deskripsi tidak ditentukan, daftar hanya menampilkan judul dasbor.

Teks deskripsi dapat dilokalkan.

enable_viz_full_screen

Parameter ini hanya berlaku jika setelan Visualisasi Layar Penuh diaktifkan oleh admin Looker. Setelan Visualisasi Layar Penuh diaktifkan secara default.

Parameter enable_viz_full_screen memungkinkan Anda menyetel apakah pelihat dasbor dapat melihat kartu dasbor dalam tampilan layar penuh dan yang diperluas. Setelan ini setara dengan setelan dasbor Izinkan mode layar penuh untuk visualisasi.

Parameter ini menerima nilai true (tampilan layar penuh dan yang diluaskan tersedia) dan false (tampilan layar penuh dan yang diluaskan tidak tersedia). Nilai defaultnya adalah true.

extends

Seperti yang dijelaskan di halaman dokumentasi Menggunakan kembali kode dengan ekstensi, parameter extends memungkinkan Anda mendasarkan satu dasbor LookML pada dasbor LookML lain, yang mungkin menambahkan atau mengganti beberapa setelan. Parameter extends menerima nama dasbor LookML lain.

Saat memperluas objek, perhatikan bahwa aturan pelokalan juga berlaku untuk perluasan Anda. Jika Anda memperluas objek, lalu menentukan label atau deskripsi baru, Anda harus memberikan definisi pelokalan dalam file string bahasa project. Lihat halaman dokumentasi Melokalkan model LookML untuk mengetahui informasi selengkapnya.

extension

Seperti yang dijelaskan di halaman dokumentasi Menggunakan kembali kode dengan ekstensi, parameter extension menunjukkan bahwa dasbor harus diperluas oleh dasbor lain. Dasbor ini tidak pernah terlihat oleh pengguna lain, tetapi dapat digunakan sebagai template untuk membuat dasbor lain yang terlihat oleh pengguna lain. Parameter extension hanya menerima nilai required. Jika parameter extension tidak disertakan, ekstensi tidak diperlukan untuk dasbor.

layout

Parameter layout menetapkan metode tata letak yang akan digunakan Looker saat memosisikan elemen dasbor. Atribut ini menerima nilai berikut:

rows

Untuk dasbor layout: grid, parameter rows memulai bagian LookML tempat Anda menentukan elemen mana yang harus masuk ke baris mana, serta tinggi setiap baris. Dalam setiap baris, setiap elemen memiliki lebar yang sama. Jika Anda tidak mencantumkan elemen di bagian ini, elemen tersebut tidak akan muncul di dasbor.

- dashboard: sales_overview
  layout: grid
  rows:
    - elements: [element_name, element_name, ...]
      height: 200
    - elements: [element_name, element_name, ...]
      height: 300

elements

Parameter elements menggunakan daftar nama elemen dasbor, yang dipisahkan dengan koma. Setiap deklarasi elements membuat baris baru di dasbor. Semua elemen yang ditempatkan ke dalam baris akan memiliki lebar yang sama. Jadi, jika Anda menempatkan 2 elemen dalam satu baris, setiap elemen akan menempati 50% ruang yang tersedia. Jika Anda menempatkan 4 elemen dalam satu baris, setiap elemen akan menempati 25% ruang yang tersedia.

height

Parameter height menentukan tinggi baris dalam piksel. Nilai defaultnya adalah 300.

tile_size

Untuk dasbor layout: tile dan layout: static, unit yang digunakan untuk menentukan ukuran dan posisi elemen adalah ukuran kartu. Anda menentukan tile_size dalam piksel, dan nilai defaultnya adalah 160. Contoh:

- dashboard: sales_overview
  layout: tile
  tile_size: 100

Dalam situasi ini, elemen dasbor dengan height: 5 dan width: 3 akan memiliki tinggi 500 piksel dan lebar 300 piksel. Parameter height dan width berlaku untuk semua jenis elemen, dan detail tentang penggunaannya muncul di halaman dokumentasi untuk setiap jenis visualisasi. Untuk contoh representatif cara kerja height dan width, lihat halaman dokumentasi Parameter diagram kolom untuk dasbor LookML.

width

Bagian ini mengacu pada parameter width yang merupakan bagian dari dasbor.

width juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi untuk elemen diagram kolom.

Untuk dasbor layout: static, parameter width menentukan total lebar dasbor yang ingin Anda gunakan dalam piksel. Parameter width tidak akan membatasi dasbor ke ukuran tertentu jika Anda menentukan elemen yang terlalu besar, atau terlalu banyak elemen dalam satu baris. Sebaliknya, setelan width membantu menjaga agar dasbor tetap berada di tengah layar. Jika Anda tidak menetapkan lebar, defaultnya adalah 1200.

- dashboard: sales_overview
  layout: static
  width: 800

refresh

Bagian ini mengacu pada parameter refresh yang merupakan bagian dari dasbor.

refresh juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi untuk elemen diagram batang.

Parameter refresh memungkinkan dasbor dimuat ulang secara otomatis berdasarkan periode tertentu, sehingga mengambil data baru. Hal ini sering kali berguna dalam setelan saat dasbor ditampilkan terus-menerus, seperti di TV kantor. Perhatikan bahwa dasbor harus dibuka di jendela browser agar parameter ini dapat diterapkan. Setelan ini tidak berjalan di latar belakang untuk "memanaskan" cache dasbor.

Kecepatan refresh dapat berupa angka (tanpa desimal) dalam detik, menit, jam, atau hari. Contoh:

- dashboard: sales_overview
  refresh: 2 hours

Berhati-hatilah saat menyetel interval pemuatan ulang singkat. Karena dasbor dapat berisi banyak kueri, beberapa di antaranya mungkin menggunakan banyak resource, dasbor tertentu dapat membebani database Anda.

auto_run

Parameter auto_run menentukan apakah dasbor akan dijalankan saat pertama kali dibuka atau dimuat ulang. Nilai defaultnya adalah true. Jika parameter ini disetel ke false, pengguna harus menekan tombol Jalankan untuk memuat dasbor. Misalnya, dasbor seperti ini akan otomatis dijalankan saat dibuka:

- dashboard: sales_overview
  auto_run: true

Terlepas dari setelan auto_run, pengguna harus selalu mengklik tombol Jalankan setelah mengubah nilai filter. Hal ini membantu mencegah pemuatan ulang yang tidak diinginkan saat pengguna menjeda selama perubahan filter atau ingin mengubah beberapa filter secara bersamaan.

crossfilter_enabled

Parameter crossfilter_enabled memungkinkan Anda mengaktifkan atau menonaktifkan filter silang untuk dasbor. Jika parameter ini disetel ke true, pelihat dasbor dapat membuat filter silang di dasbor dengan mengklik titik data tertentu.

- dashboard: sales_data
  crossfilter_enabled: true

filters_bar_collapsed

Parameter filters_bar_collapsed memungkinkan Anda menetapkan kolom filter dasbor sebagai dikecilkan atau diperluas default untuk dasbor. Jika parameter ini disetel ke true, kolom filter akan diciutkan secara default. Pelihat dasbor dapat meluaskan panel filter dengan mengklik ikon filter. Setelan default untuk opsi ini adalah false.

- dashboard: sales_data
  filters_bar_collapsed: true

filters_location_top

Parameter filters_location_top memungkinkan Anda menempatkan panel filter dasbor di atas atau kanan untuk dasbor. Jika parameter ini disetel ke true, panel filter akan muncul di bagian atas dasbor; jika disetel ke false, panel filter akan muncul di sebelah kanan dasbor. Setelan default untuk opsi ini adalah true.

- dashboard: sales_data
  filters_location_top: false

filters

Bagian ini mengacu pada parameter filters yang merupakan bagian dari dasbor.

filters juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi untuk elemen diagram batang.

filters juga dapat digunakan sebagai bagian dari pengukuran, yang dijelaskan di halaman dokumentasi parameter filters.

Parameter filters memulai bagian LookML tempat Anda menentukan filter dasbor. Filter muncul di bagian atas dasbor dan memungkinkan pengguna mengubah data di balik elemen dasbor.

Agar filter memengaruhi elemen, elemen harus disiapkan untuk "memantau" filter tersebut, menggunakan parameter listen. Parameter ini berlaku untuk semua jenis elemen, kecuali type: text dan type: button. Untuk contoh representatif cara kerja listen, lihat halaman dokumentasi Parameter diagram kolom untuk dasbor LookML.

Saat filter diterapkan ke elemen dengan cara ini, jenis filter harus cocok dengan jenis dimensi atau ukuran yang memproses filter (lihat Membangun dasbor LookML untuk mengetahui detail selengkapnya). Filter memiliki format berikut:

filters:
- name: filter_name
  title: "chosen filter title"
  type: field_filter | number_filter | date_filter | string_filter
  model: model_name
  explore: explore_name
  field: view_name.field_name
  default_value: Looker filter expression
  allow_multiple_values: true | false
  required: true | false
  listens_to_filters:
  - filter_name
    field: view_name.field_name

name

Bagian ini mengacu pada parameter name yang merupakan bagian dari filter dasbor.

name juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi untuk elemen diagram batang.

Setiap deklarasi name membuat filter dasbor baru, dan menetapkan nama untuk filter tersebut. Nama akan dirujuk dalam parameter listen elemen yang harus terpengaruh oleh filter. Parameter listen berlaku untuk semua jenis elemen selain type: text, dan detail tentang penggunaannya muncul di halaman dokumentasi untuk setiap jenis visualisasi. Untuk contoh representatif cara kerja listen, lihat halaman dokumentasi Parameter diagram kolom untuk dasbor LookML.

filters:
- name: order_date

title (untuk filter)

Bagian ini mengacu pada parameter title yang merupakan bagian dari filter dasbor.

title juga dapat digunakan sebagai bagian dari dasbor, seperti yang dijelaskan di bagian title (untuk dasbor) di halaman ini.

title juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi Parameter diagram kolom untuk dasbor LookML.

Parameter title memungkinkan Anda mengubah tampilan nama filter bagi pengguna di bagian atas dasbor. Jika tidak ditentukan, judul akan ditetapkan secara default ke nama filter.

Perhatikan contoh berikut:

filters:
- name: order_date
  title: "Order Date(s)"

Jika Anda melakukannya, bukan filter yang muncul sebagai Tanggal Pesanan, filter akan muncul sebagai Tanggal Pesanan.

type

Bagian ini mengacu pada parameter type yang merupakan bagian dari filter dasbor.

type juga dapat digunakan sebagai bagian dari elemen dasbor, yang dijelaskan di halaman dokumentasi parameter type (untuk dasbor LookML).

type juga dapat digunakan sebagai bagian dari gabungan, yang dijelaskan di halaman dokumentasi parameter type.

type juga dapat digunakan sebagai bagian dari dimensi, yang dijelaskan di halaman dokumentasi Jenis dimensi, filter, dan parameter.

type juga dapat digunakan sebagai bagian dari pengukuran, yang dijelaskan di halaman dokumentasi Jenis pengukuran.

Parameter type menentukan jenis input yang akan ditempatkan dalam filter. Meskipun semua jenis input (seperti tanggal) dapat ditulis ke dalam filter type: string_filter, input yang lebih spesifik akan memberikan widget filter yang lebih disesuaikan kepada pengguna. Keempat jenis filter tersebut adalah:

  • field_filter: Sebaiknya menjadi pilihan default Anda, saat Anda dapat menentukan dimensi atau ukuran pokok. Menggunakan type: field_filter dan mengaitkan filter dengan kolom type:string akan menyebabkan filter menyarankan kemungkinan nilai filter.
  • number_filter: Memungkinkan pengguna memasukkan nilai atau ekspresi angka/bilangan bulat.
  • date_filter: Memungkinkan pengguna memasukkan nilai atau ekspresi tanggal.
  • string_filter: Memungkinkan pengguna memasukkan teks bentuk bebas.

field_filter

Menyarankan opsi untuk dipilih, mengubah presentasinya kepada pengguna berdasarkan kolom pokok yang Anda tentukan.

Jenis filter ini harus menjadi pilihan utama Anda dalam situasi saat Anda ingin memberikan saran kepada pengguna saat mereka berinteraksi dengan filter. Dimensi tempat saran akan ditarik ditentukan dengan menggunakan parameter explore dan field, dan harus berupa kolom type: string untuk membuat saran filter.

Saran mungkin tidak berfungsi jika kolom berasal dari tabel turunan, jika sql_always_where digunakan di Eksplorasi, atau jika kolom adalah ukuran.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date  # must be of the form view_name.dimension_name

number_filter

Tidak memberikan saran, memungkinkan pengguna memasukkan nilai/ekspresi bilangan bulat/angka.

filters:
- name: order_value
  type: number_filter

date_filter

Tidak memberikan saran, memungkinkan pengguna memasukkan nilai atau ekspresi tanggal.

filters:
- name: order_date
  type: date_filter

string_filter

Tidak memberikan saran, memungkinkan pengguna memasukkan teks bentuk bebas.

filters:
- name: customer_name
  type: string_filter

default_value

Parameter default_value memungkinkan Anda menentukan nilai default yang akan digunakan untuk filter. Nilai ini dapat membantu pengguna dengan menyarankan titik awal yang wajar.

Pastikan untuk mencocokkan nilai default dengan jenis filter yang digunakan. Contoh:

filters:
- name: order_value
  type: number_filter
  default_value: "50 to 100"

- name: order_date
  type: date_filter
  default_value: "last 30 days"

- name: customer_name
  type: string_filter
  default_value: "John Doe"

Anda dapat menggunakan ekspresi filter untuk membuat nilai default. Halaman dokumentasi Ekspresi filter Looker menjelaskan hal ini secara lebih mendetail.

Saat Anda menggunakan parameter default_value dan ui_config, ekspresi filter harus kompatibel dengan nilai yang diberikan ke subparameter type dari ui_config dan jenis data yang mendukung nilai type.

Anda juga dapat menggunakan variabel Liquid _localization dan _user_attributes untuk nilai filter default yang fleksibel.

allow_multiple_values

Parameter allow_multiple_values memungkinkan Anda mengontrol apakah pengguna dapat memilih satu nilai filter atau beberapa nilai filter. Jika parameter ini disetel ke true (default), pengguna dapat memilih beberapa nilai untuk filter. Jika parameter ini disetel ke false, pengguna hanya dapat memilih satu nilai filter.

Contoh:

filters:
- name: Order ID
  title: Order ID
  type: field_filter
  allow_multiple_values: true
  required: false
  model: thelookstore
  explore: orders
  field: orders.id

required

Parameter required memungkinkan Anda mewajibkan pengguna memberikan nilai untuk filter agar dapat menjalankan dasbor. Secara default, filter tidak memerlukan nilai. Jika filter yang tidak memerlukan nilai dan dibiarkan kosong, data tidak akan dibatasi oleh kolom filter. Jika filter yang memerlukan nilai dan dibiarkan kosong, dasbor tidak akan berjalan.

filters:
  - name: State
    title: State
    type: field_filter
    required: true

ui_config

Subparameter ui_config dari filters memungkinkan Anda mengonfigurasi setelan filter untuk dasbor LookML. Setelan ini mencakup jenis kontrol filter yang digunakan, penempatan kontrol filter, dan kemungkinan nilai filter.

Contoh:


  filters:
  - name: City
    title: City
    type: field_filter
    default_value: San Francisco
    allow_multiple_values: true
    required: false
    ui_config:
      type: button_group
      display: inline
      options:
      - San Francisco
      - New York
      - Tokyo
    model: thelook
    explore: order_items
    field: users.city

Lihat halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi filter dengan UI.

type

Subparameter type dari ui_config memungkinkan Anda menentukan jenis kontrol filter yang ditampilkan.

Bergantung pada nilai yang Anda masukkan untuk type, kontrol filter dapat berupa pilihan tunggal atau pilihan ganda.

Nilai yang didukung type bergantung pada data LookML type yang ditetapkan ke kolom yang Anda filter.

STR = Kompatibel dengan jenis data string DIST = Kompatibel dengan jenis data distance
NUM = Kompatibel dengan jenis data number dan ukuran numerik DUR = Kompatibel dengan jenis data duration
TIER = Kompatibel dengan jenis data tier D&T = Kompatibel dengan sebagian besar jenis data tanggal dan waktu
ZIP = Kompatibel dengan jenis data zipcode LOC = Kompatibel dengan jenis data location
Y/N = Kompatibel dengan jenis data yesno PAR = Kompatibel dengan parameter parameter
NilaiDeskripsiJenis Data yang Didukung
Beberapa Pilihan
button_group Filter menampilkan sekelompok tombol, dengan satu tombol untuk setiap nilai yang ditentukan dengan parameter options. STR NUM TIER ZIP Y/N DIST DUR
checkboxes Filter menampilkan kotak centang, dengan satu kotak centang untuk setiap nilai yang ditentukan dengan parameter options. STR NUM TIER ZIP Y/N DIST DUR
tag_list Filter menampilkan drop-down yang mencantumkan setiap kemungkinan nilai yang ditentukan menggunakan parameter options. STR NUM TIER ZIP DIST DUR
range_slider Untuk kolom numerik, filter menampilkan penggeser yang memungkinkan pengguna menetapkan rentang angka sebagai nilai filter. Subparameter min dan max dari options digunakan untuk menentukan nilai minimum dan maksimum yang mungkin untuk filter, dan rentang default dapat ditentukan menggunakan parameter default_value. NUM DIST DUR
Pilihan Tunggal
button_toggles Filter menampilkan sekelompok tombol, dengan satu tombol untuk setiap nilai yang ditentukan dengan parameter options. STR NUM TIER ZIP Y/N DIST DUR PAR
radio_buttons Filter menampilkan tombol pilihan, dengan satu tombol untuk nilai apa pun dan satu tombol untuk setiap nilai yang ditentukan dengan parameter options. STR NUM TIER ZIP Y/N DIST DUR PAR
dropdown_menu Filter menampilkan menu drop-down yang mencantumkan setiap kemungkinan nilai yang ditentukan menggunakan parameter options. Menu drop-down juga memberi pengguna opsi untuk memilih Nilai apa pun. STR NUM TIER ZIP Y/N DIST DUR PAR
slider Untuk kolom angka, filter menampilkan penggeser yang memungkinkan pengguna memilih filter dengan menggeser antara nilai minimum dan maksimum yang mungkin, yang ditentukan menggunakan parameter options. NUM DIST DUR
Tanggal dan Waktu
day_picker Filter ini memungkinkan pengguna memilih tanggal tertentu untuk memfilter. D&T Kontrol satu hari dapat digunakan dengan sebagian besar jangka waktu dan jenis berbasis waktu, tetapi pelihat hanya dapat memilih satu tanggal dengan jenis kontrol ini.
day_range_picker Filter ini memungkinkan pengguna memilih tanggal mulai dan tanggal akhir untuk memfilter rentang tanggal. D&T Kontrol rentang tanggal dapat digunakan dengan sebagian besar jangka waktu dan jenis berbasis waktu, tetapi pelihat hanya dapat memilih rentang tanggal dengan jenis kontrol ini.
date_time_range_input Filter ini memungkinkan pengguna memfilter rentang tanggal dan waktu. D&T Kontrol rentang tanggal dan waktu dapat digunakan dengan sebagian besar jenis berbasis waktu, dan pelihat harus memilih opsi tanggal dan waktu dengan jenis kontrol ini.
relative_timeframes Filter ini memungkinkan pengguna memfilter berdasarkan rentang tanggal kustom atau memilih dari preset jangka waktu seperti Hari ini, 7 Hari Terakhir, atau 90 Hari Terakhir. D&T Kontrol jangka waktu dapat digunakan dengan sebagian besar jangka waktu dan jenis berbasis waktu, tetapi pelihat tidak dapat memilih opsi waktu dengan jenis kontrol ini.
Lainnya
advancedFilter ini menyajikan opsi untuk menerapkan satu atau beberapa filter atau filter kecocokan lanjutan.

Lihat bagian Menggunakan kontrol lanjutan di halaman ini untuk mempelajari lebih lanjut kontrol lanjutan. 		STR NUM TIER ZIP Y/N D&T DIST DUR LOC PAR

display

Anda dapat menggunakan subparameter display dari ui_config untuk menetapkan posisi filter dasbor. Anda dapat memosisikan filter dengan menetapkan salah satu nilai berikut ke display:

  • inline: Filter ditampilkan langsung di panel atas dasbor.
  • popover: Nilai ringkasan muncul di panel atas dasbor; klik nilai untuk melihat filter lengkap.
  • overflow: Tombol Lainnya muncul di panel atas dasbor dengan indikator numerik tentang jumlah filter yang meluap; pengguna dapat mengklik tombol untuk melihat filter yang meluap dan nilainya.

Beberapa jenis filter hanya dapat ditampilkan dengan cara tertentu. Misalnya, filter type: day_picker hanya dapat ditampilkan sebagai inline atau overflow. Jika Anda memberikan nilai display yang tidak valid untuk type tersebut, filter akan ditampilkan sebagai inline atau popover, mana saja yang valid. Untuk mempelajari lebih lanjut, lihat halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna.

Untuk mengetahui informasi tentang cara memosisikan filter dasbor menggunakan UI, lihat halaman dokumentasi Menambahkan dan mengedit filter yang ditentukan pengguna.

options

Subparameter options opsional dari ui_config memungkinkan Anda menentukan nilai yang dapat dipilih pengguna untuk memperbarui nilai filter dasbor untuk sementara saat pengguna melihat dasbor LookML. Jika Anda tidak menentukan nilai apa pun untuk options, Looker akan menarik nilai pertama dari database.

Misalnya, Anda dapat menetapkan San Francisco, New York, dan Tokyo sebagai kemungkinan nilai untuk filter pada kolom users.city sebagai berikut:


ui_config:
  type: button_group
  display: inline
  options:
  - San Francisco
  - New York
  - Tokyo

Jika subparameter type dari ui_config disetel ke range_slider atau slider, Anda dapat menggunakan subparameter min dan max dari options:

  • min: Menetapkan nilai minimum yang mungkin untuk filter.
  • max: Tetapkan nilai maksimum yang mungkin untuk filter.

Contoh:


ui_config:
  type: range_slider
  display: inline
  options:
    min: 0
    max: 500

model

Untuk filter dasbor type: field_filter, Anda perlu menentukan model yang akan digunakan filter untuk menarik saran. Parameter model menentukan model mana yang berisi kolom yang ingin Anda gunakan.

filters:
- name: State
  title: State
  type: field_filter
  default_value: California
  model: thelookstore
  explore: users
  field: users.state

explore

Bagian ini mengacu pada parameter explore yang merupakan bagian dari filter dasbor.

explore juga dapat digunakan sebagai bagian dari model, yang dijelaskan di halaman dokumentasi parameter explore.

explore juga dapat digunakan sebagai bagian dari elemen dasbor. Contoh representatif penggunaannya disediakan di halaman dokumentasi untuk elemen diagram batang.

Untuk filter dasbor type: field_filter, Anda perlu menentukan kolom yang akan digunakan filter untuk menarik saran. Parameter explore menentukan Explore mana yang berisi kolom yang ingin Anda gunakan.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

field

Untuk filter dasbor type: field_filter, Anda perlu menentukan kolom yang akan digunakan filter untuk menarik saran. Parameter field menentukan kolom yang ingin Anda gunakan. Penting untuk menggunakan nama kolom yang sepenuhnya tercakup. Dengan kata lain, gunakan view_name.field_name, bukan hanya field_name.

filters:
- name: order_date
  type: field_filter
  explore: orders
  field: orders.order_date

listens_to_filters

Untuk filter dasbor type: field_filter, Anda dapat mempersempit saran untuk filter berdasarkan apa yang dimasukkan pengguna untuk filter type: field_filter lainnya.

Dalam contoh berikut, saran yang diberikan untuk filter State akan didasarkan pada nilai dari filter Order ID. Nilai apa pun yang dipilih untuk filter Order ID akan memiliki nilai users.state terkait, dan nilai tersebut akan menjadi nilai yang disarankan untuk filter State. Lihat halaman dokumentasi Menambahkan dan mengedit filter dasbor yang ditentukan pengguna untuk mengetahui informasi selengkapnya.

filters:
- name: State
  title: State
  type: field_filter
  model: thelookstore
  explore: users
  listens_to_filters:
  - Order ID
  field: users.state

embed_style

Parameter embed_style memulai bagian LookML tempat Anda menyesuaikan tampilan dasbor yang disematkan. embed_style dan parameter terkaitnya hanya didukung di dasbor sematan dan diabaikan jika dasbor tidak disematkan.

Setelah melakukan perubahan pada embed_style, Anda harus men-deploy LookML ke produksi agar setelan embed_style Anda tercermin di dasbor LookML yang disematkan.

Untuk atribut dasbor sematan berikut yang menentukan warna, nilai warna dapat berupa string hex seperti #2ca6cd atau string warna bernama CSS seperti mediumblue.

Penyesuaian dasbor sematan memiliki bentuk berikut:

embed_style:
  background_color: "css_color"
  show_title: true | false
  title_color: "css_color"
  show_filters_bar: true | false
  tile_background_color: "css_color"
  tile_text_color: "css_color"

background_color

Menetapkan warna latar belakang dasbor sematan.

embed_style:
  background_color: "#ffffff"

show_title

Menentukan apakah judul dasbor sematan dapat dilihat oleh pengguna.

embed_style:
  show_title: false

title_color

Menetapkan warna judul dasbor sematan.

embed_style:
  title_color: "#008000"

show_filters_bar

Menentukan apakah filter dasbor sematan dapat dilihat oleh pengguna.

Parameter ini hanya memengaruhi tampilan visual dasbor, bukan kemampuan pengguna untuk mengakses data. Menyembunyikan panel filter TIDAK mencegah pengguna mengubah filter dengan cara lain. Untuk mengetahui informasi tentang cara menyiapkan kebijakan kontrol akses data yang aman, lihat halaman dokumentasi Pengelolaan izin dan kontrol akses.

embed_style:
  show_filters_bar: true

tile_background_color

Menetapkan warna latar belakang semua kartu di dasbor sematan.

embed_style:
  tile_background_color: "lightyellow"

tile_text_color

Menetapkan warna teks pada semua kartu di dasbor sematan.

embed_style:
  tile_text_color: "crimson"

elements

Bagian ini mengacu pada parameter elements yang merupakan bagian dari dashboard.

elements juga dapat digunakan sebagai bagian dari baris dasbor, yang dijelaskan di bagian elements untuk baris di halaman ini.

Parameter elements memulai bagian LookML tempat Anda menentukan elemen yang akan membentuk dasbor. Ada banyak parameter yang dapat menentukan tampilan elemen dasbor. Elemen ini dijelaskan lebih mendetail di halaman Parameter elemen dasbor.

- dashboard: sales_overview
  layout: tile
  elements:
  - name: order_count
    type: single_value
    model: ecommerce
    explore: orders
    measures: [orders.count]

Pikirkan jumlah dan kompleksitas elemen yang Anda tambahkan ke dasbor LookML. Lebih banyak elemen memerlukan lebih banyak resource browser, yang meningkatkan waktu rendering dasbor. Demikian pula, elemen yang merender sejumlah besar data dapat memengaruhi performa dasbor. Jika rendering menjadi masalah, pertimbangkan untuk mengurangi kompleksitas kueri elemen dasbor atau membuat beberapa dasbor dengan lebih sedikit elemen.