Nhảy đến nội dung

createICollectionRow

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

IntegrationCollections?.createICollectionRow( marker?, body?, langCode? );

Ví dụ tối thiểu

const body = {
"formIdentifier": "collection-form",?
"formData": [?
{
"marker": "name_1",?
"type": "string"?
"value": "Value"?
}
]
};

const value = await IntegrationCollections.createICollectionRow(body)
Schema

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

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

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à 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ụ phản hồi

{
"formData": [
{
"marker": "c_marker",
"type": "string",
"value": "Value"
}
],
"collectionId": 1,
"langCode": "en_US",
"createdDate": "2025-07-21T09:40:07.591Z",
"updatedDate": "2025-07-21T09:40:07.591Z",
"entityType": null,
"entityId": null,
"id": 414
}
Schema

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

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 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"