postFormsData

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

FormData.postFormsData(data, langCode)

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

---

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

{
  "marker": "last_name",
  "type": "string",
  "value": "Username"
}

---

مثال مع خاصية نوع بسيطة "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>Hello world</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
}

---

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

{
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Headline",
    "htmlValue": "<p>Hello World</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": "red",
      "value": "1",
      "extended": {
        "value": "red",
        "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": "Andrey"
    },
  ]
}

const value = await FormData.postFormsData(body)

Schema (body)

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

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

[
  {
    "marker": "name_field",
    "type": "string",
    "value": "Name"
  }
]

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": "Name",
    "type": "string"
  }
}

Schema

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

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

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

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

  [
    {
      "marker": "marker_1",
      "value": "Name"
    }
  ]