أعدادات الحقول و الشاشات (Generic Reference Overrider User Guide)

إعدادات الحقول والشاشات (Fields and Entities Settings)

معلومات الكيان (Entity Information)

• نوع الكيان: GenericReferenceOverrider
• الاسم العربي: أعدادات الحقول و الشاشات
• الاسم الإنجليزي: Fields and Entities Settings
• التصنيف: ملف أساسي (Master File)
• جدول قاعدة البيانات: GenericReferenceOverrider
• مسار القائمة: الأساسيات > الإعدادات > أعدادات الحقول و الشاشات
• مسار القائمة (إنجليزي): Basic > Settings > Fields and Entities Settings

نظرة عامة (Overview)

يُعدّ Generic Reference Overrider كياناً قوياً لإعداد النظام في Nama ERP، يُتيح للمسؤولين تخصيص وتجاوز سلوكيات الحقول المختلفة والتحقق من صحتها وخصائص العرض عبر كيانات متعددة دون الحاجة إلى تعديل كود المصدر. يوفر هذا المرونة اللازمة لتكييف النظام وفق متطلبات العمل المحددة.

المفهوم الأساسي (Core Concept)

في الأنظمة المؤسسية، تتباين قواعد العمل ومتطلبات التحقق وتفضيلات العرض بين المؤسسات المختلفة. بدلاً من إنشاء نسخ متعددة من البرنامج أو تعديل كود المصدر، يوفر Generic Reference Overrider نهجاً قائماً على الإعداد لتخصيص سلوك النظام.

يعمل النظام عبر اعتراض عمليات الحقول القياسية (التحقق، العرض، البحث، إلخ) وتطبيق قواعد مخصصة مُعرَّفة في إعدادات التجاوز. تُحمَّل هذه الإعدادات في الذاكرة عند بدء التشغيل وتُخزَّن مؤقتاً لتحسين الأداء، مع إلغاء تلقائي للتخزين المؤقت عند تغيير الإعدادات.

نظرة عامة على البنية (Architecture Overview)

يعمل Generic Reference Overrider من خلال عدة مكونات رئيسية:

1. تعريف كيان DSL (GenericReferenceOverrider.java): يُعرِّف كيان الإعداد الرئيسي بأنواع سطور التفاصيل المتعددة
2. طبقة التخزين المؤقت (GenericRefOverriderFromDBUtil.java): توفر وصولاً مخزناً مؤقتاً للإعدادات باستخدام concurrent hash maps آمنة للخيوط
3. أنواع سطور التفاصيل: سطور إعداد متخصصة لجوانب التخصيص المختلفة
4. إلغاء التخزين المؤقت القائم على الأحداث: تحديث تلقائي للتخزين المؤقت عند تغيير الإعدادات
5. نظام Post Actions (GenericReferenceOverriderPostActions.java): يوفر اقتراحات ذكية للحقول والتحقق من صحتها

التطبيق التقني (Technical Implementation)

يستخدم النظام آليات اقتراح تلقائي متطورة تُصفِّي الحقول المتاحة ديناميكياً بناءً على:

• سياق نوع الكيان
• توافق نوع الحقل
• قواعد العمل المحددة مسبقاً
• تكامل بيانات النظام الوصفية

الغرض والفوائد (Purpose and Benefits)

الفوائد الرئيسية:

• تخصيص بدون كود (No-Code Customization): تعديل سلوك النظام دون معرفة برمجية
• قواعد خاصة بكل كيان (Entity-Specific Rules): تطبيق قواعد مختلفة على أنواع كيانات مختلفة
• إعداد مركزي (Centralized Configuration): جميع التخصيصات في مكان واحد
• تأثير فوري (Immediate Effect): تُطبَّق التغييرات فوراً دون إعادة تشغيل النظام
• التحكم في المحددات (Dimension Control): تجاوز قواعد التحقق من المحددات حسب احتياجات العمل

نظرة عامة على مخطط قاعدة البيانات (Database Schema Overview)

هيكل المجموعات الكاملة (38 مجموعة)

يحتوي كيان GenericReferenceOverrider على 38 مجموعة تفاصيل، كل منها مخزنة في جداول قاعدة بيانات منفصلة:

الكيان الرئيسي: جدول GenericReferenceOverrider

مجموعات التفاصيل:

1. addDiscussionTo → AddDiscussionTo - إضافة النقاش إلي (Add Discussion To)
2. addRelatedDocumentsTo → AddRelatedDocumentsTo - إضافة المستندات المرتبطة إلى (Add Related Documents To)
3. allowUsageOfPreventedRecords → AllowUsageOfPreventedRecords - السماح باستعمال السجلات الممنوعة من الاستعمال (Allow Usage Of Prevented Records)
4. auditFields → DetailedAuditFields - Audit Fields
5. autoCodingLines → GenRefAutoCodingLine - التكويد الالي للملفات (Files Auto Coding)
6. descriptors → ReferenceDescriptorLine - Descriptors
7. details → GenRefOverriderLine - القيم المسموح بها للمراجع (Allowed Values For Generic References)
8. dimensionsConsistency → IgnoreDimensionsConsistency - تجاهل تناسق المحددات لحقول (Ignore Dimensions Consistency for Fields)
9. disabledFields → DisabledFieldsLines - Disabled Fields
10. displayMasks → FieldDisplayMask - Display Masks
11. emailSendToTypes → EmailSendToTypes - أنواع المراجع في نافذة ارسال بريد الكترونى (Email Send To Types)
12. entityIcons → EntityIconLine - Entity Icons
13. enumIcons → EnumConstantIconLine - Enum Icons
14. errorMessageLoggingConfigs → ErrorMesageLoggingConfig - Error Message Logging Configurations
15. extraCodes → ExtraCode - Extra Codes
16. extraFilter → FieldExtraFilter - Extra Filter
17. extraReferenceSearchFields → ExtraReferenceSearchFields - حقول البحث الإضافية عند البحث عن مرجع (Extra Reference Search Fields)
18. fieldAllowedValues → FieldAllowedValues - القيم المسموح بها للحقول (Field Allowed Values)
19. fieldFormats → FieldFormatLine - Field Formats
20. fieldIcons → FieldIconLine - Field Icons
21. fieldStyles → FieldStyleLine - Field Styles
22. importIntegratorLines → ImportIntegratorLine - Import Integrators
23. integratorConfig → IntegratorConfig - Integrator Config
24. invoiceRetrieverLines → InvoiceRetrieverLine - Invoice Retriever Lines
25. lines → DuplicatedFieldsLines - Clear On Duplicate
26. maxFieldsLengthInDB → MaxFieldLengthInDB - Max Fields Length In DB
27. maxLinesCounts → MaxLineCount - أقصى عدد لسطور السندات والملفات (Max Lines Counts For Documents And Files)
28. maxPOSFieldsLengthInDB → MaxPOSFieldLengthInDB - Max POS Fields Length In DB
29. notColorFields → NotColorField - ليست حقول ألوان (Not Color Fields)
30. openCreateFields → OpenCreateFields - الحقول التي يتم فتح الإنشاء عند ادخال كود غير موجود (Fields that open Edit Screen when code not found)
31. openInPopups → OpenInPopup - Open Reference In Popup
32. publicEntitiesLines → PublicEntitiesLine - Public Entities
33. queryBasedScreenField → QueryBasedScreenField - استعلامات الحقول المحسوبة (calculated Fields Queries)
34. richTextFields → RichTextFieldsLines - Rich Text Fields
35. searchInNameInFindByCode → SearchInNameInFindByCode - البحث في الأسم العربى والانجليزى عند كتابة كود ملف (Search In Name In Find By Code)
36. signatures → SignatureFields - Signatures
37. styleOverriderLines → GenRefRowStyleOverriderLine - Style Overrider Details
38. textToLinkFields → TextToLinkFieldsLine - الحقول النصية المحوله الي روابط (Text To Link Fields)
39. useScannerInFields → UseScannerInField - Use Scanner In Fields

