دليل استخدام أداة إنشاء التقارير ونماذج الطباعة

شرح تفصيلي لحقول وجداول أداة إنشاء التقارير

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

Report Group

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

Table Type

يساعدك هذا الحقل على تسهيل اختيار الجدول الرئيسي (Main Table) للتقرير من خلال تصنيف الجداول المتاحة. يحتوي على القيم التالية:

• Entity يتيح لك اختيار أي نوع كيان موجود في النظام، مثل:

  • فاتورة مبيعات SalesInvoice
  • سند صرف PaymentVoucher
  • العميل Customer
  • المورد Supplier
  • الموظف Employee
  • الحسابات Account وغيرها من الكيانات الرئيسية في النظام.

• Detail Line يتيح لك اختيار أحد جداول السطور المرتبطة بالكيانات، مثل:

  • SalesInvoiceLine: تفاصيل سطور فاتورة المبيعات
  • CustomerContactInfo: جهات الاتصال بملف العميل

• System Table يتيح لك اختيار جداول نظامية داخلية مثل:

  • ItemDimensionsQty: يعرض كميات الأصناف في المخازن المختلفة
  • FAPropertiesEntry: يعرض خصائص الأصول الثابتة

• Virtual Entity (الكيان الافتراضي) يتيح لك اختيار أحد الكيانات الافتراضية التي عرّفها المستخدم بنفسه عبر استعلام SQL مخصص (مثل اتحاد جدولين بـ UNION أو ضم عدة جداول مع تعبيرات حسابية). تظهر هذه الكيانات في قائمة الجدول الرئيسي تماماً مثل الكيانات الحقيقية، مع نفس آلية اختيار الحقول والترجمات والمراجع التلقائية للكيانات (Reference Fields).

  لتعريف كيان افتراضي جديد أو فهم كيفية إعداد خرائط الأعمدة وآلية الاستنباط (Bootstrap)، راجع دليل الكيانات الافتراضية.

عنوان التقرير بالعربية و عنوان التقرير بالإنجليزية

تُستخدم هذه الحقول لتحديد عنوان التقرير الظاهر في أعلى التقرير النهائي، وتظهر القيمة وفقًا للغة المستخدم. إذا كانت واجهة المستخدم بالعربية، سيظهر العنوان العربي، وإذا كانت بالإنجليزية، فسيظهر العنوان الإنجليزي.

Layout Method

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

• يدوي (Manual) تتيح لك تحديد الخصائص يدوياً لكل حقل ومدخل مثل الموضع والعرض والارتفاع من خلال الجداول داخل ملف إنشاء التقرير.

• From Uploaded File تسمح برفع ملف Jasper مسبق الصنع (امتداد .jrxml) واستخدام خصائص الحقول والمواضع الموجودة به داخل التقرير.

• From Editor تتيح لك استخدام محرر بصري لتنسيق الحقول وتحديد مواقعها داخل التقرير. يمكن فتح المحرر من خلال زر Open Editor.

تحويل الكميات حسب وحدة القياس المختارة

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

الخيار الأول: إضافة بارامتر UOMConversion

يضيف هذا البارامتر قائمة منسدلة في شاشة تشغيل التقرير تتيح للمستخدم اختيار وحدة القياس، ويقوم تلقائيًا بإضافة الـ joins اللازمة.

١. تأكد أن التقرير يحتوي على حقل من جدول InvItem (مثل item.code) — هذا شرط مسبق لتفعيل البارامتر. ٢. في جدول المدخلات (Parameters)، أضف سطرًا جديدًا واترك Field ID فارغًا، ثم اختر Parameter Type = UOMConversion. ٣. احفظ التقرير.

عند الحفظ يُضاف تلقائيًا:

• بارامتر UOM في ملف JRXML بقيم baseUnit, reportingUnit1, defaultPurchaseUnit, defaultSalesUnit.
• LEFT JOIN UOM AS PrimaryUOM ON PrimaryUOM.id = <InvItem>.prim$P!{UOM}_id
• LEFT JOIN PrimaryItemUOMLine AS UL ON UL.invItem_id = <InvItem>.id AND UL.uom_id = <InvItem>.prim$P!{UOM}_id

الخيار الثاني: تحويل قيمة حقل كمية إلى الوحدة المختارة

بعد إضافة بارامتر UOMConversion، يمكنك تفعيل التحويل على أي حقل كمية بشكل مستقل.

١. تأكد من توفر الشرطين: بارامتر UOMConversion موجود + حقل من InvItem في التقرير. ٢. في سطر الحقل المراد تحويله (مثل inBasePValue أو تعبير مخصّص)، فعّل خانة «استخدام معامل وحدة القياس لتحويل الكمية». ٣. احفظ التقرير.

يتحوّل تعبير الـ SELECT للحقل إلى (SUM(الحقل)) / UL.rateToBase، ويُضاف UL.rateToBase تلقائيًا إلى GROUP BY.

{
  "mainTable": "QtyTransLine",
  "fields": [
    {
      "fieldId": "in.base.primeQty.value",
      "customSqlExpression": "(@{in.base.primeQty.value}@-@{out.base.primeQty.value}@)",
      "useUOMParameterForQtyConversion": true
    },
    { "fieldId": "itemTransRef.item" }
  ],
  "parameters": [
    {
      "userAlias": "PrimaryUOM",
      "parameterType": "UOMConversion"
    },
    {
      "fieldId": "commonData.valueDate",
      "filterType": "Equals"
    }
  ]
}