postFormsData

إنشاء كائن لحفظ معلومات بيانات النموذج

FormData.postFormsData(data, langCode)

تقبل الطرق التي تستخدم طلب POST كائنًا في جسم الطلب يحتوي على حقول بيانات النموذج، والتي تتوافق مع نوع المعلومات المرسلة. فيما يلي أمثلة على كائنات بيانات النموذج لأنواع بيانات مختلفة.

const value = await FormData.postFormsData(data, langCode);

---

مثال مع خاصية نوع بسيطة "string"، "number"، "float"

{
  "marker": "last_name",
  "type": "string",
  "value": "اسم المستخدم"
}

---

مثال مع خاصية نوع بسيطة "date"، "dateTime"، "time"

{
  "marker": "birthday",
  "type": "date",
  "value": {
    "fullDate": "2024-05-07T21:02:00.000Z",
    "formattedValue": "08-05-2024 00:02",
    "formatString": "DD-MM-YYYY HH:mm"
  }
}

---

مثال مع خاصية نوع بسيطة "text"

{
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>مرحبا بالعالم</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

مثال مع خاصية نوع بسيطة "textWithHeader"

{
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "عنوان",
    "htmlValue": "<p>مرحبا بالعالم</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

مثال مع خاصية نوع بسيطة "image" أو "groupOfImages"

{
  "marker": "avatar",
  "type": "image",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585,
      "previewLink": "",
      "params": {
        "isImageCompressed": true
      }
    }
  ]
}

---

مثال مع خاصية نوع بسيطة "files"

{
  "marker": "picture",
  "type": "file",
  "value": [
    {
      "filename": "files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "downloadLink": "http://my-site.com/cloud-static/files/project/page/10/image/Screenshot-from-2024-05-02-15-23-14.png",
      "size": 392585
    }
  ]
}

---

مثال مع خاصية نوع بسيطة "radioButton" أو "list"

{
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "أحمر",
      "value": "1",
      "extended": {
        "value": "أحمر",
        "type": "string"
      }
    }
  ]
}

---

مثال مع خاصية نوع "entity" (قائمة متداخلة)

{
  "formIdentifier": "entity_form",
  "formData": {
    "en_US": [
      {
        "marker": "entity-marker",
        "type": "entity",
        "value": [25, 32, 24]
      }
    ]
  }
}

القيمة - معرفات عددية للصفحات ومعرفات نصية للمنتجات. يجب أن تتضمن معرفات المنتجات البادئة 'p-'، على سبيل المثال، 'p-1-'، 'p-2-'، إلخ. p-[parentId]-[productId]

---

مثال مع خاصية نوع "timeInterval"

{
  "formIdentifier": "reg",
  "formData": {
    "en_US": [
      {
        "marker": "interval",
        "type": "timeInterval",
        "value": [
          [
            "2025-02-11T16:00:00:000Z",
            "2025-02-13T16:00:00:000Z"
          ]
        ]
      }
    ]
  }
}

القيمة — مصفوفة من مصفوفات الفترات بتنسيق ISO 8601. على سبيل المثال، 2025-02-11T16:00:00:000Z

2025 — السنة؛ 02 — الشهر؛ 11 — يوم الشهر؛ T — الفاصل بين التاريخ والوقت؛ 16:00:00 — الوقت بتنسيق الساعات:الدقائق:الثواني؛ 000Z — الميلي ثانية وإشارة المنطقة الزمنية. Z تعني أن الوقت محدد بتنسيق UTC.

---

مثال

const body = {
  "formIdentifier": "contact_us",
  "formData": [
    {
      "marker": "last_name",
      "type": "string",
      "value": "أندري"
    }
  ]
}

const value = await FormData.postFormsData(body)

المخطط (الجسم)

formIdentifier: string
معرف نصي لكائن النموذج (علامة)
مثال: my-form

formData: FormDataLangType
البيانات المقدمة بواسطة النموذج
مثال:

[
  {
    "marker": "name_field",
    "type": "string",
    "value": "اسم"
  }
]

fileQuery: object
استعلام الملف لتحميل الملفات مع النموذج
مثال:

{
  "type": "page",
  "entity": "editor",
  "id": 3492
}

ترجع هذه الطريقة كائن FormDataEntity الذي تم إنشاؤه. إذا كنت ترغب في تغيير اللغة، فقط مررها كوسيط ثانٍ.

مثال على الإرجاع:

{
  "id": 1764,
  "formIdentifier": "my-form",
  "time": "2025-05-09T18:32:46.834Z",
  "formData": {
    "marker": "name_1",
    "value": "اسم",
    "type": "string"
  }
}

المخطط

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

formIdentifier: string
معرف نصي لكائن النموذج (علامة)
مثال: my-form

time: Date
تاريخ ووقت تعديل النموذج
مثال: 2025-05-09T18:32:46.834Z

formData: FormDataLangType
البيانات المقدمة بواسطة النموذج
مثال:

[
  {
    "marker": "marker_1",
    "value": "اسم"
  }
]