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 petak elemen tombol. Tinggi dalam satuan baris untuk layout: newspaper dasbor
width (untuk elemen) Menentukan lebar kotak petak elemen tombol. Lebar dalam satuan kolom untuk layout: newspaper dasbor
row Menentukan posisi kotak petak elemen tombol dari atas ke bawah dalam satuan baris untuk dasbor layout: newspaper
col Menentukan posisi kotak petak elemen tombol dari kiri ke kanan dalam satuan kolom untuk dasborlayout: newspaper
Parameter Tombol
rich_content_json Objek JSON yang berisi pasangan kunci/nilai dengan informasi tentang tombol

Parameter dasar

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

Parameter height, width, row, dan col berlaku untuk kotak petak 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 menetapkan nama untuknya. 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 gabungan, yang dijelaskan di halaman dokumentasi parameter type (untuk gabungan).

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

Lihat halaman dokumentasi type (untuk dasbor LookML) untuk 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 petak elemen tombol, dalam satuan baris.

Kotak petak 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 petak tombol agar memiliki tinggi 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 petak elemen tombol, dalam satuan kolom.

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

Misalnya, kode berikut menetapkan kotak petak tombol agar memiliki lebar setengah dari dasbor:

- dashboard: sales_overview
  layout: newspaper
  ...

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

Jika ada ruang dalam kotak petak 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 dipangkas pada tombol.

row

Parameter row menentukan baris tempat tepi atas kotak petak elemen tombol ditempatkan.

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 petak tombol agar ditempatkan di baris kedua elemen dalam 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 petak elemen tombol ditempatkan.

Dasbor dibagi menjadi 24 kolom. Dasbor dimulai dengan kolom 0 di sebelah kiri dasbor. Dasbor dengan tata letak koran 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 agar ditetapkan di kolom ketiga elemen dalam 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 pasangan kunci dan nilai yang menentukan karakteristik tombol dasbor.

Contoh penggunaan berikut menunjukkan tombol dasbor yang mengarah 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 mengarah 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. Lebar tombol akan bertambah untuk mengakomodasi teks hingga mencapai batas yang ditetapkan oleh parameter width, yang kemudian teks akan dipangkas.

description

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

newTab

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

alignment

alignment menetapkan perataan tombol dalam kotak petak elemen tombol. alignment secara default adalah center.

ukuran

size menetapkan ukuran tombol dan teksnya ke small, medium, atau large. Nilai size tidak memengaruhi ukuran kotak petak 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 luar 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 secara default adalah warna pertama dalam koleksi warna kategoris default instance Looker.

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

targetTabName

Jika dasbor Anda memiliki tab, targetTabName akan menetapkan tab dasbor yang akan digunakan tombol untuk mengarahkan pengguna.

Pelajari dasbor bertab lebih lanjut .

href

href menetapkan URL yang akan digunakan tombol untuk mengarahkan pengguna. Link ke dasbor Looker lain dapat berisi parameter filter yang menetapkan filter dasbor ke nilai tertentu.