Quick BI：Skema Dasar untuk Penyematan Laporan

Langkah 1: Aktifkan laporan untuk disematkan

Penyematan laporan hanya didukung untuk laporan dalam status diterbitkan.

Untuk mengaktifkan penyematan laporan, akses modul platform terbuka:

1. Navigasikan ke halaman laporan tersemat dari halaman utama produk Quick BI seperti yang ditunjukkan pada gambar di bawah ini.

   

2. Di halaman Add Embedded Report, pilih ruang kerja dan tipe objek data yang diinginkan, lalu pilih nama objek data dari daftar dan klik Enable Embedding. Gunakan fungsi pencarian nama laporan untuk dengan cepat menemukan laporan yang ingin Anda sematkan.

   

   Catatan

   Beberapa browser mungkin memblokir iframe penyematan lintas asal saat menyematkan halaman pelaporan workbook ke dalam lingkungan pihak ketiga. Hal ini dapat mencegah penulisan cookie dan menyebabkan kegagalan pengiriman data pada halaman pelaporan workbook. Oleh karena itu, disarankan untuk menggunakan fitur pelaporan workbook langsung di platform Quick BI.

3. Konfigurasi Penyematan

   Fitur debugging untuk konfigurasi penyematan laporan dimaksudkan untuk solusi yang ditingkatkan.

   Penting

   Debugging ini hanya untuk pengujian fitur. Untuk penyebaran sebenarnya, harap selesaikan Langkah 2: Dapatkan accessTicket melalui antarmuka HTTPS dan Langkah 3: Gabungkan URL single sign-on.

   Setelah mengaktifkan penyematan, kemampuan skema dasar dan skema ditingkatkan berbeda selama integrasi sebenarnya. Lihat tabel di bawah ini untuk detailnya:

   Kemampuan	Skema dasar	Skema ditingkatkan
   Pengikatan pengguna	Pemilik laporan, tidak dapat diubah	Mendukung penyesuaian, dipersonalisasi untuk setiap pengguna
   Permintaan akses	Maksimal 100.000 kali per tiket	Tanpa Batas, mendukung pengaturan kustom
   Watermark	Tidak didukung	Didukung (Kecuali layar besar yang tidak mendukung watermark)
   Masa berlaku	Maksimum 240 menit	Mendukung penyesuaian
   Parameter global	Tidak didukung	Didukung
   Blok penyematan	Tidak didukung	Didukung
   Jumlah lompatan Catatan Laporan yang akan dilompati juga perlu mengaktifkan penyematan.	Hanya bisa melompat sekali Contoh: Setelah laporan A melompat ke laporan B, laporan B tidak dapat melompat ke laporan C.	Mendukung lompatan tanpa batas Contoh: Setelah laporan A melompat ke laporan B, laporan B masih dapat melompat ke laporan C, dan C dapat terus melompat lebih jauh, dan seterusnya.

Langkah 2: Dapatkan accessTicket melalui antarmuka HTTPS

Bab ini menggunakan contoh penyematan dashboard dari ruang grup ke dalam sistem pihak ketiga.

• Jika akun yang mengaktifkan akses dashboard memiliki izin pengembang atau analisis, maka hanya dapat mengaktifkan akses untuk dashboard yang dibuat oleh akun tersebut.

• Jika akun memiliki izin manajemen, maka dapat mengaktifkan akses untuk semua laporan dalam ruang kerja tersebut.

  1. Ikuti langkah-langkah berikut untuk mendapatkan ID AccessKey dan AccessKey Secret Anda, yang disebut sebagai accessId dan accessKey.

     1. Masuk ke Konsol Quick BI.

     2. Di halaman utama Quick BI, ikuti petunjuk pada gambar di bawah ini untuk mendapatkan ID AccessKey dan AccessKey Secret Anda.

        

  2. Dapatkan ID akun Alibaba Cloud Anda, yang juga dikenal sebagai aliyunUid.

     Masuk ke akun Alibaba Cloud Anda, lalu klik foto profil di sudut kanan atas untuk melihat ID akun.

     

  3. Di halaman pengeditan laporan, dapatkan ID laporan, juga dikenal sebagai worksId:

     

  4. Dapatkan accessTicket

     Gabungkan parameter accessId, accessKey, aliyunUid, dan worksId yang diperoleh di langkah sebelumnya ke dalam alamat permintaan berikut dan kirim permintaan GET untuk mendapatkan accessTicket.

     https://bi-cn-hongkong.data.aliyun.com//openapi/ac3rd/ticket/create?worksId=xx&aliyunUid=xx&accessKey=xx&accessId=xx&validityTime=xx

     Catatan

     • AliyunUid digunakan hanya untuk menghasilkan accessTicket dan memverifikasi apakah peran saat ini memiliki izin untuk mengaktifkan Single Sign-On (SSO) untuk laporan organisasi. Ini tidak mengikat identitas laporan tersemat pihak ketiga.

     • ValidityTime adalah parameter opsional dengan rentang nilai 1 hingga 240, secara default 240. Satuannya adalah menit.

     • Untuk segera membatalkan accessTicket, kirim permintaan POST dengan nilai aliyunUid, accessId, accessKey, dan accessTicket yang sesuai.

       http://bi-cn-hongkong.data.aliyun.com//openapi/ac3rd/ticket/invalid?aliyunUid=xx&accessId=xx&accessKey=xx&accessTicket=xx

