Trình thiết kế (canvas)

Tổng quan

Trình thiết kế là canvas kéo-thả nơi bạn xây dựng quy trình bằng cách thêm bước / nút (step/node) và nối chúng bằng các cạnh (edge). Mọi thay đổi được tự động lưu vào bản nháp — bạn sẽ thấy thông báo “Đã tự động lưu vào bản nháp” ở góc màn hình.

Trình thiết kế quy trình với canvas và bảng thuộc tính

Thêm bước

Mỗi quy trình mới đã có sẵn một bước Bắt đầu (Start) — bước này do trình thiết kế tự động tạo, không xuất hiện trong menu Thêm bước.

Để thêm các bước tiếp theo:

Nhấp nút + hoặc kéo từ handle của một nút hiện có ra vùng trống.
Chọn loại bước từ menu “Thêm bước”:

Loại bước (tên trong menu)	Mục đích
Công việc người dùng (Human Task)	Giao việc cho người hoặc nhóm — họ hoàn thành biểu mẫu, có thể kèm hành động phê duyệt và ký số
Trợ lý AI (Agent)	AI phân tích, soạn thảo hoặc ra quyết định tự động với đầu ra có cấu trúc
Gửi email (Send Email)	Gửi email tự động, có thể đính kèm tài liệu
Tạo tài liệu (Generate Document)	Xuất một hoặc nhiều Mẫu tài liệu thành PDF/DOCX từ dữ liệu các bước trước
Chữ ký (Signature)	Thu thập chữ ký trên tài liệu, từ người dùng nội bộ hoặc bên ngoài qua email
Gọi webhook (Call Webhook)	Gửi yêu cầu HTTP đến hệ thống bên ngoài và dùng kết quả trả về ở các bước sau
Quyết định (Decision)	Rẽ nhánh theo điều kiện — đi theo nhánh đầu tiên khớp với dữ liệu
Lặp theo phần tử (For Each)	Chạy một nhóm bước con một lần cho mỗi phần tử trong danh sách
Phân nhánh (Fork)	Tách luồng thành nhiều nhánh chạy song song
Hợp nhất (Join)	Chờ tất cả các nhánh song song hoàn thành rồi mới tiếp tục — luôn đi kèm với Fork
Đặt biến (Set Variable)	Gán giá trị vào biến quy trình
Bản ghi thực thể (Entity Record)	Tra cứu, tìm kiếm, tạo mới, cập nhật hoặc upsert Bản ghi trong Thực thể
Tích hợp (Connected App)	Đọc/ghi dữ liệu trực tiếp trong hệ thống bên ngoài (ví dụ: HubSpot)
Truy vấn SQL (SQL Query)	Chạy câu lệnh SQL (mặc định chỉ đọc, có thể bật chế độ ghi) và lưu kết quả vào biến quy trình
Gọi quy trình con (Call Workflow)	Chạy một quy trình đã xuất bản khác, truyền đầu vào và đọc lại đầu ra
Đánh số tự động (Auto Number)	Sinh số chạy theo phạm vi cấu hình và định dạng thành mã
Kết thúc (End)	Đánh dấu điểm hoàn thành của quy trình

Kết nối và nhãn cạnh

Kéo từ handle tròn ở cạnh nút nguồn sang nút đích để tạo cạnh. Nhấp đúp vào cạnh để đặt nhãn — nhãn xuất hiện trên đường nối và giúp người đọc hiểu điều kiện (ví dụ: “Đồng ý” / “Từ chối” cho bước Decision).

Ví dụ quy trình Đề xuất mua sắm:

Bắt đầu → Trợ lý AI review → Decision → Human approval → Tạo tài liệu → Chữ ký → Email → Tích hợp → Kết thúc

Cạnh từ nút Decision nên có nhãn tương ứng với từng nhánh, chẳng hạn “Phê duyệt” và “Từ chối”.

Bảng kiểm tra (lỗi và cảnh báo)

