Setelah membuat penyematan — yang dapat dilakukan secara publik, pribadi, dengan penyematan yang ditandatangani, atau melalui API — Anda dapat berinteraksi dengan iframe tersebut menggunakan JavaScript. Anda dapat membuat halaman lebih dinamis berdasarkan status item tersemat, dan Anda bahkan dapat membuat perubahan pada item tersemat dari halaman web.
Perhatikan bahwa Looker tidak mengontrol urutan pengiriman peristiwa oleh browser ke aplikasi web. Artinya, urutan peristiwa tidak dijamin di seluruh browser atau platform. Pastikan untuk menulis JavaScript dengan tepat untuk memperhitungkan penanganan peristiwa di berbagai browser.
Anda dapat menggunakan JavaScript dengan salah satu cara berikut untuk konten tersemat Looker:
- Menggunakan Software Development Kit (SDK) sematan Looker, yang dijelaskan di halaman dokumentasi Embed SDK
- Menggunakan peristiwa JavaScript, yang dijelaskan di bagian Mengakses peristiwa di JavaScript di halaman ini
Persiapan
Sebelum Anda dapat berinteraksi dengan iframe tersemat, ikuti langkah-langkah berikut:
- Tambahkan ID ke iframe.
- Tambahkan domain sematan ke atribut
src
iframe. - Tambahkan domain penyematan ke daftar yang diizinkan.
Menambahkan ID ke iframe
Kemudian, saat mengambil data dari iframe, Anda harus memvalidasi bahwa informasi yang Anda gunakan benar-benar berasal dari iframe Looker. Untuk memfasilitasi hal ini, pastikan untuk menambahkan ID ke iframe Anda, jika Anda belum melakukannya. Pada contoh berikut, Anda menetapkan ID ke looker
dengan menambahkan id="looker"
ke iframe:
<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>
Menambahkan domain sematan ke atribut src
iframe
Di atribut src
iframe, sertakan domain tempat iframe digunakan. Dalam contoh berikut, Anda dapat menentukan myownpersonaldomain.com
sebagai domain dengan menambahkan ?embed_domain=https://myownpersonaldomain.com"
ke akhir URL di atribut src
:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com">
</iframe>
Jika Anda menggunakan penyematan yang ditandatangani, pastikan Anda menambahkan embed_domain
ke URL penyematan.
Jika Anda menggunakan Embed SDK, tambahkan sdk=2
ke akhir URL sematan. Parameter sdk=2
menunjukkan bahwa SDK ada dan Looker dapat memanfaatkan fitur tambahan yang disediakan SDK, seperti meneruskan peristiwa JavaScript antara iframe Looker dan domain Anda. SDK tidak dapat menambahkan parameter ini sendiri karena merupakan bagian dari URL yang ditandatangani. Contoh:
<iframe
id="looker"
src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://myownpersonaldomain.com&sdk=2">
</iframe>
Menambahkan domain sematan ke daftar yang diizinkan
Terakhir, Anda harus menambahkan domain tempat iframe digunakan ke daftar yang diizinkan di halaman Sisipkan pada panel Admin Looker dengan mengikuti langkah-langkah berikut:
Di kolom Daftar Izin Domain Menyematkan, masukkan domain tempat iframe digunakan, lalu tekan tombol Tab sehingga domain muncul dalam kotak dalam kolom.
Klik Perbarui.
Anda dapat menggunakan karakter pengganti *
dalam daftar yang diizinkan untuk membuat pola domain. Misalnya, https://*.myownpersonaldomain.com
akan mengizinkan https://analytics.myownpersonaldomain.com
dan https://data.myownpersonaldomain.com
.
Jika Anda menggunakan penyematan tanpa cookie dengan Looker 23.8 atau yang lebih baru, domain sematan dapat ditentukan saat sesi tanpa cookie diperoleh. Ini adalah alternatif untuk menambahkan domain penyematan ke daftar yang diizinkan menggunakan panel Admin > Sematkan. Tinjau praktik terbaik keamanan jika Anda memutuskan untuk memanfaatkan fitur ini.
Mengambil data dari iframe
Setelah menyelesaikan langkah-langkah persiapan, Anda dapat mengakses peristiwa yang diteruskan antara iframe Looker dan domain Anda dengan memproses peristiwa postMessage
.
Iframe tersemat dapat membuat beberapa jenis peristiwa, seperti yang dijelaskan di bagian Referensi jenis peristiwa di halaman ini.
Mengakses peristiwa di JavaScript
Berikut adalah contoh pemrosesan peristiwa ini di JavaScript native, lalu mencatatnya ke konsol:
window.addEventListener("message", function(event) {
if (event.source === document.getElementById("looker").contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Berikut adalah contoh pemrosesan peristiwa ini di jQuery, lalu mencatatnya ke konsol:
$(window).on("message", function(event) {
if (event.originalEvent.source === $("#looker")[0].contentWindow) {
if (event.origin === "https://instance_name.looker.com") {
console.log(JSON.parse(event.data));
}
}
});
Tabel ringkasan jenis peristiwa
Tabel berikut meringkas jenis peristiwa. Pilih jenis peristiwa untuk melihat detail tentang peristiwa tersebut.
Jenis Peristiwa | Penyebab Peristiwa |
---|---|
dashboard:loaded |
Di dasbor yang kartunya tidak disetel untuk berjalan otomatis, dasbor dan elemennya telah dimuat, tetapi kueri belum berjalan. |
dashboard:run:start |
Dasbor telah mulai dimuat, dan kartunya telah mulai memuat dan membuat kueri untuk data. |
dashboard:run:complete |
Dasbor telah selesai berjalan dan semua kartu telah selesai dimuat dan dikueri. |
dashboard:download |
PDF dasbor telah mulai didownload. |
dashboard:edit:start |
DITAMBAHKAN 22.20
Dasbor telah dialihkan ke mode edit. Peristiwa dashboard:save:complete akan diaktifkan saat dasbor berhasil disimpan. |
dashboard:edit:cancel |
DITAMBAHKAN 22.20 Dasbor yang berada dalam mode edit telah keluar dari mode edit tanpa menyimpan. |
dashboard:save:complete |
Dasbor telah diedit dan disimpan. |
dashboard:delete:complete |
Dasbor telah dihapus. |
dashboard:tile:start |
Kartu telah mulai memuat atau mengkueri data. |
dashboard:tile:complete |
Kartu telah selesai menjalankan kueri. |
dashboard:tile:download |
Data kartu telah mulai didownload. |
dashboard:tile:explore |
Pengguna telah mengklik opsi Jelajahi Dari Sini di kartu dasbor. |
dashboard:tile:view |
Pengguna telah mengklik opsi Lihat Tampilan Asli di kartu dasbor. |
dashboard:filters:changed |
Filter dasbor telah diterapkan atau diubah. |
look:ready |
Tampilan telah mulai memuat data kueri, baik kueri akan berjalan maupun tidak. |
look:run:start |
Tampilan telah mulai memuat data kueri dan kueri telah mulai berjalan. |
look:run:complete |
Tampilan telah selesai menjalankan kueri. |
look:save:complete |
Tampilan telah diedit dan disimpan. |
look:delete:complete |
Tampilan telah dipindahkan ke folder Sampah. |
drillmenu:click |
Pengguna telah mengklik menu perincian di dasbor yang dibuat dengan parameter LookML link . |
drillmodal:download |
Pengguna telah membuka kotak dialog perincian dari kartu dasbor dan mengklik opsi Download. |
drillmodal:explore |
Pengguna telah mengklik opsi Jelajahi Dari Sini di kotak dialog perincian. |
explore:ready |
Eksplorasi telah mulai memuat data kueri, baik kueri akan berjalan maupun tidak. |
explore:run:start |
Eksplorasi telah mulai memuat data kueri dan kueri telah mulai berjalan. |
explore:run:complete |
Jelajah telah selesai menjalankan kueri. |
explore:state:changed |
URL halaman Jelajah telah berubah sebagai akibat dari tindakan pengguna. |
page:changed |
Pengguna telah membuka halaman baru dalam iframe. |
page:properties:changed |
Tinggi iframe dasbor telah berubah. |
session:tokens |
Klien Looker memerlukan token untuk melanjutkan. |
session:status |
Mengirim informasi tentang status sesi. |
env:client:dialog |
Kotak dialog telah dibuka yang mungkin sebagian tidak terlihat, seperti kotak dialog drill. Peristiwa ini memungkinkan aplikasi hosting men-scroll kotak dialog agar terlihat. |
Referensi jenis peristiwa
Iframe tersemat dapat membuat berbagai jenis peristiwa:
dashboard:loaded
Di dasbor tempat kartu tidak disetel untuk dijalankan secara otomatis, peristiwa ini dibuat setelah dasbor dan elemennya dimuat, tetapi sebelum kueri dijalankan.
type: "dashboard:loaded",
status: "complete",
dashboard: {
id: 1,
title: "Business Pulse",
canEdit: true,
dashboard_filters: {
"date": "Last 6 Years",
"state": ""
},
absoluteUrl: "https://self-signed.looker.com:9999/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
url: "/embed/dashboards/1?embed_domain=https%3A%2F%2Fself-signed.looker.com%3A9999&date=Last+6+Years&state=",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
status |
String | Menunjukkan apakah dasbor dan elemennya berhasil dimuat. |
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.options |
Objek | Properti dan nilai tata letak dasbor, komponen tata letak dasbor, dan elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan peristiwa dashboard:options:set . |
dashboard:run:start
Peristiwa ini dibuat saat dasbor mulai dimuat, saat kartunya akan mulai memuat dan membuat kueri untuk data.
type: "dashboard:run:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:run:complete
Peristiwa ini dibuat saat dasbor selesai berjalan dan semua kartu telah selesai dimuat dan dikueri. Peristiwa ini dibuat terlepas dari apakah semua kartu berhasil dimuat atau tidak.
type: "dashboard:run:complete",
status: "complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://my.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
status |
String | Menunjukkan apakah dasbor dan elemennya berhasil berjalan. Jika dasbor dan elemennya berhasil dijalankan, status akan menampilkan "complete" ; jika tidak, status akan menampilkan "error" . Jika dasbor yang sedang berjalan dihentikan, baik dari antarmuka pengguna maupun dengan tindakan dashboard:stop , status akan menampilkan "stopped" . |
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objek | Properti dan nilai tata letak dasbor, komponen tata letak dasbor, dan elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan tindakan dashboard:options:set . |
dashboard.tileStatuses |
Array objek | Array objek yang memberikan status kartu. Properti objek adalah:
|
dashboard:download
Peristiwa ini dibuat saat PDF dasbor mulai didownload.
type: "dashboard:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
fileFormat: "pdf"
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
fileFormat |
String | Format dasbor yang didownload (saat ini hanya "pdf" ). |
dashboard:edit:start
DITAMBAHKAN 22.20 Peristiwa ini dibuat saat dasbor dialihkan ke mode edit.
type: "dashboard:edit:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:edit:cancel
DITAMBAHKAN 22.20 Peristiwa ini dibuat saat dasbor yang berada dalam mode edit keluar dari mode edit tanpa menyimpan.
type: "dashboard:edit:cancel",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:save:complete
Peristiwa ini dibuat saat dasbor diedit, lalu disimpan.
type: "dashboard:save:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.options |
Objek | Properti dan nilai tata letak dasbor, komponen tata letak dasbor, dan elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan peristiwa dashboard:options:set . |
dashboard:delete:complete
Peristiwa ini dibuat saat dasbor dihapus.
type: "dashboard:delete:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
url: "/embed/dashboards/...",
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.options |
Objek | Properti dan nilai tata letak dasbor, komponen tata letak dasbor, dan elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan peristiwa dashboard:options:set . |
dashboard:tile:start
Peristiwa ini dibuat saat kartu mulai memuat atau mengkueri data.
type: "dashboard:tile:start",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Bilangan bulat | Nomor ID peristiwa, bukan kartu. |
tile.title |
String | Judul kartu, seperti yang ditampilkan di bagian atas kartu. |
tile.listen |
Objek | Dasbor global memfilter kartu yang diproses oleh kartu ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...} |
dashboard:tile:complete
Peristiwa ini dibuat saat kartu selesai menjalankan kueri.
type: "dashboard:tile:complete",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
status: "complete",
truncated: false,
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
status |
String | Apakah kueri kartu berhasil diselesaikan. Kemungkinan nilainya adalah "complete" atau "error" . |
truncated |
Boolean | Apakah hasil kueri kartu terpotong karena kueri menampilkan lebih banyak baris daripada batas baris kueri. Batas baris dapat berupa batas baris yang ditentukan pengguna atau batas baris default Looker sebesar 5.000. |
tile.id |
Bilangan bulat | Nomor ID peristiwa, bukan kartu. |
tile.title |
String | Judul kartu, seperti yang ditampilkan di bagian atas kartu. |
tile.listen |
Objek | Dasbor global memfilter kartu yang diproses oleh kartu ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...} |
tile.errors |
Array objek | Diisi saat properti status adalah "error" . Array objek yang memberikan detail error, termasuk teks pesan error, deskripsi error yang lebih mendetail, dan kueri SQL kartu yang menghasilkan error. |
dashboard:tile:download
Peristiwa ini dibuat saat data kartu mulai didownload.
type: "dashboard:tile:download",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales"
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
fileFormat: "pdf"
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Bilangan bulat | Nomor ID peristiwa, bukan kartu. |
tile.title |
String | Judul kartu, seperti yang ditampilkan di bagian atas kartu. |
tile.listen |
Objek | Dasbor global memfilter kartu yang diproses oleh kartu ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...} |
fileFormat |
String | Format kartu yang didownload (hanya "pdf" saat ini). |
dashboard:tile:explore
Peristiwa ini dibuat saat pengguna mengklik opsi Jelajahi Dari Sini di kartu dasbor.
type: "dashboard:tile:explore",
label: 'Explore From Here',
url: '/embed/explore/model/view...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Atribut | Format | Deskripsi |
---|---|---|
label |
String | Label tombol. |
url |
String | URL relatif (hanya jalur) Jelajah yang akan dilihat. |
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Bilangan bulat | Nomor ID peristiwa, bukan kartu. |
tile.title |
String | Judul kartu, seperti yang ditampilkan di bagian atas kartu. |
tile.listen |
Objek | Dasbor global memfilter kartu yang diproses oleh kartu ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...} |
dashboard:tile:view
Peristiwa ini dibuat saat pengguna mengklik opsi Lihat Tampilan Asli di kartu dasbor.
type: "dashboard:tile:view",
label: 'View Original Look',
url: '/embed/look/...',
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
tile: {
id: 123,
title: "Quarterly Sales",
listen: {
"Date": "order.date",
"Total Orders": "order.count"
}
}
Atribut | Format | Deskripsi |
---|---|---|
label |
String | Label tombol. |
url |
String | URL relatif (hanya jalur) Tampilan yang akan dilihat. |
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
tile.id |
Bilangan bulat | Nomor ID peristiwa, bukan kartu. |
tile.title |
String | Judul kartu, seperti yang ditampilkan di bagian atas kartu. |
tile.listen |
Objek | Dasbor global memfilter kartu yang diproses oleh kartu ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...} |
dashboard:filters:changed
Peristiwa ini dibuat saat filter dasbor telah diterapkan atau diubah.
type: "dashboard:filters:changed",
dashboard: {
id: 23,
title: "My Dashboard",
canEdit: true,
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/...",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
options: {
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor. |
dashboard.title |
String | Judul, seperti yang ditampilkan di bagian atas dasbor. |
dashboard.canEdit |
Boolean |
DITAMBAHKAN 22.20
Jika true , pengguna dapat mengedit dasbor. |
dashboard.url |
String | URL dasbor relatif (hanya jalurnya). |
dashboard.absoluteUrl |
String | URL dasbor lengkap. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard.options |
Objek | Properti dan nilai tata letak dasbor, komponen tata letak dasbor, dan elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan peristiwa dashboard:options:set . |
look:ready
Peristiwa ini dibuat saat Tampilan mulai memuat data kueri, baik kueri berjalan maupun tidak.
type: "look:ready",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
look.url |
String | URL Tampilan relatif (hanya jalur) |
look.absoluteUrl |
String | URL Look lengkap |
look:run:start
Peristiwa ini dibuat saat Tampilan mulai memuat data kueri dan kueri mulai berjalan.
type: "look:run:start",
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
look.url |
String | URL Tampilan relatif (hanya jalur) |
look.absoluteUrl |
String | URL Look lengkap |
look:run:complete
Peristiwa ini dibuat saat Tampilan selesai menjalankan kueri.
type: look:run:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
look.url |
String | URL Tampilan relatif (hanya jalur) |
look.absoluteUrl |
String | URL Look lengkap |
look:save:complete
Peristiwa ini dibuat saat Tampilan diedit dan disimpan. Peristiwa ini dibuat saat pengguna melakukan salah satu tugas berikut:
- Mengklik tombol Edit untuk mengedit Tampilan, lalu mengklik Simpan
- Menyimpan Tampilan dengan opsi menu Simpan > Simpan Sebagai…
- Memindahkan Tampilan dari satu folder ke folder lain
Peristiwa ini tidak dibuat jika Tampilan disimpan dengan opsi menu Save > To existing dashboard atau Edit Settings.
type: look:save:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
folderid: 123
}
}
Atribut | Format | Deskripsi |
---|---|---|
look.url |
String | URL Tampilan relatif (hanya jalur) |
look.absoluteUrl |
String | URL Look lengkap |
look.folderid |
Bilangan bulat | ID folder tempat Tampilan disimpan |
look:delete:complete
Peristiwa ini dibuat saat Tampilan dipindahkan ke folder Sampah.
type: look:delete:complete
look: {
url: "/embed/looks/...",
absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
look.url |
String | URL Tampilan relatif (hanya jalur) |
look.absoluteUrl |
String | URL Look lengkap |
drillmenu:click
Peristiwa ini dibuat saat pengguna mengklik menu perincian di dasbor yang dibuat dengan parameter LookML link
. Misalnya, LookML berikut membuat menu perincian tempat pengguna dapat melihat data yang difilter menurut dimensi state
:
dimension: state {
type: string
sql: ${TABLE}.state ;;
link: {
label: "Filter by {{ state | encode_uri }}"
url: "filter::q={{ state | encode_uri }}"
icon_url: "https://google.com/favicon.ico"
}
}
Jika filter state
ditetapkan ke Illinois
, peristiwa drillmenu:click
akan menampilkan hal berikut ke host iframe:
type: "drillmenu:click",
label: "Filter by Illinois",
link_type: "url",
modal: false,
target: '_self',
url: "#filter::state=Illinois"
context: ' '
Atribut | Format | Deskripsi |
---|---|---|
label |
String | Label link seperti yang ditampilkan di menu perincian |
link_type |
String | Jenis objek di tujuan link |
modal |
Boolean | Apakah kotak dialog perincian akan digunakan, bukan navigasi browser |
target |
String | _self jika tujuan link akan menggantikan iframe saat ini, _blank jika tujuan link akan membuka jendela baru |
url |
String | URL tujuan link |
context |
String | Atribut internal yang digunakan oleh beberapa jenis visualisasi |
Sandboxing iframe akan mencegah klik menu perincian terbuka di jendela baru. Gunakan nilai sandboxing ini di dalam tag iframe:
sandbox = "allow-same-origin allow-scripts"
drillmodal:download
Peristiwa ini dibuat saat pengguna membuka kotak dialog perincian dari kartu dasbor dan mengklik opsi Download.
{
type: "drillmodal:download",
dashboard: {
id: 23,
title: "My Dashboard",
url: "/embed/dashboards/…",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/…",
dashboard_filters: {
"Date": "Last 28 days",
"Total Orders": "Greater than 100"
}
}
drillExploreUrl: "/embed...",
fileFormat: "pdf"
}
Atribut | Format | Deskripsi |
---|---|---|
dashboard.id |
Angka/String | ID dasbor tempat kartu berada. |
dashboard.title |
String | Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat kartu berada. |
dashboard.url |
String | URL dasbor relatif (hanya jalur) tempat kartu berada. |
dashboard.absoluteUrl |
String | URL dasbor lengkap tempat kartu berada. |
dashboard.dashboard_filters |
Objek | Filter yang diterapkan ke dasbor tempat kartu berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
drillExploreUrl |
String | URL Jelajahi relatif (hanya jalur) yang akan didownload. |
fileFormat |
String | Format file download data. |
drillmodal:explore
Peristiwa ini dibuat saat pengguna mengklik opsi Jelajahi Dari Sini di kotak dialog perincian.
type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Atribut | Format | Deskripsi |
---|---|---|
label |
String | Label tombol seperti yang ditampilkan di menu perincian |
url |
String | URL Jelajah relatif (hanya jalur) yang akan dilihat |
explore:ready
Peristiwa ini dibuat saat Jelajah mulai memuat data kueri, baik kueri berjalan maupun tidak.
type: "explore:ready",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
explore.url |
String | URL Jelajahi relatif (hanya jalur) |
explore.absoluteUrl |
String | URL Jelajahi lengkap |
explore:run:start
Peristiwa ini dibuat saat Jelajah mulai memuat data kueri dan kueri mulai berjalan.
type: "explore:run:start",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
explore.url |
String | URL Jelajahi relatif (hanya jalur) |
explore.absoluteUrl |
String | URL Jelajahi lengkap |
explore:run:complete
Peristiwa ini dibuat saat Jelajah selesai menjalankan kueri.
type: "explore:run:complete",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
}
}
Atribut | Format | Deskripsi |
---|---|---|
explore.url |
String | URL Jelajahi relatif (hanya jalur) |
explore.absoluteUrl |
String | URL Jelajahi lengkap |
explore:state:changed
Peristiwa ini dibuat saat URL halaman Jelajah berubah sebagai hasil dari tindakan pengguna.
type: "explore:state:changed",
explore: {
url: "/embed/explore/...",
absoluteUrl: "https://instance_name.looker.com/embed/explore/..."
}
Atribut | Format | Deskripsi |
---|---|---|
explore.url |
String | URL Jelajahi relatif (hanya jalur) |
explore.absoluteUrl |
String | URL Jelajahi lengkap |
page:changed
Peristiwa ini dibuat saat pengguna membuka halaman baru dalam iframe.
type: "page:changed",
page: {
type: "dashboard",
url: "/embed/dashboards/...",
absoluteUrl: "https://instance_name.looker.com/embed/dashboards/..."
}
Atribut | Format | Deskripsi |
---|---|---|
page.type |
String | Jenis halaman yang baru saja dibuka, seperti "dashboard" , "look" , atau "explore" |
page.url |
String | URL relatif (hanya jalur) halaman yang baru saja dibuka |
page.absoluteUrl |
String | URL lengkap halaman yang baru saja dibuka |
page:properties:changed
Peristiwa ini dibuat saat tinggi iframe dasbor berubah. Fitur ini tidak tersedia untuk Tampilan atau Jelajah karena item tersebut secara otomatis menyesuaikan tingginya dengan ukuran iframe.
type: "page:properties:changed",
height: 1000
Atribut | Format | Deskripsi |
---|---|---|
height |
Bilangan bulat | Tinggi iframe dasbor dalam piksel |
session:tokens
Peristiwa ini menunjukkan bahwa klien Looker memerlukan token untuk melanjutkan. Peristiwa ini dibuat segera setelah pembuatan iframe dan secara berkala setelahnya selama durasi sesi.
{
"type": "session:tokens",
"api_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoiYXBpX3Rva2VuIiwicmFuZG9taXplciI6IkxjYnpOeDNTVjNOb3o3UVlqTVJjNmhlMkdodjh1a2UwWUhiZWNRMHVCYm1KIn0.CBv1__QGc_H7bKNe31SHMMQCsc5ya1xOiEv1UDWAyxM",
"api_token_ttl": 463,
"navigation_token": "eyJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJodHRwczovL3NlbGYtc2lnbmVkLmxvb2tlci5jb206OTk5OSIsImV4cCI6MTY3MDYyNjMzMCwic3ViIjoiYVdrNWFGUzM4RnRwNzFFWXhuS3ZaMXdKRmV3ZjB2VzYtTV9zLWtCcHE1dXIiLCJ0b2tlbl90eXBlIjoibmF2aWdhdGlvbl90b2tlbiIsInJhbmRvbWl6ZXIiOiJHVVNlc00tdTRPRDlNdktodFJDU2pEcVFhUkJNeTh5dm42Q1FDUXhuLTNxMiJ9.sWo7LUEI5LeragVmeDamUR7u2myXpFJ0aqK_IIALUqI",
"navigation_token_ttl": 463,
"session_reference_token_ttl": 2924
}
Atribut | Format | Deskripsi |
---|---|---|
authentication_token |
String | Token autentikasi. Disertakan saat iframe dibuat. Tidak disertakan dengan respons terhadap permintaan untuk membuat token atau jika sesi telah berakhir. |
authentication_token_ttl |
Angka | Waktu aktif token autentikasi dalam detik. Disertakan saat iframe dibuat. Tidak disertakan dengan respons terhadap permintaan untuk membuat token atau jika sesi telah berakhir. |
api_token |
String | Token API. Tidak disertakan jika sesi telah berakhir. |
api_token_ttl |
Angka | Waktu aktif token API dalam detik. Tidak disertakan jika sesi telah berakhir. |
navigation_token |
String | Token navigasi. Tidak disertakan jika sesi telah berakhir. |
navigation_token_ttl |
Angka | Waktu aktif token navigasi dalam detik. Tidak disertakan jika sesi telah berakhir. |
session_references_token_ttl |
Angka | Time to live sesi dalam detik. Nilainya akan menjadi 0 saat sesi berakhir. Untuk memulihkan, aplikasi penyematan harus memperoleh sesi baru. |
session:status
Peristiwa ini dihasilkan saat aplikasi Looker tersemat menangani permintaan token sesi.
{
"type": "session:status",
"session_ttl": 0,
"expired": true,
"interrupted": false
}
Atribut | Format | Deskripsi |
---|---|---|
session_ttl |
Angka | Time to live sesi dalam detik. |
expired |
Boolean | Jika true , menunjukkan bahwa sesi telah berakhir. |
interrupted |
Boolean | Jika true , menunjukkan bahwa permintaan untuk token sesi tidak direspons. Hal ini dapat menunjukkan bahwa server tidak tersedia untuk sementara. |
recoverable |
Boolean | Hanya diisi jika interupsi adalah true . Menunjukkan apakah sesi dapat dipulihkan atau tidak. Nilai false kemungkinan berarti ada masalah dengan aplikasi penyematan. |
env:client:dialog
Peristiwa ini dibuat saat kotak dialog telah dibuka yang mungkin sebagian tidak terlihat, seperti kotak dialog perincian. Peristiwa ini memungkinkan aplikasi hosting men-scroll kotak dialog ke tampilan dengan tindakan env:host:scroll
.
{
type: "env:client:dialog",
dialogType: 'drilling',
placement: 'cover',
open: true
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | env:client:dialog menunjukkan bahwa kotak dialog telah dibuka atau ditutup. Saat ini, hanya kotak dialog perincian yang didukung, tetapi kotak dialog lainnya dapat ditambahkan di masa mendatang. Bagian atas kotak dialog perincian mungkin tidak terlihat karena kotak dialog menutupi area pandang iframe. Peristiwa ini memungkinkan aplikasi host men-scroll bagian atas kotak dialog agar terlihat. |
dialogType |
String | Jenis kotak dialog. Saat ini, hanya pembukaan atau penutupan jenis dialog "penelusuran" yang memicu peristiwa ini. |
placement |
String | Penempatan dialog. Kotak dialog jenis "drilling" selalu menggunakan placement "cover". |
open |
Boolean | Menunjukkan apakah dialog dibuka atau di-scroll. |
Membuat perubahan pada iframe
Setelah menyiapkan iframe untuk pengambilan data, Anda dapat membuat perubahan pada iframe dengan langkah-langkah berikut:
Menulis permintaan dalam JSON
Anda dapat membuat beberapa perubahan pada iframe, yang akan Anda kirim dalam bentuk JSON. Opsi yang tersedia dijelaskan di bagian Referensi tindakan di halaman ini. Jangan lupa untuk menggunakan JSON.stringify
untuk mengubah tindakan Anda menjadi JSON, seperti ini:
var my_request = JSON.stringify(
{
type: "dashboard:run"
}
);
Memposting permintaan ke properti contentWindow
iframe
Terakhir, posting pesan Anda ke contentWindow
iframe, seperti ini:
var my_iframe = document.getElementById("my_iframe_id");
my_iframe.contentWindow.postMessage(my_request, 'https://instance_name.looker.com');
Tabel ringkasan tindakan
Tabel berikut meringkas tindakan. Pilih tindakan untuk melihat detail tentang tindakan tersebut.
Tindakan | Deskripsi Tindakan |
---|---|
dashboard:load |
Memuat dasbor baru di iframe, yang menggantikan dasbor yang ada. |
dashboard:run |
Menjalankan dasbor di iframe. |
dashboard:edit |
DITAMBAHKAN 22.20 Mengalihkan dasbor ke mode edit. |
dashboard:filters:update |
Memperbarui filter dasbor yang ada di iframe. |
dashboard:options:set |
Menulis nilai baru ke tata letak dasbor dan properti elemen dasbor. |
dashboard:schedule_modal:open |
Membuka Penjadwal, yang memungkinkan pengguna mengirimkan konten Looker ke berbagai tujuan. |
dashboard:stop |
Menghentikan dasbor yang sedang berjalan atau memuat ulang data. |
look:run |
Menjalankan Look di iframe. |
look:filters:update |
Memperbarui filter Tampilan yang ada di iframe. |
explore:run |
Menjalankan Eksplorasi di iframe. |
explore:filters:update |
Memperbarui atau menghapus filter Jelajahi yang ada di iframe. |
session:tokens:request |
Mengirim token sebagai respons terhadap peristiwa session:tokens:request . |
env:host:scroll |
Mengirim informasi tentang posisi scroll iframe host saat ini ke aplikasi Looker tersemat. |
Referensi tindakan
Berikut adalah tindakan yang tersedia yang dapat Anda posting ke iframe tersemat:
dashboard:load
Gunakan tindakan ini untuk memuat dasbor baru di iframe, yang akan menggantikan dasbor yang ada. Dasbor baru akan mulai mengeksekusi kueri seolah-olah halaman dasbor baru telah dibuka.
{
type: "dashboard:load",
id: "101",
pushHistory: false
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:load menunjukkan bahwa Anda ingin memuat dasbor baru ke dalam iframe. |
id |
String | ID dasbor yang akan dimuat. |
pushHistory |
Boolean | Jika true , dasbor yang dimuat akan membuat entri histori browser baru, dan pengguna dapat menggunakan tombol kembali browser untuk kembali ke dasbor sebelumnya. Jika false , dasbor saat ini akan diganti dan navigasi browser tidak dapat digunakan untuk kembali ke dasbor tersebut. |
dashboard:run
Gunakan tindakan ini untuk menjalankan dasbor di iframe. Tindakan ini sama dengan menekan tombol Run atau Reload Data di dasbor.
{
type: "dashboard:run"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:run menunjukkan bahwa Anda ingin menjalankan dasbor. |
dashboard:edit
DITAMBAHKAN 22.20 Gunakan tindakan ini untuk mengalihkan dasbor yang ada di iframe ke mode edit. Tindakan ini sama dengan memilih Edit dasbor dari menu dasbor.
{
type: "dashboard:edit"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:edit menunjukkan bahwa Anda ingin mengalihkan dasbor ke mode edit. |
dashboard:filters:update
Gunakan tindakan ini untuk memperbarui filter dasbor yang ada di iframe. Anda tidak dapat menambahkan filter baru ke dasbor menggunakan metode ini.
{
type: "dashboard:filters:update",
filters: {
"Sale date": "Last 28 days",
"Sale amount": "Greater than 100"
}
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:filters:update menunjukkan bahwa Anda ingin memperbarui filter yang digunakan oleh dasbor. |
filters |
Objek | Filter baru yang ingin Anda terapkan ke dasbor. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...} |
dashboard:options:set
Tindakan ini tersedia setelah peristiwa dashboard:run:complete
terjadi.
Penyematan membuat pesan dan mengirimkannya ke iframe, tetapi dasbor tidak akan merespons hingga setelah dashboard:run:complete
terjadi. Tindakan dashboard:options:set
menulis nilai baru ke tata letak dasbor dan properti elemen dasbor. Hanya properti yang telah ditampilkan dalam atribut options
dari peristiwa dashboard:run:complete
yang dapat diperbarui menggunakan dashboard:options:set
. Setiap properti yang ditetapkan yang sebelumnya tidak ditampilkan oleh atribut options
dari peristiwa dashboard:run:complete
akan diabaikan.
{
type: "dashboard:options:set",
layouts: [
{
id: 1,
dashboard_id: 1,
type: "newspaper",
active: true,
column_width: null,
width: null,
deleted: false,
dashboard_layout_components: [
{
id: 1,
dashboard_layout_id: 1,
dashboard_element_id: 1,
row: 0,
column: 0,
width: 8,
height: 4,
deleted: false
},
{
id: 2,
dashboard_layout_id: 1,
dashboard_element_id: 2,
row: 0,
column: 8,
width: 8,
height: 4,
deleted: false
}
]
}
],
elements: {
1: {
title: "Total Orders",
title_hidden: false,
vis_config: {
type: "single_value",
font_size: "medium",
title: "Total Orders"
}
},
2: {
title: "Average Order Profit",
title_hidden: false,
vis_config: {
type: "single_value",
title: "Average Order Profit"
}
}
}
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:options:set menunjukkan bahwa Anda ingin menulis nilai baru ke tata letak dasbor dan properti elemen dasbor. |
layouts |
Objek | Properti tata letak dasbor yang ditampilkan oleh atribut options dalam peristiwa dashboard:run:complete . Formatnya akan mirip dengan:
|
layouts.dashboard_layout_components |
Objek | Satu atau beberapa objek komponen tata letak dasbor yang ditampilkan oleh atribut options dalam peristiwa dashboard:run:complete . Formatnya akan mirip dengan:
|
elements |
Objek | Satu atau beberapa objek elemen dasbor yang ditampilkan oleh atribut options dalam peristiwa dashboard:run:complete . Formatnya akan mirip dengan:id: { title: "string", title_hidden: boolean, vis_config: { type: "string", title: "string" }} |
dashboard:schedule_modal:open
Gunakan tindakan ini untuk membuka Penjadwal, yang memungkinkan pengguna mengirim konten Looker ke berbagai tujuan.
{
type: "dashboard:schedule_modal:open"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Penggunaan jenis dashboard:schedule_modal:open menunjukkan bahwa Anda ingin membuka kotak dialog Jadwal. |
dashboard:stop
Gunakan tindakan ini untuk menghentikan dasbor yang sedang berjalan atau memuat ulang data. Tindakan ini sama dengan mengklik tombol Cancel di dasbor. Dasbor yang berhenti menggunakan dashboard:stop
akan mengirimkan peristiwa dashboard:run:complete
dengan status:
ditetapkan ke "stopped"
.
{
type: "dashboard:stop"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis dashboard:stop menunjukkan bahwa Anda ingin menghentikan dasbor yang sedang berjalan. |
look:run
Gunakan tindakan ini untuk menjalankan kueri yang menjadi dasar Tampilan di iframe. Tindakan ini mirip dengan menekan tombol Run pada Look, dengan pengecualian bahwa look:run
selalu mengkueri database secara langsung dan tidak mengambil data dari cache Looker.
{
type: "look:run"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis look:run menunjukkan bahwa Anda ingin menjalankan Tampilan. |
look:filters:update
Gunakan tindakan ini untuk memperbarui filter Tampilan yang ada di iframe. Anda tidak dapat menambahkan filter baru ke Tampilan menggunakan metode ini.
{
type: "look:filters:update",
filters: {
"orders.created_at": "90 days",
"products.department": "sweaters"
}
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis look:filters:update menunjukkan bahwa Anda ingin memperbarui filter yang digunakan oleh Tampilan. |
filters |
Objek | Filter baru yang ingin Anda terapkan ke Tampilan. Objek ini memiliki format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
explore:run
Gunakan tindakan ini untuk menjalankan Eksplorasi di iframe. Tindakan ini mirip dengan menekan tombol Run di Jelajahi, dengan pengecualian bahwa explore:run
selalu mengkueri database secara langsung dan tidak mengambil data dari cache Looker.
{
type: "explore:run"
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis explore:run menunjukkan bahwa Anda ingin menjalankan Eksplorasi. |
explore:filters:update
Gunakan tindakan ini untuk memperbarui atau menghapus filter Jelajahi yang ada di iframe. Menyertakan filter baru yang mereferensikan kolom yang valid akan menambahkan filter baru ke Jelajahi.
{
type: "explore:filters:update",
filters: {
"orders.created_at": "90 days",
"orders.status": "complete"
}
deleteFilters: ["products.department"]
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis explore:filters:update menunjukkan bahwa Anda ingin memperbarui filter yang digunakan oleh Jelajah. |
filters |
Objek | Filter baru yang ingin Anda terapkan ke Jelajahi. Jika filters menyertakan filter yang saat ini tidak ada di Jelajahi, tetapi mereferensikan kolom yang valid, filter tersebut akan ditambahkan ke Jelajahi. Objek ini memiliki format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...} |
deleteFilters |
Array | Filter yang ada yang ingin Anda hapus dari Jelajahi. Array memiliki format: ["view_name.field_name_1", "view_name.field_name_2", ...] |
session:tokens:request
Gunakan tindakan ini untuk mengirim token sebagai respons terhadap permintaan session:tokens:request
.
{
type: "session:tokens:request",
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis session:tokens:request menunjukkan bahwa Anda ingin mengirim token sebagai respons terhadap peristiwa session:tokens:request . |
env:host:scroll
Gunakan tindakan ini untuk mengirim informasi tentang posisi scroll iframe host saat ini ke aplikasi Looker tersemat.
{
type: "env:host:scroll",
offsetTop: 10,
offsetLeft: 10,
scrollX: 5,
scrollY: 5
}
Atribut | Format | Deskripsi |
---|---|---|
type |
String | Menggunakan jenis env:host:scroll menunjukkan bahwa Anda ingin mengirim informasi tentang posisi scroll iframe host saat ini ke aplikasi Looker tersemat. |
offsetTop |
Angka | Offset atas iframe. |
offsetLeft |
Angka | Offset kiri iframe. |
scrollX |
Angka | Posisi scrollX host aplikasi. |
scrollY |
Angka | Posisi scrollY host aplikasi. |