Bagaimana cara menyelesaikan kesalahan "akses report_tree tidak sah" saat menyematkan laporan?

Deskripsi masalah

Saat menyematkan laporan ke dalam sistem pihak ketiga, Anda mungkin mengalami pesan kesalahan berikut.

Penyebab

Kesalahan ini terjadi ketika izin laporan belum diaktifkan di ruang grup yang sesuai.

Solusi

Aktifkan izin laporan dengan mengikuti langkah-langkah yang diilustrasikan di bawah ini.

Bagaimana cara menyesuaikan ketinggian laporan Quick BI tersemat pihak ketiga secara otomatis (PC)?

Deskripsi masalah

Saat menyematkan dashboard Quick BI menggunakan Iframe, pembatasan keamanan lintas domain browser dapat mencegah mendapatkan ketinggian dashboard, menyebabkan munculnya bilah gulir.

Solusi

Quick BI mentransmisikan ketinggian dashboard ke halaman eksternal menggunakan postMessage saat memuat. Halaman eksternal dapat mendengarkan acara ini untuk mendapatkan ketinggian dan ID dashboard.

Ada dua metode untuk mencapai ini:

Contoh Lengkap

<!DOCTYPE html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    </head>
    <body>
        <iframe 
        class="quickbi-iframe-demo"
    src="https://bi-cn-hongkong.data.aliyun.com//token3rd/dashboard/view/pc.htm?pageId=dd0****83f&accessTicket=fd138bcb-****-4fde-b413-81bcee59bdb6"
      scrolling="no"
     frameborder="0" 
      width="100%" 
      height="600">
    </iframe>
   <!-- <useBodyAutoHeight=true> untuk penyesuaian tinggi body otomatis, <page_Id> adalah ID halaman dashboard, accessTicket adalah token akses untuk dashboard -->
        <script>
      // Alamat Quick BI, tambahkan alamat lain jika digunakan
      const quickBIURL = ['https://bi-cn-hongkong.data.aliyun.com'];
      function messageListener(event) {
        if (quickBIURL.includes(event.origin)) {
          // Tinggi yang ditransmisikan menggunakan postMessage
          console.log('Tinggi Dashboard Quick BI:', event.data.height);
          // ID halaman dashboard yang ditransmisikan menggunakan postMessage
          console.log('ID Dashboard Quick BI:', event.data.pageId);
        }
      }
      // Dengarkan sebelum dashboard dimuat
      window.addEventListener('message', messageListener);
      // Iframe yang menyematkan dashboard Quick BI
      const iframe = document.querySelector('iframe');
       // Permintaan proaktif tinggi dashboard Quick BI
      // Data yang dilewatkan dalam pesan harus mencakup { getDashboardHeight: true }
      iframe.contentWindow.postMessage({getDashboardHeight: true}, '*');
        </script>
    </body>
</html>

Bagaimana cara mengatur lebar saat menyematkan ke aplikasi pihak ketiga menggunakan Iframe di halaman seluler?

Deskripsi masalah

Masalah kompatibilitas dengan Iframe pada versi iOS yang lebih lama dapat menyebabkan lebar sebenarnya dari Iframe meluap, mengakibatkan berbagai masalah tampilan seperti dashboard bergeser, tabel daftar tetap tidak dapat digulir, bagan terpotong, dan kotak pop-up kontrol kueri tidak sejajar.

Solusi

Atur gaya Iframe sesuai.

Ikuti kode contoh di bawah ini dengan cermat untuk modifikasi:

iframe {
    border-width: 0;
    min-width: 100%;
    width: 0;
    *width: 100%;
    height: 667px; /* Tinggi harus menggunakan bidang statis, yang dapat diatur secara dinamis setelah mendapatkan tinggi layar. height: 100% akan memiliki masalah kompatibilitas */
}