updateFormsDataByid

حدّث بيانات النموذج بواسطة المعرّف. 🔐 تتطلب هذه الطريقة التفويض.

الوصف

يحدّث سجل بيانات نموذج مُرسَل ويُعيد السجل المحدَّث كـ IUpdateFormsData.

مرّر الحقول الجديدة بصيغة body.formData، مفاتيحها رموز اللغات: { formData: { en_US: [...] } }. بخلاف postFormsData()، لا تغلّف هذه الطريقة formData حسب اللغة نيابةً عنك؛ تُخزَّن المصفوفة المسطّحة كما هي، ولا يعود السجل يظهر بعد ذلك في getFormsDataByMarker() لتلك اللغة. بدون formData تُعيد واجهة API 400 ("Provide a valid formData").

يُؤخذ formData فقط من الجسم؛ وتُتجاهل الحقول الأخرى. يُضبط وقت السجل، ومؤلفه في النماذج غير الخاصة بالتقييم، من المستدعي. لا يمكن تحديث السجل إلا للمستخدم الذي أرسله؛ ويحصل أي شخص آخر على 403.

.updateFormsDataByid(

,

);

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

المخطط

id(required): number
معرّف بيانات النموذج.
مثال: 1

body: object
الحقول المراد تحديثها: formData، مفهرسة حسب رمز اللغة. بدون formData يُعيد API الرمز 400.

أمثلة

مثال بسيط

// 1. auth
const authData = [
  {
    marker: 'email',
    value: 'john@example.com',
  },
  {
    marker: 'password',
    value: '123456',
  },
];
await AuthProvider.auth('email', {
  authData,
});
// 2. update your form data record by id
const result = await FormData.updateFormsDataByid(
  1621, // FormData ID.
  {
    formData: {
      en_US: [
        {
          marker: 'name',
          type: 'string',
          value: 'John Smith',
        },
      ],
    },
  },
);

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

{
  "id": 1621,
  "formIdentifier": "test-form",
  "time": "2026-10-28T07:18:30.456Z",
  "formData": {
    "en_US": [
      {
        "marker": "name",
        "type": "string",
        "value": "John Smith"
      }
    ]
  },
  "userIdentifier": "john@example.com",
  "entityIdentifier": "blog",
  "parentId": null,
  "fingerprint": null,
  "isUserAdmin": false,
  "formModuleId": 2
}

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

المخطط: IUpdateFormsData

id: number
معرّف سجل بيانات النموذج.
مثال: 12345

formIdentifier: string
علامة النموذج.
مثال: "contact_form"

time: string
تاريخ ووقت الإرسال.
مثال: "2023-10-01T12:00:00Z"

formData: FormDataType[]
حقول النموذج مجمّعة حسب رمز اللغة، مثل { en_US: [...] }.

userIdentifier: string
معرّف (اسم تسجيل الدخول) المستخدم الذي أرسل النموذج.
example: "john@example.com"

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

parentId: null | number
معرّف السجل الأصل.
مثال: null

fingerprint: null | string
بصمة جهاز المرسل.
مثال: null

isUserAdmin: boolean
هل أرسل السجلَ مسؤولٌ.
مثال: false

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

---