Mô tả cấu trúc JSON

Tài liệu này mô tả cấu trúc của sơ đồ JSON cho mô-đun Tích hợp.

Cấu trúc tổng quát

Sơ đồ JSON là một mảng các đối tượng, trong đó mỗi đối tượng là một nút (node) hoặc một tab:

[
  {
    "label": "Xin chào thế giới!",
    "id": "1f24387b252057fe",
    "type": "tab",
    "disabled": false
  },
  {
    "name": "chạy",
    "id": "b51ab819b83e1915",
    "type": "inject",
    "x": 46.96875,
    "y": 99.51171875,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "bd07e1ff0aedba0b"
      ]
    ]
  },
  {
    "id": "2b524ca59e4ed633",
    "type": "debug",
    "name": "gỡ lỗi",
    "x": 610.05078125,
    "y": 98.59765625,
    "z": "1f24387b252057fe",
    "wires": []
  },
  {
    "name": "hàm",
    "func": "msg.payload = 'Thế giới'\n\nreturn msg;",
    "id": "bd07e1ff0aedba0b",
    "type": "function",
    "x": 229.62890625,
    "y": 98.8515625,
    "z": "1f24387b252057fe",
    "wires": [
      [
        "2e1172b330c69aeb"
      ]
    ]
  },
  {
    "id": "2e1172b330c69aeb",
    "type": "template",
    "name": "mẫu",
    "x": 418.66796875,
    "y": 98.19140625,
    "z": "1f24387b252057fe",
    "syntax": "mustache",
    "template": "Xin chào {{payload}} !",
    "output": "str",
    "wires": [
      [
        "2b524ca59e4ed633"
      ]
    ]
  }
]

Các tham số chính của nút

Hầu hết các nút có các tham số chung sau:

id (string) - định danh duy nhất của nút
type (string) - loại nút (ví dụ: "inject", "function", "template")
name (string) - tên hiển thị của nút
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng các mảng định danh của các nút mà đầu ra được kết nối

Các nút hệ thống

Nút "tab" (tab)

Nút loại tab là một container cho nhóm các nút, được hiển thị trực quan như một tab trong giao diện.

Tham số:

label (string) - tên hiển thị của tab
id (string) - định danh duy nhất của tab
type (string) - loại nút (tab)
disabled (boolean) - tab có bị vô hiệu hóa hay không

Nút "debug" (gỡ lỗi)

Nút loại debug được sử dụng để xuất thông điệp ra bảng điều khiển gỡ lỗi.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (debug)
name (string) - tên hiển thị của nút
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Các mối quan hệ giữa các nút

Tham số wires xác định các mối quan hệ giữa các nút. Mỗi phần tử trong mảng tương ứng với đầu ra của nút và chứa một mảng định danh của các nút mà đầu ra này được kết nối.

Ví dụ:

"wires": [
  [
    "bd07e1ff0aedba0b"
  ]
]

Mô tả các tham số của nút

Nút "inject" (tiêm)

Nút inject được sử dụng để tạo và gửi thông điệp vào luồng một cách thủ công.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (inject)
name (string) - tên hiển thị của nút
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "function" (hàm)

Nút loại function cho phép thực thi mã JavaScript tùy ý.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (function)
name (string) - tên của nút
func (string) - mã được thực thi
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "template" (mẫu)

Nút loại template được sử dụng để chuyển đổi thông điệp bằng cách sử dụng các mẫu.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (template)
name (string) - tên của nút
syntax (string) - cú pháp của mẫu (mustache hoặc plain)
template (string) - mẫu thông điệp
output (string) - loại đầu ra (plain, json hoặc yaml)
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "interval-node" (khoảng thời gian)

Nút loại interval-node được sử dụng để tạo ra các thông điệp qua các khoảng thời gian đã định.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (interval-node)
name (string) - tên của nút
interval (number) - khoảng thời gian tính bằng phút giữa các thông điệp
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "switch" (công tắc)

Nút loại switch được sử dụng để định tuyến các thông điệp theo các con đường khác nhau tùy thuộc vào các điều kiện.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (switch)
name (string) - tên của nút
property (string) - thuộc tính của thông điệp để kiểm tra
rules (array) - mảng các quy tắc để định tuyến
outputs (number) - số lượng cổng đầu ra
checkall (string) - kiểm tra tất cả các quy tắc (true hoặc false)
repair (boolean) - sửa chữa các thông điệp không hợp lệ
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "split" (tách)

