Peristiwa JavaScript yang disematkan

Setelah membuat sematan — ini dapat dilakukan secara publik, secara pribadi, dengan penyematan bertanda tangan, atau melalui API — Anda dapat berinteraksi dengan iframe tersebut menggunakan JavaScript. Anda dapat membuat halaman lebih dinamis, berdasarkan status item tersemat, atau bahkan melakukan perubahan pada item tersemat dari halaman web Anda.

Perlu diketahui bahwa Looker tidak mengontrol urutan pengiriman peristiwa oleh browser ke aplikasi web. Artinya, urutan peristiwa tidak dijamin di seluruh browser atau platform. Pastikan Anda menulis JavaScript dengan tepat untuk memperhitungkan penanganan peristiwa dari berbagai browser.

Anda dapat memanfaatkan JavaScript dengan dua cara untuk konten sematan 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

Anda harus melakukan beberapa tindakan sebelum dapat berinteraksi dengan iframe yang disematkan:

Menambahkan ID ke iframe

Salah satu hal yang perlu Anda lakukan nanti adalah memvalidasi bahwa informasi yang Anda kerjakan benar-benar berasal dari iframe Looker. Untuk memfasilitasi hal ini, pastikan Anda menambahkan ID ke iframe, jika Anda belum melakukannya. Dalam contoh berikut, kami telah menambahkan id="looker":

<iframe id="looker" src="https://instance_name.looker.com/embed/dashboards/1"></iframe>

Menambahkan domain sematan ke atribut src iframe

Di src iframe, tambahkan domain tempat iframe digunakan. Dalam contoh berikut, kami telah menambahkan ?embed_domain=https://mywebsite.com":

<iframe
  id="looker"
  src="https://instance_name.looker.com/embed/dashboards/1?embed_domain=https://mywebsite.com">
</iframe>

Jika menggunakan penyematan yang ditandatangani, pastikan Anda menambahkan embed_domain ke URL sematan.

Jangan sertakan garis miring (/) dalam embed_domain.

Menambahkan domain sematan ke daftar yang diizinkan

Terakhir, Anda harus menambahkan domain tempat iframe digunakan ke daftar yang diizinkan di halaman Penyematan pada panel Admin Looker.

  1. Masukkan domain tempat iframe digunakan. Setelah mengetiknya, pastikan untuk menekan tombol Tab sehingga domain tersebut muncul dalam kotak. Jangan sertakan garis miring (/) di URL domain.
  2. Pilih tombol Perbarui.

Anda dapat menggunakan karakter pengganti * dalam daftar yang diizinkan untuk membuat pola domain. Misalnya, https://*.mycompany.com akan mengizinkan https://analytics.mycompany.com dan https://data.mycompany.com.

Jika Anda menggunakan penyematan tanpa cookie dengan Looker 23.8 atau yang lebih baru, domain sematan dapat ditentukan saat sesi tanpa cookie diperoleh. Tindakan ini merupakan alternatif untuk menambahkannya 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.

Pastikan untuk memeriksa apakah peristiwa berasal dari iframe dan domain Looker untuk menghindari pesan berbahaya.

iframe yang disematkan 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 untuk memproses peristiwa ini di jQuery, kemudian 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 merangkum jenis peristiwa. Pilih jenis acara untuk melihat detail tentang acara tersebut.

