capture

key: developer.capture nhóm: DeveloperAction hàm Client A13: capture

Chức năng

Chụp màn hình máy Client và lưu thành file PNG trên máy đó. Dùng để lưu bằng chứng hoặc soi lại lỗi sau khi workflow chạy đêm.

Tham số (3)

Tên trên UI	payloadName	Kiểu	Mặc định	Mô tả
Workflow	`workflow`	string	`workflow`	Chức năng: Nhãn dùng để đặt tên thư mục/file mà Client lưu ảnh. Đặt tên có ý nghĩa để sau này tìm lại bằng chứng cho đúng luồng. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: login-flow. Giải nghĩa: Gom mọi ảnh của luồng đăng nhập vào một chỗ. Ví dụ 2: ={{$workflow.name}}. Giải nghĩa: Tự lấy tên workflow hiện tại của n8n. Ví dụ 3: checkout-2026-07. Giải nghĩa: Tách theo chiến dịch và theo tháng.
Folder	`folder`	string	`.`	Chức năng: Thư mục trên máy Client để lưu ảnh chụp màn hình. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: .. Giải nghĩa: Lưu ngay tại thư mục làm việc của Client. Ví dụ 2: C:/captures. Giải nghĩa: Thư mục cố định, dễ tìm lại sau này. Ví dụ 3: ={{$json.folder}}. Giải nghĩa: Thư mục do bước trước quyết định.
Full Page	`full_page`	boolean	`true`	Chức năng: Bật thì xử lý toàn bộ chiều dài trang bằng cách cuộn và ghép lại; tắt thì chỉ xử lý phần đang hiển thị trên màn hình. Bạn có thể để trống nếu không cần dùng. Ví dụ 1: false. Giải nghĩa: Chỉ lấy vùng đang nhìn thấy — nhanh và nhẹ. Ví dụ 2: true. Giải nghĩa: Quét/chụp cả trang dài, kể cả phần phải cuộn mới thấy. Ví dụ 3: ={{$json.flag}}. Giải nghĩa: Quyết định theo dữ liệu điều khiển.

🚩 = bắt buộc. Ô rỗng của tham số tùy chọn sẽ bị loại khỏi payload.inputs — Client tự áp default.

Payload MQTT gửi đi

{
  "version": "great-lotus-pyauto-v1",
  "action": {
    "key": "developer.capture",
    "group": "DeveloperAction",
    "function": "capture"
  },
  "inputs": {
    "workflow": {
      "type": "string",
      "value": "workflow"
    },
    "folder": {
      "type": "string",
      "value": "."
    },
    "full_page": {
      "type": "boolean",
      "value": true
    }
  },
  "meta": {
    "requestId": "<16 hex>",
    "requestTopic": "WP2_PC176",
    "responseTopic": "RES_WP2_PC176",
    "waitForResponse": true,
    "responseTimeoutSec": 60
  }
}

Publish lên topic bạn nhập ở ô Topic; nếu bật Wait For Response, node chờ Client trả lời trên RES_<topic> với đúng meta.requestId. return: "NG" ⇒ node ném lỗi.

Sinh tự động bởi tools/gen_doc_html.js từ ACTION_SPECS (package n8n-nodes-c12_pyautogui_web@0.1.34) · 2026-07-22 · Đừng sửa tay file này — sửa _notes/ hoặc source rồi chạy lại npm run doc:build.