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

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

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

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

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

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

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

  1. قم بتثبيت SDK – أضف حزمة NuGet groupdocs.GroupDocs.Assembly-Cloud إلى مشروعك.
  2. قم بتهيئة الاعتمادات – أنشئ كائن Configuration باستخدام معرف تطبيقك SID وApp Key (المستخرجة من لوحة تحكم GroupDocs Cloud).
  3. حمّل القالب – استخدم UploadFile لوضع القالب في GroupDocs Cloud Storage.
  4. حضّر مصدر البيانات – اقرأ ملف XML أو JSON (مثل بيانات الفاتورة) إلى سلسلة نصية.
  5. حدد AssembleOptions – عيّن صيغة الإخراج، سلسلة البيانات، والمسار إلى القالب المحمّل.
  6. استدعِ AssembleDocument – يرسل SDK طلبًا واحدًا؛ يحتوي الرد على تدفق الملف المُولَّد.
  7. احفظ أو بث النتيجة – اكتب الملف على القرص، أرسله إلى عميل، أو احفظه مرة أخرى في التخزين السحابي.

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

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

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

ميزات تجميع المستندات REST API

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

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

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

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

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

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

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

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

أنشئ نص البريد الإلكتروني وأرفق الملفات المُولَّدة

أنشئ الباركود ورموز QR

حدد ألوان الخلفية لإخراج HTML

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

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

المقتطف يوضح كيفية رفع ملف قالب، ربط مصدر بيانات وتوليد مستند باستخدام Assembly Cloud API.

الخطوات

  1. قم بتكوين SDK باستخدام App SID وApp Key.
  2. ارفع ملف القالب إلى Cloud Storage.
  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 أيضًا SDKs فردية للمنصات الأخرى:

  عربي
4f0b7297e