Jenis Peristiwa Penyebab Peristiwa
dashboard:loaded Di dasbor dengan kartu tidak ditetapkan untuk dijalankan otomatis, dasbor dan elemennya telah dimuat, tetapi kueri belum berjalan.
dashboard:run:start Dasbor telah mulai dimuat, dan ubinnya mulai memuat serta membuat kueri untuk data.
dashboard:run:complete Dasbor telah selesai berjalan dan semua ubin telah selesai dimuat dan membuat kueri.
dashboard:download PDF dasbor telah mulai didownload.
dashboard:edit:start TAMBAHKAN 22.20 Dasbor telah dialihkan ke mode edit. Peristiwa dashboard:save:complete akan diaktifkan saat dasbor berhasil disimpan.
dashboard:edit:cancel TAMBAHKAN 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 membuat kueri untuk data.
dashboard:tile:complete Kartu telah selesai menjalankan kueri.
dashboard:tile:download Data kartu 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, terlepas dari apakah kueri tersebut akan berjalan atau tidak.
look:run:start Tampilan telah mulai memuat data kueri dan kueri mulai berjalan.
look:run:complete Sebuah Look telah selesai menjalankan kueri.
look:save:complete Tampilan telah diedit dan disimpan.
look:delete:complete Tampilan telah dipindahkan ke folder Sampah.
drillmenu:click Seorang pengguna mengklik menu penelusuran di dasbor yang dibuat dengan parameter LookML link.
drillmodal:download Seorang pengguna telah membuka kotak dialog latihan dari ubin dasbor dan mengklik opsi Download.
drillmodal:explore Pengguna telah mengklik opsi Jelajahi Dari Sini di kotak dialog latihan.
explore:ready Explore telah mulai memuat data kueri, terlepas dari apakah kueri akan berjalan atau tidak.
explore:run:start Explore telah mulai memuat data kueri dan kueri mulai berjalan.
explore:run:complete Explore telah selesai menjalankan kueri.
explore:state:changed URL halaman Eksplorasi telah berubah sebagai akibat dari tindakan pengguna.
page:changed Pengguna telah membuka halaman baru dalam iframe.
page:properties:changed Ketinggian iframe dasbor telah berubah.
session:tokens Klien Looker memerlukan token untuk melanjutkan.
session:status Mengirim informasi tentang status sesi.
env:client:dialog Kotak dialog yang mungkin tidak terlihat sebagian telah terbuka, misalnya kotak dialog latihan. Peristiwa ini memungkinkan aplikasi hosting untuk men-scroll kotak dialog hingga terlihat.

Referensi jenis peristiwa

Iframe yang disematkan dapat membuat berbagai jenis peristiwa yang berbeda:

dashboard:loaded

Di dasbor dengan kartu tidak ditetapkan untuk dijalankan 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 telah berhasil dimuat.
dashboard.id Angka/String ID dasbor.
dashboard.title String Judul, seperti yang ditampilkan di bagian atas dasbor.
dashboard.canEdit Boolean TAMBAH 22.20 Saat 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 Tata letak dasbor, komponen tata letak dasbor, serta properti dan nilai 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 dimuat dan membuat kueri 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 TAMBAH 22.20 Saat 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 ubin telah selesai dimuat dan membuat kueri. 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 telah berhasil dijalankan. Jika dasbor dan elemennya berhasil dijalankan, status akan menampilkan "complete"; jika tidak, status akan menampilkan "error". Jika dasbor yang berjalan dihentikan, baik dari antarmuka pengguna atau 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 TAMBAH 22.20 Saat 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 Tata letak dasbor, komponen tata letak dasbor, serta properti dan nilai 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 menyediakan status kartu. Properti objek adalah:

  • tileId — nomor ID kartu.
  • status — Jika kueri kartu berhasil dijalankan, status akan menampilkan "complete"; jika tidak, status akan menampilkan "error".
  • errors — 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:download

Acara ini dibuat saat PDF dasbor sudah 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 TAMBAH 22.20 Saat 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

TAMBAH 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 TAMBAH 22.20 Saat 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

TAMBAH 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 TAMBAH 22.20 Saat 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

Acara 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 TAMBAH 22.20 Saat 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 Tata letak dasbor, komponen tata letak dasbor, serta properti dan nilai elemen dasbor. Semua properti yang ditampilkan dalam objek options dapat diberi nilai yang diperbarui menggunakan peristiwa dashboard:options:set.

dashboard:delete:complete

Acara 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 TAMBAH 22.20 Saat 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 Tata letak dasbor, komponen tata letak dasbor, serta properti dan nilai 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 membuat kueri 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.canEdit Boolean TAMBAH 22.20 Saat true, pengguna dapat mengedit dasbor.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Bilangan bulat Nomor ID acara, bukan kartu.
tile.title String Judul kartu, seperti yang ditampilkan di bagian atas kartu.
tile.listen Objek Dasbor global memfilter kartu yang sedang diproses ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...}

dashboard:tile:complete

