Xây dựng một kịch bản

Trình biên tập

Khung vẽ nằm ở giữa, bảng thêm hộp và trình kiểm tra nằm xung quanh. Các chiếc hộp di chuyển được bằng chuột, khung nhìn có thể kéo và phóng to thu nhỏ.

Thêm một chiếc hộp

Từ bảng chọn, được sắp xếp theo nhóm: điều khiển, tổ hợp (yêu cầu và kết nối), danh sách, vòng lặp, thời gian, toán học, thuật toán, định dạng dữ liệu, mã hóa, giao diện, tiện ích.

Một hành động gắn với một yêu cầu (Yêu cầu HTTP, Yêu cầu SOAP, mọi hành động kết nối) sẽ yêu cầu bạn chỉ ra yêu cầu nào của dự án mà nó điều khiển.

Mối liên hệ kịch bản ↔ yêu cầu

Việc chỉ định một yêu cầu trong một hành động tạo ra một liên kết chặt: hành động tham chiếu tới yêu cầu bằng định danh của nó, chứ không phải bằng một bản sao. Từ đó suy ra:

• yêu cầu vẫn được dùng chung — sửa nó (URL, header, thân) sẽ thay đổi những gì mọi kịch bản dùng nó sẽ chạy, ở lần chạy kế tiếp của chúng;
• liên kết vẫn tồn tại sau khi bạn đổi tên hay di chuyển yêu cầu trong cây: nó không dựa vào tên, cũng không dựa vào đường dẫn;
• từ phía yêu cầu, smartbar có một nút “Được dùng trong kịch bản” — nó liệt kê các kịch bản gọi tới yêu cầu và cho phép nhảy sang đó. Đây là phản xạ cần có trước khi sửa một yêu cầu dùng chung;
• một yêu cầu bị thiếu (đã xóa, hoặc không có mặt khi mở dự án) sẽ làm việc kiểm tra hợp lệ của kịch bản thất bại: nút chạy vẫn bị khóa và chiếc hộp có lỗi được báo hiệu — không bao giờ có kịch bản hỏng trong im lặng.

Để chạy lại cùng một yêu cầu mà không đụng tới phiên bản đã lưu của nó, đừng sửa nó: hãy dùng các cơ chế ghi đè (cài đặt nhanh, ghi đè trên hành động, liên kết) được mô tả trong Ghi đè một yêu cầu.

Cấu hình một chiếc hộp

Mỗi chiếc hộp có các trường riêng, nhập trực tiếp trên hộp hoặc trong trình kiểm tra. Các trường chấp nhận giá trị có kiểu — chuỗi, số, luận lý, ngày, biểu thức Handlebars, biến, danh sách tùy chỉnh, bí mật… — xem Biến và môi trường.

Ctrl+Space kích hoạt tính năng tự động hoàn thành các biến và helper trong những trường có hỗ trợ.

Đấu dây

Hãy kéo từ một cổng ra tới một cổng vào.

Có hai quy tắc cần biết:

1. Một cổng vào chỉ chấp nhận một liên kết duy nhất — trừ cổng in, vốn chấp nhận bao nhiêu tùy ý và khi đó đóng vai trò một rào chắn.
2. Một đầu ra chỉ mang tín hiệu thuần túy thì không thể cấp cho một đầu vào chỉ nhận giá trị thuần túy. Mọi trường hợp còn lại đều được phép: một đầu ra mang theo giá trị cũng đóng vai trò bộ kích hoạt.

Chi tiết: Cổng và liên kết.

Bộ chọn của liên kết

Một liên kết có thể mang một bộ chọn: một đường dẫn áp lên giá trị đang di chuyển.

data.items[0].id
body['user-id']
status

Đây chính là thứ giúp bạn khỏi phải chèn một chiếc hộp biến đổi giữa mỗi lời gọi và bên tiêu thụ nó. Bộ chọn được đặt lúc tạo liên kết hoặc muộn hơn; xóa trống nó là gỡ bỏ nó.

Ghi đè một yêu cầu

Một hành động gắn với một yêu cầu có thể sửa đổi yêu cầu đó mà không đụng tới chính yêu cầu. Có bốn lớp, theo thứ tự này:

1. yêu cầu đúng như nó được lưu;
2. một cài đặt nhanh (quick config) được chỉ định trên hành động — đây là cách tái sử dụng một biến thể đã lưu của một yêu cầu ngay trong một kịch bản, mà không phải nhập lại;
3. các giá trị ghi đè nhập trên hành động;
4. giá trị đến qua một liên kết trên cổng ghi đè.

Đây là cách sạch sẽ để chạy lại cùng một lời gọi với ba bộ dữ liệu.

Chạy lại ở mỗi sự kiện

Menu ngữ cảnh của một chiếc hộp có mục “Chạy lại ở mỗi sự kiện nhận được”. Khi được bật, tùy chọn này biến mọi đầu vào đã đấu dây thành những cổng “hoặc” không chặn: chiếc hộp được kích hoạt lại ở mỗi giá trị nhận được trên bất kỳ cổng nào, thay vì chờ tất cả cùng có mặt.

Điều này là không thể thiếu khi xử lý một luồng (mỗi thông điệp MQTT, mỗi sự kiện SSE), và nó cũng là thứ tháo gỡ một chu trình hoàn tất.

Tham số và đầu ra

• Một chiếc hộp Input / Param khai báo các tham số của kịch bản. Chúng được cung cấp lúc khởi chạy, trên dòng lệnh (--param nom=valeur), hoặc được hỏi lúc chạy ở chế độ tương tác.
• Một chiếc hộp Output / Return phơi ra một kết quả cho bên gọi — hữu ích khi kịch bản được một kịch bản khác gọi qua hành động Chạy kịch bản.

Sắp xếp

Restorm biết cách tự động sắp xếp một đồ thị (dàn trang); sau đó các chiếc hộp vẫn di chuyển được bằng tay. Ctrl+Z hoàn tác, Ctrl+Shift+Z làm lại.

Kiểm tra hợp lệ

Nút chạy bị khóa chừng nào vẫn còn lỗi kiểm tra hợp lệ: liên kết không hợp lệ, yêu cầu bị thiếu, trường bắt buộc bỏ trống. Những chiếc hộp có lỗi đều được báo hiệu.