أداة إنشاء التقارير (ReportWizard) - دليل المستخدم

دليل شامل لإنشاء التقارير وإدارتها

---

مقدمة

أداة إنشاء التقارير (ReportWizard) هي أداة قوية لتوليد التقارير ضمن نظام Nama ERP، تتيح للمستخدمين إنشاء تقارير احترافية غنية بالبيانات دون كتابة أي أكواد. تُنتج مخرجات مبنية على JasperReports مع خيارات تخصيص واسعة لاستخراج البيانات وتنسيقها وعرضها.

معلومات الكيان

• نوع الكيان: ReportWizard
• الاسم العربي: أداة إنشاء تقرير
• الاسم الإنجليزي: Report Wizard
• تصنيف الكيان: ملف رئيسي
• جدول قاعدة البيانات: ReportWizard

نظرة عامة على بنية الكيان

يحتوي كيان ReportWizard على 32 مجموعة تفصيلية لتكوين التقارير بشكل شامل:

المجموعة	الاسم العربي	الاسم الإنجليزي	الغرض
fields	الحقول	Fields	تعريفات حقول التقرير وتنسيقها
parameters	المدخلات	Parameters	مدخلات المستخدم لتصفية التقارير
group1Lines - group5Lines	سطور المجموعة 1-5	Group 1-5 Lines	إعداد التجميع الهرمي بخمسة مستويات
crosstabColumns	الأعمدة	Columns	حقول الأبعاد الأفقية للجدول المحوري
crosstabRows	الصفوف	Rows	حقول الأبعاد الرأسية للجدول المحوري
crosstabMeasures	المعادلات	Measures	حقول القيم المجمّعة للجدول المحوري
dataSource1FilterLines - dataSource5FilterLines	سطور الفلترة لمصدر البيانات 1-5	Data Source 1-5 Filter Lines	تصفية بيانات متعددة المصادر
conditionalStyleLines1 - conditionalStyleLines5	جدول التنسيق الشرطي 1-5	Conditional Style 1-5 Lines	قواعد التنسيق الديناميكي
securityConstraints	Security Constraints	Security Constraints	إعداد الأمان على مستوى الصفوف
includeTablesByParameters	تضمين الجداول بشرط من خلال مدخلات	Include Tables By Parameters	تضمين الجداول بشكل ديناميكي

المزايا الرئيسية

• لا حاجة لـ SQL: اختَر الكيانات والحقول من خلال واجهة بديهية
• دعم متعدد اللغات: دعم كامل للعربية والإنجليزية في كل مكان
• معاينة فورية: شاهد التغييرات فور إجرائها
• قوالب قابلة للإعادة: احفظ إعدادات التقارير وانسخها
• أمان على مستوى المؤسسة: أمان مدمج على مستوى الصفوف والحقول
• تنسيقات مخرجات متعددة: PDF وExcel وHTML والطباعة المباشرة

أنواع التقارير المدعومة

• قوائم قياسية: تقارير جدولية بسيطة مع التصفية والترتيب
• تقارير مجمّعة: تقارير هرمية متعددة المستويات مع المجاميع الفرعية
• تقارير Crosstab/Pivot: تحليل متعدد الأبعاد بتجميع الصفوف والأعمدة
• تقارير رئيسية-تفصيلية: علاقات بين الأب والابن مع بيانات متداخلة
• تقارير إحصائية: تجميعات وحسابات وملخصات
• خطابات نموذجية: توليد مستندات بقوالب خلفية
• تقارير لوحة المعلومات: عرض مؤشرات الأداء الرئيسية والمقاييس

---

البدء

إنشاء تقرير جديد

1. الوصول إلى أداة إنشاء التقارير

   • انتقل إلى Basic → Reports → Report Wizard
   • انقر على "جديد" لإنشاء تقرير جديد
   • أو انسخ تقريراً موجوداً باستخدام "نسخ الإعداد من تقرير"

2. الإعداد الأساسي

   • الكود: معرّف فريد للتقرير (مثال: "SALES_MONTHLY_001")
   • الاسم: الاسم المعروض في قوائم التقارير
   • مجموعة التقارير: تصنيف لتنظيم التقارير
   • العنوان العربي: عنوان التقرير بالعربية
   • العنوان الإنجليزي: عنوان التقرير بالإنجليزية

3. اختيار طريقة التخطيط

   • Standard: تخطيط عمودي تقليدي
   • Crosstab: تنسيق جدول محوري
   • Custom: تخطيطات متقدمة بإعداد يدوي

إعداد الصفحة

خيارات تنسيق الصفحة

• A4 (210 × 297 مم): المقاس الدولي القياسي
• Letter (8.5 × 11 بوصة): المعيار الأمريكي الشمالي
• Legal (8.5 × 14 بوصة): مستندات ذات طول ممتد
• Custom: حدّد العرض والارتفاع بالمليمتر

اتجاه الصفحة

• Portrait: اتجاه رأسي (الطول أكبر من العرض)
• Landscape: اتجاه أفقي (العرض أكبر من الطول)

ضبط الهوامش

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

ارتفاعات الأشرطة

الأشرطة هي أقسام التقرير التي تظهر في مواضع محددة:

• ارتفاع شريط العنوان: رأس مرة واحدة في بداية التقرير (الافتراضي: 50px)
• ارتفاع شريط رأس الصفحة: يتكرر في أعلى كل صفحة (الافتراضي: 30px)
• ارتفاع شريط رأس العمود: رؤوس الجداول (الافتراضي: 30px)
• ارتفاع شريط التفاصيل: صفوف البيانات (الافتراضي: 20px)
• ارتفاع شريط تذييل الصفحة: يتكرر في أسفل كل صفحة (الافتراضي: 30px)
• ارتفاع شريط تذييل الصفحة الأخيرة: تذييل خاص بالصفحة الأخيرة فقط
• ارتفاع شريط الملخص: قسم إجماليات التقرير (الافتراضي: 30px)

---

إعداد مصدر البيانات

اختيار الجدول الرئيسي

الجدول الرئيسي هو مصدر البيانات الأساسي للتقرير:

1. اختيار نوع الجدول

   • Entity: كائنات العمل (Customer وInvoice وProduct وغيرها)
   • SQL View: views محددة مسبقاً في قاعدة البيانات
   • Custom Query: اكتب SQL خاصاً بك (للمستخدمين المتقدمين)

2. متصفح الكيانات

   • البحث باسم الكيان أو كوده
   • التصفية حسب الوحدة (Accounting وCRM وHR وغيرها)
   • عرض أوصاف الكيانات وعدد الحقول
   • التحقق من التوافق مع POS عند الحاجة

