# Trường chung và cấu trúc quy trình

Tìm kiếm bằng `GET /node-types?q=keyword&page=1&pageSize=20`, sau đó truyền ID loại nút trả về cho `GET /node-types/{nodeType}`. Trang bắt đầu từ 1 và kích thước trang là 1–100 (mặc định 20). Một loại nút như `browser_gotoUrl` khác với ID nút trong quy trình như `visit`.

| Trường của hợp đồng | Cần kiểm tra |
|  --- | --- |
| `authorable`, `runtimeSupported`, `externalRunnable`, `documentationComplete` | Khả năng soạn thảo, hỗ trợ khi chạy, khả năng thực thi từ bên ngoài và mức độ đầy đủ của tài liệu. |
| `inputSchema` | Kiểu, enum, định dạng và cấu trúc. Phân giải `$ref` bằng URL schema của chính ứng dụng bạn đang gọi. |
| `conditionalRules`, `referenceRules` | Các trường bắt buộc hoặc bị cấm trong từng chế độ, giá trị sau khi phân giải và phạm vi tham chiếu được phép. |
| `defaults`, `outputVariants`, `fieldPolicies` | Giá trị mặc định khi thực thi, đầu ra theo từng chế độ và chính sách của trường. `x-editor-default` mô tả giá trị ban đầu trong trình chỉnh sửa. |


## Cấu trúc quy trình

Hãy đặt `editorVersion: 2` và `editorParametersVersion: 1`. Các `nodes` ở cấp gốc chạy theo thứ tự, với một `start` ở đầu và một `end` ở cuối. Nút lồng nhau dùng `blocks` do từng hợp đồng quy định. Giữ ID nút là duy nhất trong toàn bộ cây và không đổi qua các lần chỉnh sửa. Đặt cho mọi nút và nhánh một `data.title` mang tính mô tả. Một nhóm không thể chứa nhóm khác.

Một nút hành động dùng `type: browser_<action>`, `data.browserAction` tương ứng và các đầu vào trong `data.browserUi.inputs`. Đầu vào của hành động dùng chuỗi như `${targetUrl}` và `${visit.data.finalUrl}`. Đầu ra của nút kết thúc và toán hạng điều kiện có thể dùng `{"type":"ref","content":["visit","data","finalUrl"]}`, với một mảng các đoạn đường dẫn. Chỉ tham chiếu đến các biến trong phạm vi nhìn thấy được và các nút đứng trước. Khai báo biến tùy chỉnh trong `start.data.customVariables`, cập nhật chúng bằng `browser_updateCustomVariable` và đọc chúng dưới dạng `${custom.<id>}`. Sau khi lưu, hãy dùng cây đã chuẩn hóa do máy chủ trả về.

## Tham chiếu biến

Khi một trường hỗ trợ tham chiếu biến, hãy dùng `${…}` và thay dấu ba chấm bằng tên biến hoặc đường dẫn tham chiếu thực tế. Quy trình phân giải tham chiếu đó khi chạy và kiểm tra giá trị thu được theo các quy tắc của trường.

Ví dụ, `"selectorRadio": "${locatorType}"` đọc tham số ban đầu `locatorType`. Giá trị `"XPath"` sẽ chọn chế độ XPath. Giá trị sau khi phân giải phải là `"CSS"` hoặc `"XPath"`, vì vậy `"TEXT"` không vượt qua bước xác thực.

## Trường ví dụ và giới hạn

| Trường | Quy tắc |
|  --- | --- |
| `gotoUrl.url` | Chuỗi bắt buộc; hỗ trợ tham chiếu. Hãy dùng URL HTTP(S) tuyệt đối cho các mẫu cần chạy được ở nhiều nơi. Với các scheme khác, hãy kiểm tra trước trên ứng dụng của bạn và xem trình duyệt xử lý chúng như thế nào. |
| `gotoUrl.postWaitMs` | Số hoặc biểu thức số được hỗ trợ; sau khi phân giải, phạm vi được ghi trong tài liệu là 0–2147483647 mili giây. Mặc định là 1000; đặt 0 để không chờ. Hãy giữ giá trị trong phạm vi này. |
| `getUrl.type` / `key` | `href` (mặc định), `origin` hoặc `search`. Chế độ search yêu cầu một key được phân giải thành chuỗi không rỗng. Ở chế độ href, `data.value` là URL hiện tại đầy đủ. Hãy kiểm tra hợp đồng thực tế của ứng dụng để biết cách xử lý giá trị search bị thiếu. |
| `browserUi.exception.timeout` | Số nguyên, 0–2147483647 mili giây. Giá trị 0 tắt thời gian chờ của nút, nhưng ngân sách thời gian của lượt chạy vẫn được áp dụng. Mặc định là 30000 cho nút hành động và 0 cho nút điều khiển. Thời gian chờ được đặt tường minh trên một nút điều khiển áp dụng cho toàn bộ đồ thị con của nút đó. |
| `browserUi.exception.policy` | Đặt tường minh `interrupt`, `skip` hoặc `handle`. Nếu một nút thất bại bị bỏ qua, các tham chiếu đến dữ liệu của nút đó sẽ được phân giải thành null; hãy kiểm tra `hasNodeErrors` của lượt chạy. |
| `retryTimes` / `retryInterval` | Khi bật thử lại cho một hành động nguyên tử, số lần thử thêm là 1–10. Khoảng cách giữa các lần thử là 0–2147483 **giây**. Việc thử lại có thể lặp lại một hành động đã có hiệu lực. |


Một mẫu bắt buộc phải có `title` (1–100 ký tự sau khi loại bỏ khoảng trắng ở hai đầu), `description` (tối đa 1000 ký tự, có thể để trống), `workflow` và `dependencies` (dùng `[]` khi không có mẫu con). Hãy kiểm tra `capabilities.data.limits` để biết kích thước yêu cầu và quy trình, số lượng nút, độ sâu lồng nhau và số chỉnh sửa trên mỗi yêu cầu. Xem [Quy trình, biến và nút cấu trúc](/vi/browser-rpa/api/workflow) và [Mô hình dữ liệu](/vi/browser-rpa/api/data-types) để biết đầy đủ các mô hình.

Tiếp theo: [xác thực và lưu ví dụ](/vi/browser-rpa/quickstart).