getSingleAttributeByMarkerSet

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

الوصف

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

.getSingleAttributeByMarkerSet(
,
,
);

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

المخطط

setMarker(مطلوب): string
معرف نصي (علامة) لمجموعة السمات
مثال: "productAttributes"

attributeMarker(مطلوب): string
معرف نصي (علامة) للسمة في المجموعة
مثال: "color"

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

أمثلة

مثال بسيط

const response = await AttributesSets.getSingleAttributeByMarkerSet('list1', 'list1');

مثال مع سمة langCode

const response = await AttributesSets.getSingleAttributeByMarkerSet('list1', 'list1', '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 | boolean
يجب ملء الحقل. الشكل: { strict: boolean }.
مثال:

{ strict: true }

validators.trimValidator: object | boolean
يتم إزالة المسافات البيضاء من القيمة. يتم تخزينها ككائن فارغ عندما يكون التبديل مفعلًا.
مثال:

{}

validators.stringInspectionValidator: object
قيود الطول لحقول السلسلة.
مثال:

{ stringLength: 0, stringMin: 2, stringMax: 60 }

validators.urlInspectionValidator: object | boolean
يجب أن تبدو القيمة كعنوان URL. يتم تخزينها إما كـ true أو ككائن.
مثال:

true

validators.emailInspectionValidator: object | boolean
يجب أن تبدو القيمة كعنوان بريد إلكتروني. يتم تخزينها إما كـ true أو ككائن.
مثال:

true

validators.checkForNumberValidator: object
يجب أن تكون القيمة رقمًا، اختياريًا عددًا صحيحًا ضمن الحدود. 0 يعطل حدًا.
مثال:

{ integerOnly: true, minValue: 1, maxValue: 10 }

validators.roundingNumberValidator: object
يقوم بتقريب الرقم قبل تخزينه.
مثال:

{ integerOnly: false, numberOfDecimals: 2, direction: 'round' }

validators.booleanValidator: object
يجب أن تساوي القيمة واحدة من القيم المعلنة.
مثال:

{ trueValue: 1, falseValue: 0 }

validators.comparisonValidator: object
يقارن القيمة مع سمة أخرى أو مع ثابت.
مثال:

{ compareAttribute: 'notChoosed', compareValue: '10', type: 'number', operator: 'equality' }

validators.regExpValidator: object
يجب أن تتطابق القيمة مع تعبير عادي؛ invert يرفض المطابقات بدلاً من ذلك.
مثال:

{ patternValue: '^[0-9]{5}$', invert: false, flags: ['i'] }

validators.fieldMaskValidator: object
يجب أن تتطابق القيمة مع قناع إدخال (9 رقم، A حرف كبير، a حرف صغير، * أي، $ واحد من ()+-).
مثال:

{ maskValue: '+9 (999) 999-99-99' }

validators.checkForAGivenList: object
يجب أن تكون القيمة في القائمة، أو خارجها عندما تكون notValue صحيحة.
مثال:

{ rangeValue: ['red', 'green'], notValue: false }

validators.defaultValueValidator: object
القيمة التي يتم استبدالها عندما يُترك الحقل فارغًا.
مثال:

{ fieldDefaultValue: 'USD' }

validators.sizeInPixelsValidator: object
حدود الصورة بالبكسل؛ يتم تنفيذها بواسطة لوحة الإدارة.
مثال:

{ maxX: 1920, maxY: 1080 }

validators.checkingFilesValidator: object
حدود حجم الملف والامتدادات المسموح بها؛ يتم تنفيذها بواسطة لوحة الإدارة.
مثال:

{ minValue: 0, maxValue: 5, minUnits: 'kb', maxUnits: 'mb', extensions: ['pdf'] }

validators.minMaxDateValidator: object
حدود التاريخ؛ يتم تنفيذها بواسطة لوحة الإدارة.
مثال:

{ minDateTimeValue: '2026-01-01', maxDateTimeValue: '2026-12-31' }

validators.valueValidator: object
تحكم "القيمة الافتراضية" في اللوحة؛ تكتب defaultValueValidator، ويتم الاحتفاظ بهذا الاسم لأن واجهة برمجة التطبيقات تقبله وتخزنه.
مثال:

{ fieldDefaultValue: 'USD' }

validators.checkForLettersValidator: object
تحقق من الحروف فقط حسب النمط؛ يتم تنفيذها بواسطة لوحة الإدارة.
مثال:

{ patternValue: '^[A-Za-z ]+$' }

localizeInfos: IAttributeLocalizeInfo
اسم القالب، مع الأخذ في الاعتبار الترجمة المحلية.
مثال:

{
  "title": "My attribute"
}

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

الوصف​

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

أمثلة​

مثال بسيط​

مثال مع سمة langCode​

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

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