محرك تقارير LINQ

ال Aspose.Words LINQ Reporting Engine for .NET يسمح للمطورين بإنشاء تقارير غنية، مدفوعة بالبيانات عن طريق دمج بنية وسوم نصية عادية مع استعلامات LINQ. يمكن للتقارير الارتباط بالمجموعات، قواعد البيانات، JSON، XML، أو الكائنات المخصصة، مع تطبيق التصفية، التجميع، والتجميع مباشرة داخل القالب. النتيجة هي تقرير مكتمل بالكامل في تنسيقات Word.

التثبيت والإعداد

  1. قم بتثبيت حزمة NuGet Aspose.Words.
  2. طبق الترخيص الخاص بك ( الترخيص القائم على القياس ).
  3. أضف مرجعًا إلى Aspose.Words وتأكد من تضمين التبعيات.
  4. للحصول على الخطوات الكاملة، انظر إلى دليل التثبيت .

المنصات المدعومة: ويندوز، لينكس، وماك أو إس مع .NET Framework, .NET, أو Mono. بيئات التطوير المتكاملة: Visual Studio 2017–2026, JetBrains Rider, MonoDevelop.

تنسيقات القالب / الإخراج المدعومة: DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML، و Word 2007 XML.

البدء السريع

إنشاء تقرير من XML:

using Aspose.Words;
using Aspose.Words.Reporting;

var doc = new Document("ReportTemplate.docx");
var dataSource = new XmlDataSource("Data.xml");

var engine = new ReportingEngine();
engine.BuildReport(doc, dataSource, "data");

doc.Save("Report.Output.docx");

الميزات والوظائف

تركيب القالب

  • الوسوم مثل <<Name>>, <<foreach:Orders>>, <<if:Condition>> قابلة للقراءة من قبل الإنسان.
  • مدعومة في الفقرات والجداول والرؤوس والتذييلات.

ربط البيانات باستخدام LINQ

  • ربط بـ المجموعات، DataTables،, EF الاستعلامات، JSON، XML، أو الكائنات المخصصة.
  • LINQ داخل السطر: Where, OrderBy, GroupBy, الإسقاطات.

التصفية، التجميع والفرز

  • كتل شرطية مع <<if:…>> / <<endif>>.
  • تجميع البيانات مع <<groupby:Property>>.
  • ترتيب داخل السطر مع orderby بنود.

دوال التجميع

  • الوسوم المدمجة: <<sum:>>, <<avg:>>, <<count>>, <<min:>>, <<max:>>.
  • تحديثات تلقائية عند تغيير مجموعات البيانات.

منطق الشرط والتبديل

  • استخدام <<switch:Expression>>, <<case:Value>>, <<default>> لعدة سيناريوهات.
  • يبسط القوالب ذات التخطيطات المختلفة.

بيانات متداخلة وهرمية

  • تصفح رسومات الكائنات (مثلاً،., <<foreach:Order.Items>>).
  • إنشاء جداول/قوائم متداخلة مع التجميع + الشروط.

دوال مخصصة وقابلية التوسعة

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

وراثة القوالب

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

استدعاءات رد فعل مدفوعة بالأحداث

  • الربط بـ ReportBuildStarted, TagProcessed, ReportBuildFinished.
  • أضف التسجيل، أدخل المخططات/الصور، أو عدّل المخرجات ديناميكياً.

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

  • نسّق التواريخ والأرقام والعملات وفق الثقافة.
  • دمج ملفات الموارد لتقارير متعددة اللغات.

FAQ

  1. كيف يختلف هذا عن دمج البريد؟? يستخدم LINQ Reporting وسوم نصية ويدعم تعبيرات LINQ، على عكس حقول دمج البريد التقليدية.
  2. ما مصادر البيانات المدعومة؟? XML، JSON، CSV، DataTables، Entity Framework، والكائنات المخصصة .NET.
  3. هل يمكنني تضمين المخططات والصور؟? نعم. يمكن للقوالب أن تشمل المخططات والباركود والصور المستخرجة من البيانات.
  4. ما هي الصيغ التي يمكنني إخراجها؟? DOC, DOCX, RTF, DOT, DOTX, DOTM, DOCM, Word 2003 XML، و Word 2007 XML.
  5. هل يدعم التوطين؟? نعم. يتم دعم التنسيق الواعي للثقافة وتكامل الموارد.
 عربي