TL;DR: Một record LarkBase có thể kích hoạt workflow lấy dữ liệu, kiểm tra field, điền vào template, tạo PDF rồi lưu link hoặc file trở lại Base. Trước khi gửi tự động cho khách hàng, cần có bước duyệt, khóa chống tạo trùng, phân quyền file và dữ liệu demo đã được ẩn danh.
Video demo: tạo PDF bằng một nút trong LarkBase
Video cho thấy trải nghiệm người dùng ở lớp ngoài: chọn record, nhấn nút và nhận kết quả PDF. Đây là demo luồng thao tác, không phải cam kết về thời gian xử lý, chi phí hoặc khả năng tương thích với mọi template.
Khi nào nên tự động tạo PDF?
Mô hình này phù hợp khi dữ liệu nguồn đã nằm trong LarkBase và đội vận hành đang lặp lại một quy trình như:
- tạo báo giá, phiếu đề xuất hoặc biên bản từ một record;
- điền lại tên khách hàng, mã đơn, ngày tháng và dòng hàng vào Word;
- xuất PDF, tải file lên rồi dán link về Base;
- gửi đúng tài liệu cho đúng người sau khi đã duyệt.
Nếu mẫu thay đổi liên tục hoặc người dùng cần tự thiết kế tài liệu mỗi ngày, một công cụ tạo tài liệu có giao diện trực tiếp có thể phù hợp hơn giải pháp tùy biến.
Kiến trúc đề xuất
LarkBase record
-> Nút thao tác hoặc trạng thái đã duyệt
-> Webhook / workflow automation
-> Kiểm tra và chuẩn hóa dữ liệu
-> Render template
-> Tạo PDF
-> Lưu file hoặc URL có kiểm soát
-> Cập nhật kết quả về LarkBase
-> Gửi email sau bước duyệt
Tách riêng dữ liệu và template giúp đội vận hành sửa record mà không phải chỉnh từng file. Template chịu trách nhiệm về logo, bố cục và kiểu chữ; workflow chịu trách nhiệm về mapping, kiểm tra dữ liệu và trạng thái xử lý.
Checklist dữ liệu trước khi render
| Nhóm | Ví dụ field | Cần kiểm tra |
|---|---|---|
| Định danh | Record ID, mã chứng từ | Dùng làm khóa chống tạo trùng |
| Người nhận | Tên, công ty, email | Đúng record và đúng mục đích sử dụng |
| Nội dung | Sản phẩm, số lượng, đơn giá | Không thiếu dòng hoặc map nhầm cột |
| Tiền tệ | Tạm tính, thuế, tổng tiền | Một quy tắc làm tròn thống nhất |
| Thời gian | Ngày lập, hạn hiệu lực | Chuẩn hóa múi giờ và định dạng |
| Trạng thái | Nháp, chờ duyệt, đã gửi | Chỉ gửi khi đủ điều kiện |
Không nên gửi toàn bộ record sang dịch vụ tạo PDF nếu template chỉ cần một phần dữ liệu. Payload tối thiểu dễ kiểm tra hơn và giảm phạm vi dữ liệu bị lộ khi có sự cố.
Xử lý tiếng Việt trong template
Một template dùng tại Việt Nam thường phải kiểm tra riêng:
- font có đầy đủ dấu tiếng Việt và được nhúng khi render;
- tiền tệ dùng quy tắc hiển thị nhất quán;
- ngày tháng không bị đổi do timezone của workflow;
- số thành chữ khớp số tiền và quy tắc nghiệp vụ;
- bảng dài có ngắt trang, lặp header và không cắt dòng quan trọng.
Đừng chỉ kiểm tra một bản “đẹp”. Nên test thêm trường hợp tên dài, ô trống, nhiều dòng hàng, số âm, số lớn và tài liệu nhiều trang.
Privacy gate: không dùng dữ liệu thật làm demo public
PDF có thể chứa tên người, email, số điện thoại, CCCD, địa chỉ, lương, công nợ hoặc giá trị giao dịch. Trước khi tạo link chia sẻ:
- dùng bộ dữ liệu giả, không chỉ đổi mỗi tên file;
- bỏ hoặc thay thế toàn bộ thông tin định danh;
- giới hạn quyền truy cập và thời hạn URL nếu tài liệu không cần public;
- không ghi token hoặc URL nội bộ vào nội dung PDF;
- kiểm tra cả metadata và text có thể copy từ file.
Các mẫu từng được dẫn trong phiên bản cũ của bài này đã được gỡ khỏi trang vì chứa trường dữ liệu không phù hợp để làm demo công khai. Chỉ nên mở lại thư viện mẫu sau khi có bộ tài liệu đã sanitize và được duyệt.
Trạng thái và xử lý lỗi nên có
Một workflow production nên để người dùng nhìn thấy trạng thái thay vì chỉ báo “đã chạy”:
Nháp -> Chờ duyệt -> Đang tạo -> Đã tạo PDF -> Đã gửi
\-> Lỗi cần xử lý
Các lỗi cần ghi rõ gồm field nào còn thiếu, template nào thất bại và lần retry nào đang chạy. Không đưa payload nhạy cảm hoặc secret vào thông báo lỗi trên Base.
Chống tạo trùng
Dùng record ID kết hợp phiên bản template hoặc mã chứng từ làm idempotency key. Trước khi retry, workflow phải kiểm tra record đã có file thành công hay chưa.
Duyệt trước khi gửi
Trong giai đoạn pilot, nên tạo PDF nháp để người phụ trách kiểm tra trước. Chỉ bật gửi email tự động sau khi mapping và quyền truy cập file đã được nghiệm thu.
Chọn plugin hay giải pháp tùy biến?
DocuGenius hiện được Lark App Directory mô tả là ứng dụng tích hợp với Base, có trình chỉnh template và hỗ trợ Word/Excel. Giải pháp này phù hợp khi đội ngũ muốn tự thiết kế tài liệu ngay trong một công cụ có sẵn. Giá và điều kiện sử dụng có thể thay đổi, vì vậy cần kiểm tra trực tiếp trên Lark App Directory hoặc nhận báo giá trước khi quyết định.
Giải pháp tùy biến phù hợp hơn khi template ổn định nhưng cần logic nghiệp vụ, tích hợp nhiều hệ thống, quy trình duyệt hoặc cách phân quyền riêng. Xem bảng quyết định DocuGenius và giải pháp tùy biến để chọn theo yêu cầu thay vì theo một con số giá cũ.
Checklist pilot
- Chọn một loại tài liệu có tần suất đủ cao.
- Chốt field nguồn và người chịu trách nhiệm duyệt.
- Dùng dữ liệu giả hoặc dữ liệu đã được phép xử lý.
- Test template với dữ liệu biên và tài liệu nhiều trang.
- Có khóa chống tạo trùng và trạng thái lỗi.
- Xác định file được lưu ở đâu, ai được xem và bao lâu.
- Chạy chế độ tạo nháp trước khi bật gửi tự động.
- Ghi lại thời gian xử lý thực tế để quyết định có mở rộng hay không.
Nếu cần khảo sát luồng LarkBase, template và kênh gửi trước khi làm pilot, xem dịch vụ tư vấn và triển khai automation của Diginno.
Bài viết hữu ích?
Chia sẻ để nhiều người biết đến!
>_ LLM-Friendly Copy
Copy as Markdown to use with ChatGPT, Claude, or other AI tools