Khi canvas có vấn đề, một banner hiện ở thanh công cụ:

Lỗi chặn xuất bản — ví dụ: bước chưa cấu hình biểu mẫu, thiếu điều kiện ở Decision.
Cảnh báo không chặn xuất bản nhưng nên xem xét.

Nhấp vào banner để xem danh sách chi tiết. Mỗi mục chỉ rõ tên bước có vấn đề; nhấp vào mục để mở bảng cấu hình của bước đó.

Tự động lưu

Trình thiết kế tự động lưu sau mỗi thay đổi vào bản nháp hiện tại. Bạn vẫn có thể nhấp Lưu bản nháp để lưu ngay lập tức. Bản nháp và phiên bản đã xuất bản là độc lập — lưu bản nháp không ảnh hưởng đến các phiên chạy (instance) đang chạy.

Lịch sử phiên bản

Mỗi lần xuất bản, phiên bản trước đó không bị mất — trình thiết kế giữ lại mọi phiên bản đã xuất bản trước đó, đánh số tăng dần (v1, v2, …).

Nhấp nút Lịch sử trên thanh công cụ để mở bảng “Lịch sử phiên bản”, liệt kê mọi phiên bản đã xuất bản — mới nhất trước — kèm người xuất bản và ngày xuất bản. Phiên bản đang hiển thị trên canvas được đánh dấu hiện tại.

Với mỗi phiên bản trong danh sách, bạn có thể:

Xem — mở phiên bản đó ở chế độ chỉ đọc để xem lại toàn bộ cấu hình tại thời điểm xuất bản (canvas hiện huy hiệu “chỉ đọc” và nút Về bản nháp hiện tại thay cho nút Xuất bản). Không dùng được cho phiên bản đang hiện tại.
Khôi phục — chép nội dung của phiên bản đã chọn vào bản nháp đang làm việc, sau khi bạn xác nhận trong hộp thoại cảnh báo. Nút này bị vô hiệu hóa nếu quy trình chưa có bản nháp nào — hãy tạo bản nháp trước.

Sao chép tham chiếu bước

Mỗi bước có một mã tham chiếu duy nhất dạng nodes.{id} — dùng để trỏ đến đầu ra của bước đó ở các bước sau (ví dụ: nodes.approval.output.decision).

Để sao chép tham chiếu: nhấp chuột phải vào nút trên canvas → chọn “Sao chép tham chiếu của bước này (nodes.{id})”. Thông báo “Đã sao chép tham chiếu” xác nhận đã copy vào clipboard.

Biến quy trình

Biến quy trình (Workflow variables) là các giá trị dùng chung cho mọi bước trong cùng một phiên chạy. Nhấp Biến trên thanh công cụ để mở bảng “Biến quy trình”.

Trường	Ý nghĩa
Tên	Tên biến, dùng để tham chiếu qua `vars.tên_biến`
Kiểu	Văn bản, Số, Boolean, Ngày / giờ, Email, Đối tượng, Mảng
Mặc định	Giá trị ban đầu nếu chưa được gán
Cho phép ghi đè khi chạy	Người khởi chạy có thể thay giá trị lúc bắt đầu phiên

Xuất và nhập JSON

Thanh công cụ có hai nút:

Xuất JSON — tải về tệp JSON biểu diễn toàn bộ canvas (nút, cạnh, biến). Dùng để sao lưu hoặc chia sẻ thiết kế.
Nhập JSON — thay thế canvas hiện tại bằng nội dung từ tệp JSON. Một hộp thoại xác nhận hiện số nút / cạnh sẽ được nhập và danh sách biểu mẫu sẽ được tạo hoặc ghi đè.

Bước tiếp theo

Xuất bản quy trình — kiểm tra điều kiện và xuất bản phiên bản chính thức.
Biểu mẫu — tạo biểu mẫu để gắn vào bước Human task hoặc bước Bắt đầu.