Quy trình
Quy trình là các luồng tự động hóa có thể tái sử dụng để xử lý lưu lượng đã ghi nhận, chạy các bước chủ động hoặc biến đổi dữ liệu - không yêu cầu bạn viết script độc lập.
Loại quy trình
| Loại | Được kích hoạt bởi | Cách dùng phổ biến |
|---|---|---|
| Thụ động | Lưu lượng mới được ghi nhận | Đánh dấu mẫu đáng chú ý, gắn thẻ yêu cầu, tự động tạo phát hiện. |
| Chủ động | Chạy thủ công | Gửi yêu cầu kiểm tra tiếp, nối chuỗi thao tác, thực hiện kiểm thử nhiều bước. |
| Chuyển đổi | Đầu vào kiểm thử, thao tác chuyển đổi hoặc Tìm và thay thế | Biến đổi văn bản hoặc byte, như định dạng JavaScript hoặc chuẩn hóa JSON. |
Quy trình thụ động chạy liên tục trong nền. Quy trình chủ động chạy theo yêu cầu trên nhóm yêu cầu được chọn.
Vùng thiết kế quy trình
Mở Quy trình và chọn quy trình để mở vùng thiết kế.
- Các nút xuất hiện trong bảng giữa. Mỗi nút có cổng đầu vào và đầu ra với kiểu dữ liệu xác định.
- Nối cổng đầu ra với cổng đầu vào bằng cách nhấp và kéo giữa chúng.
- Nhấp nút để mở bảng cấu hình bên phải.
- Thanh công cụ phía trên chứa điều khiển chạy, bật/tắt và nhập/xuất.
Loại nút
| Nút | Mô tả |
|---|---|
| Bắt đầu / Kết thúc | Nút vào và ra phù hợp với loại quy trình thụ động, chủ động hoặc chuyển đổi. |
| Điều kiện | Nếu / Ngược lại, Nếu / Ngược lại JS, So khớp HTTPQL, So khớp phạm vi, Chuỗi có chứa và So khớp biểu thức chính quy. |
| Mã hóa | Mã hóa/giải mã Base64, URL, Hex và HTML. |
| Định dạng và băm | Thu gọn JSON/Định dạng JSON, MD5, SHA-1 và SHA-256. |
| Thao tác văn bản | Xóa ký tự ở hai đầu, Nối, Tách, Tìm và thay thế, Biến đổi JQ và Trích xuất bằng Grep. |
| JavaScript | Logic tùy chỉnh dùng SDK quy trình; có thể đọc lưu lượng, thao tác trên tệp và tạo phát hiện. |
| Tích hợp | Ghi nhật ký, Webhook, Gọi quy trình, Gửi yêu cầu và Quy tắc tìm và thay thế. |
Dùng bảng chọn nút để xem cổng và cấu hình thực tế. Nhấp một kết nối để thao tác với liên kết đó thay vì xóa nút để nối lại đồ thị. Lưu bằng Lưu hoặc Ctrl+S (Command+S trên macOS).
Chia sẻ và phạm vi
Quy trình mặc định được dùng chung giữa các dự án trong cùng không gian làm việc. Bật Riêng cho dự án để giữ định nghĩa cùng dự án của nó. Định nghĩa dùng chung không có nghĩa là lưu lượng, kết quả hoặc ghi chú của mọi dự án trở thành dữ liệu dùng chung. Xuất/nhập JSON quy trình khi chuyển sang không gian làm việc hoặc bản cài đặt khác.
Kiểm thử trước khi dùng trên lưu lượng thực
Quy trình thụ động và chủ động có phần Kiểm thử HTTP với dữ liệu mẫu URL, Yêu cầu thô và Phản hồi thô. Bật quy trình, điền các trường và nhấp Kiểm thử quy trình. Kiểm thử lưu các chỉnh sửa trước khi thực thi. Giá trị mẫu được giữ theo từng quy trình khi bạn rời trang rồi quay lại.
Quy trình chuyển đổi thì có Đầu vào kiểm thử và đầu ra. Bắt đầu bằng đầu vào nhỏ mang tính đại diện, rồi kiểm thử tài nguyên có kích thước thực tế. Dữ liệu mẫu không khiến JavaScript tùy ý hoặc nút Gửi yêu cầu trở nên vô hại: mã quy trình vẫn có thể thực hiện thao tác đã cấu hình.
JavaScript và tệp
JavaScript trong quy trình hỗ trợ SDK Ogma và các lệnh nhập fs/path tương thích. Dùng sdk.fs.readFile, writeFile, appendFile, exists, readDir, mkdir và unlink cho thao tác tệp, cùng sdk.path cho đường dẫn phù hợp với nền tảng. Đây là các hàm hỗ trợ của Ogma, không phải toàn bộ thư viện chuẩn Node.js.
Với công cụ xuất tài nguyên, đọc response.getBody().toText(), chọn đích bằng sdk.path.join, tạo thư mục cha và kiểm tra sdk.fs.exists nếu không muốn ghi đè tệp hiện có. Kiểm tra đường dẫn hệ thống tệp trước khi thực thi: các hàm hỗ trợ hệ thống tệp của quy trình chạy trên máy chủ Ogma, khác với sdk.fs trong thư mục riêng của plugin. Xem SDK plugin để biết môi trường chạy riêng biệt đó.
Nhập quy trình
- Nhấp Nhập trên thanh công cụ Quy trình.
- Chọn tệp quy trình JSON.
- Quy trình mở trong vùng thiết kế. Xác minh cấu hình nút trước khi bật.
- Lưu quy trình.
Tệp JSON quy trình đã xuất có thể được chia sẻ giữa các bản cài đặt Ogma hoặc lưu trong hệ thống quản lý phiên bản.
Chạy quy trình trên lịch sử đã ghi nhận
Quy trình chủ động có thể chạy lại trên các yêu cầu đã ghi nhận trước đó.
- Mở quy trình.
- Nhấp Chạy trên lịch sử.
- Trong hộp thoại quét lịch sử, nhập bộ lọc HTTPQL không bắt buộc để giới hạn các yêu cầu quy trình xử lý.
- Nhấp Chạy.
Kiểm tra số lượng khớp và bắt đầu tác vụ. Tiến độ và lỗi xuất hiện trong tác vụ quét và, khi ghi nhật ký được bật, trong lịch sử chạy. Quy trình thụ động cung cấp Quét lịch sử và Chạy lại trên yêu cầu để xử lý dữ liệu đã ghi nhận.
Với một vài tài nguyên đáng chú ý, chọn một hoặc nhiều hàng Lịch sử HTTP, nhấp chuột phải, chọn Gửi đến Quy trình và chọn quy trình chủ động đã bật. Thao tác này đưa các mục được chọn vào quy trình mà không thay định nghĩa hoặc xử lý toàn bộ lịch sử.
Nút AI cạnh ô nhập bộ lọc quét lịch sử tạo biểu thức HTTPQL từ mô tả bằng ngôn ngữ tự nhiên.
Lượt chạy và kết quả quy trình
Bật Bật ghi nhật ký trong cấu hình quy trình khi cần chi tiết thực thi. Tùy chọn áp dụng cho quy trình thụ động, chủ động và chuyển đổi, gồm cả chuyển đổi Tìm và thay thế. Khi tắt, việc xử lý vẫn chạy nhưng không thêm nhật ký lượt chạy/bước; bật lại và lặp lại kiểm thử để chẩn đoán vấn đề.
- Nhấp lượt chạy để xem đầu ra bước của từng nút.
- Các nút gây lỗi được làm nổi bật.
- Phát hiện được tạo trong lượt chạy xuất hiện ở màn hình Phát hiện.
- Biến được trích xuất trong lượt chạy hiển thị trong bảng chi tiết bước.
Xóa tất cả xóa lịch sử chạy đã lưu của quy trình được chọn. Tải nhật ký trước khi xóa nếu cần giữ bằng chứng gỡ lỗi. Ghi nhật ký có thể lưu đầu ra lớn như toàn bộ nội dung script, nên để tắt khi chuyển đổi số lượng lớn trừ khi cần.
Bật quy trình thụ động
- Mở quy trình.
- Xác minh cấu hình vùng thiết kế hoàn chỉnh (không có cổng bắt buộc chưa được kết nối).
- Bật Bật trên thanh công cụ.
Quy trình thụ động đã bật tự động xử lý lưu lượng mới. Tắt quy trình để tạm dừng mà không xóa.