جداول الدمج - Union Tables (دمج مصادر متعددة)

تتيح لك جداول الدمج الجمع بين بيانات كيانات متشابهة متعددة تخدم أغراضاً مختلفة أو تأتي من أنظمة مختلفة في تقرير موحد واحد.

متى تستخدم جداول الدمج

• الحسابات الصافية: دمج المعاملات الموجبة والسالبة (مثال: فواتير المبيعات + مردودات المبيعات للحصول على صافي المبيعات)
• المستندات متعددة المصادر: دمج مستندات مشابهة من أنظمة مختلفة (مثال: SalesInvoice + NamaPOSSalesInvoice)
• توحيد المدفوعات: دمج أنواع مدفوعات مختلفة (مثال: ReceiptVoucher + BankTransfers)
• التقارير عبر الأنظمة: توحيد بيانات من عمليات تجارية متعددة في عرض واحد
• تجميع أنواع المستندات: دمج أنواع مستندات متنوعة تتشارك معنى تجارياً مماثلاً

كيف تعمل جداول الدمج

1. تعيين الحقول: يعيّن النظام الحقول المقابلة بين الجداول
2. مرونة الأعمدة: إذا اختلفت أسماء الأعمدة يمكنك تحديد العمود من كل جدول الذي يتوافق مع حقل التقرير
3. معالجة الدمج (Union Handling): تطبيق تحويلات لتمييز أو تعديل بيانات كل مصدر

خطوات الإعداد

1. أضف جداول الدمج في قسم "Union Tables"
2. عيّن الحقول بين الجداول (تلقائي عند تطابق الأسماء، يدوي عند الاختلاف)
3. اضبط تعبيرات "Union Handling" لتحويل البيانات لكل مصدر
4. اختبر مجموعة النتائج المدمجة

مثال 1: تقرير صافي المبيعات

Main Table: SalesInvoice
Union Table: SalesReturn
Union Handling:
  - SalesInvoice: إبقاء الكميات موجبة
  - SalesReturn: جعل الكميات سالبة
النتيجة: صافي المبيعات مع خصم المردودات تلقائياً

مثال 2: مبيعات موحدة من أنظمة متعددة

Main Table: SalesInvoice (المبيعات العادية)
Union Table: NamaPOSSalesInvoice (مبيعات نقاط البيع)
النتيجة: صورة مبيعات كاملة من جميع القنوات

مثال 3: التدفق النقدي الموحد

Main Table: ReceiptVoucher (المقبوضات النقدية)
Union Table 1: BankTransfers (المقبوضات البنكية)
Union Table 2: PaymentVoucher (المدفوعات النقدية - سالبة)
النتيجة: تقرير تدفق نقدي كامل

تضمين الجداول الديناميكي

تتيح ميزة "Include Tables By Parameters" اختيار الجداول في وقت التشغيل:

1. الإعداد

   • حدّد ما يصل إلى 10 فتحات جداول لكل سطر مدخلات
   • أنشئ مدخلاً لاختيار المستخدم
   • تُضمَّن الجداول بناءً على قيمة المدخل

2. حالات الاستخدام

   • تقارير متعددة الشركات: يختار المستخدم الشركات المراد تضمينها
   • اختيار الفترة: تضمين جداول أشهر/سنوات محددة
   • التقارير الإقليمية: تضمين جداول خاصة بالمنطقة ديناميكياً
   • فئات المنتجات: تضمين جداول الفئات المختارة فقط

3. مثال على الإعداد

   المدخل: "اختر المناطق للتضمين"
   الجدول 1: NorthRegionSales (مضمّن عند اختيار "North")
   الجدول 2: SouthRegionSales (مضمّن عند اختيار "South")
   الجدول 3: EastRegionSales (مضمّن عند اختيار "East")

مصادر بيانات متعددة

تدعم الأداة ما يصل إلى 5 مصادر بيانات إضافية بعيداً عن الجدول الرئيسي:

إعداد مصدر البيانات

1. مصدر البيانات 1-5: اختر كيانات أو استعلامات إضافية
2. إعداد الربط: حدّد العلاقات بين المصادر
3. إعداد التصفية: أضف شروط WHERE لكل مصدر

خيارات الربط

• Inner Join: تضمين السجلات المطابقة فقط
• Left Join: تضمين جميع سجلات المصدر الرئيسي مع ما يقابلها عند توفره
• Subquery: استخدام مصدر البيانات كاستعلام فرعي للحسابات
• Independent: لا علاقة (حاصل ضربي ديكارتي - استخدمه بحذر)

خيار الاستخدام كـ Subquery

عند التفعيل يصبح مصدر البيانات استعلاماً فرعياً مترابطاً:

• مفيد للحسابات (مثال: "إجمالي الطلبات لكل عميل")
• تجميعات مستقلة عن تجميع الاستعلام الرئيسي
• تحسين الأداء للحسابات المعقدة

خيار عرض جميع القيم

يتحكم في سلوك الانضمام الخارجي:

• مفعّل: Left outer join (عرض جميع سجلات المصدر الرئيسي)
• معطّل: Inner join (السجلات المطابقة فقط)

---

إدارة الحقول

أنواع الحقول

1. حقول قاعدة البيانات

أعمدة مباشرة من الكيان المختار:

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

2. حقول التعبيرات المخصصة

حسابات يعرّفها المستخدم:

• تعبيرات SQL: حسابات على مستوى قاعدة البيانات
• تعبيرات Jasper: حسابات محرك التقارير
• أمثلة على الصيغ:
  • amount * 1.15 (إضافة ضريبة 15%)
  • CONCAT(firstName, ' ', lastName) (دمج الأسماء)
  • DATEDIFF(endDate, startDate) (حساب الأيام بين تاريخين)

3. الحقول البديلة

بدائل يوفرها النظام للبيانات المعقدة:

• خيارات عرض المرجع (الكود والاسم والوصف الكامل)
• القيم المترجمة
• التمثيلات المنسقة

خيارات إعداد الحقول

تحتوي مجموعة fields (الحقول) على إعداد شامل للحقول بأكثر من 50 خاصية لكل حقل:

البنية التقنية لمجموعة الحقول

الجدول: ReportWizardFieldLineعمود الربط: reportWizard_id

الخصائص الرئيسية تشمل:

