getFormsDataByMarker

البحث عن بيانات النموذج بواسطة معرف نصي (علامة).

FormData?.getFormsDataByMarker( marker?, langCode?, offset?, limit? );

مثال بسيط

const value = await FormData.getFormsDataByMarker('my-marker')

المخطط

marker(required): string
علامة بيانات النموذج
مثال: "contact_form_data"

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

offset: number
معامل للتصفح. الافتراضي: 0
مثال: 0

limit: number
معامل للتصفح. الافتراضي: 30
مثال: 30

تسترجع هذه الطريقة كائن بيانات نموذج محدد بواسطة علامته من واجهة برمجة التطبيقات. تقبل معامل علامة كعلامة لبيانات النموذج. تعيد وعدًا يتم حله إلى مصفوفة من كائنات من نوع FormDataEntity.

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

{
  "items": [
    {
      "id": 285,
      "formIdentifier": "test-form",
      "time": "2025-07-21T01:54:30.043Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form"
    },
    {
      "id": 283,
      "formIdentifier": "test-form",
      "time": "2025-07-21T01:49:33.957Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form"
    },
    {
      "id": 281,
      "formIdentifier": "test-form",
      "time": "2025-07-21T01:44:11.296Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form"
    },
    "..."
  ],
  "total": 169
}

المخطط

items: IFormDataEntity[]
مصفوفة من كائنات بيانات النموذج.
مثال:

[
  {
    "id": 1,
    "formIdentifier": "form",
    "time": "2025-06-06T19:07:45.993Z",
    "formData": {},
    "attributeSetIdentifier": "form",
    "actionMessage": "سلسلة رسالة الإجراء"
  }
]

total: number
إجمالي عدد السجلات الموجودة.
مثال: NaN

---