جميع مجموعات التفاصيل تستخدم genericReferenceOverrider_id كمفتاح خارجي للربط بسجل الإعداد الرئيسي.

أوصاف الميزات التفصيلية (Detailed Feature Descriptions)

1. تجاوزات حقول المرجع العام (details)

المجموعة: القيم المسموح بها للمراجع (Allowed Values For Generic References)

المفهوم والغرض

تتيح حقول المرجع العام في النظام عادةً الاختيار من أنواع كيانات متعددة. على سبيل المثال، قد يقبل حقل "Reference" عملاء أو موردين أو موظفين أو أصنافاً. يتيح لك Generic Reference Override تقييد أو تعديل أنواع الكيانات المتاحة للاختيار في سياقات محددة.

كيفية العمل

يحتفظ النظام بخريطة مخزنة مؤقتاً (genRefTypesMap) تخزن قيود نوع الكيان لكل حقل. عند فتح المستخدم لبحث حقل مرجع، يتحقق النظام من هذه الخريطة لتحديد أنواع الكيانات المتاحة للاختيار.

الهيكل التقني للحقول

الحقول الرئيسية:

• forType (EntityType) → "للنوع" (For Type) - نوع الكيان الهدف للتجاوز
• fieldID (FieldID) → "الحقل" (On Field) - الحقل المحدد الذي يتم إعداده
• allowedEntity1-5 (EntityType) → "النوع المسموح 1-5" (Allowed Entity 1-5) - أنواع الكيانات المسموح بها (حتى 5)
• allowedEntityList (EntityList) → "قائمة الأنواع المسموح بها" (Allowed Entity List) - مرجع إلى قائمة كيانات لمزيد من الخيارات
• defaultEntityType (EntityType) → "النوع الافتراضي" (Default Entity Type) - نوع الكيان المحدد مسبقاً
• addToExisting (Boolean) → "إضافة الى الموجود" (Add To Existing) - ما إذا كان يضاف إلى الأنواع الموجودة أم يستبدلها

نظام اقتراح الحقول (Field Suggestion System)

يوفر النظام اقتراحات ذكية للحقول من خلال الأداة المساعدة EntityFieldIdsSuggestionUtil:

• تصفية حسب السياق: يعرض فقط الحقول المتوافقة مع نوع الكيان المحدد
• تصفية نوع الحقل: يقصر الاقتراحات على أنواع حقول Genericreference
• تحديثات ديناميكية: تتحدث اقتراحات الحقول تلقائياً عند تغيير نوع الكيان
• حقول النقاش: تتضمن اختيارياً الحقول المتعلقة بالنقاش في الاقتراحات

خيارات الإعداد

• للنوع (For Type): تطبيق التجاوز على نوع كيان محدد (مثلاً SalesInvoice فقط)
• قائمة الكيانات (Entity List): تطبيق على أنواع كيانات متعددة باستخدام قائمة محددة مسبقاً
• معرّف الحقل (Field ID): الحقل المحدد الذي يتم تجاوزه (مثلاً "customer"، "item"، "reference")
• الكيانات المسموح بها (1-5): حتى 5 أنواع كيانات يجب أن تكون متاحة للاختيار
• قائمة الكيانات المسموح بها (Allowed Entity List): لأكثر من 5 أنواع كيانات، استخدم قائمة كيانات محددة مسبقاً
• نوع الكيان الافتراضي (Default Entity Type): نوع الكيان الذي يجب تحديده مسبقاً
• إضافة إلى الموجود (Add to Existing): ما إذا كان يضاف إلى الأنواع المسموح بها الموجودة أم يستبدلها كلياً

2. المؤشرات البصرية والأيقونات (Visual Indicators and Icons)

أنواع الحقول المدعومة (Supported Field Types)

تدعم إعدادات الأيقونات أنواع حقول مختلفة حسب نوع الأيقونة:

• Field Icons: جميع أنواع الحقول
• Entity Icons: تُطبَّق على أنواع الكيانات بشكل عام
• Enum Icons: خاصة بحقول التعداد مع اقتراحات ديناميكية للقيم

أيقونات الحقول (fieldIcons)

المجموعة: Field Icons المفهوم: إضافة أيقونات سياقية إلى تسميات الحقول لتوفير تغذية راجعة بصرية فورية حول الحالة أو الأولوية أو النوع.

كيفية العمل: يقيّم النظام قيم الحقول ويطبق الأيقونات المضبوطة بناءً على معرفات الحقول.

الإعداد:

• نوع الكيان/قائمة أنواع الكيانات: نطاق التطبيق
• معرّف الحقل (Field ID): الحقل الهدف (مثلاً "status"، "priority"، "type")
• كود الأيقونة (Icon Code): معرف الأيقونة
• كود اللون (Color Code): اللون المرتبط (hex أو اسم لون)

أيقونات الكيانات (entityIcons)

المجموعة: Entity Icons المفهوم: تطبيق أيقونات على أنواع الكيانات بأكملها، تظهر عادةً في القوائم ونتائج البحث.

أيقونات ثوابت التعداد (enumIcons)

المجموعة: Enum Icons المفهوم: إضافة أيقونات إلى قيم التعداد (القوائم المنسدلة) عبر النظام.

الفوائد: يوفر لغة بصرية متسقة لقيم الحالة والأنواع والفئات في جميع أنحاء التطبيق.

نظام إدارة التعداد (Enum Management System)

اكتشاف ديناميكي للتعداد: يكتشف النظام تلقائياً جميع أنواع التعداد المتاحة من البيانات الوصفية للنظام باستخدام طريقة fetchEnumsData().

عملية الإعداد:

1. اختيار نوع التعداد: اختر من أنواع التعداد المقترحة ديناميكياً
2. اختيار القيمة: يوفر النظام القيم المسموح بها الخاصة بنوع التعداد المحدد
3. تعيين الأيقونة: عيّن أيقوناً ولوناً لقيم تعداد محددة

التطبيق التقني:

