Report Profile
Giới thiệu
Reporting luôn là 1 trong những thành phần quan trọng nhất của phần mềm. Xuất báo cáo trong Phoebus được thực hiện qua 4 bước:
Thu thập dữ liệu cần cho báo cáo.
Chọn phương pháp xây dựng báo cáo (reporting engine). Phoebus cung cấp 4 reporting engine để chạy các báo cáo:
Format Text Engine
Scriban Engine
Excel Engine
Snap Engine
Chọn template/layout trình bày dữ liệu
Sau khi báo cáo được tạo ra, Phoebus có thể chuyển đổi kết quả thành các định dạng khác nhau như txt, xml, json, docx, html, markdown ...
Chức năng này giúp kết hợp các bước trên lại thành 1 profile để sử dụng dễ dàng hơn khi cần trình bày dữ liệu ra báo cáo. Nó có thể bổ sung, hỗ trợ và sử dụng cùng các chức năng reporting đang có sẵn.
Các báo cáo mới nên được thiết kế theo cách này để dễ dàng hơn trong thiết kế và vận hành.
⚠️ Chú ý
Trước khi chức năng này xuất hiện, ta có thể sử dụng nhiều cách khác nhau để xuất báo cáo, chủ yếu là các câu lệnh pbs.BO.Output.......
Khi sử dụng các câu lệnh này, user sẽ cần cung cấp các tham số của 4 bước trên thông thông qua các tham số của câu lệnh pbs.BO.Output.......
Chức năng này là bước chuẩn hóa cách tạo báo cáo khi thiết kế hệ thống. Nó được liên kết với tài liệu, ví dụ và các bước test giúp người thiết kế hiểu được cách báo cáo vận hành.
Sử dụng
4 bước khi chạy báo cáo được khai báo ở các trường:
Các trường dữ liệu
- Code K (Definition)
- Mã hiệu profile.
- Description (Definition)
- Diễn giải.
- Survey Code
- Ta có thể khai báo Survey Definition ở đây, trước khi chạy báo cáo, chương trình sẽ hỏi user các tham số cần thiết rồi chạy.
- Invalidate Before Running v4.7.7.544
- Liệt kê các loại dữ liệu mà chương trình cần xóa cache trước khi chạy báo cáo.
- DataProfile
Khai báo profile định nghĩa nguồn dữ liệu. Nguồn này được khai báo ở chức năng Report Dataset.
Bên cạnh cách khai báo thông qua Report Dataset, người thiết kế có thể khai báo phoebus data url trực tiếp vào đây, như
pbs.BO.LA.NA?Address5=HCMCThis profile defines the dataset, which will be presented in the output report.
- RenderingEngine
Reporting Engine dùng để xây dựng báo cáo, chọn 1 trong danh sách các engine được hỗ trợ
This reporting engine will be used for building the output.
- ReportTemplate
Chọn template code được dùng để trình bày dữ liệu ra báo cáo. Tùy theo Rendering Engine mà template code sẽ được hiểu là Excel Template, Snap Template hay (Formated Text)
Depend on the engine, this template may be formatted text, excel or snap.
- OutputFormat
- Sau khi báo cáo được chạy, kết quả có thể được xuất ra nhiều định dạng khác nhau tùy theo yêu cầu sử dụng. After Building, the result may be converted to desired format. Text, XML, Excel, Pdf, Word, Html.
- Use Excel To Open Xls report
Có các giá trị :
Y- luôn mở báo cáo excel bằng Excel app.N- Luôn mở báo cáo bằng viewer của Phoebus.
Xem báo cáo dạng bảng tính bằng viewer của Phoebus
Ta có thể thiết lập Use Excel To Open Xls report = N để luôn dùng viewer của Phoebus xem kết quả dạng bảng tính.
Ta làm như vậy nếu báo cáo chỉ cho phép xem chứ không được sửa đổi gì.
Ngoài ra các lệnh drilldown ở comments các ô dữ liệu sẽ được Viewer sử dụng để chạy các lệnh drilldown ngay từ báo cáo.
✔️ Ví dụ
Trong ví dụ trên user double click vào ô A2 sẽ chạy lệnh pbs.bo.la.na
Định dạng kết quả báo cáo
Xem chi tiết tại : Report Output Format
Các nút lệnh
| Lệnh | Diễn giải |
|---|---|
| DataSource | Chọn nguồn dữ liệu |
| Template | Chọn Template 🔔 Gợi ý Khi thiết kế template Excel, nếu template chưa bao giờ được tạo ra, ta nên chạy test trước để chương trình tạo template mẫu có sẵn các bảng dữ liệu. |
| Test | Chạy thử. Chương trình sẽ hiển thị kết quả từng bước: các bảng dữ liệu nguồn, file sau khi render, file sau khi convert    |
Xem thêm
Updated on : 2023-07-16 20:44:49. by : . at X1-EXTREME.
Topic : Report Profile. pbs.bo.report.reportprofile