# Mô hình dữ liệu

> Các trường khớp với [Schema HTTP](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c). Đầu vào động của nút dùng [Schema quy trình](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) và [ngữ nghĩa quy trình](/vi/browser-rpa/api/workflow).


Trong các bảng, "Bắt buộc" nghĩa là trường đó bắt buộc khi đối tượng chứa nó có mặt. Tùy chọn không có nghĩa là có thể null. Các trường không xác định bị từ chối, trừ trong đối tượng JSON hoặc map cho phép tường minh khóa tùy ý.

## JsonValue

Giá trị JSON có thể là null, boolean, số hữu hạn, chuỗi, mảng hoặc đối tượng. JsonObject phải là một đối tượng, và các giá trị của nó phải là JSON hợp lệ, xét theo cách đệ quy. Không chấp nhận các giá trị undefined/NaN/Infinity.

## JsonObject

Giá trị JSON có thể là null, boolean, số hữu hạn, chuỗi, mảng hoặc đối tượng. JsonObject phải là một đối tượng, và các giá trị của nó phải là JSON hợp lệ, xét theo cách đệ quy. Không chấp nhận các giá trị undefined/NaN/Infinity.

## Workflow

Để biết chi tiết, xem [Cấu trúc và ngữ nghĩa quy trình](/vi/browser-rpa/api/workflow) và [schema cấu trúc](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c). Schema chỉ kiểm tra cấu trúc. Schema không thay thế các bước kiểm tra ngữ nghĩa, quyền và điều kiện chạy trên máy chủ.

## Metadata

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `requestId` | string | Có | ID truy vết của yêu cầu HTTP này. Đây là meta của phản hồi, không phải meta hiển thị của nút. Định dạng "uuid". |
| `catalogRevision` | string | Có | Bản sửa đổi nội dung của các hợp đồng nút. Định dạng: sha256: theo sau là 64 chữ số thập lục phân. |
| `replayed` | boolean | Không | Khi là true, kết quả của ý định ban đầu được trả về. Yêu cầu này vẫn có requestId khác. |


## Issue

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `code` | string | Có | Mã ổn định, dạng máy đọc được. Chương trình ra quyết định dựa trên mã này. |
| `message` | string | Có | Mô tả dành cho người đọc. Không dựa logic chương trình vào văn bản này. |
| `severity` | `error` / `warning` | Có | Lỗi (error) khiến bước kiểm tra không vượt qua. Cảnh báo (warning) cần được giải thích. |
| `path` | string | Có | JSON Pointer tương đối so với gốc của phần thân yêu cầu hiện tại. Khác với TemplateNodes.items[].path. |
| `nodeId` | string | Không | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `field` | string | Không | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `expected` | string | Không | Kiểu hoặc ràng buộc mong đợi. |
| `suggestion` | string | Không | Cách sửa được đề xuất. |


## NotCommittedDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `safeToRetrySameKey` | `true` | Có | Chỉ trả về true trong tài khoản/nhóm ban đầu, sau khi quá trình khôi phục đã hoàn tất và đã xác nhận rằng chưa có gì được commit. |


## VersionConflictDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `templateId` | string | Có | ID của mẫu được kiểm tra lần này và bạn hiện có quyền truy cập. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `expectedVersion` | integer | Có | Phiên bản được chỉ định trong yêu cầu (với lỗi 412, là phiên bản trong If-Match). Tối thiểu 1. |
| `currentVersion` | integer | Có | Phiên bản hiện tại ghi nhận được tại thời điểm kiểm tra. Đây không phải là giá trị khóa phiên bản để dùng trực tiếp cho lần ghi tiếp theo. Hãy GET lại mẫu. Tối thiểu 1. |


## WorkflowErrorDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `workflowPath` | string | Không | Vị trí của vấn đề đầu tiên trong TemplateWrite hoàn chỉnh cuối cùng. Đây không phải là đường dẫn trong phần thân yêu cầu node-edits hiện tại. |


## NodePageLimitDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `limit` | `"nodePageBytes"` | Có | Xem định nghĩa mô hình. |
| `maxBytes` | integer | Có | Xem định nghĩa mô hình. Tối thiểu 1. |


## CatalogChangedDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `expectedCatalogRevision` | string | Có | Xem định nghĩa mô hình. |
| `currentCatalogRevision` | string | Có | Xem định nghĩa mô hình. |


## ReceiptExpiredDetails

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `resourceId` | string hoặc null | Có | ID tài nguyên ban đầu được ghi trong bản ghi tombstone. Là null khi không thể giữ lại ID. |
| `originalStatus` | integer hoặc null | Có | Trạng thái HTTP ban đầu đã biết. Là null khi không có giá trị xác định. |


## Error

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `code` | string | Có | Mã ổn định, dạng máy đọc được. Chương trình ra quyết định dựa trên mã này. |
| `message` | string | Có | Mô tả dành cho người đọc. Không dựa logic chương trình vào văn bản này. |
| `retryable` | boolean | Có | Cho biết có thể khôi phục với ý định ban đầu hay không. Không có nghĩa là bạn có thể chuyển sang khóa khác và chạy lại các hành động trên trang web. |
| `issues` | array<[Issue](/vi/browser-rpa/api/data-types#issue)> | Có | Danh sách các vấn đề có cấu trúc. Là [] khi không có vấn đề nào. |
| `details` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) hoặc null | Có | Thông tin bổ sung về lỗi, hoặc null. Không chứa dữ liệu riêng tư. |


