postFormsData

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

FormData.postFormsData(data, langCode)

Các phương thức sử dụng yêu cầu POST chấp nhận một đối tượng trong thân yêu cầu chứa các trường dữ liệu biểu mẫ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.

const value = await FormData.postFormsData(data, langCode);

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ột 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 — thời gian 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ụ

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

const value = await FormData.postFormsData(body)

Schema (body)

formIdentifier: chuỗi
Định danh văn bản của đối tượng biểu mẫu (marker)
ví dụ: my-form

formData: FormDataLangType
Dữ liệu được gửi bởi biểu mẫu
ví dụ:

[
  {
    "marker": "name_field",
    "type": "string",
    "value": "Name"
  }
]

fileQuery: đối tượng
fileQuery để tải lên các tệp cùng với biểu mẫu
ví dụ:

{
  "type": "page",
  "entity": "editor",
  "id": 3492
}

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ó như tham số thứ hai.

Ví dụ trả về:

{
  "id": 1764,
  "formIdentifier": "my-form",
  "time": "2025-05-09T18:32:46.834Z",
  "formData": {
    "marker": "name_1",
    "value": "Name",
    "type": "string"
  }
}

Schema

id: số
định danh đối tượng
ví dụ: 1764

formIdentifier: chuỗi
Định danh văn bản của đối tượng biểu mẫu (marker)
ví dụ: my-form

time: Ngày
Ngày và giờ của việc sửa đổi biểu mẫu
ví dụ: 2025-05-09T18:32:46.834Z

formData: FormDataLangType
Dữ liệu được gửi bởi biểu mẫu
ví dụ:

[
  {
    "marker": "marker_1",
    "value": "Name"
  }
]