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.

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:

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

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 sơ đồ có vấn đề, một dải hiện ra ở cuối canvas, ngay dưới vùng vẽ. Nhấp vào dải để mở danh sách chi tiết: mỗi mục nêu rõ bước có vấn đề, và nhấp vào mục sẽ mở bảng cấu hình của bước đó. Trên canvas, các bước có vấn đề cũng hiện dòng Có vấn đề cần kiểm tra.

• 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, hay các nhánh song song nối sai vào Hợp nhất (Join). Khi còn lỗi, dải có màu đỏ với tiêu đề Không thể xuất bản; nút Xuất bản bị vô hiệu hóa, và di chuột lên nút sẽ thấy Sửa các lỗi kiểm tra trước khi xuất bản.
• Cảnh báo không chặn xuất bản nhưng nên xem lại. Khi chỉ còn cảnh báo, dải chuyển sang màu vàng với tiêu đề Cần xem lại, và nút Xuất bản vẫn bấm được.

Nút Quy tắc kiểm tra ở bên phải dải mở trang này.

Hai nguồn kiểm tra

Danh sách gộp kết quả của hai lượt kiểm tra khác nhau:

• Trình thiết kế tự kiểm tra ngay khi bạn vẽ — bước thiếu cấu hình, cạnh chưa nối, bước không tới được. Các mục này xuất hiện và biến mất ngay theo từng thao tác.
• Máy chủ kiểm tra bản nháp đã lưu, sau mỗi lần tự động lưu. Có những quy tắc chỉ máy chủ mới trả lời được, vì cần nhìn toàn bộ sơ đồ hoặc cần dữ liệu nằm ngoài sơ đồ:
  • hình dạng các nhánh song song quanh Phân nhánh (Fork) và Hợp nhất (Join) — thông báo Loop structure not supported;
  • một trường tệp trên biểu mẫu bắt đầu có nhận được thư mục theo dõi hay không — thông báo This field cannot come from a watched folder và các cảnh báo cùng loại;
  • quy tắc Người trong một đơn vị lấy đơn vị từ một trường không thể chứa đơn vị — thông báo Assignment;
  • biểu thức viết sai cú pháp.

Lỗi từ máy chủ cũng chặn nút Xuất bản như lỗi của trình thiết kế. Còn cảnh báo từ máy chủ thì chỉ hiện ở dải này — lúc bấm Xuất bản sẽ không có gì nhắc lại, nên hãy đọc chúng trong lúc còn đang thiết kế.

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.

Mỗi lần lưu cũng kích hoạt lượt kiểm tra của máy chủ trên bản vừa lưu — xem Hai nguồn kiểm tra.

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".

Cài đặt của quy trình

Nút Cài đặt trên thanh công cụ (gợi ý "Cấu hình quyền chạy, tự động hóa và MCP") mở popover Cấu hình quy trình gồm ba dòng, mỗi dòng hiển thị giá trị hiện tại bên phải:

Cả nút Cài đặt lẫn ba dòng bên trong chỉ hiện với người có quyền workflow.design.

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.