Menyematkan dasbor

Artikel ini menjelaskan cara menyematkan dasbor AI/BI di situs web atau aplikasi eksternal. Admin ruang kerja harus menentukan potensi permukaan penyematan sebelum dasbor dapat disematkan. Untuk detail tentang mengonfigurasi penyematan dasbor, lihat Kelola penyematan dasbor ruang kerja Anda.

Pengguna dengan izin minimal BISA EDIT dapat menghasilkan kode iframe untuk dashboard dari dialog Bagikan. Semua pengaturan berbagi untuk dasbor yang diterbitkan tetap berlaku. Hanya pengguna yang telah diberikan akses secara eksplisit yang dapat melihat dasbor yang disematkan. Lihat Berbagi dasbor untuk mempelajari selengkapnya tentang berbagi dasbor. Dasbor yang disematkan mengikuti cache dan irama refresh yang sama dengan semua dasbor lainnya. Lihat Caching dan kesegaran data.

Hasilkan kode sematkan

Untuk menyematkan dasbor, gunakan langkah-langkah berikut:

1. Buka dasbor yang diterbitkan yang ingin Anda sematkan. Lihat Menampilkan dan menata dasbor untuk mempelajari cara menampilkan dan mengakses dasbor di ruang kerja Anda.

2. Klik Bagikan di sudut kanan atas.

3. Klik Sematkan dasbor dalam dialog Berbagi .

4. Dialog Salin kode semat terbuka. Jika ada daftar domain penyematan yang diizinkan, domain akan dicantumkan. Klik tombol salin untuk menyalin cuplikan kode.

   Dialog salin kode semat memperlihatkan kode iframe yang dihasilkan dan domain di mana dasbor yang diterbitkan dapat disematkan.

5. Masukkan kode semat ke platform atau aplikasi apa pun yang mendukung penyematan HTML dan dapat merender konten iframe. Lihat contoh .

Contoh

Contoh berikut mencakup panduan langkah demi langkah untuk menyematkan dasbor Anda dalam aplikasi. Setiap set instruksi mengasumsikan bahwa Anda telah menyalin kode semat yang diuraikan di bagian sebelumnya.

Sematkan dalam Confluence

Kode semat yang dihasilkan memerlukan sedikit penyesuaian untuk memenuhi persyaratan Confluence. Untuk menyematkan dasbor Anda di halaman Confluence, selesaikan langkah-langkah berikut:

1. Edit kode semat untuk hanya menyertakan URL yang dihasilkan, bukan tag iframe atau nilai markup tambahan.

   Sebelum mengedit, kode semat menyertakan tag HTML iframe, tautan ke dasbor Anda untuk menggunakan sumber di iframe, dan spesifikasi tambahan untuk tinggi, lebar, dan batas seperti yang ditunjukkan dalam cuplikan kode berikut. Untuk dasbor Anda, contoh tempat penampung <databricks-instance-name> dan <dashboard-and-workspace-ID> berisi nilai aktual yang terkait dengan ruang kerja dan dasbor Anda. Klaimnya sebagai berikut:

   • Bagian pertama dari URL Anda saat masuk ke ruang kerja adalah <databricks-instance-name>. Lihat Mendapatkan pengidentifikasi untuk objek ruang kerja.
   • <dashboard-and-workspace-ID> adalah bagian terakhir dari URL yang menunjuk ke dasbor Anda. Ini terlihat seperti: a4bf23c498752e79f1a2d6b4c9087e31?o=3498561237865447.

   <iframe src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>" width="100%" height="600" frameborder="0"></iframe>
   

   Edit string sehingga hanya menyertakan teks tautan seperti yang ditunjukkan dalam contoh berikut.

   https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>
   

2. Sisipkan elemen iframe ke halaman Anda. Untuk mempelajari cara menyisipkan iframe ke halaman Anda, lihat Dokumentasi Confluence.

3. Tempelkan URL semat yang diedit di bidang teks URL dan atur lebar ke 100%.

4. Sesuaikan pengaturan lain sesuai dengan preferensi Anda.

Disematkan dalam Pengetahuan Salesforce

Untuk menyematkan dasbor Anda di halaman Pengetahuan Salesforce, selesaikan langkah-langkah berikut:

1. Buat halaman Visualforce. Untuk mengetahui petunjuknya, lihat dokumentasi Salesforce.

2. Dari layar Edit Halaman, pindahkan kursor Anda ke editor Markup Visualforce.

3. Tempelkan kode semat yang Anda salin di antara dua tag <apex:page></apex:page>.

4. Tambahkan dua tag paragraf (<p></p>) di sekitar kode semat.

   Contoh berikut menggunakan placeholder <dashboard-embed-code> untuk menunjukkan bentuk markup Visualforce Anda. Instans Anda harus menyertakan kode semat lengkap yang Anda salin.

   <apex:page >
   <p><dashboard-embed-code></p>
   </apex:page>
   

5. Klik Save untuk menyimpan perubahan Anda.

6. Klik Pratinjau dan pastikan bahwa dasbor ditampilkan.

7. Salin URL pratinjau komponen dan buat komponen iframe baru. Ini akan terlihat seperti cuplikan kode berikut. Pengganti <your-salesforce-domain> harus diganti dengan domain Salesforce Anda.

   <iframe src="https://<your-salesforce-domain>/apex/<component name>" width="100%" height="600" frameborder="0"></iframe>
   

