المقدمة

حدد حقولًا مخصصة لمحتواك دون الحاجة إلى تعديل الكود.

🎯 ماذا يفعل هذا الموديل؟

يتيح لك موديل AttributesSets استخدام حقول مخصصة لمحتواك (المنتجات، الصفحات، النماذج، إلخ) دون الحاجة إلى ترميزها في تطبيقك.

فكر في الأمر كمنشئ نماذج لبياناتك - أنت تحدد الحقول التي تحتاجها، وOneEntry يتولى الباقي.

📖 شرح بسيط

تخيل أنك تبني متجرًا عبر الإنترنت. كل منتج يحتاج إلى:

اسم (نص).
سعر (رقم).
صورة (صورة).
وصف (نص طويل).
فئة (قائمة منسدلة).

بدلاً من ترميز هذه الحقول في تطبيقك، تستخدم Attributes لتحديدها في لوحة إدارة OneEntry. ثم يمكنك:

إضافة حقول جديدة في أي وقت (دون تغييرات في الكود!).
إعادة استخدام الحقول عبر أنواع محتوى مختلفة.
تغيير أنواع الحقول دون إعادة نشر.
إدارة هيكل المحتوى بالكامل في مكان واحد.

مثال من العالم الحقيقي:

بدون Attributes (مشفرة):
- الكود: const product = { name: 'اسم المنتج', price: 150, image: '', description: '' }
- لإضافة حقل "اللون" → تغيير الكود، إعادة النشر، الانتظار.

مع Attributes (ديناميكي):
- الكود: const { name, price, image, description } = product
- لوحة الإدارة: إضافة خاصية "اللون".
- الكود يتضمن تلقائيًا الحقل الجديد.
- الكود: const { name, price, image, description, color } = product
- لا حاجة لإعادة النشر!

✨ المفاهيم الأساسية

ما هو السمة؟

السمة هي حقل واحد يخزن البيانات.

أمثلة:

اسم المنتج (سلسلة نصية).
سعر المنتج (عدد عشري).
صورة المنتج (صورة).
تاريخ النشر (تاريخ).

ما هو مجموعة السمات؟

مجموعة السمات هي مجموعة من السمات التي تحدد هيكلًا.

مثال: مجموعة سمات المنتج

- الاسم (سلسلة نصية)
- السعر (عدد عشري)
- الوصف (نص)
- الصور (مجموعة من الصور)
- الفئة (قائمة)
- في المخزون (عدد صحيح)

لماذا تستخدم مجموعات السمات؟

❌ بدون السمات	✅ مع السمات
حقول مشفرة	حقول ديناميكية
تغييرات في الكود	تعديل في لوحة الإدارة
إعادة نشر مطلوبة	تحديثات مباشرة
هيكل صارم	هيكل مرن
كود مكرر	مجموعات قابلة لإعادة الاستخدام

📋 ما تحتاج إلى معرفته

ثلاثة مصطلحات مهمة

المصطلح	ما هو	مثال
المؤشر	معرف فريد للكود	"product_name"
النوع	نوع البيانات المخزنة	"string"، "integer"، "image"
القيمة	قيمة السمة	"اسم المنتج"

مهم حول المؤشرات:

يجب أن تكون فريدة
لا يُسمح بالمسافات (استخدم _ بدلاً من ذلك)
لا يمكن أن تبدأ برقم
استخدم الحروف الصغيرة للاتساق

أمثلة:

✅ جيد: product_name، price_usd، main_image
❌ سيء: product name، 2nd_price، Product Name

📚 أنواع البيانات المتاحة

يمكن أن تخزن السمات أنواعًا مختلفة من البيانات. اختر النوع المناسب لكل حقل.

جدول مرجعي سريع

النوع	الأفضل للاستخدام	مثال للاستخدام
string	نص قصير	اسم المنتج، البريد الإلكتروني
text	نص طويل منسق	منشور مدونة، وصف
textWithHeader	نص مع عنوان	أقسام المقالات
integer	أعداد صحيحة	الكمية، العمر
real	أعداد عشرية عالية الدقة	بيانات علمية
float	أعداد عشرية	السعر، التقييم
date	فقط التاريخ	تاريخ الميلاد، الموعد النهائي
dateTime	التاريخ + الوقت	بدء الحدث، تم النشر في
time	فقط الوقت	ساعات العمل
file	أي ملف	PDF، مستند
image	صورة واحدة	صورة شخصية، شعار
groupOfImages	صور متعددة	معرض الصور
radioButton	اختيار واحد	الحجم (S/M/L)
list	اختيار من القائمة	الدولة، الفئة
entity	رابط لمحتوى آخر	المنتجات ذات الصلة
timeInterval	نطاق زمني	فترة الترويج
json	بيانات مهيكلة مخصصة	استجابة API