• بيانات التعداد الوصفية مخزنة مؤقتاً لتحسين الأداء
• اقتراحات قيم في الوقت الفعلي بناءً على نوع التعداد
• يدعم جميع تعدادات النظام

أمثلة:

• حالة الطلب: "Draft" = دائرة صفراء، "Approved" = علامة خضراء، "Cancelled" = X أحمر
• مستوى الأولوية: "High" = علامة تعجب حمراء، "Medium" = شرطة برتقالية، "Low" = نقطة خضراء

3. عرض الحقول والتنسيق (Field Display and Formatting)

أقنعة العرض (displayMasks)

المجموعة: Display Masks

المفهوم: تطبيق أنماط تنسيق على قيم الحقول لعرض متسق دون تغيير البيانات المخزنة.

ملاحظة تقنية: تُطبَّق الأقنعة أثناء عرض واجهة المستخدم ولا تؤثر على التخزين في قاعدة البيانات.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" - نوع الكيان الهدف
• fieldID (FieldID) → "الحقل" - الحقل المراد تنسيقه
• displayMask (Text) → Display Mask - نمط التنسيق

أنواع الحقول المدعومة

الحقول المتوافقة: حقول Integer و Long و Decimal فقط

أمثلة على الأقنعة:

• ###,###.## - تنسيق أرقام قياسي مع فاصل الآلاف
• ###.00 - منازل عشرية ثابتة
• ##.##% - تنسيق النسبة المئوية

أقنعة عرض G2 (متقدم)

خيارات تنسيق محسّنة:

• ##,# → "1234 → 1,234" (فاصل الآلاف)
• ##.## \% → "25.5 → 25.5%" (نسبة مئوية مع % مُهرَّبة)
• ##.00 → "25.5 → 25.50" (منازل عشرية ثابتة)
• c → "1234 → $1,123.00" (تنسيق العملة)
• ##,#.00 → "1234567.56 → 1,234,567.56" (تنسيق رقم كامل)

تنسيقات الحقول (fieldFormats)

المجموعة: Field Formats المفهوم: التحكم في قواعد التحقق من إدخال الحقل وتنسيقه. يمكن تطبيق ذلك بشكل مشروط بناءً على استعلامات ديناميكية أو تعريفات معايير.

خيارات الإعداد:

• الحد الأقصى للطول (Max Length): الحد الأقصى لعدد الأحرف المسموح بها
• الحد الأدنى للطول (Min Length): الحد الأدنى لعدد الأحرف المطلوبة
• السماح بالأرقام (Allow Numbers): ما إذا كانت الأحرف الرقمية مسموحاً بها
• السماح بالحروف (Allow Letters): ما إذا كانت الأحرف الأبجدية مسموحاً بها
• محتوى مختلط (Mixed Content): ما إذا كانت الأرقام والحروف معاً مسموحاً بها
• تطبيق مشروط (Conditional Application): تطبيق القواعد بناءً على استعلامات ديناميكية أو معايير محددة

حالات الاستخدام:

• تقييد أكواد الأصناف بتنسيق أرقام فقط
• فرض متطلبات الحد الأدنى لطول كلمة المرور
• السماح بالحروف فقط في حقول الاسم
• تطبيق قواعد تحقق مختلفة بناءً على نوع المستند أو حالته

أنماط الحقول (fieldStyles)

المجموعة: Field Styles المفهوم: التحكم في خصائص عرض الحقل وسلوكه. هذا ليس تنسيقاً مشروطاً، بل إعداد مباشر لخصائص الحقل.

خيارات الإعداد:

• اتجاه النص (Text Direction): تعيين اتجاه من اليمين إلى اليسار (RTL) أو من اليسار إلى اليمين (LTR)
• حقل كلمة المرور (Password Field): تحويل حقول النص إلى حقول كلمة مرور (عرض نجوم أو نقاط)
• لون النص (Text Color): تعيين لون محتوى النص
• لون الخلفية (Background Color): تعيين لون خلفية الحقل

حالات الاستخدام:

• تعيين حقول اللغة العربية باتجاه RTL
• تحويل الحقول الحساسة إلى عرض كلمة مرور
• تطبيق نظام ألوان الشركة على حقول محددة
• إبراز الحقول المهمة بألوان خلفية
• ضمان اتجاه النص الصحيح للتطبيقات متعددة اللغات

4. التحقق من البيانات والقيود (Data Validation and Restrictions)

القيم المسموح بها للحقول (fieldAllowedValues)

المجموعة: القيم المسموح بها للحقول (Field Allowed Values)

المفهوم: إنشاء قوائم منسدلة مخصصة وتقييد قيم الحقول بخيارات محددة مسبقاً.

كيفية العمل: يحتفظ النظام ببنية بيانات وصفية (FieldsAllowedValuesMetadata) تخزن القيم المسموح بها لكل مجموعة من نوع الكيان والحقل. أثناء إدخال البيانات، يتحقق النظام من هذه القوائم.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" (For Type) - نوع الكيان الهدف
• fieldID (FieldID) → "الحقل" (On Field) - الحقل المراد تقييده
• restrictValues (Boolean) → "عدم السماح بكتابة القيم يدويا" (Restrict Selection) - فرض القيود
• allowedValue1-10 (Text) → "القيمة المسموح بها 1-10" (Allowed Value 1-10) - القيم المسموح بها المحددة مسبقاً

أنواع الحقول المدعومة

الحقول المتوافقة: Text و Integer و Long و Decimal و BigText و Enum و EntityType

اقتراحات قيم ذكية: يوفر النظام اقتراحات مدركة للسياق للقيم المسموح بها بناءً على:

• نوع الحقل وأنماط البيانات الموجودة
• سياق نوع الكيان
• قواعد العمل والقيود

الإعداد:

• تقييد القيم (Restrict Values): علامة بوليانية لفرض القيود
• القيم المسموح بها (1-10): حتى 10 قيم محددة مسبقاً لكل سطر إعداد
• سطور متعددة: إنشاء سطور إضافية لمزيد من القيم

فوائد الأعمال:

• ضمان اتساق البيانات
• تقليل أخطاء إدخال البيانات
• توحيد المصطلحات عبر الأقسام
• الامتثال للمتطلبات التنظيمية

الحد الأقصى لطول الحقل (maxFieldsLengthInDB)

المجموعة: Max Fields Length In DB المفهوم: تجاوز أطوال حقول قاعدة البيانات الافتراضية بحدود خاصة بالعمل للأنظمة العادية.

أنواع الحقول المدعومة

الحقول المتوافقة: Text و FieldID و Enum و Link و Email و Password و Color و PhoneNumber

تكامل النظام: يتضمن إجراء إدارياً updateFieldsMaxLengthInDB لتطبيق تغييرات طول الحقل على مخطط قاعدة البيانات.

الإعداد:

• للنوع (For Type): نوع كيان محدد
• معرّف الحقل (Field ID): الحقل المراد تقييده
• الحد الأقصى للطول (Max Length): الحد الأقصى لعدد الأحرف

