getFormsDataByMarker

Tìm kiếm dữ liệu biểu mẫu theo định danh văn bản (marker).

Mô tả

Phương thức này lấy một đối tượng dữ liệu biểu mẫu cụ thể theo marker của nó từ API. Nó chấp nhận tham số marker như là marker của dữ liệu biểu mẫu. Nó trả về một Promise mà khi hoàn thành sẽ trả về một mảng các đối tượng thuộc loại FormDataEntity.

FormData.getFormsDataByMarker(

marker*, formModuleConfigId*, body, isExtended, langCode, offset, limit

);

Sơ đồ tham số

Sơ đồ

marker(bắt buộc): string
Marker của biểu mẫu
ví dụ: "contact_form"

formModuleConfigId(bắt buộc): number
ID cấu hình mô-đun biểu mẫu
ví dụ: 4

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

{
  "entityIdentifier": 14,
  "entityparentIdentifier": 167,
  "userIdentifier": "",
  "status": [
    "new",
    "approved"
  ],
  "dateFrom": "2025-01-01",
  "dateTo": ""
}

isExtended: number
Cờ để lấy các trường bổ sung
ví dụ: 1

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

offset: number
Tham số cho phân trang. Mặc định: 0
ví dụ: 0

limit: number
Tham số cho phân trang. Mặc định: 30
ví dụ: 30

Mặc định, bạn có thể lấy 10 đối tượng. Điều này là do giới hạn bản ghi trong cài đặt quyền của mô-đun.
Để phân trang hoạt động chính xác, bạn cần cấu hình Quyền mô-đun theo nhu cầu của bạn trong phần tương ứng.

Ví dụ

Ví dụ tối thiểu

const response = await FormData.getFormsDataByMarker('my-marker');

Ví dụ với các thuộc tính

const response = await FormData.getFormsDataByMarker('my-marker', 'en_US', 0, 30);

Ví dụ phản hồi

{
  "items": [
    {
      "id": 3464,
      "formIdentifier": "test-form",
      "time": "2026-01-07T04:10:50.809Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 3447,
      "formIdentifier": "test-form",
      "time": "2026-01-07T02:09:20.987Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 3430,
      "formIdentifier": "test-form",
      "time": "2026-01-07T00:05:59.818Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    "..."
  ],
  "total": 518
}

Sơ đồ phản hồi

Sơ đồ: IFormsDataEntity

items: IFormByMarkerDataEntity[]
Mảng các đối tượng dữ liệu biểu mẫu.
ví dụ:

[
  {
    "id": 42,
    "parentId": null,
    "formIdentifier": "test-form",
    "depth": 0,
    "ip": null,
    "status": null,
    "userIdentifier": null,
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "attributeSetIdentifier": "form",
    "time": "2025-03-03T15:51:17.458Z",
    "entityIdentifier": "blog",
    "isUserAdmin": false,
    "formModuleConfigId": 2
  }
]

total: number
Tổng số bản ghi đã tìm thấy.
ví dụ: 100

---