Giao diện
@digiforce-nc/plugin-workflow-cc
Plugin đăng ký node CC (carbon copy) trong workflow, mở rộng plugin-workflow. Gửi thông báo cho những người liên quan mà không yêu cầu hành động phản hồi, workflow tiếp tục ngay sau khi gửi.
Plugin này làm gì?
Node CC gửi thông báo đến một hoặc nhiều người dùng để họ nắm thông tin. Khác với node Manual hay Approval, CC không chờ phản hồi - workflow tiếp tục ngay lập tức sau khi gửi thông báo thành công.
CC node xây dựng trên nền Manual node nhưng bỏ qua phần chờ phản hồi. Người nhận thấy thông báo trong danh sách todo với trạng thái "đã CC" và có thể mở xem chi tiết bản ghi liên quan.
Cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
recipients | array | Danh sách user/role nhận thông báo |
title | string | Tiêu đề thông báo |
content | string | Nội dung thông báo (hỗ trợ template với biến workflow) |
showDetail | boolean | Cho phép người nhận xem chi tiết bản ghi |
detailBlocks | array | Cấu hình UI block hiển thị chi tiết |
Input / Output
| Hướng | Dữ liệu | Mô tả |
|---|---|---|
| Input | data | Dữ liệu bản ghi hiện tại từ workflow context |
| Input | recipients | Danh sách người nhận (có thể lấy từ biến) |
| Output | notified | Số lượng người đã gửi thông báo thành công |
| Output | status | Trạng thái: sent / partial / failed |
Tính năng chính
| # | Tính năng | Chi tiết |
|---|---|---|
| 1 | Thông báo không chặn | Gửi xong tiếp tục workflow, không chờ phản hồi |
| 2 | Nhiều người nhận | Gửi cho user cụ thể hoặc cả role |
| 3 | Template nội dung | Nội dung sử dụng biến từ workflow context |
| 4 | Xem chi tiết | Người nhận có thể mở xem dữ liệu bản ghi liên quan |
| 5 | Liên kết nhanh | Đính kèm link trực tiếp đến bản ghi |
Trường hợp sử dụng
| # | Kịch bản | Mô tả |
|---|---|---|
| 1 | Thông báo đơn hàng mới | CC cho kho và kế toán khi đơn hàng được tạo |
| 2 | Cập nhật tiến độ | Thông báo cho PM khi task chuyển trạng thái |
| 3 | CC sau phê duyệt | Gửi thông báo cho HR sau khi đơn nghỉ phép được duyệt |
| 4 | Thông báo lỗi | CC cho team DevOps khi workflow phát hiện lỗi hệ thống |
| 5 | Audit trail | CC cho compliance team về mỗi giao dịch quan trọng |
So sánh CC với các node liên quan
| Đặc điểm | CC | Manual | Approval | Notification |
|---|---|---|---|---|
| Chờ phản hồi | Không | Có | Có | Không |
| Hiển thị bản ghi | Có | Có | Có | Không |
| Todo list | Có (read-only) | Có | Có | Không |
| Kênh gửi | In-app | In-app | In-app | Đa kênh |
Lưu ý quan trọng
- CC node không tạo "todo" yêu cầu hành động - chỉ tạo notification
- Người nhận không thể approve/reject - chỉ xem thông tin
- Kết hợp với Approval node: CC gửi cho người liên quan, Approval gửi cho người phê duyệt
- Nếu tất cả recipients không tồn tại, node vẫn pass (không lỗi)
- Template nội dung hỗ trợ HTML cơ bản để format thông báo
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/plugin-workflow | Workflow engine (peer) |
@digiforce-nc/plugin-workflow-manual | Manual node base (peer) |
@digiforce-nc/server | Server framework (peer) |
@digiforce-nc/client | Client framework (peer) |