حالات الاستخدام:

• تقييد أكواد الأصناف بأنماط محددة
• الامتثال لمتطلبات تكامل الأنظمة الخارجية
• فرض اتساق البيانات عبر الأنظمة
• منع الإدخالات الطويلة بشكل مفرط

الحد الأقصى لطول حقل نقاط البيع (maxPOSFieldsLengthInDB)

المجموعة: Max POS Fields Length In DB

المفهوم: تعيين حدود طول حقل محددة لأنظمة نقاط البيع (POS)، تكون عادةً أقصر من الأنظمة العادية.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" - نوع كيان POS
• fieldID (FieldID) → "الحقل" - الحقل المراد تقييده
• maxLength (Integer) → "اقصي طول" - الحد الأقصى لطول الحرف لـ POS

التعرف على كيانات POS

الكشف التلقائي عن POS: يحدد النظام تلقائياً كيانات POS باستخدام علامة isPosClass() في البيانات الوصفية للكيان.

التصفية الذكية: عند إعداد أطوال حقول POS:

• تُقترح كيانات POS فقط في اختيار نوع الكيان
• تقتصر اقتراحات الحقول على حقول Decimal و Text و Password
• يمنع النظام إعداد كيانات غير POS للحدود الخاصة بـ POS

لماذا حدود POS منفصلة: تعاني أنظمة POS في الغالب من قيود بسبب:

• حدود أحرف طابعة الإيصالات (عادةً 40-48 حرفاً في السطر)
• شاشات العرض الصغيرة
• متطلبات المعاملات السريعة
• قيود الطابعات الحرارية

الإعداد:

• للنوع (For Type): نوع الكيان في سياق POS (يُصفَّى تلقائياً لكيانات POS)
• معرّف الحقل (Field ID): الحقل المراد تقييده
• الحد الأقصى للطول (Max Length): الحد الأقصى للأحرف لعرض/طباعة POS

حدود POS الشائعة:

• اسم العميل: 20-25 حرفاً
• وصف الصنف: 30 حرفاً
• سطور العنوان: 35 حرفاً
• مرجع الدفع: 15 حرفاً

حالات الاستخدام:

• ضمان ملاءمة الأسماء للإيصالات
• تحسين عرض شاشة POS
• الحفاظ على قابلية القراءة على الشاشات الصغيرة
• الامتثال لمتطلبات الطابعات المالية

الحد الأقصى لعدد السطور (maxLinesCounts)

المجموعة: أقصى عدد لسطور السندات والملفات (Max Lines Counts For Documents And Files) المفهوم: تحديد عدد سطور التفاصيل المسموح بها في المستندات.

متطلبات نوع الحقل

الحقول المتوافقة: حقول التفاصيل فقط

تنطبق قيود عدد السطور تحديداً على حقول التفاصيل/المجموعات التي تمثل سطور المستند.

الفوائد:

• منع مشكلات أداء النظام
• فرض قواعد العمل (مثلاً: 10 أصناف كحد أقصى لكل طلب)
• التحكم في تعقيد المستند
• إدارة قيود الطباعة والعرض

5. إدارة اتساق المحددات (Dimension Consistency Management)

فهم المحددات (Understanding Dimensions)

في أنظمة ERP، تمثل المحددات الهياكل التنظيمية:

• الفرع (Branch): المواقع المادية أو وحدات الأعمال
• القسم (Department): الأقسام الوظيفية
• الشركة (Legal Entity): شركات قانونية منفصلة
• مجموعة التحليل (Analysis Set): تجميعات تحليلية مخصصة

قواعد اتساق المحددات (dimensionsConsistency)

المجموعة: تجاهل تناسق المحددات لحقول (Ignore Dimensions Consistency for Fields) السلوك الافتراضي: يفرض النظام اتساق المحددات، مما يضمن أن جميع البيانات المرتبطة تنتمي إلى نفس الوحدة التنظيمية.

خيارات التجاوز:

• تجاهل الفرع (Ignore Branch): السماح بالمعاملات عبر الفروع
• تجاهل القسم (Ignore Department): تمكين العمليات بين الأقسام
• تجاهل الشركة (Ignore Legal Entity): السماح بالمعاملات بين الشركات
• تجاهل مجموعة التحليل (Ignore Analysis Set): تخطي فحوصات الاتساق التحليلي
• السماح بالمسودات (Allow Drafts): تضمين المستندات المسودة في المراجع

سيناريوهات الأعمال:

• تحويلات المخزون عبر الفروع
• الخدمات المشتركة عبر الأقسام
• القروض والتحويلات بين الشركات
• متطلبات إعداد التقارير الموحدة

6. ضوابط حالة الحقل وسلوكه (Field State and Behavior Controls)

الحقول المعطلة (disabledFields)

المجموعة: Disabled Fields المفهوم: جعل حقول محددة للقراءة فقط أو معطلة في واجهة المستخدم.

الإعداد:

• للنوع (For Type): تطبيق على نوع كيان محدد
• قائمة الكيانات (Entity List): تطبيق على أنواع كيانات متعددة
• معرّف الحقل (Field ID): الحقل المراد تعطيله

حالات الاستخدام:

• منع تعديل الحقول المحسوبة
• قفل القيم المولدة من النظام
• حماية البيانات الحرجة من التعديل غير المقصود

السماح باستعمال السجلات الممنوعة (allowUsageOfPreventedRecords)

المجموعة: السماح باستعمال السجلات الممنوعة من الاستعمال (Allow Usage Of Prevented Records) المفهوم: تجاوز منع النظام لاستخدام سجلات معينة تكون محجوبة عادةً (السجلات التي تحتوي على الحقل preventUsage = true).

كيفية العمل: عندما تُوضَع علامة على السجلات بوصفها ممنوعة من الاستخدام، لا يسمح النظام عادةً باختيارها في حقول المرجع. يتيح هذا الإعداد استثناءات محددة.

حالات الاستخدام:

• السماح باختيار الأصناف غير النشطة للتقارير التاريخية
• السماح للعملاء المحجوبين بعمليات محددة
• تمكين العقود المنتهية لأغراض المرجع
• السماح بالمستندات المسودة في مسارات عمل معينة

الحقول التي ليست حقول ألوان (notColorFields)

المجموعة: ليست حقول ألوان (Not Color Fields) المفهوم: منع معاملة حقول محددة كحقول ألوان، حتى لو كانت تحتوي على قيم تشبه الألوان.

الغرض: قد تحتوي بعض حقول النص على قيم تبدو ككودات ألوان (مثلاً "#123456") لكن لا ينبغي عرضها كألوان.

7. سلوكيات الحقول المتقدمة (Advanced Field Behaviors)

حقول النص المنسق (richTextFields)

المجموعة: Rich Text Fields

المفهوم: تمكين تحرير النص المنسق (عريض، مائل، نقاط، إلخ) لحقول نصية محددة.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" - نوع الكيان الهدف
• fieldID (FieldID) → "الحقل" - حقل BigText المراد تحسينه

