استخدم تعبيرات الترقيم للهوية لا للسياسة
تنشئ تعبيرات المعرّف التسلسلي ورقم النموذج شكلاً مقروءاً لرقم خصصه KayanOS مسبقاً. وهي مناسبة لمراجع مثلCSR-2026-00042 وليست بديلاً عن حالة أو صلاحية أو اعتماد أو قرار تدقيق.
توجد الدالتان المحجوزتان في دوال المعرّفات والترقيم. لا تفترض توفرهما في حقل محسوب عادي.
سياق معرّف الكيان التسلسلي
تتلقى تعبيرات مساحة الاسم:
تضيف تعبيرات التنسيق
$namespace و$sequence، و$sequence نص. تحدد مساحة الاسم سلسلة العد، بينما يحدد التنسيق طريقة عرض الرقم المخصص.
سياق ترقيم النموذج
يستخدم ترقيم النموذج جذوراً مختلفة:$ و$record و$savedState و$variables و$fields و$organizationId و$formId و$formVersionId و$sessionId و$codePrefix و$profile و$status و$initiatorId و$initiatorType و$publicUserId و$preview و$timezone و$now. وتضيف تعبيرات التنسيق $namespace و$sequence.
$formId، بينما يملك معرّف الكيان $entityKey و$fieldKey.
الدالتان
serialDate الرموز yyyy وyy وMM وdd فقط. وهي تختلف عمداً عن dateFormat العامة التي تستخدم YYYY وDD ورموزاً أخرى. يعيد التاريخ غير الصالح نصاً فارغاً؛ لذلك اختبر المرجع النهائي المعروض لا الدالة منفردة فقط.
قواعد التصميم الحتمي
- حافظ على ثبات مساحة الاسم؛ فتغييرها يغير سلسلة العد.
- استخدم
$sequenceو$namespaceومفاتيح النطاق الثابتة والساعة المضبوطة. لا تستخدمrandomأوshuffleأوsampleأو حقلاً يتغير بعد التخصيص. - استخدم تنسيقاً مقروءاً ومحدود الطول.
- اختبر أول قيمة وقيمة تتجاوز عرض الحشو وحد السنة وأي وضع إدخال/طلب يدوي مسموح.
- تعامل مع المعرّف المعروض كمرجع قابل للتتبع، ولا تعدله لمجرد تحسين شكل شاشة.
أنماط شائعة
استخدم نمط الفئة فقط عندما تقبل سياسة الخدمة صراحة سلسلة مستقلة لكل قيمة فئة مخزنة. لا تعد التسمية التي أعيدت تسميتها قيمة فئة ثابتة.