Bagikan melalui

Membuat, mengedit, dan menyimpan laporan yang disematkan

  • Artikel

Analitik tersemat Power BI memungkinkan Anda membuat, mengedit, dan menyimpan laporan yang disematkan. Laporan dapat dibuat berdasarkan himpunan data yang sudah ada, atau Anda dapat mengedit laporan yang sudah ada. Anda juga dapat menyimpan laporan setelah dibuat atau diedit.

Cara membuat laporan

Pelajari cara membuat laporan kosong baru dari himpunan data yang sudah ada.

Izin token akses yang diperlukan untuk membuat laporan

Buat token semat dengan akses ke himpunan data. Jika Anda menggunakan metode autentikasi pengguna master , pastikan aplikasi Anda memiliki cakupan berikut: , , dan . Lihat Sematkan Token - Hasilkan Token untuk informasi selengkapnya.

Izin sisi klien yang diperlukan untuk membuat laporan

Izin sisi klien berikut diperlukan untuk membuat laporan:

  • Buat - Pengguna dapat membuat laporan baru.

  • Semua - Pengguna dapat membuat, menampilkan, mengedit, menyimpan, dan menyimpan salinan laporan.

Membuat laporan baru

Buat laporan kosong baru dari himpunan data yang sudah ada. Anda akan memerlukan ID himpunan data dan URL yang disematkan. Misalnya, Anda dapat menggunakan REST API getDatasetsInGroup dan mengambil CreateReportEmbedURL. Lihat Himpunan Data - Dapatkan Himpunan Data di Grup untuk informasi selengkapnya.

Nota

Anda harus memiliki izin build atau tulis pada himpunan data untuk membuat laporan baru.

let embedCreateConfiguration = {
    tokenType: tokenType,
    accessToken: accessToken,
    embedUrl: embedURL,
    datasetId: datasetId,
    settings: settings,
    theme: theme, // optional
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Create report
let report = powerbi.createReport(embedContainer, embedCreateConfiguration);

Anda juga memiliki opsi untuk membuat laporan dengan tema yang diterapkan padanya. Visual baru yang ditambahkan ke laporan akan menghormati gaya tema. Lihat Menerapkan tema laporan untuk informasi selengkapnya.

Cara mengedit laporan

Pelajari cara mengedit laporan yang sudah ada dan beralih antara mode Tampilkan dan Edit.

Izin token akses yang diperlukan untuk pengeditan

Buat token semat dengan akses ke laporan. Jika Anda menggunakan metode autentikasi pengguna master , pastikan aplikasi Anda memiliki cakupan berikut: dan . Anda juga harus mengatur bendera allowEdit: true untuk setiap laporan yang perlu diedit pengguna akhir. Lihat Sematkan Token - Hasilkan Token untuk informasi selengkapnya.

Izin sisi klien yang diperlukan untuk pengeditan

Izin sisi klien berikut diperlukan untuk mengedit laporan:

  • Salin - Pengguna dapat menyimpan salinan laporan dengan menggunakan Simpan Sebagai.

  • ReadWrite - Pengguna dapat melihat, mengedit, dan menyimpan laporan.

  • Semua - Pengguna dapat membuat, menampilkan, mengedit, menyimpan, dan menyimpan salinan laporan.

Mengedit laporan

Muat laporan yang sudah ada dalam mode Edit. Laporan harus disematkan dengan cara yang sama seperti aplikasi menyematkan laporan reguler, dan mode tampilan harus dalam Edit. Pastikan Anda mengatur parameter viewMode ke models.ViewMode.Edit, dan Anda memiliki izin klien yang tepat.

let config = {
    type: 'report',
    tokenType: models.TokenType.Aad or models.TokenType.Embed,
    accessToken: YourAccessToken,
    embedUrl: YourEmbedUrl,
    id: YourEmbedReportId,
    permissions: models.Permissions.All,
    viewMode: models.ViewMode.Edit,
};

// Grab the reference to the div HTML element that will host the report
let embedContainer = $('#embedContainer')[0];

// Embed report
let report = powerbi.embed(embedContainer, config);

Pengguna Anda sekarang dapat mengedit laporan berdasarkan izin yang telah diaktifkan.

Anda juga dapat beralih antara mode Edit dan Tampilan setelah laporan dimuat.

report.switchMode("view");

Untuk beralih ke mode edit:

report.switchMode("edit");

Cara menyimpan laporan

Pelajari cara menyimpan laporan, termasuk opsi tambahan seperti menyimpan salinan laporan dan menyimpan laporan ke ruang kerja lain.

Izin token akses yang diperlukan untuk menyimpan

Buat token semat dengan akses ke laporan dan himpunan data. Jika Anda ingin menyimpan laporan ke ruang kerja lain, token harus memiliki akses ke ruang kerja target. Jika Anda menggunakan metode autentikasi pengguna master , pastikan aplikasi Anda memiliki cakupan berikut: , dan . Anda juga harus mengatur bendera allowEdit: true untuk setiap laporan yang perlu diedit pelanggan. Lihat Sematkan Token - Hasilkan Token untuk informasi selengkapnya.

Izin sisi klien yang diperlukan untuk menyimpan

Izin sisi klien berikut diperlukan untuk menyimpan laporan:

  • ReadWrite - Pengguna dapat melihat, mengedit, dan menyimpan laporan.

  • Buat - Pengguna dapat membuat laporan baru.

  • Salin - Pengguna dapat menyimpan salinan laporan dengan menggunakan Simpan Sebagai.

  • Semua - Pengguna dapat membuat, menampilkan, mengedit, menyimpan, dan menyimpan salinan laporan.

Menyimpan laporan

Saat membuat laporan, laporan tidak disimpan sampai Anda memanggil operasi save dari menu file atau JavaScript.

report.save();

Menyimpan salinan laporan

Simpan salinan tambahan dengan nama yang berbeda. Salinan laporan akan disimpan ke ruang kerja yang sama dengan himpunan data laporan.

let saveAsParameters = {
    name: "newReport"
};

report.saveAs(saveAsParameters);

Anda juga dapat menyimpan laporan ke ruang kerja lain. Pastikan Anda memiliki izin yang tepat untuk ruang kerja target.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Verifikasi bahwa laporan disimpan

Hubungi report.isSaved untuk memastikan laporan disimpan. Metode ini dapat membantu mencegah hilangnya perubahan yang tidak disimpan.

let isReportSaved = await report.isSaved();

Membuat pengalaman saveAs kustom

Anda dapat membuat dialog saveAs kustom dengan menambahkan pengaturan laporan useCustomSaveAsDialog: true ke objek konfigurasi. Pengaturan ini menyembunyikan dialog antarmuka pengguna default.

Peristiwa saveAsTriggered dinaikkan saat pengguna mengklik Simpan Sebagai di UI. Gunakan informasi ini untuk menampilkan dialog kustom Anda.

report.on("saveAsTriggered", function (event) {
    console.log(event);
});

Untuk melakukan operasi simpan sebagai, Anda dapat memanggil report.saveAs dari dialog kustom Anda. Lihat Menyimpan salinan laporan untuk informasi selengkapnya.

let saveAsParameters = {
    name: "newReport"
    targetWorkspaceId: "13bbf317-fe2b-4b15-a081-94b0921c28e5"
};

report.saveAs(saveAsParameters);

Dengarkan peristiwa simpan dan simpanTapa

Peristiwa saved dinaikkan saat penyimpanan dipicu oleh tindakan save atau saveAs di UI atau dengan menggunakan API. Lihat Cara menangani peristiwa untuk informasi selengkapnya.

report.on("saved", function (event) {
    console.log(event);
});

Konten terkait