اصطلاح — حقول الوصف (D9)
ما هو
"D9" هو النمط المقفول (قرار MIQ-133 رقم 52) لأي حقل وصف اختياري طويل النص ثنائي اللغة على CRUD إدارة بيانات مرجعية: زوج textarea إنجليزي/عربي، حدّ 1000 حرف، اختياري، مع العربية من اليمين إلى اليسار. وُجِد بحيث يبدو كل حقل "Description" عبر شاشات الإدارة ويتصرّف على نحو متطابق.
متى يُستخدم
عندما يحمل كيان بيانات مرجعية زوجًا قابلًا للعدم Description_1_English / Description_2_Arabic (أو أي حقل إدارة طويل النص قابل للعدم). أول مُتبنٍّ: Skill (SkillAdminDtos — Description1English / Description2Arabic، كلاهما قابل للعدم).
النمط
البيانات / DTO. حقلان قابلان للعدم، Description_1_English وDescription_2_Arabic، varchar محدّد بـ 1000. تشغّل الخدمة NormalizeNullableText بحيث يُخزَّن الإدخال الفارغ/المسافات كـ NULL، لا "" أبدًا.
الواجهة. زوج <textarea> بأربعة صفوف، الإنجليزي فوق العربي، كلاهما maxLength={1000}، كلاهما اختياري، العربي يحمل dir="rtl". تحت كلٍّ، نص مساعدة مُوطَّن: "Optional. Max 1000 characters."
التحقّق. اختياري (لا NotEmpty)؛ قاعدة حدّ-أقصى عند 1000. مُوطَّن عبر مخطط مفاتيح i18n للواجهة الخلفية <Entity>.Validation.* إن لزمت رسالة.
مزالق / قيود
- الفارغ يُطبَّع إلى NULL. لا تُخزِّن
""—NormalizeNullableTextالخاص بالخدمة يطوي الفراغ/المسافات إلىNULLبحيث تُمثَّل "لا وصف" بطريقة واحدة فقط. - كلتا اللغتين اختياريتان ومستقلّتان — قد يحمل صف وصفًا إنجليزيًا ولا عربيًا، أو لا شيء.
- الشكل مقفول. حقل وصف جديد يعيد استخدام هذا النمط بالضبط (1000 / اختياري / RTL-على-العربي / زوج بأربعة صفوف). إذا احتاج حقل قواعد مختلفة (مطلوب، أطول، لغة واحدة)، فهو ليس حقل D9 — لا تثنِ D9 ليلائمه.
- متميّز عن أعمدة الاسم ثنائية اللغة المطلوبة.
Name_1_English/Name_2_Arabicتتبع قواعد اسم الكيان (غالبًا المطلوبة)؛ يحكم D9 حقول الوصف طويلة النص تحديدًا.
حالة البناء
Available — مقفول في MIQ-133 (قرار رقم 52) ومُنفَّذ على إدارة Skill (MIQ-133 المرحلة Phase 2)؛ النمط المرجعي لحقول الوصف المستقبلية.
ذات صلة
- قالب CRUD للبيانات المرجعية، مفاتيح i18n للواجهة الخلفية
- التدويل — الأعمدة ثنائية اللغة وRTL.
- المصدر: قرار تقرير MIQ-133 رقم 52 (
manpoweriq/docs/MIQ_133_Report.md)؛Application/Skills/SkillAdminDtos.cs.