createICollectionRow

إنشاء صف في مجموعة.

الوصف

ينشئ صفًا في المجموعة ذات العلامة marker المحددة ويُعيد ICollectionRow الجديد.

.createICollectionRow(

, ,

);

مخطط المعلمات

المخطط

marker(required): string
علامة المجموعة.
مثال: "collection1"

body(required): ICollectionFormObject
بيانات الصف: علامة النموذج وقيم الحقول.
مثال:

{
  "formIdentifier": "collection-form",
  "formData": [
    {
      "marker": "collection_marker",
      "type": "string",
      "value": "Collection marker"
    }
  ]
}

body.formIdentifier(required): string
علامة النموذج.
مثال: "collection-form"

body.formData(required): ICollectionFormData[] | Record<string, ICollectionFormData[]>
قيم الحقول: مصفوفة مسطحة [{ marker, type, value }] (كما في المثال)، أو المصفوفة نفسها داخل رمز لغة — { "en_US": [...] }. تخزّن المنصة الشكلين؛ ويرسل SDK القيمة كما هي.
مثال:

[
  {
    "marker": "name_1",
    "type": "string",
    "value": "Value"
  }
]

formData.marker(required): string
المعرّف النصي (العلامة) لحقل النموذج.
مثال: "collection_marker"

formData.type(required): string
نوع سمة حقل النموذج، على سبيل المثال string أو integer أو date.
مثال: "number"

formData.value(required): string
قيمة حقل النموذج.
مثال: "Collection marker"

langCode: string
رمز اللغة. الافتراضي: langCode المُمرَّر إلى defineOneEntry ("en_US" إذا لم يُمرَّر).
مثال: "en_US"

أمثلة

مثال بسيط

const body = {
  ,
  
    {
      ,
      ,
      
    }
  ]
};
const response = await IntegrationCollections.createICollectionRow('test_collection', body);

مثال على الاستجابة

{
  "formData": [
    {
      "marker": "c_marker",
      "type": "string",
      "value": "Value"
    }
  ],
  "collectionId": 1,
  "langCode": "en_US",
  "createdDate": "2026-10-27T09:15:04.121Z",
  "updatedDate": "2026-10-27T09:15:04.121Z",
  "entityType": null,
  "entityId": null,
  "id": 929
}

مخطط الاستجابة

المخطط: ICollectionRow

id: number
معرّف الصف.
مثال: 1

createdDate: string
تاريخ إنشاء السجل.
مثال: "2023-01-01T00:00:00Z"

updatedDate: string
تاريخ آخر تحديث للسجل.
مثال: "2023-01-02T00:00:00Z"

collectionId: number | null
معرّف المجموعة التي ينتمي إليها الصف.
example: 1

formData: ICollectionFormData[]
حقول النموذج لصف المجموعة.
مثال:

[
  {
    "marker": "name_1",
    "type": "string",
    "value": "Value"
  }
]

formData.marker: string
معرف نص (علامة) حقل النموذج.
مثال: "collection_marker"

formData.type: string
نوع سمة حقل النموذج، على سبيل المثال string أو integer أو date.
مثال: "number"

formData.value: string
قيمة حقل النموذج.
مثال: "Collection marker"

entityType: string | null
نوع الكيان المرتبط به صف المجموعة.
example: "product"

entityId: number | null
معرّف الكيان المرتبط به صف المجموعة.
مثال: 12345

attributeSetIdentifier: string | null
علامة مجموعة السمات التي يستخدمها النموذج المرفق بصف المجموعة، أو null إذا لم توجد.
مثال: "attributeSet1" أو null

langCode: string | null
رمز اللغة الذي تم تخزين السطر تحته.
مثال: "en_US"

formIdentifier: string | null
علامة النموذج المُرسلة في body.formIdentifier. تُرجعها updateICollectionRow فقط.
مثال: "collection_form"

total: string
عدد داخلي تُرجعه getICollectionRowByMarkerAndId فقط؛ دائمًا "1". لا تعتمد عليه.
مثال: "1"

---