createICollectionRow

Tạo một bản ghi trong bộ sưu tập.

Mô tả

Hàm này trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng ICollectionRow.

IntegrationCollections.createICollectionRow(

marker, body, body.formIdentifier, body.formData, langCode

);

Sơ đồ tham số

Sơ đồ

marker(bắt buộc): string
Định danh văn bản của bộ sưu tập
ví dụ: "collection1"

body(bắt buộc): ICollectionFormObject
Đối tượng để tạo một bản ghi
ví dụ:

{
  "formIdentifier": "collection-form",
  "formData": {
    "en_US": [
      {
        "marker": "collection_marker",
        "type": "string",
        "value": "Đánh dấu bộ sưu tập"
      }
    ]
  }
}

body.formIdentifier(bắt buộc): string
Định danh văn bản (marker) của biểu mẫu.
ví dụ: "collection-form"

body.formData(bắt buộc): Record<string, ICollectionFormData>
Một đối tượng mà trong đó các khóa là các marker trường biểu mẫu và các giá trị là các mảng của các đối tượng ICollectionFormData.
ví dụ:

[
  {
    "marker": "name_1",
    "type": "string",
    "value": "Giá trị"
  }
]

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

Ví dụ

Ví dụ tối thiểu

const body = {
"formIdentifier": "collection-form",
"formData": [
{
"marker": "name_1",
"type": "string"
"value": "Giá trị"
}
]
};
const response = await IntegrationCollections.createICollectionRow(body);

Ví dụ phản hồi

{
  "formData": [
    {
      "marker": "c_marker",
      "type": "string",
      "value": "Giá trị"
    }
  ],
  "collectionId": 1,
  "langCode": "en_US",
  "createdDate": "2025-09-30T20:32:44.573Z",
  "updatedDate": "2025-09-30T20:32:44.573Z",
  "entityType": null,
  "entityId": null,
  "id": 461
}

Sơ đồ phản hồi

Sơ đồ: ICollectionRow

id: number
Định danh của đối tượng.
ví dụ: 1

createdDate: string
Ngày tạo bản ghi.
ví dụ: "2023-01-01T00:00:00Z"

updatedDate: string
Ngày cập nhật cuối cùng của bản ghi.
ví dụ: "2023-01-02T00:00:00Z"

collectionId: number | null
collectionId liên kết với hàng bộ sưu tập.
ví dụ: "sản phẩm", "đơn hàng", "v.v."

formData: ICollectionFormData[]
Mảng các đối tượng dữ liệu biểu mẫu liên kết với hàng bộ sưu tập.
ví dụ:

[
  {
    "marker": "name_1",
    "type": "string",
    "value": "Giá trị"
  }
]

entityType: string | null
Loại thực thể liên kết với hàng bộ sưu tập.
ví dụ: "sản phẩm", "đơn hàng", "v.v."

entityId: number | null
Định danh của thực thể liên kết với hàng bộ sưu tập.
ví dụ: 12345

attributeSetIdentifier: string | null
Định danh của bộ thuộc tính được sử dụng bởi biểu mẫu gắn với hàng bộ sưu tập, hoặc null nếu không áp dụng.
ví dụ: "attributeSet1" hoặc null

total: string
Tổng số lượng.
ví dụ: "1"

---