Acara 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.canEdit Boolean TAMBAH 22.20 Saat true, pengguna dapat mengedit dasbor.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin 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 ubin terpotong karena kueri yang menampilkan lebih banyak baris daripada batas baris kueri. Batas baris dapat berupa batas baris yang ditentukan pengguna atau batas baris default Looker sebanyak 5.000.
tile.id Bilangan bulat Nomor ID acara, bukan kartu.
tile.title String Judul kartu, seperti yang ditampilkan di bagian atas kartu.
tile.listen Objek Dasbor global memfilter kartu yang sedang diproses 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

Acara 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.canEdit Boolean TAMBAH 22.20 Saat true, pengguna dapat mengedit dasbor.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Bilangan bulat Nomor ID acara, bukan kartu.
tile.title String Judul kartu, seperti yang ditampilkan di bagian atas kartu.
tile.listen Objek Dasbor global memfilter kartu yang sedang diproses ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...}
fileFormat String Format kartu yang didownload (saat ini hanya "pdf").

dashboard:tile:explore

Acara 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.canEdit Boolean TAMBAH 22.20 Saat true, pengguna dapat mengedit dasbor.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Bilangan bulat Nomor ID acara, bukan kartu.
tile.title String Judul kartu, seperti yang ditampilkan di bagian atas kartu.
tile.listen Objek Dasbor global memfilter kartu yang sedang diproses ini. Objek ini memiliki format: {"Filter Label": "Filter Field", ...}

dashboard:tile:view

Acara 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.canEdit Boolean TAMBAH 22.20 Saat true, pengguna dapat mengedit dasbor.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
tile.id Bilangan bulat Nomor ID acara, bukan kartu.
tile.title String Judul kartu, seperti yang ditampilkan di bagian atas kartu.
tile.listen Objek Dasbor global memfilter kartu yang sedang diproses 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 TAMBAH 22.20 Saat 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 Tata letak dasbor, komponen tata letak dasbor, serta properti dan nilai 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 tersebut berjalan atau 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 jalurnya)
look.absoluteUrl String URL Tampilan lengkap

look:run:start

Peristiwa ini dibuat saat Tampilan mulai memuat data kueri dan kueri mulai dijalankan.

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 jalurnya)
look.absoluteUrl String URL Tampilan lengkap

look:run:complete

Peristiwa ini dibuat saat Look telah 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 jalurnya)
look.absoluteUrl String URL Tampilan lengkap

look:save:complete

Acara ini dibuat saat Tampilan diedit dan disimpan. Peristiwa ini dibuat saat pengguna melakukan salah satu tugas berikut:

Acara ini tidak dibuat jika Tampilan tersebut disimpan dengan opsi menu Simpan > Ke dasbor yang ada atau Edit Setelan.

type: look:save:complete
look: {
  url: "/embed/looks/...",
  absoluteUrl: "https://instance_name.looker.com/embed/looks/...",
  spaceId: 123
  }
}
Atribut Format Deskripsi
look.url String URL Tampilan relatif (hanya jalurnya)
look.absoluteUrl String URL Tampilan lengkap
look.spaceID Bilangan bulat ID folder tempat Tampilan disimpan

look:delete:complete

Acara 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 jalurnya)
look.absoluteUrl String URL Tampilan lengkap

drillmenu:click

Peristiwa ini dibuat saat pengguna mengklik menu penelusuran 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 penelusuran
link_type String Jenis objek di tujuan link
modal Boolean Apakah kotak dialog penelusuran akan digunakan, bukan navigasi browser
target String Adalah _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

Melakukan sandbox iframe akan mencegah klik menu penelusuran terbuka di jendela baru. Gunakan nilai sandbox ini di dalam tag iframe:

sandbox = "allow-same-origin allow-scripts"

drillmodal:download

Acara ini dibuat saat pengguna membuka kotak dialog latihan dari ubin 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 ubin berada.
dashboard.title String Judul dasbor, seperti yang ditampilkan di bagian atas dasbor tempat ubin berada.
dashboard.url String URL dasbor relatif (hanya jalur) yang mencakup ubin.
dashboard.absoluteUrl String URL dasbor lengkap yang mencakup ubin.
dashboard.dashboard_filters Objek Filter diterapkan ke dasbor tempat ubin berada. Objek ini memiliki format: {"Filter name 1": "value 1", "Filter name 2": "value 2", ...}
drillExploreUrl String URL Jelajah relatif (hanya jalurnya) untuk didownload.
fileFormat String Format file data yang didownload.

drillmodal:explore