• الإعداد الأساسي: fieldId، arabicTitle، englishTitle، type، namaFieldType
• إعدادات العرض: fieldWidth، widthSize، hidden، displayFieldAs
• التنسيق: patternType، customPattern، barcodeType
• التجميع: sqlAggregationType، totalPosition، showRunningTotalInsteadOfValue
• إجماليات المجموعة: showTotalInGroup1Section حتى showTotalInGroup5Section
• المراجع: displayReferenceAs، doNotAddLinkToReferences، referenceOrderBy
• المنطق المخصص: customSqlExpression، customJasperExpression، unionHandling
• التصميم: style، conditionalStyleGrid، summaryStyle

خصائص العرض

1. عرض الحقل

   • عرض ثابت: حدد العرض بالبكسل
   • حجم الشبكة: تحجيم تكيفي (Small وMedium وLarge وXLarge)
   • تلقائي: يحدده النظام بناءً على المحتوى

2. العناوين والتسميات

   • العنوان العربي: التسمية في التقارير العربية
   • العنوان الإنجليزي: التسمية في التقارير الإنجليزية
   • العناوين المدمجة: رؤوس مجمّعة للأعمدة المجمّعة
   • الاسم المستعار للمستخدم: اسم داخلي بديل للتعبيرات

3. التحكم في الرؤية

   • مخفي: الحقل مضمّن في البيانات لكنه لا يُعرض
   • عرض المرفق كصورة: عرض المرفقات كصور مضمّنة
   • عدم إضافة رابط للمراجع: تعطيل الوصول التفصيلي على حقول المرجع

خيارات التنسيق

1. أنواع النمط

   • رقم: المنازل العشرية وفاصل الآلاف وتنسيق السالب
   • عملة: رمز العملة والمنازل العشرية
   • تاريخ: تنسيقات تواريخ متنوعة (dd/MM/yyyy وMMM dd yyyy وغيرها)
   • وقت: تنسيقات وقت (HH:mm:ss وhh:mm AM/PM)
   • نسبة مئوية: عرض كنسبة مئوية بمنازل عشرية محددة
   • مخصص: أنماط تنسيق يعرّفها المستخدم

2. الأنماط المخصصة

   • #,##0.00: رقم بمنزلتين عشريتين
   • dd/MM/yyyy: تنسيق التاريخ
   • #,##0.00;(#,##0.00): تنسيق موجب؛سالب
   • 00000: أصفار بادئة (مثال: 00123)

3. خيارات العرض

   • عرض الحقل كـ: نص أو رقم أو باركود أو QR Code
   • نوع الباركود: Code128 وCode39 وQR وDataMatrix وEAN13
   • حقل العملة: ربط بحقل عملة للتقارير متعددة العملات
   • عرض الصفر فارغاً: إخفاء القيم الصفرية

دوال التجميع

1. أنواع تجميع SQL

   • SUM: مجموع جميع القيم
   • COUNT: عدد السجلات
   • COUNT DISTINCT: عدد القيم الفريدة
   • AVG: متوسط القيم
   • MIN: القيمة الدنيا
   • MAX: القيمة القصوى
   • GROUP_CONCAT: دمج القيم النصية

2. مواضع الإجماليات

   • None: بلا إجماليات
   • Summary Only: الإجمالي الكلي في نهاية التقرير
   • Group Footers: إجماليات فرعية لكل مجموعة
   • Both: إجماليات فرعية للمجموعات والإجمالي الكلي

3. الإجماليات المتراكمة

   • عرض الإجمالي المتراكم بدلاً من القيمة: عرض المجموع التراكمي
   • إعادة الضبط عند المجموعة: إعادة ضبط الإجمالي المتراكم عند حدود المجموعة

الميزات المتقدمة للحقول

1. إعداد الروابط التشعبية

   • إنشاء روابط قابلة للنقر في التقارير
   • الربط بتقارير أخرى أو URLs خارجية
   • تمرير المدخلات عبر الروابط
   • مثال: "http://erp/customer/" + $F{customerId}

2. التنسيق الشرطي

   • تطبيق تنسيقات مختلفة بناءً على القيم
   • إبراز الأرقام السالبة
   • تلوين حقول الحالة
   • تغليظ القيم المهمة

3. خيارات عرض المرجع

   • الكود فقط: عرض كود المرجع
   • الاسم فقط: عرض اسم المرجع
   • الكود والاسم: عرض كليهما
   • التفاصيل الكاملة: معلومات المرجع الكاملة

---

التجميع والتنظيم

فهم المجموعات

تنظّم المجموعات البيانات بشكل هرمي، مما يُنشئ أقساماً برؤوس وتذييلات ومجاميع فرعية. تدعم أداة ReportWizard 5 مستويات من التجميع.

مثال على التسلسل الهرمي للمجموعات

Country (المجموعة 1)
  ├── Region (المجموعة 2)
  │   ├── City (المجموعة 3)
  │   │   ├── District (المجموعة 4)
  │   │   │   ├── Store (المجموعة 5)
  │   │   │   │   └── سجلات التفاصيل
  │   │   │   └── إجماليات المتجر
  │   │   └── إجماليات المنطقة
  │   └── إجماليات المدينة
  └── إجماليات الإقليم
إجماليات الدولة

ضبط كل مستوى مجموعة

حقول المجموعة

• اختر حقلاً أو أكثر للتجميع بناءً عليه
• الترتيب مهم للتسلسل الهرمي
• يمكن التجميع بواسطة تعبيرات

رؤوس المجموعة

1. عرض رأس المجموعة: تفعيل/تعطيل قسم الرأس
2. العنوان العربي: تسمية الرأس بالعربية
3. العنوان الإنجليزي: تسمية الرأس بالإنجليزية
4. تعبير الرأس المخصص: محتوى رأس ديناميكي

تذييلات المجموعة

1. ارتفاع شريط التذييل: مسافة لإجماليات المجموعة
2. عنوان الإجماليات العربي: تسمية الإجماليات الفرعية بالعربية
3. عنوان الإجماليات الإنجليزي: تسمية الإجماليات الفرعية بالإنجليزية
4. تعبير التذييل المخصص: محتوى تذييل محسوب

خيارات سلوك المجموعة

1. التحكم في الصفحة

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

2. المواصفات المرئية

   • الارتفاع: ارتفاع شريط المجموعة بالبكسل
   • حجم الخط: حجم النص لرؤوس/تذييلات المجموعة
   • لون المقدمة: لون النص
   • لون الخلفية: لون خلفية الشريط

تعبيرات المجموعة المخصصة

تدعم المجموعات تعبيرات مخصصة للحسابات المعقدة:

تعبيرات الرأس المخصصة

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

تعبيرات التذييل المخصصة

• حسابات مجاميع فرعية معقدة
• حسابات النسبة المئوية من الإجمالي
• تجميعات على مستوى المجموعة

سطور التعبيرات

أضف حقول تعبيرات متعددة للرؤوس/التذييلات:

1. عرّف التعبير
2. اضبط الموضع والتنسيق
3. اضبط شروط الرؤية

ضبط إجماليات المجموعة

لكل حقل يحتوي على تجميع:

• عرض الإجمالي في قسم المجموعة 1: None/Header/Footer/Both
• عرض الإجمالي في قسم المجموعة 2: None/Header/Footer/Both
• (يستمر لجميع المستويات الخمسة)

---

الترتيب والتصفية

طرق الترتيب

يحدد حقل sortMethod (طريقة الترتيب) كيفية ترتيب البيانات في التقرير:

1. الترتيب بناءً على حقول الترتيب (ترتيب محدد من خلال حقول الترتيب)

• قيمة Enum: SortBasedOnSortFields
• عدد مدخلات الترتيب: عدد حقول الترتيب (1-10)
• تصاعدي/تنازلي: اتجاه الترتيب لكل حقل
• الأداء: الأكثر كفاءة للبيانات الكبيرة
• الإعداد: يستخدم مجموعة sortFields (حقول الترتيب) لتحديد معايير الترتيب

2. الترتيب بناءً على مدخل التقرير (ترتيب من خلال مدخلات يقوم باختيارها المستخدم)

• قيمة Enum: SortBasedOnReportParameter
• حقول ترتيب Jasper: يستخدم مجموعة jasperSortFieldsLines
• الاستخدام عند: ترتيب قابل للاختيار من المستخدم أو ترتيب بحقول محسوبة
• التحكم في وقت التشغيل: يمكن للمستخدمين تعديل ترتيب الفرز أثناء تنفيذ التقرير

3. الترتيب متعدد المستويات

اضبط حقول الترتيب الأساسي والثانوي والثالثي:

1. أساسي: معيار الترتيب الرئيسي
2. ثانوي: الترتيب داخل المجموعات الأساسية
3. ثالثي: المستوى الأخير من الترتيب

خيارات التصفية

شروط WHERE الثابتة

مرشحات دائمة تُطبَّق دائماً:

-- أمثلة:
status = 'Active'
amount > 1000
date >= '2024-01-01'
region IN ('North', 'South')

شروط HAVING الثابتة

مرشحات تُطبَّق بعد التجميع:

-- أمثلة:
SUM(amount) > 10000
COUNT(*) >= 5
AVG(score) > 75

التصفية الديناميكية بالمدخلات

أنشئ مرشحات قابلة للاختيار من المستخدم:

1. عرّف المدخل
2. أضفه لجملة WHERE
3. يختار المستخدم القيمة في وقت التشغيل

إعداد سطور WHERE

بناء شروط تصفية معقدة:

1. أضف شروط سطور WHERE متعددة
2. ادمجها بمنطق AND/OR
3. دعم للاستعلامات الفرعية وجمل EXISTS

تعبيرات Print When

التحكم في ظهور العناصر:

-- أمثلة:
$F{amount} > 0  -- اعرض فقط إذا كانت القيمة موجبة
$V{PAGE_NUMBER} == 1  -- في الصفحة الأولى فقط
$P{showDetails} == true  -- بناءً على المدخل

---

المدخلات وإدخال المستخدم

أنواع المدخلات

1. المدخلات البسيطة

• نص: إدخال نص حر
• رقم: قيم رقمية مع التحقق
• تاريخ: منتقي تاريخ بتقويم
• منطقي: مربع تحديد نعم/لا

2. مدخلات الاختيار

• اختيار واحد: قائمة منسدلة
• اختيار متعدد: خانات اختيار متعددة
• مرجع كيان: الاختيار من قائمة الكيانات

3. مدخلات النطاق

• نطاق تاريخ: من وإلى تاريخ
• نطاق رقمي: الحد الأدنى والأقصى
• نطاق مخصص: منطق نطاق يعرّفه المستخدم

إعداد المدخلات

تحتوي مجموعة parameters (المدخلات) على خيارات إعداد واسعة:

البنية التقنية لمجموعة المدخلات

الجدول: ReportWizardParameterLineعمود الربط: reportWizard_id

الخصائص الرئيسية تشمل:

• الإعداد الأساسي: fieldId، arabicTitle، englishTitle، required، requiredGroup
• أنواع البيانات: paramType، parameterType، namaFieldType
• القيم الافتراضية: defaultValue، defaultValueDate، defaultValueDateTime، refDefaultValue
• دعم النطاق: defaultValueWithBetween، defaultValueDateWithBetween، refDefaultValueWithBetween
• مدخلات المرجع: refEntityType، filter، filterType، referenceOrderBy
• التحكم في التخطيط: layout، showInsideReport، hidden
• المنطق المتسلسل: sourceParameter، sourceProperty، allowedValues
• التعبيرات المخصصة: customSqlExpression، customJasperExpression

الإعدادات الأساسية

1. معرّف الحقل: اسم مرجع المدخل
2. العنوان العربي: التسمية في الواجهة العربية
3. العنوان الإنجليزي: التسمية في الواجهة الإنجليزية
4. القيمة الافتراضية: قيمة مسبقة التعبئة
5. مطلوب: يجب تعبئته قبل التشغيل

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

1. موضع المدخلات (parametersPosition): القيم المتاحة من النظام:

   • FirstPageHeaderOnly: عرض في رأس الصفحة الأولى فقط
   • AllPagesHeader: تكرار في رأس كل صفحة
   • AllPagesFooter: عرض في تذييل كل صفحة
   • None: عدم عرض المدخلات في التقرير
   • GroupHeader: عرض في رؤوس المجموعات
   • GroupFooter: عرض في تذييلات المجموعات
   • LastPageFooter: عرض في تذييل الصفحة الأخيرة فقط
   • Summary: عرض في قسم الملخص

2. عدد المدخلات في الصف (numberOfParametersInRow): أعمدة لكل صف (1-4)

3. مواصفات شبكة المدخلات:

   • الارتفاع وحجم الخط والألوان
   • المحاذاة والتباعد
   • الحدود والخلفية

الميزات المتقدمة للمدخلات

المدخلات المتسلسلة

مدخلات تعتمد على مدخلات أخرى:

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

المدخلات المخفية

قيم محسوبة بواسطة النظام:

• المستخدم الحالي
• التاريخ/الوقت الحالي
• وحدة التنظيم
• سياق الأمان

التحقق من صحة المدخلات

• التحقق من الحقول المطلوبة
• التحقق من التنسيق (بريد إلكتروني وهاتف وغيرها)
• التحقق من النطاق
• تعبيرات التحقق المخصصة

استخدام المجموعات كمدخلات