🔍 أوصاف مفصلة لأنواع البيانات

أنواع النصوص

متى تستخدم ماذا:

string - سطر واحد، أقل من 255 حرفًا (اسم، بريد إلكتروني، عنوان)
text - عدة فقرات، يدعم التنسيق (مقالات، أوصاف)
textWithHeader - نص يحتاج إلى عنوان (أقسام المدونة، الأسئلة الشائعة)

أنواع الأرقام

متى تستخدم ماذا:

integer - لا حاجة للأعداد العشرية (العمر، الكمية، المشاهدات)
float - أعداد عشرية قياسية (السعر 19.99 دولار، التقييم 4.5)
real - دقة إضافية مطلوبة (حسابات علمية)

أنواع التاريخ/الوقت

متى تستخدم ماذا:

date - فقط اليوم (عيد الميلاد، الموعد النهائي)
time - فقط الساعة (ساعات العمل، وقت الموعد)
dateTime - كلاهما مطلوب (بدء الحدث، نشر المقال)
timeInterval - فترة بين التواريخ (مدة البيع، تواريخ الإجازة)

أنواع الملفات والصور

متى تستخدم ماذا:

file - أي مستند (PDF، DOC، ZIP)
image - صورة واحدة (صورة المنتج، صورة شخصية)
groupOfImages - صور متعددة (معرض، صور المنتج)

أنواع الاختيار

متى تستخدم ماذا:

radioButton - اختر خيارًا واحدًا فقط (نعم/لا، الحجم S/M/L)
list - قائمة منسدلة مع خيارات (الدولة، الفئة، الحالة)

أنواع متقدمة

entity - رابط لصفحات/منتجات أخرى (عناصر ذات صلة، فئات)
json - تخزين هياكل بيانات معقدة (استجابات API، إعدادات)

📖 أمثلة على أنواع البيانات

فيما يلي أمثلة تقنية على هيكل كل نوع بيانات.

💡 البيانات التي يتم إرجاعها في مجموعة السمات لا تشمل القيم الفعلية للسمات، حيث تحتوي هذه القيم على كيانات محددة مثل الصفحات، المنتجات، إلخ. الاستثناء الوحيد هو نوع السمة timeInterval. يمكن أن تحتوي هذه السمة على قيم من خلال تحديد المربع المقابل في لوحة الإدارة

انقر لرؤية جميع أمثلة أنواع البيانات

مرجع أنواع البيانات

يمكن أن تكون أنواع البيانات من الأنواع التالية:

String: نص بسيط، على سبيل المثال، "مرحبًا، العالم!".

مثال:

{
  "type": "string",
  "value": {},
  "marker": "string",
  "position": 1,
  "listTitles": [],
  "validators": {
    "requiredValidator": {
      "strict": true
    }
  },
  "localizeInfos": {
    "title": "String"
  },
  "additionalFields": [
    {
      "type": "integer",
      "value": "10",
      "marker": "Extra"
    }
  ]
}

Text: نص أطول، غالبًا ما يكون منسقًا، على سبيل المثال، مقال أو رسالة.

مثال:

{
  "type": "text",
  "value": {},
  "marker": "text",
  "position": 2,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Text"
  },
  "additionalFields": []
}

Text with Header: نص مع عنوان يمكن استخدامه للدلالة على موضوع أو فئة.

مثال:

{
  "type": "textWithHeader",
  "value": {},
  "marker": "text_with_header",
  "position": 3,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Text With Header"
  },
  "additionalFields": []
}

Integer: عدد صحيح، على سبيل المثال، 5، 100، -2.

مثال:

{
  "type": "integer",
  "value": {},
  "marker": "integer",
  "position": 4,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Integer"
  },
  "additionalFields": []
}

Real: نفس الشيء مثل Float، ولكن بدقة أعلى.

مثال:

{
  "type": "real",
  "value": {},
  "marker": "real_number",
  "position": 5,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Real Number"
  },
  "additionalFields": []
}