Acara ini dibuat saat pengguna mengklik opsi Jelajahi Dari Sini di kotak dialog latihan.

type: "drillmodal:explore",
label: "Explore From Here",
url: "/embed/explore/model/view..."
Atribut Format Deskripsi
label String Label tombol seperti yang ditunjukkan di menu penelusuran
url String URL Eksplorasi relatif (hanya jalurnya) yang akan dilihat

explore:ready

Peristiwa ini dibuat saat Explore mulai memuat data kueri, baik kueri tersebut berjalan atau tidak.

type: "explore:ready",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Atribut Format Deskripsi
explore.url String URL Eksplorasi relatif (hanya jalurnya)
explore.absoluteUrl String URL Eksplorasi lengkap

explore:run:start

Peristiwa ini dibuat saat Explore mulai memuat data kueri dan kueri mulai dijalankan.

type: "explore:run:start",
explore: {
  url: "/embed/explore/...",
  absoluteUrl: "https://instance_name.looker.com/embed/explore/...",
  }
}
Atribut Format Deskripsi
explore.url String URL Eksplorasi relatif (hanya jalurnya)
explore.absoluteUrl String URL Eksplorasi lengkap

explore:run:complete

Acara 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 Eksplorasi relatif (hanya jalurnya)
explore.absoluteUrl String URL Eksplorasi lengkap

explore:state:changed

Peristiwa ini dibuat saat URL halaman Jelajahi berubah sebagai akibat 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 Eksplorasi relatif (hanya jalurnya)
explore.absoluteUrl String URL Eksplorasi 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. Item tersebut tidak tersedia untuk Tampilan atau Eksplorasi karena item tersebut 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 pada saat 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 Nomor 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 Nomor 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 Nomor Waktu token navigasi aktif dalam hitungan detik. Tidak disertakan jika sesi telah berakhir.
session_references_token_ttl Nomor Waktu sesi aktif dalam hitungan detik. Nilainya akan menjadi 0 ketika sesi telah berakhir. Untuk memulihkan, aplikasi penyematan harus memperoleh sesi baru.

session:status

Peristiwa dibuat saat aplikasi Looker tersemat menangani permintaan token sesi.

{
  "type": "session:status",
  "session_ttl": 0,
  "expired": true,
  "interrupted": false
}
Atribut Format Deskripsi
session_ttl Nomor Waktu sesi aktif dalam hitungan detik.
expired Boolean Jika true, menunjukkan bahwa sesi telah berakhir.
interrupted Boolean Jika true, menunjukkan bahwa permintaan token sesi tidak direspons. Hal ini dapat menunjukkan bahwa server untuk sementara tidak tersedia.
recoverable Boolean Hanya diisi saat terganggu adalah true. Menunjukkan apakah sesi dapat dipulihkan atau tidak. Nilai false kemungkinan berarti ada masalah dengan aplikasi penyematan.

env:client:dialog

Peristiwa dibuat saat kotak dialog telah terbuka yang mungkin sebagian tidak terlihat, seperti kotak dialog latihan. Peristiwa ini memungkinkan aplikasi hosting men-scroll kotak dialog hingga terlihat dengan tindakan env:host:scroll.

{
  type: "env:client:dialog",
  dialogType: 'drilling',
  placement: 'cover',
  open: true
}
Atribut Format Deskripsi
type String env:client:dialog menunjukkan kotak dialog telah dibuka atau ditutup. Saat ini, hanya kotak dialog latihan yang didukung, tetapi kotak dialog lainnya dapat ditambahkan di masa mendatang. Ada kemungkinan bahwa bagian atas kotak dialog latihan tidak terlihat karena kotak dialog menutupi area pandang iframe. Peristiwa ini memungkinkan aplikasi host men-scroll bagian atas kotak dialog ke tampilan.
dialogType String Jenis kotak dialog. Saat ini, hanya pembukaan atau penutupan jenis dialog "pengeboran" yang akan memicu peristiwa ini.
placement String Penempatan dialog. Kotak dialog dengan jenis "pengeboran" selalu menggunakan placement "penutup".
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 berikut:

  1. Tulis permintaan Anda dalam JSON.
  2. Posting permintaan ke contentWindow iframe.

Menulis permintaan dalam JSON

