getFormsDataByMarker

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

الوصف

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

FormData.getFormsDataByMarker(

marker*, formModuleConfigId*, body, isExtended, langCode, offset, limit

);

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

المخطط

marker(required): string
علامة النموذج
مثال: "contact_form"

formModuleConfigId(required): number
معرف تكوين وحدة النموذج
مثال: 4

body: object
جسم الطلب
مثال:

{
  "entityIdentifier": 14,
  "entityparentIdentifier": 167,
  "userIdentifier": "",
  "status": [
    "new",
    "approved"
  ],
  "dateFrom": "2025-01-01",
  "dateTo": ""
}

isExtended: number
علامة للحصول على حقول إضافية
مثال: 1

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

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

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

بشكل افتراضي، يمكنك استرجاع 10 كائنات. وذلك بسبب حد السجلات في إعدادات أذونات الوحدة.
لعمل التصفح بشكل صحيح، تحتاج إلى تكوين أذونات الوحدة وفقًا لاحتياجاتك في القسم المقابل.

أمثلة

مثال بسيط

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

مثال مع السمات

const response = await FormData.getFormsDataByMarker('my-marker', 'en_US', 0, 30);

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

{
  "items": [
    {
      "id": 5794,
      "formIdentifier": "test-form",
      "time": "2026-04-14T14:53:27.413Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 5777,
      "formIdentifier": "test-form",
      "time": "2026-04-14T13:22:33.279Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    {
      "id": 5760,
      "formIdentifier": "test-form",
      "time": "2026-04-14T13:20:53.653Z",
      "formData": [
        {
          "marker": "name",
          "type": "string",
          "value": "Test"
        }
      ],
      "attributeSetIdentifier": "form",
      "moduleIdentifier": "content"
    },
    "..."
  ],
  "total": 686
}

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

المخطط: IFormsDataEntity

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

[
  {
    "id": 42,
    "parentId": null,
    "formIdentifier": "test-form",
    "depth": 0,
    "ip": null,
    "status": null,
    "userIdentifier": null,
    "formData": [
      {
        "marker": "name",
        "type": "string",
        "value": "Test"
      }
    ],
    "attributeSetIdentifier": "form",
    "time": "2025-03-03T15:51:17.458Z",
    "entityIdentifier": "blog",
    "isUserAdmin": false,
    "formModuleConfigId": 2
  }
]

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

items.parentId: null | number
المعرف الفريد لصفحة النموذج الأصلية.
مثال: 123

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

items.depth: number
**
مثال: 1

items.ip: string | null
Ip.
مثال: '127.0.0.1'

items.fingerprint: string | null
بصمة الإصبع.
مثال: 'fingerprint'

items.status: string | null
الحالة.
مثال: 'approved'

items.userIdentifier: string | null
المعرف النصي (العلامة) للمستخدم.
مثال: "admin"

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

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

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

items.time: Date | string
معرف النموذج.
مثال: "2023-10-01T12:00:00Z"

items.entityIdentifier: string
المعرف النصي (العلامة) للكيان.
مثال: "test"

items.isUserAdmin: boolean
هل المستخدم إداري.
مثال: true

items.formModuleConfigId: number
معرف تكوين وحدة النموذج.
مثال: 2

items.moduleIdentifier: string
معرف الوحدة.
مثال: "blog"

items.entityId: number
معرف تكوين وحدة النموذج.
مثال: 2

total: number
إجمالي عدد السجلات التي تم العثور عليها.
مثال: 100

---