getAttributesByMarker

الحصول على جميع السمات مع البيانات من مجموعة السمات.

الوصف

ترجع هذه الطريقة جميع السمات مع البيانات من مجموعة السمات. ترجع وعدًا (Promise) يتم حله إلى مصفوفة من كائنات IAttributesSetsEntity - الكيانات الخاصة بالسمات نفسها (marker, type, value, listTitles, validators, localizeInfos, additionalFields, …)، وليس كيان مجموعة السمات.

AttributesSets.getAttributesByMarker(

marker*, langCode

);

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

المخطط

marker(required): string
علامة السمة
مثال: "productAttributes"

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

أمثلة

مثال بسيط

const response = await AttributesSets.getAttributesByMarker('my-marker');

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

const response = await AttributesSets.getAttributesByMarker('my-marker', 'en_US');

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

[
  {
    "type": "string",
    "value": null,
    "marker": "admin-text",
    "position": 1,
    "listTitles": [],
    "validators": {},
    "multiselect": false,
    "initialValue": null,
    "localizeInfos": {
      "title": "Admins text"
    },
    "additionalFields": {}
  }
]

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

المخطط: IAttributesSetsEntity[]

type: AttributeType
نوع السمة.
مثال: "string", "text", "integer", "إلخ"

value: unknown
قيمة السمة، مُعَيارَة بنفس الطريقة التي يتم بها معيارَة قيمة السمة: number | null للأنواع الرقمية، كائن الملف نفسه لملف واحد من نوع image/file، null عندما لا تحمل السمة قيمة.

initialValue: unknown
القيمة الأولية للسمة.

marker: string
معرف نصي للسمة (علامة).
مثال: "color", "size", "إلخ"

position: number
رقم الموضع للفرز.
مثال: 1

listTitles: IListTitle[]
مصفوفة من القيم (مع بيانات موسعة) لسمات القائمة و radioButton؛ مصفوفة فارغة للأنواع غير القائمة.
مثال:

[
  {
    "title": "red",
    "value": 1,
    "position": 1,
    "extendedValue": null,
    "extendedValueType": null
  },
  {
    "title": "yellow",
    "value": 2,
    "position": 2,
    "extendedValue": null,
    "extendedValueType": null
  }
]

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"

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

{
  "requiredValidator": {
    "strict": true
  },
  "defaultValueValidator": {
    "fieldDefaultValue": 11
  }
}

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 }.

localizeInfos: IAttributeLocalizeInfo
اسم القالب، مع الأخذ في الاعتبار التوطين.
مثال:

{
  "title": "My attribute"
}

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

---

أمثلة الاستخدام

خطوات تفصيلية في الوثائق:

• الحصول على السمات حسب العلامة — استرجاع مخطط السمة لمجموعة سمات معينة حسب علامتها.

جربها مباشرة

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

• الحصول على السمات حسب العلامة — استرجاع مخطط السمة لمجموعة سمات معينة حسب علامتها.