8. Buka halaman Pengetahuan tempat Anda ingin menyematkan dasbor Anda.

9. Klik Edit>Tambahkan komponen media.

10. Tempelkan kode iframe dari langkah sebelumnya ke dalam kolom Sematkan.

Sematkan di SharePoint

Untuk menyematkan dasbor Anda di SharePoint, Anda mungkin perlu menambahkan URL Azure Databricks Anda ke daftar situs yang diizinkan untuk konten yang disematkan di SharePoint. Lihat [Dokumentasi Microsoft] untuk mempelajari cara memperbolehkan konten yang disematkan di halaman SharePoint. Kemudian, selesaikan langkah-langkah berikut:

1. Buka halaman SharePoint tempat Anda ingin meletakkan dasbor tersemat.
2. Tambahkan elemen Sematkan ke halaman.
3. Tempelkan kode semat lengkap ke dalam bidang Alamat Situs Web atau kode semat di sisi kanan layar.
4. Klik untuk mengonfirmasi.

Menyematkan satu widget

Untuk menyematkan satu widget dari dasbor, Anda memerlukan kode semat dasbor dan pengidentifikasi unik widget yang ingin Anda tampilkan.

Untuk menemukan ID widget:

1. Buka dasbor Anda yang telah diterbitkan di ruang kerja Azure Databricks.

2. Klik menu menu kebab untuk widget yang ingin Anda sematkan.

3. Klik Tampilkanlayar penuh. URL baru berisi ID widget.

4. Salin parameter pencarian fullscreenWidget dan semua setelah tanda sama dengan (=) hingga akhir string atau sampai ampersand berikutnya (&), mana pun yang lebih dulu muncul. Jangan sertakan ampersand (&) dalam string yang disalin.

   Contoh berikut menunjukkan bagian terakhir URL untuk widget layar penuh:

   fullscreenWidget=dashboards%2F01eff2e6ef131891bbd9d788f05acdc4%2Fpages%2F01eff2e974cd19b4a073bef1fb5b8956%2Fwidgets%2F01eff2e974ce113da1fd029b54653ac7
   

   Dalam hal ini, ID widget dashboards%2F01eff2e6ef131891bbd9d788f05acdc4%2Fpages%2F01eff2e974cd19b4a073bef1fb5b8956%2Fwidgets%2F01eff2e974ce113da1fd029b54653ac7

Sesuaikan kode semat yang dihasilkan:

1. Lihat Membuat kode sematan untuk mengetahui langkah-langkah pembuatannya dalam menghasilkan kode sematan dasbor.
2. Tambahkan &fullscreenWidget=<ID> ke URL semat, ganti <ID> dengan ID widget.

Misalnya, jika URL semat dasar Anda adalah sebagai berikut:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=<ID>"

URL semat yang diperbarui dengan ID widget akan terlihat seperti berikut:

src="https://<databricks-instance-name>/embed/dashboardsv3/<dashboard-and-workspace-ID>&fullscreenWidget=dashboards%2F01eff2e6ef131891bbd9d788f05acdc4%2Fpages%2F01eff2e974cd19b4a073bef1fb5b8956%2Fwidgets%2F01eff2e974ce113da1fd029b54653ac7"

Lihat dasbor yang disematkan

Dasbor yang disematkan menawarkan cara yang aman bagi penonton untuk mengakses data dasbor di luar Azure Databricks. Semua pengaturan berbagi yang ada berlaku. Penonton yang dimaksudkan harus diberikan akses ke dasbor. Lihat Siapa yang bisa mengakses dasbor Anda?.

Untuk melihat dasbor yang disematkan:

• Navigasi ke halaman tempat dasbor telah disematkan.
• Jika perlu, masuk dengan kredensial Azure Databricks.

Memperbarui dasbor yang disematkan

Semua penonton dasbor yang disematkan dapat secara manual me-refresh dasbor sesuai permintaan. Anda juga dapat menyiapkan jadwal untuk me-refresh dasbor secara berkala.

Lihat Mengelola dasbor dan pembaruan langganan terjadwal.

Pemecahan masalah dasbor yang disematkan

Bagian ini mencantumkan masalah umum yang mungkin Anda temui dan menawarkan resolusi yang disarankan:

Iframe yang disematkan kosong

Jika iframe yang disematkan tidak menampilkan data, itu mungkin karena Anda telah menonaktifkan cookie pihak ketiga. Mengaktifkan cookie pihak ketiga sering kali diperlukan untuk memungkinkan konten eksternal, seperti dasbor yang disematkan, berfungsi dengan benar dalam halaman web lain.

Anda dapat menyesuaikan pengaturan browser untuk mengizinkan atau membuka blokir cookie pihak ketiga untuk mengatasi masalah ini. Jika Anda tidak ingin mengizinkan semua cookie pihak ketiga, banyak browser memungkinkan Anda untuk menambahkan pengecualian untuk situs tertentu di mana cookie pihak ketiga harus diizinkan. Lihat dokumentasi bantuan browser Anda untuk instruksi terperinci tentang mengelola cookie.