Start (Bắt đầu)
Nơi mọi lần chạy khởi đầu.
Mục đích
Đánh dấu điểm vào của flow. Runtime đặt node hiện tại là node Start và bắt đầu vòng lặp thực thi từ đó.
Mỗi flow có đúng một Start.
Khi nào dùng
Luôn luôn — nó được tạo cùng flow. Bạn không thêm hay gỡ nó.
Khi nào không dùng
Không có tình huống nào bạn xóa node Start. Flow không có nó thì không chạy được.
Điều kiện
Không. Start chạy không cần thiết bị và không nhận cấu hình.
Cách nó chạy
Runtime khởi tạo ngữ cảnh thực thi — mọi biến khai đặt null, rồi áp mặc định, rồi initial value, rồi kiểm kiểu — và đặt node hiện tại là id của node Start.
Start rồi rẽ Success ngay lập tức.
Nó tính là một node thực thi so với rào chắn maxNodeExecutions của flow.
Thiết lập
Start không có thiết lập. Object params của nó rỗng theo thiết kế.
Mọi thứ bạn tưởng cấu hình ở đây sống trong flow settings:
| Bạn muốn | Nó sống ở đâu |
|---|---|
| Timeout và threshold mặc định | Flow settings → Defaults |
Rào chắn (maxNodeExecutions, v.v.) | Flow settings → Runtime |
| Flow kỳ vọng instance nào | Flow settings → Target |
| Cổng tính năng OCR và input | Flow settings → Features |
| Khai báo biến và mặc định | Hộp thoại Variables |
| Giá trị cấp theo lần chạy | Flow Input Parameter |
Port
| Port | Đi vào khi | Bắt buộc |
|---|---|---|
| Success | Luôn, ngay lập tức | Có |
| Fatal | Lỗi hệ thống | Không — không bao giờ được đi |
Ví dụ cơ bản
Ví dụ thực tế — kiểm tra tiền đề
Thứ giá trị nhất đặt ngay sau Start là kiểm rằng bạn đang ở nơi mình nghĩ:
Flow giả định trạng thái khởi đầu của nó là nguồn thất bại khó lý giải phổ biến nhất. Một node phát hiện sau Start loại bỏ cả lớp vấn đề đ ó.
Ví dụ nâng cao — gieo trạng thái lần chạy
Nơi flow cần bộ đếm hay cờ khởi tạo ngoài mặc định khai, làm một lần ngay sau Start:
Ưu tiên mặc định khai nơi có thể — chúng được áp tự động lúc khởi động và không nhánh nào bỏ qua được.
Best practices
- Đặt kiểm tra tiền đề ngay sau Start. Xác minh trạng thái màn trước khi hành động.
- Dùng mặc định khai thay vì node Variable cho giá trị khởi đầu, để một nhánh không vượt qua được chúng.
- Giữ Start nối đúng một node. Nhiều edge từ Start làm đường vào khó đọc.
- Đừng coi Start là node cấu hình — nó không có cấu hình.
Ghi chú hiệu năng
- Start không tốn gì lúc chạy.
- Nó tiêu một lần thực thi so với
maxNodeExecutions, chỉ đáng kể với flow gần trần. - Mọi chi phí khởi động thật — kiểm schema, chuẩn hóa, kiểm đồ thị, kiểm biểu thức, kiểm asset, biên dịch, tạo session — diễn ra trong preflight trước khi Start chạy.
Ghi chú bộ nhớ
- Ngữ cảnh thực thi (biến,
nodeResults,lastResult) được tạo trước khi Start chạy. Mỗi session có riêng. - Start tự nó không cấp phát gì.
Lỗi thường gặp
| Lỗi | Hậu quả | Cách sửa |
|---|---|---|
| Giả định màn khởi đầu | Flow hành động trên màn sai | Thêm kiểm tra tiền đề |
| Tìm thiết lập trên Start | Không có | Dùng flow settings |
| Nhiều edge ra khỏi Start | Đường vào rối | Nối một |
| Khởi tạo biến trong nhánh | Bị bỏ nếu nhánh không được đi | Dùng mặc định khai |
Khắc phục sự cố
Lần chạy không khởi động chút nào.
Preflight trượt trước Start — schema, kiểm đồ thị, biểu thức, asset, cổng tính năng, hay session instance. Lỗi được runtime.start báo, và không sự kiện runtime.started nào phát.
Lần chạy khởi động nhưng lập tức làm sai. Màn khởi đầu không như flow giả định. Thêm kiểm tra tiền đề.
Lần chạy từ chối với TYPE_MISMATCH.
Một mặc định hay initial value của biến khai vi phạm kiểu. Sửa khai báo.
FAQ
Flow có nhiều Start được không? Không — đúng một điểm vào.
Xóa node Start được không? Không. Flow không có nó không chạy được.
Start tính vào maxNodeExecutions?
Có. Stop cũng vậy.
Đặt timeout của flow ở đâu? Flow settings → Defaults, không phải trên Start.
Node liên quan
- Stop — đối trọng kết thúc
- Return — kết thúc flow từ bất kỳ đâu
- Sub Flow — flow được gọi có Start riêng
Trang liên quan
- Mô hình thực thi — trình tự khởi động và vòng lặp
- Giải phẫu Flow — settings thật sự sống ở đâu