مولد التقارير لـ C#

مكتبة .NET لبناء تقارير مخصصة للغاية باستخدام واجهة برمجة التطبيقات REST

  • GroupDocs.Assembly Cloud SDK for cURL
  • GroupDocs.Assembly Cloud SDK for Java
  • GroupDocs.Assembly Cloud SDK for C++
  • GroupDocs.Assembly Cloud SDK for Go
  • GroupDocs.Assembly Cloud SDK for Node.js
  • GroupDocs.Assembly Cloud SDK for PHP
  • GroupDocs.Assembly Cloud SDK for Python
  • GroupDocs.Assembly Cloud SDK for Ruby
  • GroupDocs.Assembly Cloud SDK for Swift
ابدأ التجربة المجانية

GroupDocs.Assembly Cloud هي خدمة مُدارة بالكامل، قائمة على REST، تُمكّن المطورين من إنشاء مستندات بتنسيق غني برمجيًا.

تعمل الخدمة مع ملفات القوالب - Word، Excel، PowerPoint، HTML، PDF، أو أي من تنسيقات OpenOffice المدعومة - التي تحتوي على وسوم خاصة. أثناء التشغيل، تُربط البيانات من مصادر XML أو JSON بتلك الوسوم باستخدام بنية تعبيرية على غرار LINQ، مما يسمح لك بإضافة قيم بسيطة، وجداول، وصور، ومخططات، ورموز شريطية، وروابط تشعبية، وحتى محتوى شرطي. تتولى البنية التحتية السحابية جميع المهام الشاقة: تحليل القالب، وإجراء العمليات الحسابية، وعرض الرسومات، وأخيرًا تسليم المستند المُجمّع بالتنسيق الذي تطلبه (DOCX، PDF، HTML، PNG، إلخ).

نظرًا لأن واجهة برمجة التطبيقات (API) لا تعتمد على منصة محددة، يمكنك استدعاؤها من أي لغة يمكنها إصدار طلبات HTTP. تُغلّف حزمة تطوير البرامج (SDK) لـ .NET استدعاءات REST في واجهة برمجة تطبيقات أصلية كائنية التوجه، وتُخفي تفاصيل المصادقة، وتُوفّر نماذج طلب/استجابة مُعدّلة.

سير عمل .NET النموذجي:

  1. تثبيت حزمة تطوير البرامج - أضف حزمة NuGet groupdocs.GroupDocs.Assembly-Cloud إلى مشروعك.

  2. تكوين بيانات الاعتماد - أنشئ كائن Configuration باستخدام مُعرّف تطبيقك (SID) ومفتاح التطبيق (الذي تم الحصول عليه من لوحة معلومات GroupDocs Cloud).

  3. تحميل القالب - استخدم UploadFile لوضع القالب في تخزين GroupDocs Cloud.

  4. إعداد مصدر البيانات - اقرأ ملف XML أو JSON (مثل بيانات الفاتورة) إلى سلسلة نصية.

  5. تعيين خيارات التجميع - حدد تنسيق الإخراج، وسلسلة البيانات، ومسار القالب المُحمّل. ٦. استدعاء AssembleDocument - تُرسل مجموعة تطوير البرامج (SDK) طلبًا واحدًا؛ وتحتوي الاستجابة على تدفق الملف المُولّد.

٧. حفظ أو بث النتيجة - اكتب الملف على القرص، أو أرسله إلى العميل، أو خزّنه مرة أخرى في التخزين السحابي.

مجموعة تطوير البرامج (SDK) مفتوحة المصدر، وتُدار على GitHub: https://github.com/groupdocs-GroupDocs.Assembly-cloud/groupdocs-GroupDocs.Assembly-cloud-dotnet. تتلقى تحديثات منتظمة، وتتضمن اختبارات شاملة للوحدات، وتتبع إصدارات دلالية.

الأمان مُدمج: جميع البيانات مُشفّرة باستخدام SSL/TLS، والوصول محمي بواسطة مفاتيح API شخصية. لا حاجة لأي برامج إضافية أو مكونات خارجية من جهة العميل - تعمل الخدمة بالكامل في السحابة، مما يجعلها مثالية للتطبيقات المحلية، أو التطبيقات بدون خادم، أو تطبيقات سطح المكتب.

باختصار، يوفر لك GroupDocs.Assembly Cloud مع .NET SDK حلاً قابلاً للتطوير ومنخفض الكود لإنشاء العقود والفواتير والتقارير والعروض ورسائل الدمج البريدي وأي سير عمل آخر يعتمد على المستندات بشكل كبير مباشرة من كود C# الخاص بك.

ميزات واجهة برمجة تطبيقات تجميع المستندات REST

إنشاء مستندات من قوالب تحتوي على عناصر نائبة

ربط البيانات على غرار LINQ لمصادر XML/JSON

تضمين الصور والرسوم البيانية والمستندات الخارجية

إنشاء جداول وقوائم ديناميكية من بيانات المصفوفة

إدراج الارتباطات التشعبية والإشارات المرجعية برمجيًا

تطبيق الصيغ وعمليات البيانات المتسلسلة

كتل المحتوى الشرطية (منطق IF‑ELSE)

المتغيرات القابلة لإعادة الاستخدام للحسابات المكلفة

إنشاء نص البريد الإلكتروني وإرفاق الملفات المولدة

إنشاء رموز الباركود ورموز الاستجابة السريعة

تعيين ألوان الخلفية لإخراج HTML

اتصال آمن عبر SSL/TLS ومفاتيح API

تجميع مستند باستخدام C#

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

الخطوات

  1. تهيئة حزمة تطوير البرامج (SDK) باستخدام معرف أمان التطبيق (SID) ومفتاح التطبيق.
  2. تحميل ملف القالب إلى التخزين السحابي.
  3. إعداد “AssembleOptions” - تحديد تنسيق الإخراج، والبيانات، ومسار القالب.
  4. استدعاء “AssembleDocument” واستلام الملف المُجمّع.
using GroupDocs.Assembly.Cloud.Sdk;

var config = new Configuration
{
    AppSid = ".#-.#-.#-.#-.#",
    AppKey = "......"
};
var assemblyApi = new AssemblyApi(config);

var fileName = "Input1.docx";
var dataFile = "Input2.docx";

// Upload template
var uploadRequest = new UploadFileRequest(File.OpenRead(fileName), fileName);
assemblyApi.UploadFile(uploadRequest);

// Assemble document
var assembleOptions = new AssembleOptions
{
    SaveFormat = "docx",
    ReportData = File.ReadAllText(dataFile),
    TemplateFileInfo = new TemplateFileInfo { FilePath = fileName }
};
var assembleRequest = new AssembleDocumentRequest(assembleOptions);
var assembledDocument = assemblyApi.AssembleDocument(assembleRequest);

Support and Learning Resources

توفر GroupDocs.Assembly Cloud أيضًا مجموعات SDK فردية للمنصات الأخرى:

  عربي