متطلبات نوع الحقل

الحقول المتوافقة: حقول BigText فقط

وظيفة النص المنسق مصممة تحديداً لحقول النص الكبيرة التي يمكنها استيعاب المحتوى المنسق.

حالات الاستخدام:

• أوصاف المنتجات بتنسيق
• بنود العقود مع التأكيد
• قوالب البريد الإلكتروني بالتنسيق
• روايات التقارير بالهيكل

حقول التوقيع (signatures)

المجموعة: Signatures

المفهوم: تحويل حقول المرفقات لعرض أيقونات التوقيع بدلاً من أيقونات الرفع القياسية، مما يتيح التقاط التوقيعات الرقمية.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" - نوع الكيان الهدف
• fieldID (FieldID) → "الحقل" - حقل Binary/Attachment للتوقيعات

متطلبات نوع الحقل

الحقول المتوافقة: حقول Binary/Attachment فقط

يُصفِّي النظام تلقائياً اقتراحات الحقول لإظهار الحقول الثنائية فقط عند إعداد وظيفة التوقيع.

كيفية العمل: عند الإعداد، تظهر حقول المرفقات بزر توقيع. يؤدي النقر على هذا الزر إلى فتح لوحة رسم حيث يمكن للمستخدمين:

• التوقيع بشاشة اللمس: التوقيع باستخدام الإصبع أو القلم على الأجهزة التي تدعم اللمس
• التوقيع بالماوس: رسم التوقيعات باستخدام الماوس على أجهزة سطح المكتب
• تكامل جهاز ePad Ink: التقاط التوقيعات باستخدام أجهزة لوحة توقيع متخصصة بإدخال القلم

التكامل التقني: يدعم أجهزة ePad Ink وهي أجهزة احترافية لالتقاط التوقيعات تُستخدم في بيئات البيع بالتجزئة والبنوك ومعالجة المستندات.

حالات الاستخدام:

• توقيعات الموافقة على العقود
• توقيعات تأكيد التسليم
• موافقات التفويض
• إقرارات المستندات القانونية
• نماذج موافقة العملاء

تكامل الماسح الضوئي (useScannerInFields)

المجموعة: Use Scanner In Fields المفهوم: إعداد حقول المرفقات لدعم المسح المباشر للمستندات من أجهزة الماسح الضوئي المتصلة أو الطابعات متعددة الوظائف ذات قدرة المسح.

متطلبات نوع الحقل

الحقول المتوافقة: حقول Binary/Attachment فقط

مثل حقول التوقيع، يقتصر تكامل الماسح الضوئي على أنواع الحقول الثنائية للتخزين الصحيح للمستندات.

كيفية العمل: عند تطبيقه على حقول المرفقات، يتيح هذا:

• المسح المباشر إلى الحقل: مسح المستندات مباشرةً إلى حقول المرفقات
• تكامل جهاز الماسح الضوئي: يعمل مع أجهزة مسح المستندات المتصلة
• مجموعات الطابعة-الماسح: يدعم الأجهزة متعددة الوظائف ذات قدرات المسح
• إنشاء ملف تلقائي: تُحفظ المستندات الممسوحة تلقائياً كمرفقات

المتطلبات التقنية:

• أجهزة ماسح ضوئي متوافقة متصلة بالنظام
• برامج تشغيل الماسح الضوئي مثبتة بشكل صحيح
• طابعات متعددة الوظائف متصلة بالشبكة مع قدرات المسح إلى مجلد

حالات الاستخدام:

• مسح الفواتير مباشرةً إلى مرفقات أوامر الشراء
• التقاط وثائق الهوية أثناء تسجيل العملاء
• رقمنة العقود الورقية والاتفاقيات
• أرشفة الإيصالات المادية والوثائق
• تبسيط عمليات سير مستندات العمل

8. إدارة حقول الكود (Code Fields Management)

حقول كود إضافية (extraCodes)

المجموعة: Extra Codes المفهوم: تعيين حقول إضافية لتعمل كحقول كود جنباً إلى جنب مع حقل الكود الأساسي.

كيفية العمل: في Nama ERP، تمتلك الكيانات عادةً حقل "كود" أساسياً واحداً للتعريف الفريد. تتيح لك هذه الميزة تعيين حقول أخرى لتعمل أيضاً ككودات، مما يتيح معرّفات فريدة متعددة أو مفاتيح بحث بديلة.

الإعداد:

• للنوع (For Type): نوع كيان محدد
• لقائمة الأنواع (For Type List): أنواع كيانات متعددة
• مطبق على (Applicable For): استخدام قواعد قابلية التطبيق المحددة مسبقاً (جميع الشاشات، المستندات، الملفات الأساسية)
• معرّف الحقل (Field ID): الحقل المراد معاملته ككود إضافي

حالات الاستخدام:

• إضافة حقل الباركود ككود صنف بديل
• استخدام رقم الموظف ككود إضافي بجانب معرّف الموظف
• إنشاء حقل SKU كمعرف منتج ثانوي
• إضافة رقم التسجيل الضريبي ككود عميل إضافي
• تمكين أنظمة ترقيم مرجعي متعددة

الفوائد:

• البحث بمعرّفات فريدة متعددة
• دعم أنظمة الترقيم القديمة
• تمكين معايير الترميز الخاصة بالصناعة
• تسهيل التكامل مع الأنظمة الخارجية

حقول التدقيق التفصيلي (auditFields)

المجموعة: Audit Fields المفهوم: تمكين تتبع التدقيق التفصيلي لحقول محددة، مع تسجيل كل تغيير بطابع زمني ومعلومات المستخدم.

كيفية العمل: بينما يتتبع النظام معلومات التدقيق القياسية (تاريخ ومنشئ/معدِّل السجل)، تتيح هذه الميزة مسارات تدقيق تفصيلية على مستوى الحقل للبيانات الحرجة.

الإعداد:

• للنوع (For Type): نوع كيان محدد
• لقائمة الأنواع (For Type List): أنواع كيانات متعددة
• مطبق على (Applicable For): قواعد النطاق المحددة مسبقاً
• معرّف الحقل (Field ID): الحقل المراد تتبعه بالتفصيل

المعلومات المتتبعة:

• القيمة القديمة والقيمة الجديدة
• المستخدم الذي أجرى التغيير
• الطابع الزمني الدقيق للتغيير

حالات الاستخدام:

• تتبع تغييرات الأسعار على الأصناف
• مراقبة تعديلات حد الائتمان
• تدقيق تغييرات حالة الموافقة
• تسجيل تعديلات البيانات الحساسة
• الحفاظ على مسارات تدقيق الامتثال

9. تحسين البحث والمرجع (Search and Reference Enhancement)

واصفات المرجع (descriptors)

المجموعة: Descriptors المفهوم: تخصيص كيفية ظهور سجلات الكيانات في نتائج البحث والقوائم المنسدلة.

أنواع الواصفات:

• البحث فقط (Search Only): عرض مخصص في نتائج البحث
• العنوان فقط (Title Only): عرض مخصص في رؤوس الحقول
• البحث والعنوان (Search and Title): كلا السياقين

الإعداد:

• واصف عربي (Arabic Descriptor): تنسيق مخصص للعرض بالعربية
• واصف إنجليزي (English Descriptor): تنسيق مخصص للعرض بالإنجليزية
• عناصر نائبة للحقول (Field Placeholders): استخدام صيغة {fieldName} لتضمين قيم ديناميكية

مثال: {code} - {name} ({branch}) يظهر كـ "CUST001 - ABC Company (Branch A)"

حقول البحث الإضافية في المرجع (extraReferenceSearchFields)

المجموعة: حقول البحث الإضافية عند البحث عن مرجع (Extra Reference Search Fields) المفهوم: تضمين حقول إضافية في عمليات بحث حقل المرجع تتخطى الكود والاسم القياسيين.

الفوائد:

• البحث برقم الهاتف في عمليات بحث العملاء
• إيجاد الأصناف بالباركود أو الأكواد البديلة
• تحديد موقع الموظفين برقم الموظف أو القسم
• البحث في المستندات بالأرقام المرجعية

الإعداد:

• معرّف الحقل (Field ID): حقل إضافي للبحث فيه
• معامل البحث (Search Operator): طريقة المطابقة (يحتوي، يساوي، يبدأ بـ)

البحث في الاسم عند إيجاد الكود (searchInNameInFindByCode)

المجموعة: البحث في الأسم العربى والانجليزى عند كتابة كود ملف (Search In Name In Find By Code) المفهوم: عندما يبحث المستخدمون بالكود، يبحث النظام أيضاً في حقل الاسم عن تطابقات.

حالة الاستخدام: يكتب المستخدم "ABC" متوقعاً إيجاد "ABC Company" رغم أن الكود هو "CUST001"

10. ضوابط الاستعلام والعرض المتقدمة (Advanced Query and Display Controls)

حقول الشاشة القائمة على الاستعلام (queryBasedScreenField)

المجموعة: استعلامات الحقول المحسوبة (Calculated Fields Queries)

المفهوم: إنشاء حقول ديناميكية محسوبة تنفذ استعلامات لعرض قيم مجمعة أو محسوبة.

كيفية العمل: تعريف ما يصل إلى 20 حقلاً مختلفاً قائماً على الاستعلام تنفذ استعلامات SQL وتعرض النتائج في شاشات الكيانات. يتم حساب هذه الحقول في الوقت الفعلي بناءً على البيانات الحالية.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" (For Type) - نوع الكيان الهدف
• forTypeList (EntityTypeList) → "لقوائم أنواع" (For Type List) - أنواع كيانات متعددة
• detailField (FieldID) → "معرف السطور" (Detail Field) - الحقل لسياق سطر التفاصيل
• field1Query-field20Query (BigText) → "استعلام الحقل المحسوب 1-20" (Field Query 1-20) - استعلامات SQL للحقول المحسوبة (حتى 20)

الإعداد:

• للنوع/لقائمة الأنواع: أنواع الكيانات التي تظهر فيها الحقول
• حقل التفاصيل (Detail Field): إذا كان العرض في سطور التفاصيل
• استعلام الحقل (1-20): استعلامات SQL لكل حقل ديناميكي

قدرات الاستعلام:

• دوال التجميع (SUM، COUNT، AVG، MIN، MAX)
• عمليات بحث الكيانات المرتبطة
• الحسابات الشرطية
• الربط عبر الجداول
• الحسابات القائمة على التاريخ

حالات الاستخدام:

• عرض إجمالي الرصيد المستحق للعميل
• عرض المخزون الحالي للصنف عبر جميع المخازن
• حساب أيام الإجازة المتراكمة للموظف
• عرض نسبة التقدم في الموافقة على المستند
• عرض عدد المعاملات المرتبطة

الفلاتر الإضافية للحقل (extraFilter)

المجموعة: Extra Filter المفهوم: تطبيق معايير تصفية إضافية على عمليات بحث حقل المرجع بناءً على شروط ديناميكية.

كيفية العمل: عندما يفتح المستخدمون بحث حقل مرجع، تُطبَّق فلاتر إضافية لتقييد الخيارات المتاحة بناءً على المعايير المحددة.

الإعداد:

• للنوع (For Type): نوع الكيان الذي يحتوي على الحقل
• قائمة الكيانات (Entity List): أنواع كيانات متعددة
• معرّف الحقل (Field ID): حقل المرجع المراد تصفيته
• تعريف المعايير (Criteria Definition): قواعد التصفية المطبقة
• النوع المصفى (Filtered Type): نوع الكيان الذي يتم تصفيته

أمثلة على الفلاتر:

• عرض الأصناف من فئات محددة فقط
• عرض العملاء الذين لديهم رصيد متاح
• إدراج الموظفين في الأقسام النشطة
• عرض المستندات ضمن نطاق تاريخي
• تصفية الموردين حسب شروط الدفع

متجاوز نمط الصف (styleOverriderLines)

المجموعة: Style Overrider Details المفهوم: تطبيق ألوان خلفية ديناميكية على صفوف كاملة في الشبكات والقوائم بناءً على نتائج الاستعلام.

كيفية العمل: تنفيذ استعلام لكل صف يعيد قيمة لون، تُطبَّق بعد ذلك كلون خلفية الصف.

الإعداد:

• للنوع (For Type): نوع الكيان للشبكة
• قائمة الكيانات (Entity List): أنواع كيانات متعددة
• معرّف الحقل (Field ID): سياق حقل محدد (اختياري)
• استعلام لون خلفية الصف: استعلام يعيد قيمة لون

حالات الاستخدام:

• إبراز الفواتير المتأخرة باللون الأحمر
• عرض الطلبات ذات الأولوية باللون الأصفر
• عرض الأصناف الملغاة باللون الرمادي
• تمييز عملاء VIP باللون الذهبي
• الإشارة إلى المهام العاجلة باللون البرتقالي

11. إدارة المستندات والسجلات (Document and Record Management)

معالجة حقول النسخ المماثل (lines)

المجموعة: Clear On Duplicate المفهوم: تحديد الحقول التي يجب مسحها عند إنشاء نسخة مماثلة من مستند.

كيفية العمل: عندما يختار مستخدم "نسخة مماثلة" على مستند، يمسح النظام الحقول المحددة مع الاحتفاظ بالأخرى.

الأنماط الشائعة:

• مسح أرقام المستندات والتواريخ
• الاحتفاظ بتفاصيل العميل وأصناف السطور
• إعادة تعيين حالات الموافقة
• مسح الأرقام المرجعية

الفتح في نافذة منبثقة (openInPopups)

المجموعة: Open Reference In Popup المفهوم: إجبار أنواع كيانات محددة على الفتح في نوافذ منبثقة بدلاً من التنقل بالشاشة الكاملة.

الفوائد:

• عمليات بحث مرجعية أسرع
• الحفاظ على السياق في الشاشة الأصلية
• تحسين كفاءة سير عمل المستخدم
• تقليل تعقيد التنقل بين الشاشات

حقول الإنشاء المفتوح (openCreateFields)

المجموعة: الحقول التي يتم فتح الإنشاء عند ادخال كود غير موجود (Fields that open Edit Screen when code not found) المفهوم: تمكين المستخدمين من إنشاء سجلات جديدة مباشرةً من عمليات بحث حقل المرجع.

مسار العمل: يبدأ المستخدم الكتابة في حقل مرجع، فإذا لم يُعثَر على تطابق، يعرض النظام إنشاء سجل جديد بالقيمة المكتوبة كنقطة بداية.

حقول النص المحوَّلة إلى روابط (textToLinkFields)

المجموعة: الحقول النصية المحوله الي روابط (Text To Link Fields) المفهوم: تحويل حقول النص إلى روابط تشعبية قابلة للنقر بأنواع روابط مختلفة.

الإعداد:

• للنوع (For Type): نوع كيان محدد
• قائمة الكيانات (Entity List): أنواع كيانات متعددة
• معرّف الحقل (Field ID): حقل النص المراد تحويله
• نوع الرابط (Link Type): نوع الرابط (URL، بريد إلكتروني، هاتف، WhatsApp، إلخ)

أنواع الروابط المتاحة:

• URL: فتح عناوين الويب
• بريد إلكتروني (Email): فتح عميل البريد الإلكتروني بـ mailto:
• هاتف (Phone): إجراء مكالمات هاتفية على الأجهزة المحمولة
• واتساب (WhatsApp): فتح WhatsApp برقم مملوء مسبقاً
• تنقل داخلي (Internal Navigation): روابط لكيانات أخرى في النظام

حالات الاستخدام:

• جعل حقول الموقع الإلكتروني قابلة للنقر
• تمكين النقر للإرسال بالبريد الإلكتروني لعناوين البريد
• إنشاء النقر للاتصال لأرقام الهاتف
• الربط بالمستندات ذات الصلة
• الاتصال بأنظمة التتبع الخارجية

12. تخطيط الشاشة ومكونات واجهة المستخدم (Layout and UI Components)

إضافة نقاش (addDiscussionTo)

المجموعة: إضافة النقاش إلي (Add Discussion To)

المفهوم: إضافة أقسام نقاش/تعليقات إلى شاشات الكيانات حيث لا تكون موجودة بشكل افتراضي.

كيفية العمل: يُدخِل لوحة نقاش في تخطيطات الكيانات، مما يتيح للمستخدمين إضافة تعليقات وملاحظات ونقاشات متسلسلة.

الإعداد التقني

الحقول الرئيسية:

• forType (EntityType) → "للنوع" (For Type) - نوع الكيان الهدف للوحة النقاش
• forTypeList (EntityTypeList) → "لقوائم أنواع" (For Type List) - أنواع كيانات متعددة
• addToPage → "إضافة إلي صفحة" (Add To Page) - الصفحة/التبويب الذي يجب إضافة لوحة النقاش إليه
• insertAt (Integer) → "إضافة في" (Insert At) - ترتيب الموضع في التخطيط
• applicableFor → "مطبق على" (Applicable For) - قواعد النطاق

الإعداد:

• للنوع/لقائمة الأنواع: أنواع الكيانات الهدف
• مطبق على (Applicable For): قواعد النطاق
• إضافة إلى صفحة (Add To Page): أي صفحة/تبويب لإضافة لوحة النقاش
• إضافة في (Insert At): الموضع في التخطيط (رقم الترتيب)

الميزات:

• نقاشات متسلسلة
• مرفقات ملفات في التعليقات
• تتبع الطابع الزمني والمستخدم

حالات الاستخدام:

• إضافة تعليقات إلى سجلات البيانات الأساسية
• تمكين النقاشات على كيانات الإعداد
• إنشاء قسم ملاحظات للأصناف
• إضافة سلاسل تواصل إلى المستندات
• تمكين التعاون الجماعي على المشاريع

إضافة مستندات ذات صلة (addRelatedDocumentsTo)

المجموعة: إضافة المستندات المرتبطة إلى (Add Related Documents To) المفهوم: إضافة قسم مستندات ذات صلة إلى شاشات الكيانات لإدارة المستندات.

الإعداد:

• للنوع/لقائمة الأنواع: أنواع الكيانات الهدف
• مطبق على (Applicable For): قواعد النطاق
• إضافة إلى صفحة (Add To Page): أي صفحة/تبويب لإضافة اللوحة
• إضافة في (Insert At): الموضع في التخطيط

13. دعم التكامل والأنظمة الخارجية (Integration and External System Support)

الكيانات العامة (publicEntitiesLines)

المجموعة: Public Entities المفهوم: إجبار سجلات محددة على تعيين جميع محدداتها كعامة، متجاوزةً القيود البعدية العادية.

كيفية العمل: عادةً، عندما يسجل مستخدم دخوله إلى شركة أو فرع محدد، يمكنه فقط تعديل أو إنشاء سجلات ضمن نطاق ذلك المحدد. يزيل هذا الإعداد تلك القيود لأنواع الكيانات المحددة.

السلوك الافتراضي: يقتصر المستخدمون على محدداتهم المعيّنة (الشركة، الفرع، القسم، إلخ)

تأثير التجاوز: تصبح السجلات قابلة للوصول والتعديل عبر جميع المحددات، بصرف النظر عن القيود البعدية المعيّنة للمستخدم

حالات الاستخدام:

• البيانات الأساسية المشتركة (كدليل الحسابات) المتاحة لجميع الفروع
• السياسات والإجراءات على مستوى الشركة
• كيانات إعداد النظام التي تحتاج إلى وصول عالمي
• البيانات المرجعية المستخدمة عبر شركات قانونية متعددة
• كتالوجات الأصناف الشائعة المشتركة عبر جميع المواقع

اعتبارات الأمان: استخدم بحذر إذ يتجاوز هذا حدود الأمان المهمة التي أنشأها الهيكل البعدي

إعداد المكامل (integratorConfig)

المجموعة: Integrator Config المفهوم: إعداد نقاط نهاية REST API لإنشاء وتحديث الكيانات من خلال عمليات التكامل الخارجية.

كيفية العمل: يحدد كيفية إرسال الأنظمة الخارجية للبيانات لإنشاء أو تحديث السجلات، مع تعيين الحقول وقوالب الاستجابة.

الإعداد:

• النوع المُنشأ (Created Type): نوع الكيان المراد إنشاؤه
• معامل النوع المُنشأ (Created Type Param): معامل النوع الديناميكي
• استعلام البحث (Finder Query): استعلام للعثور على السجلات الموجودة للتحديثات
• خريطة الحقول (Fields Map): تعيين JSON للحقول الخارجية إلى الداخلية
• قالب الاستجابة (Response Template): تنسيق استجابة مخصص
• إغلاق نافذة المتصفح (Close Browser Window): إغلاق تلقائي بعد الإتمام
• تشغيل مسار الكيان (Run Entity Flow): تنفيذ مسار العمل بعد الإنشاء
• تصدير المكامل (Export Integrator): إتاحة للتصدير
• إنشاء فقط (Create Only): منع التحديثات، السماح بالإنشاء فقط