تمكين المستخدمين من اختيار التجميع في وقت التشغيل:

1. استخدام المجموعات كمدخلات: تفعيل الخيار
2. الإعداد: تحديد مستويات المجموعة القابلة للاختيار
3. وقت التشغيل: يختار المستخدم بنية التجميع

---

تقارير Crosstab

فهم تقارير Crosstab

تحوّل تقارير Crosstab (الجداول المحورية) البيانات المبنية على صفوف إلى تنسيق مصفوفي، مثالية للتحليل المقارن عبر أبعاد متعددة.

البنية الأساسية

                 البُعد الأفقي للعمود →
                 يناير  فبراير  مارس   الإجمالي
البُعد   الشمال  100    150    125    375
الرأسي   الجنوب  200    175    225    600
  ↓      الشرق   150    160    180    490
         الإجمالي 450   485    530   1465

إعداد Crosstab

حقول الصفوف (البُعد الرأسي)

1. اختيار حقول الصفوف: حدد الحقول للتجميع الرأسي
2. ترتيب الصفوف: يحدد التسلسل الهرمي
3. مدخلات الصفوف: السماح بالاختيار في وقت التشغيل
   • الاختيار كمدخل: تمكين اختيار المستخدم
   • عدد المدخلات: الحد الأقصى للحقول القابلة للاختيار
   • بادئة العنوان: بادئة تسمية المدخل

حقول الأعمدة (البُعد الأفقي)

1. اختيار حقول الأعمدة: حدد الحقول للتجميع الأفقي
2. ترتيب الأعمدة: يحدد التسلسل الهرمي
3. مدخلات الأعمدة: السماح بالاختيار في وقت التشغيل
   • الاختيار كمدخل: تمكين اختيار المستخدم
   • عدد المدخلات: الحد الأقصى للحقول القابلة للاختيار
   • بادئة العنوان: بادئة تسمية المدخل

المعادلات (القيم)

1. اختيار حقول المعادلات: القيم المراد تجميعها
2. نوع التجميع: SUM وCOUNT وAVG وMIN وMAX
3. تنسيق العرض: تنسيق الأرقام والمنازل العشرية
4. معادلات متعددة: دعم حقول قيم متعددة

خيارات عرض Crosstab

إعداد الخلايا

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

الإعدادات المرئية

• عرض الشبكة: عرض حدود الخلايا
• استخدام شبكة بيضاء: لون حدود فاتح
• نظام الألوان: تطبيق على بنية Crosstab

الميزات المتقدمة لـ Crosstab

الأبعاد الديناميكية

السماح للمستخدمين باختيار الأبعاد في وقت التشغيل:

1. تمكين اختيار المدخلات
2. توفير خيارات الأبعاد
3. يتكيف التقرير مع الاختيار

المعادلات المحسوبة

إنشاء قيم مشتقة:

• نسب مئوية من الإجماليات
• حسابات النمو
• النسب والمؤشرات
• صيغ مخصصة

دعم Drill-Down

النقر على الخلايا لرؤية التفاصيل:

• الربط بتقارير تفصيلية
• تمرير سياق الخلية كمدخلات
• الحفاظ على سياق التنقل

---

التنسيق المرئي

أنظمة الألوان

الأنظمة المحددة مسبقاً

يوفر حقل colorScheme خيارات ألوان واسعة. تشمل الأنظمة الرئيسية:

ألوان احترافية/تجارية:

• Aliceblue: ثيم أزرق فاتح احترافي
• Ghostwhite: ثيم أبيض نظيف
• Lightgray: ثيم رمادي احترافي
• Silver: ثيم فضي مؤسسي
• Gainsboro: رمادي هادئ احترافي

ألوان زاهية:

• Blue: نظام أزرق كلاسيكي
• Green: أخضر مستوحى من الطبيعة
• Red: ثيم أحمر جريء
• Purple: نظام بنفسجي غني
• Orange: ثيم برتقالي نشط

محايد/مناسب للطباعة:

• White: خلفية بيضاء نظيفة
• Black: ثيم أسود عالي التباين
• Gray: نظام رمادي قياسي

قائمة الألوان الكاملة (أكثر من 100 خيار)

يدعم النظام أكثر من 100 لون محدد مسبقاً منها: Aliceblue وAntiquewhite وAqua وAquamarine وAzure وBeige وBisque وBlack وBlanchedalmond وBlue وBlueviolet وBrown وBurlywood وCadetblue وChartreuse وChocolate وCoral وCornflowerblue وCornsilk وCrimson وCyan وغيرها الكثير. يمكن تطبيق كل لون بتغييرات (Default وLight وDark).

تغييرات الألوان

• Default: ألوان النظام القياسية
• Light: متغيرات أفتح
• Dark: متغيرات أغمق

ألوان المكونات

ضبط الألوان لكل عنصر في التقرير:

1. الرؤوس والإجماليات

   • لون الإجمالي: خلفية صفوف الإجماليات
   • لون نص الإجمالي: النص في صفوف الإجماليات
   • لون المجموعة: خلفية رأس المجموعة
   • لون نص المجموعة: نص رأس المجموعة

2. مناطق البيانات

   • لون المعادلات: خلفية خلايا المعادلات
   • لون نص المعادلات: نص خلايا المعادلات
   • لون التفاصيل: خلفية صفوف البيانات
   • لون نص التفاصيل: نص صفوف البيانات

3. الصفوف المتبادلة

   • تلوين سطر بسطر: تمكين الألوان المتبادلة
   • خلفية السطر الزوجي: خلفية الصفوف الزوجية
   • لون مقدمة السطر الزوجي: نص الصفوف الزوجية

مواصفات الأشرطة

لكل شريط (قسم) خصائص قابلة للضبط:

شريط رأس العمود

• الارتفاع: ارتفاع صف الرأس
• حجم الخط: حجم نص الرأس
• غامق: تغليظ الرؤوس
• المحاذاة: يسار/وسط/يمين
• الخلفية: لون خلفية الرأس

شريط التفاصيل

• الارتفاع: ارتفاع صف البيانات
• حجم الخط: حجم نص البيانات
• الحشو: حشو الخلية
• الحدود: حدود الخلية

شريط الملخص

• الارتفاع: ارتفاع قسم الملخص
• حجم الخط: حجم نص الإجماليات
• النمط: غامق ومائل وتحته خط
• فاصل: خط فوق الإجماليات

إعداد الشبكة

خيارات عرض الشبكة

1. عرض الشبكة: عرض حدود الجدول
2. استخدام شبكة بيضاء: حدود رمادي فاتح
3. نمط الشبكة: صلبة ومنقطة ومتقطعة