Anda dapat melakukan beberapa perubahan pada iframe yang akan Anda kirimkan dalam bentuk JSON. Opsi yang tersedia dijelaskan di bagian Referensi tindakan di halaman ini. Jangan lupa 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 merangkum tindakan. Pilih tindakan untuk melihat detail tentang tindakan tersebut.

Tindakan Deskripsi Tindakan
dashboard:load Memuat dasbor baru di iframe, menggantikan dasbor yang ada.
dashboard:run Menjalankan dasbor di iframe.
dashboard:edit TAMBAH 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 menjalankan atau memuat ulang data.
look:run Menjalankan Look di iframe.
look:filters:update Memperbarui filter Tampilan yang ada di iframe.
explore:run Menjalankan Explore dalam iframe.
explore:filters:update Memperbarui atau menghapus filter Explore yang ada di iframe.
session:tokens:request Mengirim token sebagai respons terhadap peristiwa session:tokens:request.
env:host:scroll Mengirim informasi tentang posisi scroll saat ini dari iframe host ke aplikasi Looker tersemat.

Referensi tindakan

Berikut adalah tindakan yang dapat Anda posting ke iframe tersemat:

dashboard:load

Gunakan tindakan ini untuk memuat dasbor baru di iframe guna 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 di 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

TAMBAH 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 dengan 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.

Penanam membuat pesan dan mengirimkannya ke iframe, tetapi dasbor tidak merespons hingga dashboard:run:complete terjadi. Tindakan dashboard:options:set akan 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 kumpulan properti 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. Item data tersebut akan memiliki format yang mirip dengan:

  • id: "string",
  • dashboard_id: "string",
  • type: "newspaper",
  • active: boolean,
  • column_width: number,
  • width: number
layouts.dashboard_layout_components Objek Satu atau beberapa objek komponen tata letak dasbor yang ditampilkan oleh atribut options dalam peristiwa dashboard:run:complete. Item data tersebut akan memiliki format yang mirip dengan:

  • id: "string",
  • dashboard_layout_id: "string",
  • dashboard_element_id: "string",
  • row: number,
  • column: number,
  • width: number,
  • height: number,
  • deleted: boolean,
elements Objek Satu atau beberapa objek elemen dasbor yang ditampilkan oleh atribut options dalam peristiwa dashboard:run:complete. Item data tersebut akan memiliki format yang 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 mengirimkan konten Looker ke berbagai tujuan.

{
  type: "dashboard:schedule_modal:open"
}
Atribut Format Deskripsi
type String Menggunakan jenis dashboard:schedule_modal:open menunjukkan bahwa Anda ingin membuka kotak dialog Schedule.

dashboard:stop

Gunakan tindakan ini untuk menghentikan dasbor yang sedang menjalankan 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: yang ditetapkan ke "stopped".

{
  type: "dashboard:stop"
}
Atribut Format Deskripsi
type String Menggunakan jenis dashboard:stop menunjukkan bahwa Anda ingin menghentikan dasbor yang berjalan.

look:run

Gunakan tindakan ini untuk menjalankan kueri tempat Look berada di iframe. 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 Look.

look:filters:update

Gunakan tindakan ini untuk memperbarui filter Look yang ada di iframe. Anda tidak dapat menambahkan filter baru ke Tampilan dengan 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 Explore di iframe. Ini mirip dengan menekan tombol Run di Explore, 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 Jelajah.

explore:filters:update

Gunakan tindakan ini untuk memperbarui atau menghapus filter Jelajah yang ada di iframe. Menyertakan filter baru yang mereferensikan kolom yang valid akan menambahkan filter baru ke Eksplorasi.

{
  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 Eksplorasi, tetapi filter tersebut mereferensikan kolom yang valid, filter tersebut akan ditambahkan ke Eksplorasi. Objek ini memiliki format: {"view_name.field_name_1": "value 1", "view_name.field_name_1": "value 2", ...}
deleteFilters Array Filter yang sudah ada yang ingin Anda hapus dari Eksplorasi. 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 saat ini dari iframe host 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 mengirimkan informasi tentang posisi scroll saat ini dari iframe host ke aplikasi Looker tersemat.
offsetTop Nomor Offset atas iframe.
offsetLeft Nomor Offset kiri iframe.
scrollX Nomor Posisi scrollX host aplikasi.
scrollY Nomor Posisi scrollY host aplikasi.