getAllForms

احصل على جميع كائنات النماذج.

الوصف

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

Forms.getAllForms(

langCode, offset, limit

);

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

المخطط

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

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

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

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

أمثلة

جربها مباشرة

قم بتشغيل هذه الطريقة بشكل تفاعلي في JS SDK sandbox — قم بتوصيل عنوان URL لمشروعك ورمز التطبيق عند الزيارة الأولى، ثم افتح:

• احصل على جميع النماذج — استرجع كل نموذج تم تكوينه في المشروع.

---

مثال بسيط

const response = await Forms.getAllForms();

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

const response = await Forms.getAllForms('en_US', 0, 30);

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

{
  "items": [
    {
      "id": 4,
      "attributeSetId": 11,
      "type": "data",
      "localizeInfos": {
        "title": "user_form",
        "titleForSite": "",
        "successMessage": "",
        "unsuccessMessage": "",
        "urlAddress": "",
        "database": "0",
        "script": "0"
      },
      "version": 9,
      "position": 1,
      "identifier": "user_form",
      "processingType": "script",
      "templateId": null,
      "attributes": [
        {
          "type": "string",
          "marker": "name_attr",
          "isLogin": false,
          "isSignUp": false,
          "position": 1,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {},
          "initialValue": null,
          "localizeInfos": {
            "title": "name"
          },
          "additionalFields": {},
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        },
        {
          "type": "string",
          "marker": "username",
          "isLogin": true,
          "isSignUp": false,
          "position": 2,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {},
          "initialValue": null,
          "localizeInfos": {
            "title": "username"
          },
          "additionalFields": {},
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        },
        {
          "type": "string",
          "marker": "password",
          "isLogin": false,
          "isSignUp": false,
          "position": 3,
          "settings": {},
          "isVisible": true,
          "isPassword": true,
          "listTitles": [],
          "validators": {},
          "initialValue": null,
          "localizeInfos": {
            "title": "password"
          },
          "additionalFields": {},
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        },
        "..."
      ]
    },
    {
      "id": 6,
      "attributeSetId": 15,
      "type": "data",
      "localizeInfos": {
        "title": "Test form",
        "titleForSite": "",
        "successMessage": "",
        "unsuccessMessage": "",
        "urlAddress": "",
        "database": "0",
        "script": "0"
      },
      "version": 14,
      "position": 2,
      "identifier": "test-form",
      "processingType": "script",
      "templateId": null,
      "attributes": [
        {
          "type": "string",
          "marker": "name",
          "isLogin": false,
          "isSignUp": false,
          "position": 1,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {
            "requiredValidator": {
              "strict": true
            },
            "stringInspectionValidator": {
              "stringMax": 0,
              "stringMin": 0,
              "stringLength": 0
            }
          },
          "initialValue": null,
          "localizeInfos": {
            "title": "Name"
          },
          "additionalFields": {
            "additional_field": {
              "type": "string",
              "value": "Additional field data",
              "marker": "additional_field"
            }
          },
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        },
        {
          "type": "file",
          "marker": "file",
          "isLogin": false,
          "isSignUp": false,
          "position": 2,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {},
          "initialValue": null,
          "localizeInfos": {
            "title": "File"
          },
          "additionalFields": {},
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        }
      ]
    },
    {
      "id": 7,
      "attributeSetId": 15,
      "type": "data",
      "localizeInfos": {
        "title": "File form",
        "titleForSite": "Form title (for application)",
        "successMessage": "Message about successful data processing",
        "unsuccessMessage": "Message about unsuccessful data processing",
        "urlAddress": "",
        "database": "0",
        "script": "0"
      },
      "version": 15,
      "position": 3,
      "identifier": "file_form",
      "processingType": "script",
      "templateId": null,
      "attributes": [
        {
          "type": "string",
          "marker": "name",
          "isLogin": false,
          "isSignUp": false,
          "position": 1,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {
            "requiredValidator": {
              "strict": true
            },
            "stringInspectionValidator": {
              "stringMax": 0,
              "stringMin": 0,
              "stringLength": 0
            }
          },
          "initialValue": null,
          "localizeInfos": {
            "title": "Name"
          },
          "additionalFields": {
            "additional_field": {
              "type": "string",
              "value": "Additional field data",
              "marker": "additional_field"
            }
          },
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        },
        {
          "type": "file",
          "marker": "file",
          "isLogin": false,
          "isSignUp": false,
          "position": 2,
          "settings": {},
          "isVisible": true,
          "isPassword": false,
          "listTitles": [],
          "validators": {},
          "initialValue": null,
          "localizeInfos": {
            "title": "File"
          },
          "additionalFields": {},
          "isSignUpRequired": false,
          "isNotificationEmail": false,
          "isNotificationPhoneSMS": false,
          "isNotificationPhonePush": false
        }
      ]
    },
    "..."
  ],
  "total": 9
}

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