إعداد خطوط الشبكة

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

التنسيق الشرطي

تطبيق التنسيق بناءً على قيم البيانات:

شروط التنسيق (5 شبكات متاحة)

1. تعبير الشرط: متى يُطبَّق التنسيق
2. خصائص التنسيق: ما الذي يتغير
3. الأولوية: ترتيب التقييم

التنسيقات الشرطية الشائعة

• القيم السالبة: نص أحمر للأرقام السالبة
• الحدود: لون بناءً على النطاقات
• مؤشرات الحالة: اللون حسب حقل الحالة
• الإبراز: تغليظ القيم المهمة

مثال على الشروط

$F{amount} < 0           → نص أحمر
$F{status} == "Urgent"    → غامق + خلفية صفراء
$F{score} >= 90          → خلفية خضراء
$V{ROW_COUNT} % 2 == 0   → لون صف متبادل

الصور الخلفية

إعداد الصورة

1. رفع صورة: JPEG أو PNG أو GIF
2. الشفافية: 0-255 (0=شفاف، 255=معتم)
3. الحجم: العرض والارتفاع بالبكسل
4. الموضع: إحداثيات X وY

حالات استخدام الصور

• العلامات المائية: شعار الشركة بشفافية منخفضة
• ورق الرسائل الرسمية: قالب مستند رسمي
• النماذج: خلفيات نماذج مطبوعة مسبقاً
• الأمان: أنماط حماية النسخ

شفافية الحقول

• جعل الحقول شفافة: الدمج مع الخلفية
• إبقاء الحقول معتمة: خلفيات حقول صلبة

---

الميزات المتقدمة

قيود الأمان

الأمان على مستوى الصفوف

تصفية البيانات بناءً على أذونات المستخدم:

1. بناءً على المستخدم: عرض بيانات المستخدم فقط
2. بناءً على الدور: التصفية حسب دور المستخدم
3. التنظيم: تقييد بيانات المستخدم بوحدته التنظيمية
4. قواعد مخصصة: منطق أمان معقد

الأمان على مستوى الحقول

التحكم في رؤية الحقول:

• إخفاء الحقول الحساسة
• إخفاء البيانات جزئياً
• الرؤية الشرطية

متغيرات Jasper

إنشاء متغيرات مخصصة للحسابات:

أنواع المتغيرات

1. Sum: إجماليات متراكمة أو مجموعة
2. Count: أعداد السجلات
3. Average: حسابات المتوسط
4. Min/Max: القيم الحدية
5. Custom: تعبيرات المستخدم

إعداد المتغير

• الاسم: معرّف المتغير
• التعبير: صيغة الحساب
• نوع إعادة الضبط: متى تُعاد تهيئة القيمة
• القيمة الابتدائية: قيمة البداية

مكونات الرأس

إضافة عناصر مخصصة لرؤوس التقارير:

أنواع المكونات

1. نص ثابت: تسميات وعناوين
2. حقول ديناميكية: التاريخ الحالي وأرقام الصفحات
3. صور: شعارات ورسومات
4. مدخلات: عرض قيم المدخلات
5. مخصص: محتوى مبني على تعبيرات

تخطيط المكونات

• وضع المكونات بدقة
• تطبيق طبقات على مكونات متعددة
• العرض الشرطي

ميزات مصدر البيانات

الاستعلامات الفرعية

استخدام مصادر البيانات كاستعلامات فرعية:

-- الاستعلام الرئيسي يجلب العملاء
-- الاستعلام الفرعي يجلب عدد الطلبات لكل عميل
SELECT c.*, 
  (SELECT COUNT(*) FROM orders WHERE customerId = c.id) as orderCount
FROM customers c

معالجة الدمج (Union Handling)

تتيح لك تعبيرات Union Handling تحويل بيانات كل جدول مصدر في استعلامات الدمج والتمييز بينها:

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

حالات الاستخدام الشائعة:

1. تحويل الإشارة: جعل المردودات سالبة مع إبقاء المبيعات موجبة
2. تحديد المصدر: إضافة تسميات لتحديد النظام الذي جاءت منه البيانات
3. تحويلات القيم: تطبيق حسابات مختلفة لكل مصدر
4. توحيد البيانات: تطبيع التنسيقات المختلفة لبنية موحدة

الإعداد:

• يمكن لكل حقل أن يحتوي على تعبير union handling
• يحدد التعبير كيفية معالجة قيمة الحقل من كل مصدر
• يمكن الإشارة إلى جدول المصدر لتطبيق منطق شرطي

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

• عمود الجدول الرئيسي: customer_name
• عمود جدول الدمج: client_name
• يعيّن النظام هذين الحقلين كحقل واحد في التقرير

---

مخرجات التقرير والتصدير

تشغيل التقارير

خيارات التنفيذ

1. تشغيل التقرير: توليد وعرض
2. تحميل التقرير: حفظ في ملف
3. إرسال التقرير بالبريد: إرسال للمستلمين
4. جدولة التقرير: التوليد التلقائي

تنسيقات المخرجات

1. PDF

   • طباعة عالية الجودة
   • خطوط مضمّنة
   • نص قابل للبحث
   • إشارات مرجعية وروابط

2. Excel

   • تصدير البيانات مع التنسيق
   • تصفية تلقائية مفعّلة

3. HTML

   • عرض في متصفح الويب
   • عناصر تفاعلية

خيارات الطباعة

الطباعة المباشرة

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

إعدادات الطباعة

• تطابق حجم الورق
• التعامل مع الاتجاه
• ضبط الهوامش
• التحجيم للملاءمة

---

تحسين الأداء

تحسين الاستعلامات

استخدام الجداول المؤقتة مقابل CTEs

• CTEs: أفضل لمجموعات البيانات الصغيرة
• الجداول المؤقتة: أفضل لمجموعات البيانات الكبيرة
• الإعداد: useTempTablesInsteadOfCTE

التحكم في الصفحات

• تفعيل: تحميل البيانات بصفحات
• تعطيل: تحميل جميع البيانات دفعة واحدة
• الإعداد: ignorePagination

تحسين الترتيب

الترتيب قبل المجموعات

• ترتيب البيانات قبل التجميع
• يحسّن أداء المجموعات
• الإعداد: usedBeforeGroupsSort

ترتيب قاعدة البيانات مقابل ترتيب التقرير

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

استراتيجيات تحميل البيانات

التحميل الكسول

• تحميل البيانات عند الحاجة
• تقليل وقت التحميل الأولي
• أفضل للتقارير الكبيرة

التحميل المسبق

• تحميل جميع البيانات مسبقاً
• أفضل للتقارير الصغيرة
• تنقل أسرع

