Thêm báo cáo hoặc bảng thông tin Power BI vào một trang web trong cổng thông tin
Lưu ý
- Từ tháng 10 năm 2022, cổng thông tin Power Apps trở thành Power Pages.
- Chủ đề này áp dụng cho các chức năng cũ. Để biết thông tin mới nhất, hãy truy cập tài liệu hướng dẫn sử dụng Microsoft Power Pages.
Mẹo
Bài viết này giải thích cách thêm báo cáo hoặc bảng thông tin Power BI bằng thẻ Liquid powerbi. Thêm thành phần Power BI trên trang web trong cổng thông tin của bạn bằng cách sử dụng Studio cổng thông tin, đi đến Thêm thành phần Power BI vào trang web bằng cách sử dụng Studio cổng thông tin.
Bạn có thể thêm báo cáo hoặc bảng thông tin Power BI vào một trang web trong cổng thông tin bằng cách sử dụng thẻ Liquid powerbi. Sử dụng thẻ powerbi trong trường Sao chép trên trang web hoặc trong trường Nguồn trên mẫu web.
Nếu đang thêm một báo cáo hoặc bảng thông tin Power BI được tạo trong không gian làm việc mới của Power BI, bạn phải chỉ định loại xác thực là powerbiembedded trong thẻ Liquid powerbi.
Lưu ý
- Nếu bạn đã chỉ định Microsoft Entra ID làm loại xác thực trong thẻ powerbi Liquid, bạn phải chia sẻ ID đó với những người dùng được yêu cầu trước khi thêm báo cáo hoặc trang tổng quan Power BI bảo mật vào một trang web trong cổng thông tin. Thêm thông tin: Chia sẻ không gian làm việc Power BI và Chia sẻ bảng thông tin vào báo cáo Power BI.
- powerbiembedded hỗ trợ các bảng thông tin và báo cáo Power BI kết nối với Azure Analysis Services. Bạn cũng có thể sử dụng thuộc tính "customdata" trong mã liquid để chuyển giá trị cho thuộc tính CustomData.
- Báo cáo Power BI được phân trang không được hỗ trợ.
Ví dụ:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Để tìm hiểu về cách lấy đường dẫn bảng thông tin và ID của ngăn xếp bảng thông tin, hãy tham khảo các phần phía sau của bài viết này.
Sử dụng bảng thông tin hoặc báo cáo kết nối với Azure Analysis Services
Bạn có thể thêm thẻ Liquid powerbi với bảng thông tin hoặc báo cáo kết nối với Azure Analysis Services.
Để thêm bảng thông tin hoặc báo cáo kết nối với Azure Analysis Services, hãy sử dụng tham số CustomData trong chuỗi kết nối.
Ví dụ:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/<GroupID>/reports/<ReportID>" roles:"<roles associated with report>" customdata:"<customdata>" %}
Thẻ customdata tùy chọn có thể được đặt cấu hình dưới dạng chuỗi hoặc được tạo động dựa trên thuộc tính của đối tượng, sử dụng dấu chấm (".") hoặc dấu ngoặc vuông ("[]") để phân tách giữa đối tượng và thuộc tính, ở giữa hai cặp dấu ngoặc dấu ngoặc nhọn.
Ví dụ:
customdata: {{ object.attribute }}customdata: {{ object[attribute] }}
Vì thẻ customdata trả về một chuỗi nên có thể cần phải chuyển đổi chuỗi này thành số nguyên trong truy vấn DAX.
Quan trọng
- Cổng thông tin không hỗ trợ bảng thông tin hoặc báo cáo Power BI kết nối với Azure Analysis Services sử dụng cổng dữ liệu để kết nối với nguồn dữ liệu tại chỗ.
- Phiên bản cổng thông tin của bạn phải là 9.3.4.x trở lên để tính năng này hoạt động.
Azure Analysis Services và Vai trò (RLS)
Thẻ roles là không bắt buộc đối với các báo cáo và bảng thông tin dựa trên Azure Analysis Services. Khi không sử dụng, vai trò được mặc định thành vai trò mà ứng dụng được gán trong Azure Analysis Services.
Tuy nhiên, thẻ này có thể trở nên cần thiết để chỉ định một vai trò (hoặc các vai trò) nhất định trong số một số vai trò có sẵn và vẫn có thể được yêu cầu khi sử dụng bảo mật Cấp hàng.
Các vai trò nằm trong cơ sở dữ liệu Azure Analysis Services chứ không có trong báo cáo, không giống như các loại báo cáo Power BI khác.
Không cung cấp vai trò nào trong mã Liquid.
Nếu không có vai trò nào được cung cấp trong mã Liquid, thì vai trò trong Azure Analysis Services sẽ được xác định theo (các) vai trò mà Ứng dụng có quyền truy cập, đồng thời sẽ lọc kết quả theo dữ liệu tùy chỉnh đã cung cấp dựa trên truy vấn DAX trong (các) vai trò. Nghĩa là, tất cả vai trò có sẵn sẽ kết hợp các quyền truy cập tương ứng, nhưng vẫn sẽ lọc nếu dữ liệu tùy chỉnh đã cung cấp phù hợp. Tình huống này thường xảy ra nhất với báo cáo Azure Analysis Services hoặc bảng tổng quan một ngăn xếp.
Cung cấp các vai trò trong mã Liquid.
Các vai trò trong Azure Analysis Services có thể được cung cấp trong mã Liquid, tương tự như các vai trò RLS. Việc sử dụng các vai trò này có thể được yêu cầu khi có nhiều vai trò nhưng bạn muốn sử dụng các vai trò cụ thể cho trang. Khi sử dụng bất kỳ vai trò nào trong chuỗi kết nối, việc chỉ định vai trò trong Azure Analysis Services là điều bắt buộc. Ví dụ: bảng thông tin nhiều ngăn xếp sử dụng ngăn xếp Azure Analysis Services với ngăn xếp RLS.
Những cân nhắc sau áp dụng khi sử dụng các ngăn xếp Azure Analysis Services trong bảng thông tin:
- Nếu ngăn xếp Azure Analysis Services được sử dụng trong bảng thông tin với các ngăn xếp khác yêu cầu vai trò, thì vai trò trong Azure Analysis Services phải được thêm vào danh sách vai trò.
- Nhiều ngăn xếp từ các nguồn Azure Analysis Services khác nhau có thể được sử dụng với vai trò riêng, nhưng dữ liệu tùy chỉnh phải giống nhau đối với mỗi ngăn xếp và không thể sử dụng nhiều giá trị dữ liệu tùy chỉnh trong mã Liquid. Thẻ customdata và tham số customdata cho EffectiveIdentity chỉ nhận một giá trị chuỗi.
Nhận đường dẫn của bảng thông tin hoặc báo cáo
Đăng nhập vào Power BI.
Mở bảng thông tin hoặc báo cáo mà bạn muốn nhúng trong cổng thông tin của mình.
Sao chép URL từ thanh địa chỉ.
Nhận ID của ngăn xếp bảng thông tin
Đăng nhập vào Power BI.
Mở bảng thông tin mà bạn muốn nhúng ngăn xếp trong cổng thông tin của mình.
Trỏ tới ngăn xếp, chọn Tùy chọn khác rồi chọn Mở chế độ tiêu điểm.
Sao chép các ID ngăn xếp từ URL trong thanh địa chỉ. ID ngăn xếp là giá trị sau /ngăn xếp/.
Cách sử dụng thư viện JavaScript powerbi-client trong cổng thông tin
Bạn có thể sử dụng thư viện JavaScript powerbi-client cho Power BI Embedded báo cáo hoặc trang tổng quan trong cổng thông tin của mình. Để biết thêm thông tin về thư viện JavaScript powerbi-client, hãy xem Trang wiki về JavaScript Power BI.
Dưới đây là JavaScript mẫu để cập nhật thiết đặt báo cáo hoặc để xử lý các sự kiện. Mẫu này vô hiệu hóa ngăn bộ lọc, tắt điều hướng trang và bật sự kiện dataSelected.
Quan trọng
- Sử dụng thư viện JavaScript powerbi-client để tắt hoặc bật ngăn bộ lọc. Tuy nhiên, nếu bạn muốn hạn chế quyền truy cập vào dữ liệu hoặc định cấu hình bảo mật, hãy sử dụng Bảo mật cấp hàng (RLS) với Power BI. Việc tắt ngăn bộ lọc không hạn chế quyền truy cập dữ liệu và ngăn này có thể được bật lại bằng cách sử dụng mã thư viện JavaScript.
- Thư viện JavaScript powerbi-client chỉ được hỗ trợ cho luồng PowerBI Embedded .
$(document).ready(function () {
var embedContainer = $(".powerbi")[0];
if (embedContainer) {
var report = powerbi.get(embedContainer);
report.on("loaded", function () {
report.updateSettings({
panes: {
filters: {
visible: false
},
pageNavigation: {
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
})
}
});
Để thêm JavaScript tùy chỉnh vào trang web:
- Mở ứng dụng Quản lý cổng thông tin.
- Chọn Trang web từ ngăn bên trái.
- Chọn trang web có chứa báo cáo hoặc bảng thông tin Power BI.
- Chọn tab Nâng cao.
- Sao chép và dán JavaScript bên trong phần JavaScript tùy chỉnh.
- Chọn Lưu & Đóng.
Bây giờ, hãy tìm hiểu các thao tác JavaScript mẫu và các tùy chọn khác nhau.
Nhận tham chiếu đến HTML báo cáo được nhúng
Nhận tham chiếu đến HTML báo cáo được nhúng.
var embedContainer = $(".powerbi")[0];
Thêm thông tin: Nhận tham chiếu đến một thành phần Power BI hiện có đưa ra phần tử chứa
Nhận tham chiếu đến báo cáo được nhúng
var report = powerbi.get(embedContainer);
Làm việc với ngăn Power BI
Bạn có thể sử dụng thiết đặt cho các ngăn để làm việc với ngăn Power BI trên trang web cổng thông tin. Ví dụ: bạn có thể sử dụng thiết đặt bộ lọc để ẩn hoặc hiển thị ngăn hoặc làm việc với thiết đặt điều hướng trang.
Dưới đây là một mẫu để loại bỏ ngăn bộ lọc:
report.updateSettings({
panes: {
filters :{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Dưới đây là một mẫu để làm việc với cả điều hướng trang và bộ lọc:
report.updateSettings({
panes: {
filters :{
visible: false
},
pageNavigation:{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Thêm thông tin: Cập nhật thiết đặt và Nhúng cấu hình - Thiết đặt
Xử lý sự kiện
Thành phần nhúng có thể phát ra các sự kiện khi thu hồi hoàn thành một lệnh được thực thi. Ví dụ: dưới đây là một mẫu cho sự kiện dataSelected.
//Report.off removes a given event listener if it exists
report.off("dataSelected");
//Report.on will add an event list
report.on('dataSelected', function(event){
console.log('Event - dataSelected:');
console.log(event.detail);
})
Thêm thông tin: Xử lý sự kiện
Xem thêm
- Thêm thành phần Power BI vào trang web bằng cách sử dụng Studio cổng thông tin
- Thiết lập tích hợp Power BI
- thẻ powerbi Liquid
Lưu ý
Bạn có thể cho chúng tôi biết bạn thích dùng ngôn ngữ nào cho tài liệu không? Làm một cuộc khảo sát ngắn. (xin lưu ý, khảo sát này bằng tiếng Anh)
Cuộc khảo sát sẽ mất khoảng bảy phút. Không có dữ liệu cá nhân nào được thu thập (điều khoản về quyền riêng tư).
Phản hồi
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem: https://aka.ms/ContentUserFeedback.
Gửi và xem ý kiến phản hồi dành cho