المخطط: IFormsEntity[]

total: number
إجمالي عدد العناصر.

items: IFormsEntity[]
مصفوفة من كائنات النماذج.

items.id: number
معرف الكائن.
مثال: 12345

items.attributeSetId: number | null
معرف مجموعة السمات المستخدمة، أو null إذا لم يكن ذلك قابلاً للتطبيق.
مثال: 1234

items.type: string | null
نوع النموذج.
مثال: "contact"

items.localizeInfos: IFormLocalizeInfo
اسم النموذج وحقول التوطين الخاصة بالنموذج (رسائل النجاح/الخطأ، تكوين المعالجة، إلخ).
مثال:

{
  "key": "value"
}

items.version: number
رقم إصدار الكائن.
مثال: 1

items.position: number
موضع الكائن.
مثال: 1

items.identifier: string
المعرف النصي لحقل السجل.
مثال: "form_contact_us"

items.processingType: string
نوع معالجة النموذج.
مثال: "async"

items.templateId: number | null
معرف القالب المستخدم من قبل النموذج، أو null إذا لم يتم استخدام أي قالب.
مثال: 6789

items.attributes: IFormAttribute[]
حقول النموذج مع توطينها، والمحققين، وعلامات محددة للنموذج.

attributes.marker: string
علامة الحقل (اسم الآلة).
مثال: "email"

attributes.type: AttributeType
نوع بيانات السمة (مثل "string"، "file").

attributes.position: number
موضع ترتيب الحقل.
مثال: 1

attributes.isVisible: boolean
ما إذا كان الحقل مكشوفًا للمستخدم.
مثال: true

attributes.localizeInfos: IAttributeLocalizeInfo
تسميات موطنة للحقل. بالنسبة لسمات timeInterval، تحمل أيضًا حمولة جدول intervals.

attributes.initialValue: unknown
القيمة الافتراضية المطبقة عندما لا يتم ملء الحقل.

attributes.listTitles: IListTitle[]
خيارات محددة مسبقًا لحقول list/radioButton؛ مصفوفة فارغة لأنواع أخرى.

listTitles.title: string
العنوان أو الاسم المرتبط بعنصر القائمة.
مثال: "اسم العنصر"

listTitles.value: number | string
قيمة عنصر القائمة، والتي يمكن أن تكون إما رقمًا أو سلسلة اعتمادًا على السياق.
مثال: 42

listTitles.position: string | number | null
موضع عنصر القائمة، والذي يمكن تمثيله كسلسلة أو رقم أو null إذا لم يكن ذلك قابلاً للتطبيق.
مثال: 1

listTitles.extended: object
كائن يحتوي على خصائص إضافية أو بيانات وصفية تتعلق بعنصر القائمة. يمكن أن تشمل أي تفاصيل إضافية تمد المعلومات الأساسية.

listTitles.extended.value: string | null
القيمة الممتدة، والتي يمكن أن تكون سلسلة أو null.
مثال: "extra_value"

listTitles.extended.type: string | null
نوع القيمة الممتدة، والتي يمكن أن تكون سلسلة أو null.
مثال: "color"

attributes.validators: IAttributeValidators
قواعد التحقق؛ كائن فارغ عندما لا يتم تكوين أي محققين.

validators.requiredValidator: object
يحدد الحقل كحقل مطلوب. الشكل: { strict: boolean }.
مثال: { strict: true }

validators.stringInspectionValidator: object
قيود الطول لحقول السلسلة. الشكل: { stringMin: number; stringMax: number; stringLength: number }.

validators.emailInspectionValidator: boolean
تبديل للتحقق من تنسيق البريد الإلكتروني.

validators.defaultValueValidator: object
تكوين القيمة الافتراضية مع نص خطأ مخصص اختياري. الشكل: { customErrorText?: string; fieldDefaultValue?: unknown; fieldDefaultValue2?: unknown }.

attributes.settings: Record<string, unknown>
تكوين محدد للحقل؛ كائن فارغ بشكل افتراضي.

