postFormsData

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

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

FormData.postFormsData( body, langCode );

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

مثال بسيط

const body = {
"formIdentifier": "contact_us",
"formData": [
{
"marker": "last_name",
"type": "string"
"value": "Andrey"
}
]
};
const value = await FormData.postFormsData(body)

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

المخطط (body)

body(required): كائن
جسم الطلب
مثال:

{
  "formIdentifier": "form",
  "formData": [
    {
      "marker": "name",
      "type": "string",
      "value": "Jack"
    }
  ]
}

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

body.formIdentifier: سلسلة
معرف النموذج
مثال: "contact-form"

body.formData: سلسلة
**
مثال:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Jack"
  }
]

body.formData.marker: سلسلة
علامة خاصية النموذج
مثال: "name"

body.formData.type: سلسلة
نوع خاصية النموذج
مثال: "string"

body.formData.value: سلسلة
قيمة خاصية النموذج
مثال: "Jack"

مثال مع خاصية نوع بسيطة "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.

---

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

{
  "formData": {
    "formIdentifier": "test-form",
    "time": "2025-07-21T09:40:06.587Z",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "id": 286
  },
  "actionMessage": ""
}

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

المخطط: IFormDataEntity

formIdentifier: سلسلة
معرف الصفحة.
مثال: "contact_form"

time: تاريخ | سلسلة
معرف النموذج.
مثال:

"2023-10-01T12:00:00Z"

formData: FormDataType[]
بيانات النموذج.
مثال:

[
  {
    "marker": "name",
    "type": "string",
    "value": "Test"
  }
]

id: رقم
المعرف الفريد لصفحة النموذج.
مثال: 12345

actionMessage: سلسلة | null
رسالة الإجراء لبيانات النموذج.
مثال: "تم إرسال النموذج بنجاح"

attributeSetIdentifier: سلسلة | null
معرف نصي (علامة) لمجموعة الخصائص المستخدمة.
مثال: "product_attributes"

---