createICollectionRow

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

الوصف

ترجع Promise التي تحل إلى كائن ICollectionRow.

IntegrationCollections.createICollectionRow(

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

);

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

المخطط

marker(مطلوب): string
معرف نص المجموعة
مثال: "collection1"

body(مطلوب): ICollectionFormObject
كائن لإنشاء سجل
مثال:

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

body.formIdentifier(مطلوب): string
معرف نصي (علامة) النموذج.
مثال: "collection-form"

body.formData(مطلوب): Record<string, ICollectionFormData>
كائن حيث المفاتيح هي علامات حقول النموذج والقيم هي مصفوفات من كائنات ICollectionFormData.
مثال:

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

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

أمثلة

مثال بسيط

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

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

{
  "formData": [
    {
      "marker": "c_marker",
      "type": "string",
      "value": "Value"
    }
  ],
  "collectionId": 1,
  "langCode": "en_US",
  "createdDate": "2026-04-07T17:35:20.519Z",
  "updatedDate": "2026-04-07T17:35:20.519Z",
  "entityType": null,
  "entityId": null,
  "id": 699
}

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

المخطط: ICollectionRow

id: number
معرف الكائن.
مثال: 1

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

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

collectionId: number | null
معرف المجموعة المرتبط بسطر المجموعة.
مثال: "product", "order", "إلخ"

formData: ICollectionFormData[]
مصفوفة من كائنات بيانات النموذج المرتبطة بسطر المجموعة.
مثال:

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

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

formData.type: string
نوع حقل النموذج، مثل "text"، "number"، "date"، "إلخ".
مثال: "number"

formData.value: string
قيمة حقل النموذج، والتي يمكن أن تكون "string"، "number"، "date"، "إلخ".
مثال: "Collection marker"

entityType: string | null
نوع الكيان المرتبط بسطر المجموعة.
مثال: "product"، "order"، "إلخ"

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

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

total: string
إجمالي العدد.
مثال: "1"

---