attributes.additionalFields: Record<string, IFormAttributeAdditionalField>
حقول فرعية متداخلة مفاتيحها بواسطة العلامة؛ كائن فارغ عندما لا يوجد.

attributes.isLogin: boolean
ما إذا كان هذا الحقل يحمل قيمة تسجيل الدخول المستخدمة للمصادقة.
مثال: false

attributes.isSignUp: boolean
ما إذا كان هذا الحقل مطلوبًا أثناء التسجيل.
مثال: false

attributes.isNotificationEmail: boolean
ما إذا كان هذا الحقل يخزن البريد الإلكتروني المستخدم للإشعارات.
مثال: false

attributes.isNotificationPhonePush: boolean
ما إذا كان هذا الحقل يخزن رقم الهاتف المستخدم للإشعارات الفورية.
مثال: false

attributes.isNotificationPhoneSMS: boolean
ما إذا كان هذا الحقل يخزن رقم الهاتف المستخدم لإشعارات SMS.
مثال: false

items.total: number | string
إجمالي عدد الإدخالات ذات الصلة.
مثال: "1"

items.moduleFormConfigs: IFormConfig[]
مصفوفة من تكوينات نماذج الوحدة المرتبطة بالنموذج.

moduleFormConfigs.id: number
معرف تكوين النموذج.
مثال: 123

moduleFormConfigs.formIdentifier: string
معرف النموذج (فقط في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: "review"

moduleFormConfigs.moduleIdentifier: string
معرف الوحدة المرتبطة بتكوين النموذج.
مثال: "module_identifier"

moduleFormConfigs.isGlobal: boolean
تشير إلى ما إذا كان تكوين النموذج عالميًا.
مثال: true

moduleFormConfigs.isClosed: boolean
تشير إلى ما إذا كان تكوين النموذج مغلقًا.
مثال: true

moduleFormConfigs.isModerate: boolean
تشير إلى ما إذا كان النموذج يتطلب اعتدالًا (فقط في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: false

moduleFormConfigs.viewOnlyUserData: boolean
تشير إلى ما إذا كان تكوين النموذج يسمح بعرض بيانات المستخدم (يستخدم في واجهة برمجة التطبيقات للنماذج).
مثال: true

moduleFormConfigs.commentOnlyUserData: boolean
تشير إلى ما إذا كان تكوين النموذج يسمح بالتعليق على بيانات المستخدم (يستخدم في واجهة برمجة التطبيقات للنماذج).
مثال: true

moduleFormConfigs.viewOnlyMyData: boolean
تشير إلى ما إذا كان تكوين النموذج يسمح بعرض بياناتي (يستخدم في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: false

moduleFormConfigs.commentOnlyMyData: boolean
تشير إلى ما إذا كان تكوين النموذج يسمح بالتعليق على بياناتي (يستخدم في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: false

moduleFormConfigs.entityIdentifiers: object[]
مصفوفة من معرفات الكيانات المرتبطة بتكوين النموذج.

moduleFormConfigs.nestedEntityIdentifiers: string[]
مصفوفة من سلاسل معرفات الكيانات المتداخلة (فقط في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: ["catalog"]

moduleFormConfigs.exceptionIds: string[]
مصفوفة من معرفات الاستثناءات.

moduleFormConfigs.formDataCount: number
إجمالي عدد إدخالات بيانات النموذج (فقط في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: 306

moduleFormConfigs.entityFormDataCount: Record<string, number>
عدد بيانات النموذج لكل معرف كيان (فقط في واجهة برمجة التطبيقات للمنتجات/الصفحات).
مثال: {"catalog": 306}

moduleFormConfigs.isRating: boolean | null
تشير إلى ما إذا كان تكوين النموذج هذا مخصصًا للتقييمات.
مثال: null

moduleFormConfigs.isAnonymous: boolean | null
تشير إلى ما إذا كانت التقديمات المجهولة مسموح بها.
مثال: null

moduleFormConfigs.allowHalfRatings: boolean | null
تشير إلى ما إذا كانت التقييمات النصفية مسموح بها.
مثال: null

moduleFormConfigs.allowRerating: boolean | null
تشير إلى ما إذا كان إعادة التقييم مسموحًا به.
مثال: null

moduleFormConfigs.maxRatingScale: number | null
أقصى قيمة لمقياس التقييم.
مثال: 5

moduleFormConfigs.ratingCalculation: string
طريقة حساب التقييم.
مثال: "average"

---