استخدام الفهارس

تأكد من وجود فهارس لـ

• أعمدة JOIN
• أعمدة جملة WHERE
• أعمدة ORDER BY
• أعمدة GROUP BY

أفضل ممارسات تصميم التقارير

1. تحديد الحقول: أدرج الحقول الضرورية فقط
2. تحسين التعبيرات: التعبيرات البسيطة تعمل بشكل أفضل
3. تقليل المجموعات: مستويات مجموعة أقل = معالجة أسرع
4. التجميع المبكر: استخدم تجميع SQL عند الإمكان
5. التصفية المبكرة: طبّق جمل WHERE لتقليل البيانات

---

حالات استخدام شائعة

تقارير المبيعات

ملخص المبيعات الشهري

1. الجدول الرئيسي: SalesInvoice
2. المجموعات: الشهر والمنطقة وموظف المبيعات
3. المعادلات: إجمالي المبيعات والعدد والمتوسط
4. المدخلات: نطاق التاريخ ومرشح المنطقة

تحليل مبيعات العملاء

1. الجدول الرئيسي: Customer
2. مصدر البيانات 2: SalesInvoice (مرتبط)
3. المجموعات: فئة العميل والعميل
4. المعادلات: مبيعات العام الحالي ومبيعات السنة الماضية ونسبة النمو

التقارير المالية

قائمة الدخل

1. الجدول الرئيسي: GeneralLedger
2. المجموعات: نوع الحساب والحساب
3. المعادلات: المدين والدائن والرصيد
4. خاص: إخفاء الأرصدة الصفرية

الذمم المدينة المتقادمة

1. الجدول الرئيسي: AccountsReceivable
2. المجموعات: فئات التقادم (0-30، 31-60، وغيرها)
3. المعادلات: المبلغ المستحق
4. المدخلات: تاريخ الاحتساب

تقارير المخزون

تقرير حالة المخزون

1. الجدول الرئيسي: InventoryItem
2. مصدر البيانات 2: StockMovement
3. المجموعات: الفئة والبند
4. المعادلات: الكمية الموجودة والمتاحة والمطلوبة

تحليل الحركة

1. الجدول الرئيسي: StockMovement
2. المجموعات: الفترة ونوع الحركة
3. Crosstab: البنود × الأشهر
4. المعادلات: الكمية والقيمة

تقارير الموارد البشرية

قائمة الموظفين

1. الجدول الرئيسي: Employee
2. المجموعات: القسم والمسمى الوظيفي
3. الحقول: الاسم وتاريخ التعيين والراتب
4. الأمان: رؤية الراتب حسب الدور

ملخص الحضور

1. الجدول الرئيسي: Attendance
2. Crosstab: الموظف × التاريخ
3. المعادلات: الساعات والإضافي
4. التنسيق الشرطي: إبراز حالات الغياب

---

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة وحلولها

التقرير يعمل ببطء

الأسباب والحلول:

1. بيانات كبيرة: تفعيل الصفحات واستخدام المرشحات
2. تعبيرات معقدة: تبسيطها أو نقلها لـ SQL
3. مجموعات كثيرة: تقليل مستويات التجميع
4. فهارس مفقودة: إضافة فهارس لقاعدة البيانات

البيانات لا تظهر

تحقق من:

1. شروط WHERE التي تستثني البيانات
2. قيود الأمان التي تحد من الوصول
3. شروط JOIN المقيدة جداً
4. القيم الافتراضية للمدخلات

إجماليات غير صحيحة

تحقق من:

1. نوع التجميع (SUM مقابل COUNT)
2. إعدادات إعادة ضبط المجموعة
3. البيانات المكررة من JOINs
4. التعامل مع قيم NULL

مشكلات في التنسيق

راجع:

1. إعداد النمط
2. إعدادات اللغة المحلية
3. توفر الخطوط
4. اختيار نظام الألوان

أخطاء التحقق

"Fields grid validation failed"

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

"Group validation failed"

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

"Parameter validation failed"

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

نصائح الأداء

للتقارير الكبيرة (أكثر من 10,000 صف)

1. استخدم ترتيب قاعدة البيانات
2. فعّل الصفحات
3. حدّد الحقول المرئية
4. استخدم تقارير الملخصات مع Drill-Down

للحسابات المعقدة

1. احسب مسبقاً في views قاعدة البيانات
2. استخدم متغيرات Jasper بكفاءة
3. خزّن مؤقتاً الحسابات المتكررة
4. حسّن تعقيد التعبيرات

لمصادر بيانات متعددة

1. استخدم أنواع الانضمام المناسبة
2. فكّر في الاستعلامات الفرعية للتجميعات
3. حدّد الحواصل الضربية
4. صفّ مبكراً في كل مصدر

ميزات وضع التصحيح

عند استكشاف الأخطاء:

1. عرض SQL المولّد: رؤية الاستعلام الفعلي
2. تقييم التعبيرات: اختبار التعبيرات
3. معاينة ببيانات عينة: مجموعة بيانات محدودة
4. خطة التنفيذ: خطة استعلام قاعدة البيانات
5. مقاييس الأداء: الوقت لكل مرحلة

---

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

تصميم التقارير

1. ابدأ بسيطاً: ابدأ بتقرير أساسي وأضف الميزات تدريجياً
2. اختبر بشكل تدريجي: تحقق من عمل كل قسم قبل إضافة المزيد
3. استخدم القوالب: انسخ التقارير الناجحة كنقطة انطلاق
4. وثّق الغرض: استخدم الأوصاف والتعليقات

معايير التسمية

1. أكواد التقارير: استخدم البادئات (FIN_* وHR_* وSALES_*)
2. الأسماء المستعارة للحقول: أسماء ذات معنى للتعبيرات
3. أسماء المدخلات: تسميات واضحة وسهلة للمستخدم
4. أسماء المجموعات: تسمية هرمية

الصيانة

1. التحكم في الإصدارات: احتفظ بنسخة احتياطية قبل إجراء تغييرات كبيرة
2. توثيق التغييرات: وثّق التعديلات
3. الاختبار بعد التحديثات: التحقق بعد تغيير الكيانات
4. المراجعة الدورية: مراجعة استخدام التقارير وأدائها

الأمان

1. أقل الصلاحيات: امنح الوصول الضروري فقط
2. اختبار الأمان: تحقق من صحة عمل القيود
3. مراجعة التقارير الحساسة: سجّل الوصول للبيانات السرية
4. مراجعات دورية: حدّث الأمان مع تغيير الأدوار

تجربة المستخدم

