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": [
    {
      "marker": "collection_marker",
      "type": "string",
      "value": "Collection marker"
    }
  ]
}

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": "Value"
  }
]

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": "Value"
    }
  ]
};
const response = await IntegrationCollections.createICollectionRow(body);

Ví dụ phản hồi

{
  "formData": [
    {
      "marker": "c_marker",
      "type": "string",
      "value": "Value"
    }
  ],
  "collectionId": 1,
  "langCode": "en_US",
  "createdDate": "2026-04-15T14:20:16.885Z",
  "updatedDate": "2026-04-15T14:20:16.885Z",
  "entityType": null,
  "entityId": null,
  "id": 738
}

Sơ đồ phản hồi

Sơ đồ: ICollectionRow

id: number
Định danh đố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ụ: "product", "order", "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": "Value"
  }
]

formData.marker: string
Định danh văn bản (marker) của trường biểu mẫu.
ví dụ: "collection_marker"

formData.type: string
Loại của trường biểu mẫu, chẳng hạn như "text", "number", "date", "v.v."
ví dụ: "number"

formData.value: string
Giá trị của trường biểu mẫu, có thể là "string", "number", "date", "v.v."
ví dụ: "Collection marker"

entityType: string | null
Loại thực thể liên kết với hàng bộ sưu tập.
ví dụ: "product", "order", "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 liề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"

---