Float: نوع بيانات للأعداد العشرية التي يمكن أن تحتوي على جزء عشري، على سبيل المثال، 3.14، 1.5، -0.25.

مثال:

{
  "type": "float",
  "value": {},
  "marker": "float",
  "position": 6,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Float"
  },
  "additionalFields": []
}

Date and Time: مجموعة من التاريخ والوقت، على سبيل المثال، 2023-10-27 10:00:00.

مثال:

{
  "type": "dateTime",
  "value": {},
  "marker": "date_time",
  "position": 7,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "DateTime"
  },
  "additionalFields": []
}

Date: تاريخ، على سبيل المثال، 2023-10-27.

مثال:

{
  "type": "date",
  "value": {},
  "marker": "date",
  "position": 8,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Date"
  },
  "additionalFields": []
}

Time: وقت، على سبيل المثال، 10:00:00.

مثال:

{
  "type": "date",
  "value": {},
  "marker": "date",
  "position": 8,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Date"
  },
  "additionalFields": []
}  

File: أي ملف على جهاز الكمبيوتر الخاص بك، على سبيل المثال، مستند، صورة، موسيقى.

مثال:

{
  "type": "file",
  "value": {},
  "marker": "file",
  "position": 10,
  "listTitles": [],
  "validators": {
    "checkingFilesValidator": {
      "maxUnits": "kb",
      "maxValue": "2000",
      "minUnits": "kb",
      "minValue": 0,
      "extensions": []
    }
  },
  "localizeInfos": {
    "title": "File"
  },
  "additionalFields": []
}

Image: صورة، على سبيل المثال، صورة فوتوغرافية، رسم.

مثال:

{
  "type": "image",
  "value": {},
  "marker": "image",
  "position": 11,
  "listTitles": [],
  "validators": {
    "sizeInPixelsValidator": {
      "maxX": "500",
      "maxY": "500"
    }
  },
  "localizeInfos": {
    "title": "Image"
  },
  "additionalFields": []
}

Group of Images: مجموعة من الصور، على سبيل المثال، ألبوم صور.

مثال:

{
  "type": "groupOfImages",
  "value": {},
  "marker": "image_group",
  "position": 12,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Image Group"
  },
  "additionalFields": []
}

Radio Button: زر اختيار يمكن من خلاله اختيار خيار واحد فقط.

مثال:

{
  "type": "radioButton",
  "value": {},
  "marker": "radio",
  "position": 13,
  "listTitles": [
    {
      "title": "A",
      "value": "a",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 1
    },
    {
      "title": "B",
      "value": "b",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 2
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "Radio"
  },
  "additionalFields": []
}

List: قائمة من العناصر، على سبيل المثال، قائمة تسوق.

مثال:

{
  "type": "list",
  "value": {},
  "marker": "list",
  "position": 14,
  "listTitles": [
    {
      "title": "A",
      "value": "a",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 1
    },
    {
      "title": "B",
      "value": "b",
      "extended": {
        "type": null,
        "value": null
      },
      "position": 2
    },
    {
      "title": "C",
      "value": "c",
      "extended": {
        "type": "string",
        "value": "قيمة إضافية"
      },
      "position": 3
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "List"
  },
  "additionalFields": []
}

Entity: كيان يمثل كائنًا.

مثال:

{
  "type": "entity",
  "value": {},
  "marker": "entity",
  "position": 15,
  "listTitles": [
    {
      "title": "المنتجات",
      "value": {
        "id": 1,
        "depth": 0,
        "parentId": null,
        "position": 1,
        "selected": true
      }
    },
    {
      "title": "صفحة عادية",
      "value": {
        "id": 4,
        "depth": 0,
        "parentId": null,
        "position": 2,
        "selected": true
      }
    },
    {
      "title": "خطأ",
      "value": {
        "id": 2,
        "depth": 0,
        "parentId": null,
        "position": 3,
        "selected": true
      }
    }
  ],
  "validators": {},
  "localizeInfos": {
    "title": "Entity"
  },
  "additionalFields": [
    {
      "type": "string",
      "value": "حقل اختبار",
      "marker": "test_field"
    }
  ]
}

Time interval: تقويم مرن مع واجهة سهلة الاستخدام لإدارة بيانات الفترات الزمنية.

مثال:

{
  "time_interval": {
    "id": 4,
    "type": "timeInterval",
    "value": [
      // مصفوفة من مجموعات القيم، كل منها مرتبط بفترة زمنية محددة (عبر intervalId). يتم تشكيل هذه المصفوفة عند تمكين استلام القيم في CMS
      {
        // سجلات زمنية محددة تنطبق على التواريخ المحددة
        "values": [
          {
            // معرف السجل الفريد
            "id": "1dc1787d-acc3-4315-a45d-52166c72e577",
            // نطاق التاريخ (شامل) الذي ينطبق عليه هذا السجل
            "dates": ["2025-11-27T00:00:00.000Z", "2025-11-27T00:00:00.000Z"],
            // مصفوفة من الفترات الزمنية بتنسيق [[بداية، نهاية], ...]
            "times": [
              [
                // بداية الفترة الزمنية (الساعات والدقائق)
                {
                  "hours": 19,
                  "minutes": 18
                },
                // نهاية الفترة الزمنية
                {
                  "hours": 21,
                  "minutes": 19
                }
              ]
            ],
            // محجوز (غير مستخدم في التنفيذ الحالي)
            "intervals": [],
            // استثناءات — مقاطع زمنية مستبعدة من الجدول في التاريخ المحدد
            "exceptions": [
              {
                // تاريخ الاستثناء
                "date": "2025-12-17T17:00:00.000Z",
                // مصفوفة من الفترات الزمنية المستبعدة
                "externalTimes": [
                  ["2025-12-17T17:25:00.000Z", "2025-12-17T17:27:00.000Z"]
                ]
              }
            ],
            // مرجع إلى الفترة من مصفوفة `intervals`
            "intervalId": "0da61a19-49cb-40b1-88e6-1fa3c93a1fa6",
            // علامة للتكرار الأسبوعي (في اليوم المقابل من الأسبوع)
            "inEveryWeek": true
          },
          {
            "id": "cfa187d3-0284-4e0d-8206-7b353cf47110",
            "dates": ["2025-12-18T00:00:00.000Z", "2025-12-18T00:00:00.000Z"],
            // مصفوفة من الفترات الزمنية بتنسيق [[بداية، نهاية], ...]
            "times": [
              [
                {
                  "hours": 0,
                  "minutes": 25
                },
                {
                  "hours": 0,
                  "minutes": 27
                }
              ],
              [
                {
                  "hours": 19,
                  "minutes": 18
                },
                {
                  "hours": 21,
                  "minutes": 19
                }
              ]
            ],
            "intervals": [],
            "exceptions": [
              {
                "date": "2025-12-17T17:00:00.000Z",
                "externalTimes": [
                  ["2025-12-17T17:25:00.000Z", "2025-12-17T17:27:00.000Z"]
                ]
              }
            ],
            "intervalId": "0da61a19-49cb-40b1-88e6-1fa3c93a1fa6"
          },
          {
            "id": "474de0f7-595f-49a5-aaa7-65617203ae69",
            "dates": ["2025-12-25T00:00:00.000Z", "2025-12-25T00:00:00.000Z"],
            // لا توجد فترات زمنية
            "times": [],
            // قواعد ديناميكية لتوسيع الجدول
            "external": [
              {
                // التاريخ الأساسي لحساب الحدث المتكرر
                "date": "2026-01-15T00:00:00.000Z",
                // يتكرر الحدث كل شهر في هذا اليوم
                "inEveryMonth": true
              }
            ],
            "intervals": [],
            "exceptions": [
              {
                "date": "2025-12-17T17:00:00.000Z",
                "externalTimes": [
                  ["2025-12-17T17:25:00.000Z", "2025-12-17T17:27:00.000Z"]
                ]
              }
            ],
            "intervalId": "0da61a19-49cb-40b1-88e6-1fa3c93a1fa6",
            // علامة للتكرار الأسبوعي
            "inEveryWeek": true,
            // علامة للتكرار الشهري
            "inEveryMonth": true,
            // علامة للتكرار السنوي
            "inEveryYears": true
          }
        ],
        // مرجع إلى الفترة من مصفوفة `intervals`
        "intervalId": "0da61a19-49cb-40b1-88e6-1fa3c93a1fa6"
      },
      {
        "values": [
          {
            "id": "2f80dc18-16da-45cb-82c6-e41e1f6ee084",
            "dates": ["2025-12-22T00:00:00.000Z", "2025-12-23T00:00:00.000Z"],
            "times": [],
            "intervals": [],
            "exceptions": [],
            "intervalId": "918175fd-cc18-4ca5-9bee-c78c61c9415a",
            "inEveryWeek": true,
            "inEveryMonth": true
          }
        ],
        "intervalId": "918175fd-cc18-4ca5-9bee-c78c61c9415a"
      }
    ],
    "isPrice": false,
    "original": true,
    "intervals": [
      // مصفوفة من قوالب الفترات الزمنية
      {
        // معرف فريد لقالب الفترة
        "id": "0da61a19-49cb-40b1-88e6-1fa3c93a1fa6",
        "range": [
          // النطاق الرئيسي لتطبيق الفترة
          "2025-11-26T17:00:00.000Z",
          "2025-11-26T17:00:00.000Z"
        ],
        // استثناءات على مستوى الفترة بالكامل
        "external": [
          {
            "date": "2025-12-17T17:00:00.000Z",
            "externalTimes": [
              ["2025-12-17T17:25:00.000Z", "2025-12-17T17:27:00.000Z"]
            ]
          }
        ],
        // فترات زمنية داخلية (فترات العمل/النشاط)
        "intervals": [
          {
            "id": "01fea594-9933-47ac-af0a-ec0e0884f618",
            // نهاية الفترة الزمنية
            "end": {
              "hours": 21,
              "minutes": 19
            },
            // بداية الفترة الزمنية
            "start": {
              "hours": 19,
              "minutes": 18
            },
            // مدة الكتلة المتكررة (بالدقائق)؛ null — لا دورية
            "period": null
          },
          {
            "id": "22ba24af-1fae-4422-8c92-0635b684a306",
            "end": {
              "hours": 0,
              "minutes": 29
            },
            "start": {
              "hours": 0,
              "minutes": 25
            },
            // دورية: تتكرر الفترات الزمنية بخطوة مدتها دقيقتان
            "period": 2,
            // استثناء داخل الفترة الدورية
            "external": {
              // علامة لعرض الاستثناء في الواجهة
              "show": false,
              // مدة الجزء المستبعد (بالدقائق)
              "value": 2
            }
          }
        ],
        "inEveryWeek": true,
        "inEveryMonth": true,
        "inEveryYears": true
      },
      {
        "id": "918175fd-cc18-4ca5-9bee-c78c61c9415a",
        "range": ["2026-01-18T17:00:00.000Z", "2026-01-20T17:00:00.000Z"],
        // لا توجد استثناءات
        "external": [],
        // لا توجد فترات زمنية داخلية
        "intervals": [],
        "inEveryWeek": true,
        "inEveryMonth": true,
        "inEveryYears": true
      }
    ],
    // علامة لرؤية السمة في الواجهة
    "isVisible": true,
    "identifier": "time_interval",
    "localizeInfos": {
      "en_US": {
        "title": "Time interval"
      }
    },
    "receiveValues": true
  }
}

JSON: بعض البيانات بتنسيق JSON.

مثال:

{
  "type": "json",
  "value": {},
  "marker": "json",
  "position": 17,
  "listTitles": [],
  "validators": {},
  "localizeInfos": {
    "title": "Json"
  },
  "additionalFields": []
}

ستتوافق واجهة ملء المحتوى مع نوع البيانات المحدد لكل حقل سمة.

💡 ملاحظات مهمة

المدققون

يمكنك إضافة مدققين للسمات لضمان جودة البيانات:

الحقول المطلوبة.
الحد الأدنى/الحد الأقصى للطول للنص.
حدود حجم الملف للتحميلات.
أبعاد البكسل للصور.
نطاقات التاريخ.

انقر لرؤية أمثلة المدققين

requiredValidator: يتطلب إدخال قيمة.

مثال:

{
  "type": "string",
  "value": {},
  "marker": "string",
  "position": 1,
  "listTitles": [],
  "validators": {
    "requiredValidator": {
      "strict": true
    }
  },
  "localizeInfos": {
    "title": "Currency"
  },
  "additionalFields": [
    {
      "type": "integer",
      "value": "10",
      "marker": "extra"
    }
  ]
}

defaultValueValidator:

مثال:

{
  "type": "string",
  "value": {},
  "marker": "string",
  "position": 1,
  "listTitles": [],
  "validators": {
    "defaultValueValidator": {
      "customErrorText": "خطأ مخصص",
      "fieldDefaultValue": "usd",
      "fieldDefaultValue2": "",
    },
  },
  "localizeInfos": {
    "title": "String"
  },
  "additionalFields": [
    {
      "type": "integer",
      "value": "10",
      "marker": "extra"
    }
  ]
}

تعلم المزيد: انظر المدققون قسم التكوين التفصيلي.

مجموعات السمات المشتركة

⚠️ مهم: إذا تم استخدام مجموعة سمات من قبل كيانات متعددة، كن حذرًا عند إجراء تغييرات:

إضافة سمة:

سيتم إضافتها إلى جميع الكيانات التي تستخدم المجموعة.
يبقى المحتوى الحالي دون تغيير.
سيكون الحقل الجديد فارغًا للعناصر الحالية.

إزالة سمة:

سيتم إزالتها من جميع الكيانات التي تستخدم المجموعة.
سيتم حذف القيم الحالية بشكل دائم.

مثال:

مجموعة سمات "معلومات المنتج" المستخدمة من قبل:
- المنتجات المادية
- المنتجات الرقمية
- الخدمات

إضافة سمة "الوزن" → تمت إضافتها إلى الثلاثة جميعًا!
إزالة سمة "الوزن" → تمت إزالتها من الثلاثة جميعًا! ⚠️

📊 جدول مرجعي سريع - الطرق الشائعة

الطريقة	ماذا تفعل
getAttributes()	الحصول على جميع كائنات مجموعات السمات.
getAttributesByMarker()	الحصول على جميع السمات حسب المؤشر مع البيانات من مجموعة السمات.
getAttributeSetByMarker()	الحصول على كائن واحد من مجموعة السمات حسب المؤشر.
getSingleAttributeByMarkerSet()	الحصول على سمة واحدة مع البيانات من مجموعة السمات.

❓ الأسئلة الشائعة (FAQ)

ما الفرق بين string و text؟

string - نص قصير، سطر واحد (حد أقصى ~255 حرفًا). استخدمه للأسماء، العناوين، البريد الإلكتروني.
text - نص طويل، عدة فقرات، يدعم التنسيق وHTML. استخدمه للأوصاف، المقالات.

متى يجب أن أستخدم integer مقابل float؟

integer - أعداد صحيحة فقط: 1، 2، 100، -5. استخدمه للكميات، العد، الأعمار.
float - أعداد عشرية: 19.99، 4.5، -0.25. استخدمه للأسعار، التقييمات، القياسات.
real - مثل float ولكن بدقة أعلى. استخدمه للحسابات العلمية.

أفضل ممارسة: خطط لأنواع السمات الخاصة بك قبل إضافة المحتوى.

ماذا يحدث إذا قمت بحذف سمة؟

لا يمكنك حذف سمة إذا كانت مستخدمة في مجموعة سمات.

هل يمكنني إعادة استخدام نفس السمة في مجموعات سمات مختلفة؟

لا، كل سمة تنتمي إلى مجموعة سمات واحدة. لكن يمكنك:

إنشاء سمات مشابهة مع مؤشرات مختلفة
إعادة استخدام مجموعات السمات بالكامل عبر كيانات متعددة

ما هو "المؤشر" ولماذا هو مهم؟

المؤشر هو المعرف الفني الذي تستخدمه في الكود:

// في كودك:
product.attributeValues.product_name  // ← "product_name" هو المؤشر

// مقابل الاسم (المعروض في الإدارة):
"اسم المنتج"  // ← هذا فقط للبشر

قواعد المؤشرات:

يجب أن تكون فريدة
لا مسافات (استخدم _)
لا يمكن أن تبدأ بأرقام
استخدم الحروف الصغيرة
اختر أسماء وصفية

كيف أعرف أي نوع يجب أن أستخدمه لبياناتي؟

اسأل نفسك:

هل هو نص؟
- قصير (< 255 حرفًا)؟ → string
- طويل مع تنسيق؟ → text
- يحتاج إلى عنوان؟ → textWithHeader
هل هو رقم؟
- لا أعداد عشرية؟ → integer
- يحتوي على أعداد عشرية؟ → float
- دقة علمية؟ → real
هل هو اختيار؟
- اختر خيارًا واحدًا؟ → radioButton
- قائمة منسدلة؟ → list
هل هو ملف؟
- صورة؟ → image أو groupOfImages
- مستند؟ → file
هل هو تاريخ؟
- فقط تاريخ؟ → date
- تاريخ + وقت؟ → dateTime
- فترة زمنية؟ → timeInterval

هل يمكنني الحصول على سمات متداخلة (سمات داخل سمات)؟

نعم، يمكنك استخدام حقول إضافية

كيف أضيف قواعد التحقق؟

في لوحة إدارة OneEntry:

انتقل إلى مجموعة السمات الخاصة بك
انقر على سمة
أضف المدققين (مطلوب، الحد الأدنى/الحد الأقصى، regex، إلخ.)
احفظ التغييرات

تعلم المزيد: انظر المدققون قسم التكوين التفصيلي.

🎓 أفضل الممارسات

استخدم مؤشرات وصفية (product_price وليس pp)
خطط لأنواع السمات قبل إضافة المحتوى
أعد استخدام مجموعات السمات عند الإمكان
أضف مدققين لضمان جودة البيانات
وثق ما هي كل سمة

مزيد من المعلومات حول واجهة مستخدم الموديل https://doc.oneentry.cloud/docs/attributes/introduction

تعريف موديل AttributesSets


const { AttributesSets } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة

موديل المنتجات - يستخدم مجموعات السمات لبيانات المنتج
موديل الصفحات - يستخدم مجموعات السمات لمحتوى الصفحة
موديل الكتل - يستخدم مجموعات السمات للكتل القابلة لإعادة الاستخدام
موديل النماذج - إنشاء نماذج مع حقول مخصصة

المقدمة

🎯 ماذا يفعل هذا الموديل؟​

📖 شرح بسيط​

✨ المفاهيم الأساسية​

ما هو السمة؟​

ما هو مجموعة السمات؟​

لماذا تستخدم مجموعات السمات؟​

📋 ما تحتاج إلى معرفته​

ثلاثة مصطلحات مهمة​

📚 أنواع البيانات المتاحة​

جدول مرجعي سريع​

🔍 أوصاف مفصلة لأنواع البيانات​

أنواع النصوص​

أنواع الأرقام​

أنواع التاريخ/الوقت​

أنواع الملفات والصور​

أنواع الاختيار​

أنواع متقدمة​

📖 أمثلة على أنواع البيانات​

مرجع أنواع البيانات​

💡 ملاحظات مهمة​

المدققون​

مجموعات السمات المشتركة​

📊 جدول مرجعي سريع - الطرق الشائعة​

❓ الأسئلة الشائعة (FAQ)​

ما الفرق بين string و text؟​

متى يجب أن أستخدم integer مقابل float؟​

ماذا يحدث إذا قمت بحذف سمة؟​

هل يمكنني إعادة استخدام نفس السمة في مجموعات سمات مختلفة؟​

ما هو "المؤشر" ولماذا هو مهم؟​

كيف أعرف أي نوع يجب أن أستخدمه لبياناتي؟​

هل يمكنني الحصول على سمات متداخلة (سمات داخل سمات)؟​

كيف أضيف قواعد التحقق؟​

🎓 أفضل الممارسات​

تعريف موديل AttributesSets​

🔗 الوثائق ذات الصلة​

🎯 ماذا يفعل هذا الموديل؟

📖 شرح بسيط

✨ المفاهيم الأساسية

ما هو السمة؟

ما هو مجموعة السمات؟

لماذا تستخدم مجموعات السمات؟

📋 ما تحتاج إلى معرفته

ثلاثة مصطلحات مهمة

📚 أنواع البيانات المتاحة

جدول مرجعي سريع

🔍 أوصاف مفصلة لأنواع البيانات

أنواع النصوص

أنواع الأرقام

أنواع التاريخ/الوقت

أنواع الملفات والصور

أنواع الاختيار

أنواع متقدمة

📖 أمثلة على أنواع البيانات

مرجع أنواع البيانات

💡 ملاحظات مهمة

المدققون

مجموعات السمات المشتركة

📊 جدول مرجعي سريع - الطرق الشائعة

❓ الأسئلة الشائعة (FAQ)

ما الفرق بين string و text؟

متى يجب أن أستخدم integer مقابل float؟

ماذا يحدث إذا قمت بحذف سمة؟

هل يمكنني إعادة استخدام نفس السمة في مجموعات سمات مختلفة؟

ما هو "المؤشر" ولماذا هو مهم؟

كيف أعرف أي نوع يجب أن أستخدمه لبياناتي؟

هل يمكنني الحصول على سمات متداخلة (سمات داخل سمات)؟

كيف أضيف قواعد التحقق؟

🎓 أفضل الممارسات

تعريف موديل AttributesSets

🔗 الوثائق ذات الصلة