1. مدخلات واضحة: قدّم أوصافاً مفيدة للمدخلات
2. قيم افتراضية ذات معنى: اضبط قيماً افتراضية منطقية
3. تنسيق متسق: استخدم تنسيقات قياسية عبر التقارير
4. إجماليات مفيدة: أدرج الإجماليات الفرعية والكلية ذات الصلة
5. رسائل خطأ: قدّم توجيهاً واضحاً عند حدوث مشكلات

---

الملاحق

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

• TextDF: حقول النص
• IntegerDF: أعداد صحيحة
• DecimalDF: أعداد عشرية
• BooleanDF: قيم صح/خطأ
• DateDF: حقول التاريخ
• DateTimeDF: حقول التاريخ والوقت
• LongTextDF: حقول نص طويل
• FieldID: مراجع حقول الكيانات

دوال تجميع SQL

• SUM(): مجموع القيم
• COUNT(): عدد الصفوف
• COUNT(DISTINCT): القيم الفريدة
• AVG(): متوسط القيم
• MIN(): القيمة الدنيا
• MAX(): القيمة القصوى
• GROUP_CONCAT(): نص مدمج
• STDDEV(): الانحراف المعياري
• VARIANCE(): التباين الإحصائي

دوال تعبيرات Jasper

• $F{fieldname}: قيمة الحقل
• $P{parameter}: قيمة المدخل
• $V{variable}: قيمة المتغير
• $R{resource}: حزمة الموارد
• PAGE_NUMBER: الصفحة الحالية
• REPORT_COUNT: إجمالي السجلات
• ROW_COUNT: الصف الحالي

أنماط تنسيق التاريخ

• dd/MM/yyyy: 31/12/2024
• MM/dd/yyyy: 12/31/2024
• yyyy-MM-dd: 2024-12-31
• dd MMM yyyy: 31 Dec 2024
• MMMM dd, yyyy: December 31, 2024
• EEEE, MMMM dd, yyyy: Tuesday, December 31, 2024

أنماط تنسيق الأرقام

• #,##0: 1,234
• #,##0.00: 1,234.00
• #,##0.00;(#,##0.00): 1,234.00 أو (1,234.00)
• 0.00%: 12.34%
• $ #,##0.00: $ 1,234.00
• 00000: 01234

رموز الألوان (Hex)

• #000000: أسود
• #FFFFFF: أبيض
• #FF0000: أحمر
• #00FF00: أخضر
• #0000FF: أزرق
• #FFFF00: أصفر
• #808080: رمادي
• #E6E6E6: رمادي فاتح

---

الملحق التقني

البنية الكاملة للكيان

التفاصيل التقنية لكيان ReportWizard

معلومات الكيان:

• نوع الكيان: ReportWizard
• الاسم العربي: أداة إنشاء تقرير
• الاسم الإنجليزي: Report Wizard
• جدول قاعدة البيانات: ReportWizard
• التصنيف: ملف رئيسي (وليس ملف مستند)

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

• التخطيط والتصميم: layoutMethod، pageFormat، pageOrientation، colorScheme، variation
• مصادر البيانات: mainTable، dataSource1-dataSource5، tableType، entityType
• الترتيب: sortMethod، sortParametersCount، ascendingOrDescending، usedBeforeGroupsSort
• التجميع: useGroupsAsParameter، startNewPageGroup1-startNewPageGroup5
• الأداء: useTempTablesInsteadOfCTE، ignorePagination، usedBeforeGroupsSort
• الأمان: صلاحيات العرض والتحديث والاستخدام مع قيود على مستوى الصفوف
• Crosstab: crosstabCellWidth، crosstabCellHeight، displayCrosstabMeasuresVertically

قائمة المجموعات الكاملة (32 مجموعة):

1. fields (الحقول) - تعريفات الحقول
2. parameters (المدخلات) - إعدادات المدخلات
3. userAliases - الأسماء المستعارة للمستخدم
4. headerComponents - مكونات تخطيط الرأس
5. sortFields (حقول الترتيب) - تعريفات حقول الترتيب في قاعدة البيانات
6. group1Lines حتى group5Lines (سطور المجموعة 1-5) - تجميع بخمسة مستويات
7. group1HeaderCustomExpressionLines حتى group5HeaderCustomExpressionLines - تعبيرات رأس المجموعة
8. group1FooterCustomExpressionLines حتى group5FooterCustomExpressionLines - تعبيرات تذييل المجموعة
9. unionTables - إعدادات جداول الدمج
10. whereLines - شروط جملة WHERE
11. jasperSortFieldsLines - إعدادات ترتيب Jasper
12. jasperVariables - متغيرات Jasper المخصصة
13. dataSource1FilterLines حتى dataSource5FilterLines - تصفية متعددة المصادر
14. dataSource1LinkingLines حتى dataSource5LinkingLines - ربط متعدد المصادر
15. printWhenExpressionLines - قواعد الطباعة الشرطية
16. crosstabColumns (الأعمدة) - حقول أعمدة Crosstab
17. crosstabRows (الصفوف) - حقول صفوف Crosstab
18. crosstabMeasures (المعادلات) - حقول معادلات Crosstab
19. securityConstraints - قواعد قيود الأمان
20. conditionalStyleLines1 حتى conditionalStyleLines5 (جدول التنسيق الشرطي 1-5) - 5 شبكات تنسيق شرطي
21. includeTablesByParameters (تضمين الجداول بشرط من خلال مدخلات) - التضمين الديناميكي للجداول

قيم حقول Enum:

• sortMethod: SortBasedOnSortFields (ترتيب محدد من خلال حقول الترتيب)، SortBasedOnReportParameter (ترتيب من خلال مدخلات يقوم باختيارها المستخدم)
• parametersPosition: FirstPageHeaderOnly وAllPagesHeader وAllPagesFooter وNone وGroupHeader وGroupFooter وLastPageFooter وSummary
• colorScheme: أكثر من 100 لون محدد مسبقاً من Aliceblue إلى Yellowgreen
• layoutMethod: Manual وFromUploadedFile وFromEditor

التكامل مع Nama ERP

تتكامل أداة ReportWizard بعمق مع نظام Nama ERP:

• تكامل الكيانات: يمكنها إعداد تقارير عن أي كيان في النظام
• تكامل الأمان: تحترم أذونات المستخدم والقيود التنظيمية
• تعدد اللغات: دعم كامل للعربية والإنجليزية في أسماء الحقول والواجهة
• تحسين الأداء: تحسين متقدم للاستعلامات والتخزين المؤقت
• قدرات التصدير: تنسيقات مخرجات متعددة (PDF وExcel وHTML)

---

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