postFormsData

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

الوصف

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

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

FormData.postFormsData(

body, body.formIdentifier, body.formModuleConfigId, body.moduleEntityIdentifier, body.replayTo, body.status, body.formData, body.fileQuery, langCode

);

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

المخطط (body)

body(مطلوب): IBodyPostFormData
جسم الطلب
مثال:

  {
    "formIdentifier": "test-form",
    "formModuleConfigId": 2,
    "moduleEntityIdentifier": "blog",
    "replayTo": null,
    "status": "sent",
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ]
  }

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

body.formModuleConfigId(مطلوب): number
المعرف الفريد لتكوين وحدة النموذج.
مثال: 2

body.moduleEntityIdentifier(مطلوب): string
معرف النص (علامة) لكيان الوحدة.
مثال: "blog"

body.replayTo(مطلوب): string | null
البريد الإلكتروني للرد عليه.
مثال: "some@email.com"

body.status(مطلوب): string
حالة النموذج.
مثال: "sent"

body.formData(مطلوب): FormDataType[]
مصفوفة من كائنات بيانات النموذج.
مثال:

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

body.fileQuery: IUploadingQuery
استعلام ملف اختياري لتحميل الملفات.
مثال:

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

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

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

body.formData: string
**
مثال:

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

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

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

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

أمثلة

مثال بسيط

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

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

const body = {
  "marker": "last_name",
  "type": "string",
  "value": "Username"
};

const response = await FormData.postFormsData(body);

---

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

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

const response = await FormData.postFormsData(body);

---

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

const body = {
  "marker": "about",
  "type": "text",
  "value": {
    "htmlValue": "<p>Hello world</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
};

const response = await FormData.postFormsData(body);

---

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

const body = {
  "marker": "about",
  "type": "textWithHeader",
  "value": {
    "header": "Headline",
    "htmlValue": "<p>Hello World</p>",
    "plainValue": "",
    "params": {
      "isEditorDisabled": false,
      "isImageCompressed": true
    }
  }
};

const response = await FormData.postFormsData(body);

---

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

const body = {
  "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
      }
    }
  ]
};

const response = await FormData.postFormsData(body);

---

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

const body = {
  "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
    }
  ]
};

const response = await FormData.postFormsData(body);

---

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

const body = {
  "marker": "selector",
  "type": "list",
  "value": [
    {
      "title": "red",
      "value": "1",
      "extended": {
        "value": "red",
        "type": "string"
      }
    }
  ]
};

const response = await FormData.postFormsData(body);

---

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

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

const response = await FormData.postFormsData(body);

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

---

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

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

const response = await FormData.postFormsData(body);

القيمة — مصفوفة من مصفوفات الفترات بتنسيق 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": ""
}

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

المخطط: IPostFormResponse

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

formData: object
بيانات النموذج.
مثال:

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

formData.formIdentifier: string
معرف النموذج.
مثال: "contact_form"

time: Date | string
وقت إرسال النموذج.
مثال: "2023-10-01T12:00:00Z"

entityIdentifier: string | null
معرف الكيان.
مثال: "blog"

isUserAdmin: boolean
هل المستخدم مسؤول.
مثال: false

formModuleId: number
معرف وحدة النموذج.
مثال: 2

parentId: any
معرف الوالد.
مثال: null

userIdentifier: number
معرف المستخدم.
مثال: null

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

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

---