Nhúng report

Bạn có hai cách hiện report trên website khác. Liên kết công khai cho phép bất kỳ ai xem report mà không cần đăng nhập. Nhúng bảo mật để máy chủ của bạn quyết định ai được xem, và hỗ trợ bảo mật cấp hàng (row-level security).

Trước khi bắt đầu

Report phải đã xuất bản. Nếu chưa, hộp thoại báo Hãy xuất bản báo cáo trước khi nhúng.
Bạn cần quyền Build và quyền chia sẻ trên report. Vai trò Quản trị và Biên tập của workspace có cả hai. Xem Chia sẻ.
Liên kết công khai còn cần công tắc Cho phép công khai lên web của tổ chức. Công tắc này mặc định tắt.
Nhúng bảo mật cần công tắc Cho phép nhúng có xác thực của tổ chức và một khoá nhúng, và chỉ Quản trị của workspace tạo được.
Report trong My workspace không nhúng được. Hãy chuyển report sang một workspace dùng chung trước.

Chọn công khai hay bảo mật

	Website công khai (iframe)	Nhúng bảo mật (khoá nhúng)
Ai xem được	Bất kỳ ai có liên kết, không cần đăng nhập.	Chỉ người máy chủ của bạn cho phép.
Bảo mật cấp hàng	Không được dùng.	Hỗ trợ.
Thiết lập	Sao chép liên kết hoặc đoạn HTML.	Máy chủ của bạn lấy token nhúng ngắn hạn.
Dùng cho	Chỉ dữ liệu công khai.	Cổng khách hàng, trang nội bộ.

Nhúng công khai

Mở report ở chế độ xem.
Bấm … › Nhúng. Hộp thoại Nhúng báo cáo mở ra.
Chọn Website công khai (iframe).
Đọc cảnh báo Dữ liệu sẽ trở thành công khai, rồi đánh dấu Tôi hiểu dữ liệu sẽ công khai.
Bấm Tạo liên kết công khai.
Sao chép Liên kết, hoặc Mã HTML để dán vào website, bằng Sao chép.

Quản lý liên kết công khai: danh sách Liên kết công khai hiện từng liên kết ở trạng thái Đang hoạt động hoặc Đã thu hồi.

Xoay vòng tạo liên kết mới và thu hồi liên kết cũ ngay.
Thu hồi dừng liên kết ngay. Các trang đang nhúng sẽ ngừng hiển thị report.

Không tạo được liên kết công khai khi:

tổ chức đã tắt Cho phép công khai lên web;
data model của report có bảo mật cấp hàng;
report đã có 5 liên kết công khai đang hoạt động.

Nhúng bảo mật

Nhúng bảo mật gồm ba phần:

Một khoá nhúng của workspace, giữ trên máy chủ của bạn.
Máy chủ của bạn đổi khoá nhúng lấy token nhúng ngắn hạn bằng cách gọi POST /api/embed/token.
Trang web của bạn tải report trong iframe và chuyển token nhúng vào bằng postMessage. Token không bao giờ nằm trong URL.

Tạo khoá nhúng

Ở menu bên trái, trong mục Workspace, mở Khoá nhúng.
Bấm Tạo khoá nhúng.
Nhập Tên (tối đa 100 ký tự).
Chọn Phạm vi: Tất cả báo cáo trong workspace, hoặc Chọn báo cáo (tối đa 100).
Chọn Hết hạn sau: 30, 90, 180 hoặc 365 ngày. Mặc định là 90.
Nếu cần, điền Website được phép (tuỳ chọn): mỗi dòng một origin, ví dụ https://portal.example.com, tối đa 20. Để trống thì mọi website đều được.
Xác nhận. Sao chép secret.

Danh sách có các cột Tên, Phạm vi, Hết hạn, Dùng lần cuối, Trạng thái và Thao tác. Xoay vòng tạo secret mới và thu hồi secret cũ ngay. Thu hồi dừng token và mọi token nhúng tạo từ nó. Đánh dấu Hiện token đã thu hồi để xem token cũ. Mỗi workspace có tối đa 20 khoá nhúng đang hoạt động. Mọi thao tác đều được ghi nhật ký.

Nhúng report

Mở report ở chế độ xem và bấm … › Nhúng.
Chọn Nhúng bảo mật (khoá nhúng).
Dùng hai mẫu Máy chủ (lấy token nhúng) và Trang web (iframe) làm điểm khởi đầu cho lập trình viên.
Bấm Mở Khoá nhúng của workspace nếu bạn chưa có token.

Token nhúng có hiệu lực từ 1 đến 60 phút; mặc định 60. Khi data model của report có bảo mật cấp hàng, máy chủ của bạn phải gửi danh tính người xem: tên người dùng và tối đa 16 tên vai trò. Xem Bảo mật cấp hàng.

Report nhúng làm được gì

Report nhúng hiện những gì report đã xuất bản hiện. Điều này gồm từng visual, và cả Shape map dùng bản đồ tùy chỉnh bạn đã tải lên: bản nhúng tải bản đồ đó chỉ cho report được nhúng, dù từ liên kết công khai hay khoá nhúng. Report nhúng hiện các trang, slicer và tô sáng chéo. Report nhúng không có drill, drill-through, chế độ phóng to visual, bố cục điện thoại hay tự động làm mới Realtime.

Thông báo người xem có thể gặp:

Thông báo	Ý nghĩa
Liên kết nhúng không hợp lệ hoặc đã bị thu hồi.	Liên kết đã bị thu hồi hoặc xoay vòng.
Phiên nhúng đã hết hạn.	Token nhúng đã hết hạn. Trang của bạn phải xin token mới từ máy chủ.
Tổ chức đã tắt chia sẻ công khai.	Cho phép công khai lên web đã bị tắt.
Website này không được phép hiển thị báo cáo.	Website không có trong Website được phép của khoá nhúng.
Báo cáo này không thể xem công khai.	Data model có bảo mật cấp hàng.

Bật hoặc tắt nhúng công khai (quản trị viên)

Chủ sở hữu hoặc Quản trị của tổ chức điều khiển Cho phép công khai lên web trong Cài đặt tổ chức › Nhúng. Tắt công tắc sẽ dừng mọi liên kết công khai của tổ chức ngay lập tức. Nhúng bảo mật có công tắc riêng, Cho phép nhúng có xác thực, ở cùng chỗ. Xem Cài đặt nhúng và giao diện.

Lưu ý

Mọi thao tác với liên kết công khai và khoá nhúng đều được ghi vào audit log.
Liên kết và token đã thu hồi không bật lại được. Hãy tạo cái mới.

Câu hỏi thường gặp

Tôi có nhúng được report dùng bảo mật cấp hàng không? Có, bằng nhúng bảo mật. Report như vậy không được tạo liên kết công khai.

Tôi làm mất liên kết công khai. Có xem lại được không? Không. Bấm Xoay vòng để tạo liên kết mới, rồi cập nhật website.

Ai tạo được khoá nhúng? Chỉ Quản trị của workspace: “Chỉ quản trị viên workspace quản lý khoá nhúng.”