Parameter tombol untuk dasbor LookML

Tombol hanya didukung oleh dasbor LookML dengan setelan berikut:

Halaman ini menunjukkan cara menambahkan dan menyesuaikan elemen dasbor LookML type: button dengan parameter dasbor LookML dalam file dashboard.lkml. Tombol berguna untuk menempatkan link dalam dasbor Anda. Anda dapat menautkan ke konten Looker, seperti Look dan dasbor, atau ke situs lain.

Untuk mengetahui informasi tentang cara menambahkan tombol ke dasbor melalui UI Looker, lihat halaman dokumentasi Membuat dasbor yang ditentukan pengguna.

Contoh penggunaan


## BASIC PARAMETERS
type: button
name: text
height: N
width: N
row: N
col: N

## BUTTON PARAMETER
rich_content_json: '{
 "text": "button text",
 "description": "description",
 "newTab": true | false,
 "alignment": "left" | "right" | "center",
 "size": "small" | "medium" | "large",
 "style": "OUTLINED" | "FILLED" | "TRANSPARENT",
 "color": "hex string or css color",
 "href": "link"
 }'

Definisi parameter

Nama Parameter Deskripsi
Parameter Dasar
type (untuk elemen) Menentukan jenis visualisasi yang akan digunakan dalam elemen
name (untuk elemen) Membuat elemen
height (untuk elemen) Menentukan tinggi kotak ubin elemen tombol. Tinggi dalam satuan baris untuk dasbor layout: newspaper
width (untuk elemen) Menentukan lebar kotak ubin elemen tombol. Lebar dalam satuan kolom untuk dasbor layout: newspaper
row Menentukan posisi atas ke bawah kotak kartu elemen tombol dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi kiri ke kanan kotak ubin elemen tombol dalam satuan kolom untuk dasbor layout: newspaper
Parameter Tombol
rich_content_json Objek JSON yang berisi key-value pair dengan informasi tentang tombol

Parameter dasar

Saat menentukan elemen dasbor LookML dari type: button, Anda harus menentukan nilai setidaknya untuk parameter name dan type.

Parameter height, width, row, dan col berlaku untuk kotak kartu elemen tombol, bukan untuk tombol itu sendiri.

name

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

name juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Setiap deklarasi name membuat elemen dasbor baru dan memberinya nama. Nama elemen harus unik.

name yang diberikan ke tombol tidak akan muncul di UI dasbor.

- name: orders_by_date

type

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

type juga dapat digunakan sebagai bagian dari filter dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

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

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 ukuran, yang dijelaskan di halaman dokumentasi Jenis ukuran.

Parameter type menentukan jenis visualisasi yang akan digunakan dalam elemen.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall |
        looker_wordcloud | looker_boxplot | button | group

Lihat halaman dokumentasi type (untuk dasbor LookML) guna mengetahui ringkasan berbagai jenis elemen dasbor LookML.

height

Bagian ini mengacu pada parameter height yang merupakan bagian dari elemen dasbor.

height juga dapat digunakan sebagai bagian dari baris dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter height menentukan tinggi kotak ubin elemen tombol, dalam satuan baris.

Kotak kartu elemen tombol secara default memiliki tinggi 6 baris. Tinggi minimum adalah 1 baris. Mengubah tinggi elemen tombol dapat memengaruhi elemen lain di dasbor, tetapi tidak akan memengaruhi tinggi tombol itu sendiri.

Misalnya, kode berikut menetapkan kotak ubin tombol menjadi setinggi 12 baris:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

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

width juga dapat digunakan sebagai bagian dari dasbor, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Parameter width menentukan lebar kotak ubin elemen tombol, dalam satuan kolom.

Lebar kotak ubin elemen tombol ditetapkan secara default ke 8 kolom, yang merupakan sepertiga dari lebar penuh dasbor. Lebar minimum untuk kotak kartu tombol adalah 2.

Misalnya, kode berikut menetapkan kotak ubin tombol menjadi setengah lebar dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

Jika ada ruang dalam kotak ubin tombol, lebar tombol akan bertambah untuk mengakomodasi string teks yang panjang, yang ditentukan dalam text. Namun, lebar tombol tidak akan bertambah melebihi nilai yang ditetapkan dalam parameter width; dan, jika perlu, string yang ditentukan dalam text akan dipotong pada tombol.

row