Nút loại split được sử dụng để tách các thông điệp thành nhiều phần.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (split)
name (string) - tên của nút
property (string) - thuộc tính của thông điệp để tách
propertyType (string) - loại thuộc tính (msg, flow, global)
splt (string) - ký tự phân tách cho chuỗi
spltType (string) - loại ký tự phân tách (str, bin)
arraySplt (number) - kích thước các phần cho mảng
arraySpltType (string) - loại tách mảng (len, index)
stream (boolean) - chế độ xử lý theo luồng
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho các đầu ra

Nút "http in" (HTTP vào)

Nút loại http in được sử dụng để tạo các endpoint HTTP và nhận các yêu cầu HTTP đến.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (http in)
name (string) - tên của nút (không bắt buộc)
url (string) - đường dẫn URL của endpoint
method (string) - phương thức HTTP (get, post, put, delete, patch)
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho việc xử lý các yêu cầu

Nút "http request" (HTTP yêu cầu)

Nút loại http request được sử dụng để thực hiện các yêu cầu HTTP ra ngoài.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (http request)
name (string) - tên của nút
url (string) - địa chỉ URL cho yêu cầu
method (string) - phương thức HTTP (GET, POST, PUT, DELETE, v.v.)
ret (string) - định dạng phản hồi (obj, txt, bin)
headers (array) - mảng các tiêu đề của yêu cầu
paytoqs (string) - nơi đặt payload (body, query)
useAuth (boolean) - sử dụng xác thực hay không
authType (string) - loại xác thực (basic, bearer)
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho việc xử lý phản hồi

Nút "http response" (HTTP phản hồi)

Nút loại http response được sử dụng để gửi phản hồi HTTP cho khách hàng.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (http response)
name (string) - tên của nút
statusCode (number) - mã trạng thái HTTP của phản hồi
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối (thường là rỗng)

Nút "cms-events"

Nút này cho phép theo dõi các sự kiện từ mô-đun Events và đưa chúng vào luồng.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (cms-events)
name (string) - tên của nút
eventMarker (string) - định danh của sự kiện
property (string) - thuộc tính của thông điệp để xử lý
targetType (string) - loại mục tiêu xử lý (msg, flow, global)
x, y (number) - tọa độ của nút trên không gian làm việc
z (string) - định danh của tab mà nút thuộc về
wires (array) - mảng kết nối cho việc xử lý tiếp theo

Nút "admin-api" (Admin API)

Nút này cho phép tương tác với các API khác nhau.

Các tham số chính:

id (string) - định danh duy nhất của nút
type (string) - loại nút (admin-api)
name (string) - tên của nút
path (string) - đường dẫn của API endpoint
method (string) - phương thức HTTP (post, get, put, delete)
operation (string) - định danh của thao tác của bộ điều khiển
data (string) - dữ liệu yêu cầu ở định dạng JSON
wires (array) - mảng kết nối cho việc xử lý phản hồi

Mô tả cấu trúc JSON

Cấu trúc tổng quát​

Các tham số chính của nút​

Các nút hệ thống​

Nút "tab" (tab)​

Nút "debug" (gỡ lỗi)​

Các mối quan hệ giữa các nút​

Mô tả các tham số của nút​

Nút "inject" (tiêm)​

Nút "function" (hàm)​

Nút "template" (mẫu)​

Nút "interval-node" (khoảng thời gian)​

Nút "switch" (công tắc)​

Nút "split" (tách)​

Nút "http in" (HTTP vào)​

Nút "http request" (HTTP yêu cầu)​

Nút "http response" (HTTP phản hồi)​

Nút "cms-events"​

Nút "admin-api" (Admin API)​

Cấu trúc tổng quát

Các tham số chính của nút

Các nút hệ thống

Nút "tab" (tab)

Nút "debug" (gỡ lỗi)

Các mối quan hệ giữa các nút

Mô tả các tham số của nút

Nút "inject" (tiêm)

Nút "function" (hàm)

Nút "template" (mẫu)

Nút "interval-node" (khoảng thời gian)

Nút "switch" (công tắc)

Nút "split" (tách)

Nút "http in" (HTTP vào)

Nút "http request" (HTTP yêu cầu)

Nút "http response" (HTTP phản hồi)

Nút "cms-events"

Nút "admin-api" (Admin API)