Với các mã đã biết, details bị ràng buộc bởi các điều kiện allOf và không thể là một đối tượng tùy ý: RPA_REQUEST_NOT_COMMITTED → NotCommittedDetails (bắt buộc); RPA_TEMPLATE_VERSION_CONFLICT → VersionConflictDetails (bắt buộc); RPA_VERSION_CONFLICT → VersionConflictDetails hoặc null; RPA_VALIDATION_FAILED → WorkflowErrorDetails hoặc null; RPA_CATALOG_CHANGED → CatalogChangedDetails hoặc null; RPA_REQUEST_EXPIRED → ReceiptExpiredDetails (bắt buộc). Ví dụ đầy đủ và ma trận khôi phục có tại [Chi tiết lỗi và ma trận khôi phục](/vi/browser-rpa/api/recovery).

## ErrorResponse

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `error` | [Error](/vi/browser-rpa/api/data-types#error) | Có | Đối tượng lỗi có cấu trúc, bắt buộc. Không thể là null. |
| `meta` | [Metadata](/vi/browser-rpa/api/data-types#metadata) | Có | Xem định nghĩa mô hình. |


## DependencyPin

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `processId` | string | Có | ID của mẫu con cục bộ được tham chiếu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |


## TemplateWrite

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `title` | string | Có | Tên hiển thị. Khi ghi mẫu, dài 1–100 ký tự sau khi loại bỏ khoảng trắng ở hai đầu. Độ dài tối thiểu 1; độ dài tối đa 100. |
| `description` | string | Có | Văn bản mô tả. Bắt buộc khi ghi mẫu. Dùng chuỗi rỗng để xóa mô tả. Độ dài tối đa 1000. |
| `workflow` | [Workflow](/vi/browser-rpa/api/data-types#workflow) | Có | Đối tượng quy trình ở định dạng gốc của trình chỉnh sửa. Quy trình chạy theo thứ tự của nodes/blocks. |
| `dependencies` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Có | Danh sách phụ thuộc mẫu con. Danh sách phải khớp một-một với các mẫu con mà applySubProcess tham chiếu trong quy trình. revisionId là revisionId hiện tại của mẫu con (`remote:<childTemplateId>@<version>`). Nếu không có phụ thuộc, gửi []. Khi chạy, giống như trong ứng dụng, mỗi lượt chạy lấy một bản chụp nhanh cố định của các mẫu con mới nhất tại thời điểm đó. Tối đa 1000 phần tử. |


## TemplateSummary

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `title` | string | Có | Tên hiển thị. Khi ghi mẫu, dài 1–100 ký tự sau khi loại bỏ khoảng trắng ở hai đầu. |
| `description` | string | Có | Văn bản mô tả. Bắt buộc khi ghi mẫu. Dùng chuỗi rỗng để xóa mô tả. |
| `version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `updatedAt` | integer | Có | Thời điểm cập nhật gần nhất, tính bằng mili giây Unix. Tối thiểu 0. |


## Template

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `title` | string | Có | Tên hiển thị. Khi ghi mẫu, dài 1–100 ký tự sau khi loại bỏ khoảng trắng ở hai đầu. |
| `description` | string | Có | Văn bản mô tả. Bắt buộc khi ghi mẫu. Dùng chuỗi rỗng để xóa mô tả. |
| `workflow` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Có | Đối tượng quy trình ở định dạng gốc của trình chỉnh sửa. Quy trình chạy theo thứ tự của nodes/blocks. |
| `dependencies` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Có | Danh sách phụ thuộc mẫu con. Danh sách phải khớp một-một với các mẫu con mà applySubProcess tham chiếu trong quy trình. revisionId là revisionId hiện tại của mẫu con (`remote:<childTemplateId>@<version>`). Nếu không có phụ thuộc, gửi []. Khi chạy, giống như trong ứng dụng, mỗi lượt chạy lấy một bản chụp nhanh cố định của các mẫu con mới nhất tại thời điểm đó. Tối đa 1000 phần tử. |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `updatedAt` | integer | Có | Thời điểm cập nhật gần nhất, tính bằng mili giây Unix. Tối thiểu 0. |
| `warnings` | array<[Issue](/vi/browser-rpa/api/data-types#issue)> | Có | Các vấn đề và hạn chế không cản trở việc lưu. Hãy đánh giá tác động của từng mục. |
| `redactedPaths` | array<string> | Có | Trường tương thích. Luôn là mảng rỗng trong phiên bản hiện tại. Local API không che nội dung mẫu. |


## NodeEdit

**Tùy chọn 1**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"insert"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `parentId` | string hoặc null | Có | ID của vùng chứa cha đích; null nghĩa là cấp gốc. |
| `beforeNodeId` | string hoặc null | Có | Nút được chèn hoặc di chuyển tới trước nút anh em này. Giá trị null sẽ thêm nút vào cuối vùng chứa. |
| `node` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Có | Đối tượng nút hoàn chỉnh, bao gồm mọi khối cần giữ lại. |


**Tùy chọn 2**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"replace"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `nodeId` | string | Có | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `node` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Có | Đối tượng nút hoàn chỉnh, bao gồm mọi khối cần giữ lại. |


**Tùy chọn 3**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"move"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `nodeId` | string | Có | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `parentId` | string hoặc null | Có | ID của vùng chứa cha đích; null nghĩa là cấp gốc. |
| `beforeNodeId` | string hoặc null | Có | Nút được chèn hoặc di chuyển tới trước nút anh em này. Giá trị null sẽ thêm nút vào cuối vùng chứa. |


**Tùy chọn 4**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"remove"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `nodeId` | string | Có | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |


## NodeEdits

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `operations` | array<[NodeEdit](/vi/browser-rpa/api/data-types#nodeedit)> | Có | Các thao tác chỉnh sửa nút nguyên tử, được áp dụng theo thứ tự. Toàn bộ lô chỉ tạo một phiên bản mẫu. Tối thiểu 1 phần tử; tối đa 100 phần tử. |
| `variables` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Không | Khai báo biến hoàn chỉnh. Nếu bỏ qua trường này trong một lần chỉnh sửa nút, các biến hiện có được giữ nguyên. |
| `dependencies` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Không | Danh sách phụ thuộc mẫu con. Danh sách phải khớp một-một với các mẫu con mà applySubProcess tham chiếu trong quy trình. revisionId là revisionId hiện tại của mẫu con (`remote:<childTemplateId>@<version>`). Nếu không có phụ thuộc, gửi []. Khi chạy, giống như trong ứng dụng, mỗi lượt chạy lấy một bản chụp nhanh cố định của các mẫu con mới nhất tại thời điểm đó. |


## TemplateNodes

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<object> | Có | Mảng các mục trên trang hiện tại hoặc trong tài nguyên hiện tại. |
| `templateVersion` | integer | Có | Phiên bản mẫu tại thời điểm truy vấn cây nút này. Tối thiểu 1. |


**Các trường của `items[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items[].id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `items[].parentId` | string hoặc null | Có | ID của vùng chứa cha đích; null nghĩa là cấp gốc. |
| `items[].path` | string | Có | JSON Pointer tương đối so với gốc quy trình, chẳng hạn /nodes/1. Đây không phải là issue.path của phần thân yêu cầu. |
| `items[].node` | [Cấu trúc quy trình](/vi/browser-rpa/api/workflow) / [JSON Schema](/vi/browser-rpa/local-api#h%E1%BB%A3p-%C4%91%E1%BB%93ng-c%E1%BB%A5c-b%E1%BB%99-d%E1%BA%A1ng-m%C3%A1y-%C4%91%E1%BB%8Dc-%C4%91%C6%B0%E1%BB%A3c) | Có | Đối tượng nút hoàn chỉnh, bao gồm mọi khối cần giữ lại. |


## ParameterValues

Ánh xạ từ tên của bất kỳ tham số đã khai báo nào sang `{kind:"json",value:JsonValue}`. Dùng `{}` khi không có tham số. Tham số có cùng dạng như trong lượt chạy trên ứng dụng:

| Loại tham số | value | Mô tả |
|  --- | --- | --- |
| string/number/boolean/array/object thông thường | Giá trị JSON tương ứng | Kiểu, phạm vi và độ dài được kiểm tra theo khai báo [biến ban đầu](/vi/browser-rpa/api/workflow#2-bi%E1%BA%BFn-ban-%C4%91%E1%BA%A7u-s%C3%A1u-ki%E1%BB%83u-tr%C6%B0%E1%BB%9Dng). |
| Chuỗi riêng tư (extra.private=true) | Chuỗi văn bản thuần | Máy chủ lưu giá trị vào kho lưu trữ an toàn cục bộ rồi chạy quy trình. Bản ghi lượt chạy chỉ giữ tham chiếu cho tham số này (đầu ra của nút và đầu ra của lượt chạy suy ra từ tham số này không bị che). Nếu bỏ qua tham số, giá trị mặc định của mẫu sẽ được dùng. `"******"` cũng có nghĩa là dùng giá trị mặc định của mẫu. |
| Tệp (extra.type=file) | Chuỗi đường dẫn cục bộ tuyệt đối (một tệp) hoặc mảng chuỗi (nhiều tệp) | Máy chủ tham chiếu trực tiếp đến tệp tại đường dẫn đó và không sao chép tệp. Đường dẫn phải tồn tại, phải là tệp thông thường đọc được, và phải đáp ứng giới hạn về phần mở rộng, số lượng và kích thước. Nếu không, kết quả là RPA_INVALID_PARAMETERS tại vị trí `/parameters/<name>`. Tệp được kiểm tra lại trước mỗi lần thực thi. Nếu khi đó tệp không còn tồn tại hoặc không dùng được, lượt chạy đó thất bại và error.details.issues chỉ ra tham số tương ứng. |
| Chuỗi cho phép đường dẫn cục bộ (extra.localPath=true) | Chuỗi đường dẫn cục bộ | Giống như chuỗi thông thường. |


Bước kiểm tra trước với `purpose=run` chỉ thực hiện cùng các bước kiểm tra và không ghi vào kho lưu trữ an toàn.

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `kind` | `"json"` | Có | Trường phân biệt: inline/template cho source, hoặc json cho tham số lượt chạy. |
| `value` | [JsonValue](/vi/browser-rpa/api/data-types#jsonvalue) | Có | Giá trị JSON thực tế. Kiểu của giá trị phải thỏa mãn biến hoặc điều kiện tương ứng. |


## ValidationSource

**Tùy chọn 1**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `kind` | `"inline"` | Có | Trường phân biệt: inline/template cho source, hoặc json cho tham số lượt chạy. |
| `template` | [TemplateWrite](/vi/browser-rpa/api/data-types#templatewrite) | Có | Toàn bộ phần thân của mẫu đề xuất, hoặc bản tóm tắt mẫu được cố định cho lượt chạy. Đọc trường này theo mô hình chứa nó. |
| `base` | object | Không | Với xác thực inline, đây là phiên bản của mẫu hiện có và căn cứ để giữ lại giá trị mặc định riêng tư. Trường này không được lưu. |


**Các trường của `base`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `base.templateId` | string | Có | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128. |
| `base.version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |


**Tùy chọn 2**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `kind` | `"template"` | Có | Trường phân biệt: inline/template cho source, hoặc json cho tham số lượt chạy. |
| `templateId` | string | Có | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128. |
| `version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |


## ValidationRequest

**Tùy chọn 1**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `purpose` | `"save"` | Có | Với save, chỉ kiểm tra các điều kiện để lưu. Với run, còn kiểm tra thêm tham số, môi trường và giới hạn của lượt chạy. |
| `source` | [ValidationSource](/vi/browser-rpa/api/data-types#validationsource) | Có | Chọn một mẫu đề xuất hoặc một mẫu đã lưu. Dùng đúng một tùy chọn. |


**Tùy chọn 2**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `purpose` | `"run"` | Có | Với save, chỉ kiểm tra các điều kiện để lưu. Với run, còn kiểm tra thêm tham số, môi trường và giới hạn của lượt chạy. |
| `source` | [ValidationSource](/vi/browser-rpa/api/data-types#validationsource) | Có | Chọn một mẫu đề xuất hoặc một mẫu đã lưu. Dùng đúng một tùy chọn. |
| `environmentId` | string | Có | ID của một môi trường thực tế. Lấy ID từ truy vấn môi trường. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `parameters` | [ParameterValues](/vi/browser-rpa/api/data-types#parametervalues) | Có | Ánh xạ từ tên tham số sang {kind:json,value:JSON} (văn bản thuần cho tham số riêng tư, đường dẫn cục bộ tuyệt đối cho tham số tệp; xem ParameterValues). Dùng {} khi không có tham số. |


## ValidationReport

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `valid` | boolean | Có | Là true khi không có lỗi tĩnh. Không có nghĩa là lượt chạy thực tế sẽ thành công. |
| `issues` | array<[Issue](/vi/browser-rpa/api/data-types#issue)> | Có | Danh sách các vấn đề có cấu trúc. Là [] khi không có vấn đề nào. |
| `truncated` | boolean | Có | Là true khi đã chạm giới hạn số vấn đề. Hãy xác thực lại sau khi sửa các vấn đề. |
| `runtimeChecks` | array<object> | Có | Các mục vẫn cần xác nhận khi chạy. Mảng rỗng không chứng minh rằng trang web thật dùng được, và cũng không giải thích vì sao không có mục nào. |
| `effectiveInputs` | object | Có | Bản tóm tắt chẩn đoán tùy chọn, có khóa là nodeId. defaultsApplied chỉ chứa các giá trị mặc định an toàn được bổ sung trong lần xác thực này, còn unresolvedFields liệt kê các trường đầu vào chưa được phân giải. Các mục có thể bị bỏ qua, hoặc có thể trả về {}, nên việc thiếu một mục không cho biết quá trình chuẩn hóa có diễn ra hay không. |
| `workflowHash` | string | Có | Định danh nội dung dùng cho chẩn đoán. Không đảm bảo giữ ổn định giữa nguồn inline/đã lưu, giữa các danh mục hoặc giữa các bước chuẩn hóa, và không chứng minh rằng quy trình đã được lưu. Xem các quy tắc bổ sung trong common.md. |
| `catalogRevision` | string | Có | Bản sửa đổi nội dung của các hợp đồng nút. Định dạng: sha256: theo sau là 64 chữ số thập lục phân. |
| `dependencyRevisions` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Có | Các bản sửa đổi phụ thuộc chính xác được dùng để cố định hoặc xác thực. |


**Các trường của `runtimeChecks[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `runtimeChecks[].nodeId` | string | Có | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `runtimeChecks[].field` | string | Có | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `runtimeChecks[].code` | string | Có | Giá trị chung hiện tại là RPA_RUNTIME_CHECK_REQUIRED. Một mã chưa biết được bổ sung trong tương lai vẫn có nghĩa là đang chờ xác nhận khi chạy. Xem common.md. |
| `runtimeChecks[].reason` | string | Có | Lý do không khả dụng, lý do cách ly hoặc lý do cần kiểm tra khi chạy. |


## Capabilities

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `apiVersion` | `"v1"` | Có | Phiên bản chính của HTTP API. |
| `schemaVersion` | string | Có | Phiên bản của hợp đồng soạn thảo (semver). |
| `catalogRevision` | string | Có | Bản sửa đổi nội dung của các hợp đồng nút. Định dạng: sha256: theo sau là 64 chữ số thập lục phân. |
| `editorVersions` | array<integer> | Có | Danh sách các phiên bản trình chỉnh sửa hiện được chấp nhận. |
| `parameterVersions` | array<`1`> | Có | Danh sách các phiên bản tham số hiện có thể ghi qua API công khai. |
| `operations` | array<string> | Có | Mảng các operationId đã được đăng ký trên instance này và được cấp quyền cho ứng dụng hiện tại. |
| `runtimeProfile` | `"v1"` | Có | Chính sách thực thi từ bên ngoài: giống như lượt chạy trong ứng dụng, không có hạn chế bổ sung nào về nút, trường hoặc tham số. |
| `limits` | object | Có | Giới hạn đang có hiệu lực. Hãy dùng các giá trị trong phản hồi. |
| `docs` | object | Có | URL tương đối của tài liệu tương ứng với khả năng hiện tại. |


**Các trường của `limits`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `limits.requestBytes` | integer | Có | Kích thước tối đa của phần thân HTTP, tính bằng byte. Tối thiểu 1. |
| `limits.workflowBytes` | integer | Có | Kích thước tối đa của quy trình khi được tuần tự hóa dạng gọn, tính bằng byte. Tối thiểu 1. |
| `limits.maxNodes` | integer | Có | Số nút tối đa trên mỗi mẫu, bao gồm cả vùng chứa. Tối thiểu 1. |
| `limits.maxDepth` | integer | Có | Độ sâu lồng nhau tối đa. Tối thiểu 1. |
| `limits.maxEdits` | integer | Có | Số thao tác tối đa trong một lần chỉnh sửa nút. Tối thiểu 1. |
| `limits.maxIssues` | integer | Có | Số vấn đề tối đa được trả về trong một lần. Tối thiểu 1. |
| `limits.requestsPerMinute` | integer | Có | Số yêu cầu tối đa mỗi phút cho ứng dụng đang đăng nhập. Tối thiểu 1. |
| `limits.maxInFlightWrites` | integer | Có | Số thao tác ghi đang xử lý đồng thời tối đa cho ứng dụng đang đăng nhập. Tối thiểu 1. |
| `limits.nodeDataBytes` | integer | Có | Kích thước tối đa của một giá trị data trong bản ghi thực thi nút, tính bằng byte của JSON UTF-8 dạng gọn. Mặc định 65536. Giá trị vượt giới hạn sẽ bị lược bỏ toàn bộ. Tối thiểu 1. |
| `limits.nodePageBytes` | integer | Có | Kích thước tối đa của một trang hoàn chỉnh gồm các bản ghi thực thi nút, tính bằng byte của JSON UTF-8 dạng gọn. Mặc định 8388608. Trang vượt giới hạn sẽ trả về 413. Đây không phải là giới hạn của phần thân yêu cầu. Tối thiểu 1. |


**Các trường của `docs`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `docs.openapi` | string | Có | URL của tài liệu dạng máy đọc được cho HTTP API cục bộ. |
| `docs.schema` | string | Có | URL của tài liệu workflow.schema.json tương ứng với bản sửa đổi danh mục. |
| `docs.aiGuide` | string | Có | URL của hướng dẫn thao tác dành cho AI. |
| `docs.nodeIndex` | string | Có | URL của danh mục nút. |
| `docs.examples` | string | Có | URL của tài liệu ví dụ đầy đủ. |


## NodeTypeSummary

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `action` | string hoặc null | Có | Tên hành động của trình thực thi. Là null với nút cấu trúc. |
| `nodeVersion` | integer | Có | Phiên bản hợp đồng của loại nút này. Đây không phải là khóa phiên bản cho một nút riêng lẻ trong mẫu. Tối thiểu 1. |
| `category` | string | Có | Phân loại của nút. Lọc theo các giá trị thực tế trong danh mục. |
| `title` | string | Có | Tên hiển thị của loại nút. |
| `description` | string | Có | Mô tả hành vi của loại nút. |
| `authorable` | boolean | Có | Cho biết loại này có thể dùng trong soạn thảo công khai hay không. Các trường của loại này vẫn tuân theo fieldPolicies. |
| `runtimeSupported` | boolean | Có | Cho biết trình thực thi nội bộ có hỗ trợ loại này hay không. |
| `externalRunnable` | boolean | Có | Cho biết instance hiện tại có thể chạy nút này qua Local API hay không. Là true khi hành động đã được đăng ký. Vẫn cần xác thực cho lượt chạy. |
| `documentationComplete` | boolean | Có | Cho biết toàn bộ quy tắc có thể thực thi đã được công bố hay chưa. |
| `unavailableReasons` | array<string> | Có | Danh sách lý do nút không khả dụng. Mảng rỗng nghĩa là không có lý do nào đã biết. |


## ConditionRule

**Tùy chọn 1**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `eq` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `field` | string | Có | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `value` | [JsonValue](/vi/browser-rpa/api/data-types#jsonvalue) | Có | Giá trị JSON thực tế. Kiểu của giá trị phải thỏa mãn biến hoặc điều kiện tương ứng. |


**Tùy chọn 2**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `in` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `field` | string | Có | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `values` | array<[JsonValue](/vi/browser-rpa/api/data-types#jsonvalue)> | Có | Tập giá trị được điều kiện in cho phép. |


**Tùy chọn 3**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `and` / `or` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `rules` | array<[ConditionRule](/vi/browser-rpa/api/data-types#conditionrule)> | Có | Tập điều kiện con cho and/or, có ít nhất một phần tử. Tối thiểu 1 phần tử. |


**Tùy chọn 4**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"not"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |
| `rule` | [ConditionRule](/vi/browser-rpa/api/data-types#conditionrule) | Có | Điều kiện con của not. |


**Tùy chọn 5**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `op` | `"always"` | Có | Trường phân biệt. Giá trị phải khớp với tùy chọn này. |


## NodeContract

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `action` | string hoặc null | Có | Tên hành động của trình thực thi. Là null với nút cấu trúc. |
| `nodeVersion` | integer | Có | Phiên bản hợp đồng của loại nút này. Đây không phải là khóa phiên bản cho một nút riêng lẻ trong mẫu. Tối thiểu 1. |
| `category` | string | Có | Phân loại của nút. Lọc theo các giá trị thực tế trong danh mục. |
| `title` | string | Có | Tên hiển thị của loại nút. |
| `description` | string | Có | Mô tả hành vi và quy tắc ngữ nghĩa của nút. |
| `authorable` | boolean | Có | Cho biết loại này có thể dùng trong soạn thảo công khai hay không. Các trường của loại này vẫn tuân theo fieldPolicies. |
| `runtimeSupported` | boolean | Có | Cho biết trình thực thi nội bộ có hỗ trợ loại này hay không. |
| `externalRunnable` | boolean | Có | Cho biết instance hiện tại có thể chạy nút này qua Local API hay không. Là true khi hành động đã được đăng ký. Vẫn cần xác thực cho lượt chạy. |
| `documentationComplete` | boolean | Có | Cho biết toàn bộ quy tắc có thể thực thi đã được công bố hay chưa. |
| `unavailableReasons` | array<string> | Có | Danh sách lý do nút không khả dụng. Mảng rỗng nghĩa là không có lý do nào đã biết. |
| `inputSchema` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | JSON Schema của đầu vào hành động. Với loại cấu trúc, schema này xác thực toàn bộ nút. |
| `outputVariants` | array<object> | Có | Các nhánh schema đầu ra, được chọn theo chế độ. |
| `referenceRules` | array<object> | Có | Dạng giá trị được phép và phạm vi tham chiếu của từng trường. |
| `conditionalRules` | array<object> | Có | Các quy tắc có điều kiện, được kiểm tra sau khi giá trị mặc định và bindings có hiệu lực. |
| `fieldPolicies` | array<object> | Có | Mức độ nhạy cảm và hạn chế soạn thảo theo từng trường. Các quy tắc này cũng áp dụng cho bindings. |
| `defaults` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | Giá trị mặc định an toàn khi thực thi đã được chuẩn hóa, được hợp nhất vào các trường bị bỏ qua. x-editor-default không được dùng khi thực thi. |
| `examples` | array<object> | Có | Mảng các ví dụ gồm đầu vào và đầu ra minh họa của nút này. |
| `sideEffects` | array<`browser` / `read` / `write` / `file` / `script` / `credential` / `environment`> | Có | Các loại tác dụng phụ mà việc chạy nút có thể gây ra. |
| `docUrl` | string | Có | URL của tài liệu chi tiết cho nút này. |


**Các trường của `outputVariants[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `outputVariants[].when` | [ConditionRule](/vi/browser-rpa/api/data-types#conditionrule) | Có | Điều kiện dạng khai báo. Chỉ hỗ trợ các phép toán trong ConditionRule. |
| `outputVariants[].schema` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | JSON Schema của node.data trong điều kiện này. Đây không phải là URL tài liệu. |
| `outputVariants[].publicProjection` | string | Có | Mô tả cách dữ liệu trong bản ghi lượt chạy khác với đầu ra của trình thực thi (không che thông tin; chỉ có handle là không thể tuần tự hóa). |


**Các trường của `referenceRules[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `referenceRules[].field` | string | Có | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `referenceRules[].allow` | array<`literal` / `reference` / `template` / `numericExpression`> | Có | Những dạng nào trong literal/reference/template/numericExpression được phép. |
| `referenceRules[].expectedType` | string | Có | Kiểu đích sau khi tham chiếu được phân giải. |
| `referenceRules[].scope` | string | Có | Phạm vi nhìn thấy được của tham chiếu. |


**Các trường của `conditionalRules[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `conditionalRules[].when` | [ConditionRule](/vi/browser-rpa/api/data-types#conditionrule) | Có | Điều kiện dạng khai báo. Chỉ hỗ trợ các phép toán trong ConditionRule. |
| `conditionalRules[].requiredFields` | array<string> | Có | Các trường bắt buộc trong điều kiện này. |
| `conditionalRules[].forbiddenFields` | array<string> | Có | Các trường bị cấm trong điều kiện này. |
| `conditionalRules[].constraints` | array<string> | Có | Mô tả ràng buộc. Trước khi công bố, mỗi mô tả phải tương ứng với một quy tắc xác thực có thể thực thi. |
| `conditionalRules[].issueCode` | string | Có | Mã vấn đề được trả về khi điều kiện bị vi phạm. |


**Các trường của `fieldPolicies[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `fieldPolicies[].field` | string | Có | Trường đầu vào của nút hoặc trường quy tắc tương ứng. |
| `fieldPolicies[].sensitivity` | `public` / `secret` / `credential` / `localPath` / `inlineFile` / `sourceCode` | Có | Phân loại mức độ nhạy cảm dữ liệu của trường. |
| `fieldPolicies[].authoringPolicy` | `allowed` / `privateReferenceOnly` / `restricted` | Có | Luôn là `allowed` trong phiên bản hiện tại: trường nhận giá trị literal hoặc tham chiếu. Hai giá trị còn lại chỉ được giữ để tương thích với các phiên bản trước. |
| `fieldPolicies[].when` | [ConditionRule](/vi/browser-rpa/api/data-types#conditionrule) | Có | Điều kiện dạng khai báo. Chỉ hỗ trợ các phép toán trong ConditionRule. |


**Các trường của `examples[]`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `examples[].id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `examples[].input` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | Đầu vào ví dụ. |
| `examples[].expectedOutput` | [JsonValue](/vi/browser-rpa/api/data-types#jsonvalue) | Có | Giá trị đầu ra minh họa. Giá trị thực tế lấy từ lượt chạy. |
| `examples[].requirements` | array<string> | Có | Điều kiện tiên quyết của ví dụ. |


## StartRun

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `templateId` | string | Có | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128. |
| `version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `environmentId` | string | Có | ID của một môi trường thực tế. Lấy ID từ truy vấn môi trường. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `parameters` | [ParameterValues](/vi/browser-rpa/api/data-types#parametervalues) | Có | Ánh xạ từ tên tham số sang {kind:json,value:JSON} (văn bản thuần cho tham số riêng tư, đường dẫn cục bộ tuyệt đối cho tham số tệp; xem ParameterValues). Dùng {} khi không có tham số. |


## RunStatus

Kiểu: `queued` / `preparing` / `running` / `cancel_requested` / `success` / `failed` / `cancelled` / `stopped` / `missed`. Lượt chạy không thể xác nhận đã dừng và lượt chạy được khôi phục sau khi ứng dụng thoát cũng trả về `failed`. Về lý do, xem `error.code` (`OUTCOME_UNKNOWN` / `RPA_INTERRUPTED`). Hãy kiểm tra cả isolation.

## RunSummary

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `status` | [RunStatus](/vi/browser-rpa/api/data-types#runstatus) | Có | Trạng thái hiện tại. Đối chiếu với các giá trị enum của mô hình. |
| `template` | object | Có | Toàn bộ phần thân của mẫu đề xuất, hoặc bản tóm tắt mẫu được cố định cho lượt chạy. Đọc trường này theo mô hình chứa nó. |
| `environment` | object | Có | Bản tóm tắt môi trường đích được cố định cho lượt chạy. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `startedAt` | integer hoặc null | Có | Thời điểm bắt đầu. Là null nếu lượt chạy chưa bắt đầu (luôn có trong bản ghi nút). |
| `endedAt` | integer hoặc null | Có | Thời điểm kết thúc. Là null nếu lượt chạy chưa kết thúc. |
| `startAfter` | integer hoặc null | Có | Thời điểm bắt đầu sớm nhất, tính bằng mili giây Unix, khi tác vụ của mẫu được đặt bắt đầu trễ. Trước thời điểm đó, lượt chạy ở trạng thái queued và không chiếm dụng môi trường. Là null khi không có độ trễ hoặc với lượt chạy gỡ lỗi. |
| `hasNodeErrors` | boolean | Có | Cho biết có lỗi nút nào xảy ra hay không. Không chỉ xem trạng thái tổng thể mà bỏ qua trường này. |
| `isolation` | object hoặc null | Có | Trạng thái cách ly của môi trường, hoặc null. Khi trạng thái là quarantined, không thể dùng lại môi trường. |


**Các trường của `template`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `template.id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `template.title` | string | Có | Tên hiển thị. Khi ghi mẫu, dài 1–100 ký tự sau khi loại bỏ khoảng trắng ở hai đầu. |
| `template.version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `template.revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |


**Các trường của `environment`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `environment.id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `environment.name` | string | Có | Tên công khai. |


**Các trường của `isolation`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `isolation.state` | `quarantined` / `released` | Có | Trạng thái cách ly của môi trường: quarantined hoặc released. |
| `isolation.reason` | string | Có | Lý do không khả dụng, lý do cách ly hoặc lý do cần kiểm tra khi chạy. |
| `isolation.since` | integer | Có | Thời điểm bắt đầu cách ly, tính bằng mili giây Unix. Tối thiểu 0. |
| `isolation.releasedAt` | integer hoặc null | Có | Thời điểm giải phóng. Là null nếu môi trường chưa được giải phóng. |


## PublicError

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `code` | string | Có | Mã ổn định, dạng máy đọc được. Chương trình ra quyết định dựa trên mã này. |
| `message` | string | Có | Mô tả dành cho người đọc. Không dựa logic chương trình vào văn bản này. |
| `details` | object | Không | Ngữ cảnh thuộc danh sách cho phép của lỗi nút hoặc lỗi lượt chạy (field, reason, httpStatus, netError, systemCode, phase, v.v.). Về ý nghĩa của từng trường, xem [mã lỗi của nút và lượt chạy](/vi/browser-rpa/api/error-codes). Trường này bị lược bỏ khi không có ngữ cảnh. |


## RunDetail

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `run` | [RunSummary](/vi/browser-rpa/api/data-types#runsummary) | Có | Bản tóm tắt lượt chạy hiện tại. |
| `result` | object hoặc null | Có | Kết quả lượt chạy. Là null cho đến khi có kết quả. Trường outputs là ánh xạ các đầu ra của quy trình. |
| `snapshot` | object | Có | Bản tóm tắt các bản sửa đổi mẫu và phụ thuộc đã được cố định, không kèm nội dung gốc. |


**Các trường của `result`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `result.outputs` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) | Có | Đầu ra của quy trình. Giá trị thực tế được trả về nguyên trạng (không bị che). |
| `result.error` | [PublicError](/vi/browser-rpa/api/data-types#publicerror) hoặc null | Có | Đối tượng lỗi công khai, hoặc null. |


**Các trường của `snapshot`**

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `snapshot.templateId` | string | Có | ID mẫu đích (ID đám mây của mẫu trong Mẫu tùy chỉnh của ứng dụng, là một chuỗi số). Độ dài tối thiểu 1; độ dài tối đa 128. |
| `snapshot.version` | integer | Có | Phiên bản mẫu có thể chỉnh sửa hiện tại. Đọc giá trị này từ phản hồi thực tế. Tối thiểu 1. |
| `snapshot.revisionId` | string | Có | ID bản sửa đổi bất biến. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `snapshot.dependencyRevisions` | array<[DependencyPin](/vi/browser-rpa/api/data-types#dependencypin)> | Có | Các bản sửa đổi phụ thuộc chính xác được dùng để cố định hoặc xác thực. |


## ArtifactMetadata

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID duy nhất của tài nguyên hoặc nút. Lấy ID từ phản hồi trước đó; không tự đoán. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `runId` | string | Có | ID của lượt chạy mà tạo phẩm thuộc về. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `name` | string | Có | Tên công khai. |
| `path` | string | Có | Đường dẫn cục bộ tuyệt đối mà nút đã thực sự ghi vào. Tệp không bị sao chép hay lưu trữ. Nếu sau đó tệp bị di chuyển hoặc xóa, đường dẫn vẫn được giữ lại. Độ dài tối thiểu 1; độ dài tối đa 4096. |
| `mimeType` | string | Có | Kiểu phương tiện (media type) của tạo phẩm. |
| `size` | integer | Có | Kích thước của tạo phẩm, tính bằng byte. Tối thiểu 0. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `contentAvailable` | `false` | Có | Hiện luôn là false. API không cung cấp nội dung tệp. Hãy đọc tệp cục bộ theo đường dẫn. |


## NodeExecution

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `id` | string | Có | ID bản ghi ổn định của một lần gọi logic của nút. Các lần thử lại cập nhật attempts trên cùng bản ghi. Các lần gọi khác nhau trong vòng lặp hoặc quy trình con nhận ID khác nhau. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `nodeId` | string | Có | ID nút ổn định trong mẫu. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `workflowRevisionId` | string | Có | ID bản sửa đổi của quy trình gốc hoặc quy trình con mà nút này thuộc về. Độ dài tối thiểu 1; độ dài tối đa 128. |
| `invocationPath` | string | Có | Đường dẫn lần gọi dạng không trong suốt (opaque) do máy chủ cung cấp. Chỉ sao chép giá trị này để lọc theo khớp chính xác. Không đoán hay tự dựng cấu trúc của nó. Độ dài tối thiểu 1; độ dài tối đa 4096. |
| `status` | `running` / `success` / `failed` / `cancelled` | Có | Trạng thái hiện tại của lần gọi này. Lần gọi không thể xác nhận đã kết thúc có trạng thái failed, với error.code là OUTCOME_UNKNOWN hoặc RPA_INTERRUPTED. Điều này không chứng minh rằng các tác dụng phụ trên trang web đã dừng. |
| `attempts` | integer | Có | Số lần thử đã bắt đầu trong cùng một lần gọi logic của nút. Đây không phải là danh sách các bản ghi lịch sử riêng biệt. Tối thiểu 0. |
| `startedAt` | integer | Có | Thời điểm bắt đầu. Là null nếu chưa bắt đầu (luôn có trong bản ghi nút). Tối thiểu 0. |
| `endedAt` | integer hoặc null | Có | Thời điểm kết thúc. Là null nếu chưa kết thúc. |
| `durationMs` | integer hoặc null | Có | Thời gian thực hiện của nút, tính bằng mili giây. Có thể là null nếu nút chưa hoàn tất. |
| `data` | [JsonObject](/vi/browser-rpa/api/data-types#jsonobject) hoặc null | Có | Dữ liệu nghiệp vụ hoặc đầu ra công khai của nút. Đọc trường này theo mô hình của ngữ cảnh chứa nó. |
| `dataTruncated` | boolean | Có | Khi data vượt quá giới hạn byte công khai, toàn bộ giá trị bị lược bỏ thành null và trường này được đặt thành true. Điều này không làm thay đổi trạng thái thực thi. Là false khi không có dữ liệu nào được tạo ra. |
| `error` | [PublicError](/vi/browser-rpa/api/data-types#publicerror) hoặc null | Có | Đối tượng lỗi công khai, hoặc null. |
| `artifacts` | array<[ArtifactMetadata](/vi/browser-rpa/api/data-types#artifactmetadata)> | Có | Siêu dữ liệu của các tạo phẩm gắn với nút này. |
| `matchedIndex` | integer | Không | Chỉ số khớp tùy chọn, bắt đầu từ 1. Tối thiểu 1. |


## RequestReceipt

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `key` | string | Có | UUID dùng làm Idempotency-Key của ý định ghi ban đầu. Định dạng "uuid". |
| `operation` | string | Có | operationId của thao tác nghiệp vụ ban đầu. |
| `state` | `accepted` / `committed` / `completed` / `failed` / `unknown` | Có | Trạng thái đăng ký/commit/công bố của ý định ghi ban đầu. Đây không phải là trạng thái thực thi của lượt chạy. |
| `createdAt` | integer | Có | Thời điểm tạo, tính bằng mili giây Unix. Tối thiểu 0. |
| `updatedAt` | integer | Có | Thời điểm cập nhật gần nhất, tính bằng mili giây Unix. Tối thiểu 0. |
| `replayAvailable` | boolean | Có | Cho biết biên nhận còn nằm trong khoảng thời gian phát lại đầy đủ hay không. |
| `resourceId` | string hoặc null | Có | ID của tài nguyên mà thao tác ban đầu đã tạo hoặc tác động lên. Có thể là null. |
| `originalStatus` | integer hoặc null | Có | Mã trạng thái HTTP ban đầu. Có thể là null. |
| `result` | [JsonValue](/vi/browser-rpa/api/data-types#jsonvalue) | Có | Phần data của phản hồi thành công ban đầu, không có header/ETag. Là null khi chưa tạo ra kết quả nào hoặc trạng thái là failed. |
| `safeError` | [PublicError](/vi/browser-rpa/api/data-types#publicerror) | Không | code/message công khai của biên nhận failed, không kèm stack trace nội bộ. |


## NodeTypeSummaryPage

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<[NodeTypeSummary](/vi/browser-rpa/api/data-types#nodetypesummary)> | Có | Mảng các mục trên trang hiện tại hoặc trong tài nguyên hiện tại. |
| `total` | integer | Có | Tổng số kết quả khớp. Tối thiểu 0. |
| `page` | integer | Có | Số trang, bắt đầu từ 1. Tối thiểu 1. |
| `pageSize` | integer | Có | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100. |


## TemplateSummaryPage

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<[TemplateSummary](/vi/browser-rpa/api/data-types#templatesummary)> | Có | Mảng các mục trên trang hiện tại hoặc trong tài nguyên hiện tại. |
| `total` | integer | Có | Tổng số kết quả khớp. Tối thiểu 0. |
| `page` | integer | Có | Số trang, bắt đầu từ 1. Tối thiểu 1. |
| `pageSize` | integer | Có | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100. |


## RunSummaryPage

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<[RunSummary](/vi/browser-rpa/api/data-types#runsummary)> | Có | Mảng các mục trên trang hiện tại hoặc trong tài nguyên hiện tại. |
| `total` | integer | Có | Tổng số kết quả khớp. Tối thiểu 0. |
| `page` | integer | Có | Số trang, bắt đầu từ 1. Tối thiểu 1. |
| `pageSize` | integer | Có | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100. |


## NodeExecutionPage

| Trường | Kiểu | Bắt buộc | Mô tả và ràng buộc |
|  --- | --- | --- | --- |
| `items` | array<[NodeExecution](/vi/browser-rpa/api/data-types#nodeexecution)> | Có | Mảng các mục trên trang hiện tại hoặc trong tài nguyên hiện tại. |
| `total` | integer | Có | Tổng số kết quả khớp. Tối thiểu 0. |
| `page` | integer | Có | Số trang, bắt đầu từ 1. Tối thiểu 1. |
| `pageSize` | integer | Có | Số mục mỗi trang. Mặc định 20, tối đa 100. Tối thiểu 1; tối đa 100. |