Parameter row menentukan baris tempat tepi atas kotak ubin elemen tombol ditempatkan. Jika tombol ditempatkan di dalam grup kartu menggunakan parameter group, row menentukan posisi baris tombol relatif terhadap bagian atas penampung grup (row: 0).

Dasbor dimulai dengan baris 0 di bagian atas dasbor. Elemen tombol dasbor secara default memiliki tinggi elemen 6 baris, yang berarti elemen dasbor di bagian atas dasbor (row: 0) secara default akan menempati baris 0-5.

Dalam contoh berikut, kode menetapkan kotak ubin tombol untuk ditempatkan di baris kedua elemen di dasbor, dengan asumsi elemen ditetapkan pada tinggi default:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Parameter col menentukan kolom tempat tepi kiri kotak ubin elemen tombol ditempatkan. Jika tombol ditempatkan di dalam grup kartu menggunakan parameter group, col menentukan posisi kolom tombol relatif terhadap tepi kiri penampung grup (col: 0).

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak surat kabar secara default memiliki lebar elemen 8 kolom, yang berarti elemen dasbor di sebelah kiri dasbor (col: 0) secara default akan menempati kolom 0-7.

Misalnya, kode berikut menetapkan elemen yang akan ditetapkan di kolom ketiga elemen di dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

Parameter tombol

Parameter yang dijelaskan di bagian ini dapat digunakan untuk menambahkan konten ke elemen dasbor LookML type: button.

rich_content_json

rich_content_json adalah objek JSON dengan beberapa key-value pair yang menentukan karakteristik tombol dasbor.

Contoh penggunaan berikut menunjukkan tombol dasbor yang mengarahkan ke dasbor lain.

rich_content_json: '{
 "text": "Go to Sales Dashboard",
 "description": "View sales from the last 18 months.",
 "newTab": true,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "href":"https://instance_name.looker.com/dashboards/152?State=California&Created+Fiscal+Quarter=2022"
 }'

Contoh penggunaan berikut menunjukkan tombol dasbor yang mengarahkan ke tab di dasbor.

rich_content_json: '{
 "text": "Go to Users tab",
 "description": "View user data from the last 18 months.",
 "newTab": false,
 "alignment": "center",
 "size": "medium",
 "style": "FILLED",
 "color": "forestgreen",
 "targetTabName":"Users"
 "href":""
 }'

text

text menentukan teks yang akan muncul di tombol di UI dasbor. Tombol akan melebar untuk mengakomodasi teks hingga mencapai batas yang ditetapkan oleh parameter width, dan pada titik tersebut teks akan terpotong.

description

description menentukan teks yang muncul sebagai tooltip saat Anda mengarahkan kursor ke tombol. Jika tidak ada deskripsi yang diberikan, deskripsi default akan menampilkan link yang diberikan di href.

newTab

newTab adalah Boolean yang menentukan apakah link tombol akan terbuka di tab baru (true) atau terbuka di tab saat ini (false). newTab ditetapkan secara default ke true.

alignment

alignment menetapkan perataan tombol dalam kotak ubin elemen tombol. alignment ditetapkan secara default ke center.

ukuran

size menetapkan ukuran tombol dan teksnya ke small, medium, atau large. Nilai size tidak memengaruhi ukuran kotak ubin elemen tombol atau parameter height.

style

style menetapkan gaya tombol ke salah satu nilai berikut:

  • FILLED: Isi tombol diisi dengan warna yang ditetapkan di color. Teks tombol berwarna putih. Ini adalah nilai defaultnya.
  • OUTLINED: Tombol memiliki garis batas di sekeliling tepinya, tetapi isinya transparan. Warna teks tombol ditetapkan oleh color.
  • TRANSPARENT: Isi tombol transparan. Warna teks tombol ditetapkan oleh color.

color

color menetapkan warna tombol atau teks tombol, bergantung pada setelan style. color ditetapkan secara default ke warna pertama dalam koleksi warna kategoris default instance Looker.

Nilai warna dapat diformat sebagai string heksadesimal, seperti #2ca6cd, atau sebagai nama warna CSS, seperti mediumblue.

targetTabName

Jika dasbor Anda memiliki tab, targetTabName akan menetapkan tab dasbor yang akan dibuka pengguna saat mengklik tombol.

Pelajari dasbor tab lebih lanjut.

href

href menetapkan URL yang akan dituju pengguna saat mengklik tombol. Link ke dasbor Looker lainnya dapat berisi parameter filter yang menetapkan filter dasbor ke nilai tertentu.