updateICollectionRow

حدّث صفًا في مجموعة.

الوصف

يحدّث صفًا حسب علامة المجموعة وid الصف، ويُعيد ICollectionRow المحدَّث.

يستبدل formData البيانات المخزّنة للصف بالكامل. تُحفظ المصفوفة المسطّحة تحت langCode فقط، وتُزال القيم المخزّنة تحت لغات أخرى. للاحتفاظ بعدة لغات، أرسل formData بمفاتيح اللغات، مثل { "en_US": [...], "fr_FR": [...] }.

.updateICollectionRow(

, , ,

);

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

المخطط

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

id(required): number
معرّف الصف في المجموعة.
مثال: 12

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

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

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

أمثلة

مثال بسيط

const body = {
  ,
  
    {
      ,
      ,
      
    }
  ]
};
const response = await IntegrationCollections.updateICollectionRow("test_collection", 12, body);

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

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

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

المخطط: 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
معرف نصي (marker) لحقل النموذج.
مثال: "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"

---