حالات الاستخدام:

• تكامل منصة التجارة الإلكترونية
• مزامنة CRM خارجي
• تقديم بيانات تطبيق الجوال
• تكامل نظام الشريك
• استيراد البيانات الآلي

مكامل الاستيراد (importIntegratorLines)

المجموعة: Import Integrators المفهوم: إعداد كيفية استيراد البيانات الخارجية وتعيينها لكيانات داخلية.

معرّفات المكامل المحددة مسبقاً

مكاملات النظام: يتضمن النظام إعدادات مكامل محددة مسبقاً:

• MAGSaveOrder - معالجة طلبات Magento
• lastEcommerceSyncTime - توقيت مزامنة التجارة الإلكترونية
• lastEcommerceOrderId - تكامل تتبع الطلبات
• vacbal - استيراد رصيد الإجازات
• shipordstatus - تحديثات حالة طلب الشحن
• assetTimes - تتبع أوقات الأصول
• assetTimesWithSlots - جدولة الأصول مع فتحات زمنية

الإعداد التلقائي: عند اختيار معرف مكامل، يطبق النظام تلقائياً الإعدادات الافتراضية:

• نوع الاستيراد: JSON
• إضافة سجل: مفعّل
• تحديث سجل: مفعّل
• المتابعة عند الأخطاء: مفعّلة
• قطع المسافات الزائدة: مفعّل

الميزات:

• قواعد تعيين الحقول
• منطق تحويل البيانات
• متطلبات التحقق
• إجراءات معالجة الأخطاء

أنواع مرسلي البريد الإلكتروني (emailSendToTypes)

المجموعة: أنواع المراجع في نافذة ارسال بريد الكترونى (Email Send To Types) المفهوم: إعداد أنواع الكيانات التي يمكن اختيارها كمستلمي بريد إلكتروني لحقول بريد إلكتروني محددة.

أنواع حقول البريد الإلكتروني المحددة مسبقاً

حقول البريد الإلكتروني المتاحة: يدعم النظام أنواع حقول بريد إلكتروني محددة مسبقاً:

• to1, to2, to3 - المستلمون الأساسيون
• cc1, cc2, cc3 - مستلمو النسخة الكربونية

اقتراحات ذكية: تُصفَّى اقتراحات معرّف الحقل تلقائياً لإظهار أنواع حقول البريد الإلكتروني المحددة مسبقاً فقط.

الإعداد:

• معرّف الحقل (Field ID): حقل البريد الإلكتروني الذي يتم إعداده (من القائمة المحددة مسبقاً)
• أنواع الكيانات (1-5): حتى 5 أنواع كيانات يمكنها أن تكون مستلمي بريد إلكتروني
• نوع الإرسال (Send Type): كيفية إرسال الرسائل (To، CC، BCC)

حالات الاستخدام:

• إعداد إشعارات بريد عملاء
• إعداد حقول تواصل الموظفين
• تعريف قواعد مراسلة الموردين
• إنشاء حقول بريد متعددة الأطراف
• التحكم في قوائم توزيع البريد

سطور استرداد الفواتير (invoiceRetrieverLines)

المجموعة: Invoice Retriever Lines المفهوم: إعداد إنشاء المستندات واستردادها تلقائياً للكيانات.

كيفية العمل: ينشئ تلقائياً مستندات (فواتير، تقارير، إلخ) عند إنشاء الكيانات أو تعديلها، مخزِّناً إياها في مواقع محددة.

الإعداد:

• تعريف التقرير (Report Definition): قالب التقرير المستخدَم
• حفظ الملفات في المجلد (Save Files In Folder): موقع نظام الملفات للمستندات المنشأة
• بادئة URL (URL Prefix): بادئة URL للوصول عبر الويب
• تنسيق الإخراج (Output Format): PDF، DOCX، XLSX، ODS، ODT
• عدم التخزين المؤقت (Do Not Cache): تعطيل التخزين المؤقت للمحتوى الديناميكي

حالات الاستخدام:

• إنشاء الفواتير تلقائياً عند إتمام البيع
• إنشاء تأكيدات الطلبات تلقائياً
• إنشاء الشهادات عند الموافقة
• إنتاج مستندات الشحن
• إنشاء تقارير الامتثال

14. الترميز والترقيم التلقائي (Auto-Coding and Numbering)

الترميز التلقائي (autoCodingLines)

المجموعة: التكويد الالي للملفات (Files Auto Coding) المفهوم: إنشاء أكواد تلقائية للسجلات الجديدة بناءً على أنماط قابلة للإعداد.

تكامل تعريف المعايير

التصفية الذكية لنوع الكيان: يوفر النظام تصفية ذكية لتعريفات المعايير:

• تُصفَّى تعريفات المعايير لإظهار تلك المطبقة على نوع/أنواع الكيانات المحددة فقط
• عند اختيار تعريف معايير، يملأ النظام تلقائياً حقل نوع الكيان
• يدعم أنواع الكيانات المفردة وقوائم أنواع الكيانات
• العلاقة ثنائية الاتجاه تضمن الاتساق بين المعايير وأنواع الكيانات

التطبيق التقني: يستخدم DTOCriteriaBuilder لإنشاء معايير مصفاة بناءً على سياق نوع الكيان.

صيغة النمط:

• {valueDate.year}: السنة بأربعة أرقام
• {valueDate.month}: الشهر برقمين
• {branch.code}: كود فرع السجل

أمثلة:

• الفاتورة: INV-{valueDate.year}- → "INV-2024-000001"
• أمر الشراء: PO-{branch.code}-{fiscalPeriod.shortCode}- → "PO-HQ-2503-0001"

15. ميزات تكامل النظام والمستودع (System Integration and Repository Features)

تكامل مستودع التطبيق (Implementation Repository Integration)

المفهوم: دمج الإعدادات مع نظام مستودع التطبيق للإدارة المركزية.

حقول المستودع

حقول تكامل النظام:

• saveToImplRepo (Boolean) → "الحفظ في كتالوج التجهيز" - حفظ الإعداد في مستودع التطبيق
• systemReport (Boolean) → "نظامي" - تمييز كإعداد تقرير على مستوى النظام
• implRepo (Reference) → "كتالوج التجهيز" - مرجع لكيان ImplementationRepository
• screenshot (Binary) - وثائق بصرية للإعداد
• pdfSample (Binary) - نموذج PDF للمرجع
• attachment1-5 (Binary) - مرفقات وثائق إضافية
• relatedEntity1-2 (Text) - مراجع الكيانات المرتبطة
• relatedToModule1-2 (Text) - تتبع ارتباط الوحدة
• selectedColor (Color) → "اللون المختار" - اللون المختار لتصميم واجهة المستخدم