Nhảy đến nội dung

postFormsData

Tạo một đối tượng dữ liệu biểu mẫu để lưu thông tin.

Phương thức này trả về một đối tượng FormDataEntity đã được tạo. Nếu bạn muốn thay đổi ngôn ngữ, chỉ cần truyền nó với tham số thứ hai.

FormData.postFormsData( body, langCode );

Các phương thức với yêu cầu POST chấp nhận một đối tượng với trường dữ liệu biểu mẫu làm nội dung yêu cầu, tương ứng với loại thông tin được gửi. Dưới đây là các ví dụ về các đối tượng dữ liệu biểu mẫu cho các loại dữ liệu khác nhau.

Ví dụ tối thiểu​

const body = {
"formIdentifier": "contact_us",
"formData": [
{
"marker": "last_name",
"type": "string"
"value": "Andrey"
}
]
};

const value = await FormData.postFormsData(body)

Sơ đồ tham số​

Sơ đồ (body)

body(required): object
Nội dung yêu cầu
ví dụ:

{
  "formIdentifier": "form",
  "formData": [
    {
      "marker": "name",
      "type": "string",
      "value": "Jack"
    }
  ]
}

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

body.formIdentifier: string
Định danh của biểu mẫu
ví dụ: "contact-form"

body.formData: string
**
ví dụ:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Jack"
  }
]

body.formData.marker: string
Đánh dấu thuộc tính biểu mẫu
ví dụ: "name"

body.formData.type: string
Loại thuộc tính biểu mẫu
ví dụ: "string"

body.formData.value: string
Giá trị thuộc tính biểu mẫu
ví dụ: "Jack"

Ví dụ với thuộc tính kiểu đơn giản "string", "number", "float"​

{
  "marker": "last_name",
  "type": "string",
  "value": "Username"
}

Ví dụ với thuộc tính kiểu đơn giản "date", "dateTime", "time"​

{
  "marker": "birthday",
  "type": "date",
  "value": {
    "fullDate": "2024-05-07T21:02:00.000Z",
    "formattedValue": "08-05-2024 00:02",
    "formatString": "DD-MM-YYYY HH:mm"
  }
}

Ví dụ với thuộc tính kiểu đơn giản "text"​

{
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Hello world</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

Ví dụ với thuộc tính kiểu đơn giản "textWithHeader"​

{
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Tiêu đề",
    "htmlValue": "<p>Hello World</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

Ví dụ với thuộc tính kiểu đơn giản "image" hoặc "groupOfImages"​

{
  "marker": "avatar",
  "type": "image",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585,
      "previewLink": "",
      "params": {
        "isImageCompressed": true
      }
    }
  ]
}

Ví dụ với thuộc tính kiểu đơn giản "files"​

{
  "marker": "picture",
  "type": "file",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585
    }
  ]
}

Ví dụ với thuộc tính kiểu đơn giản "radioButton" hoặc "list"​

{
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "đỏ",
      "value": "1",
      "extended": {
        "value": "red",
        "type": "string"
      }
    }
  ]
}

Ví dụ với thuộc tính kiểu "entity" (danh sách lồng nhau)​

{
  "formIdentifier": "entity_form",
  "formData": {
    "en_US": [
      {
        "marker": "entity-marker",
        "type": "entity",
        "value": [25, 32, 24]
      }
    ]
  }
}

Giá trị - các định danh số cho các trang và các định danh chuỗi cho các sản phẩm. Các định danh cho sản phẩm nên bao gồm tiền tố 'p-', ví dụ, 'p-1-', 'p-2-', v.v. p-[parentId]-[productId]

Ví dụ với thuộc tính kiểu "timeInterval"​

{
  "formIdentifier": "reg",
  "formData": {
    "en_US": [
      {
        "marker": "interval",
        "type": "timeInterval",
        "value": [
          [
            "2025-02-11T16:00:00:000Z",
            "2025-02-13T16:00:00:000Z",
          ]
        ]
      }
    ]
  }
}

giá trị — mảng các mảng khoảng thời gian theo định dạng ISO 8601. ví dụ 2025-02-11T16:00:00:000Z

2025 — năm; 02 — tháng; 11 — ngày trong tháng; T — ký tự phân cách giữa ngày và giờ; 16:00:00 — giờ theo định dạng giờ:phút:giây; 000Z — chỉ thị mili giây và múi giờ. Z có nghĩa là thời gian được chỉ định theo định dạng UTC.

Ví dụ trả về:​

{
  "formData": {
    "formIdentifier": "test-form",
    "time": "2025-07-21T09:40:06.587Z",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "id": 286
  },
  "actionMessage": ""
}

Sơ đồ phản hồi​

Sơ đồ: IFormDataEntity

formIdentifier: string
Định danh của trang.
ví dụ: "contact_form"

time: Date | string
Định danh của biểu mẫu.
ví dụ:

"2023-10-01T12:00:00Z"

formData: FormDataType[]
Dữ liệu biểu mẫu.
ví dụ:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Test"
  }
]

id: number
Định danh duy nhất của trang biểu mẫu.
ví dụ: 12345

actionMessage: string | null
Thông điệp hành động cho dữ liệu biểu mẫu.
ví dụ: "Biểu mẫu đã được gửi thành công"

attributeSetIdentifier: string | null
Định danh văn bản (đánh dấu) của bộ thuộc tính đã sử dụng.
ví dụ: "product_attributes"