مولّد التقارير لـ Go

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

  • GroupDocs.Assembly Cloud SDK لـ cURL
  • GroupDocs.Assembly Cloud SDK لـ .NET
  • 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 SDK لـ Go يتيح لك دمج قدرات قوية لتوليد المستندات في أي تطبيق Go دون الحاجة إلى مكتبات طرف ثالث ثقيلة. الخدمة مستضافة بالكامل على السحابة وتتواصل عبر REST API بسيطة، مما يعني أنك تحتاج فقط إلى اتصال بالإنترنت وبيانات اعتماد API الخاصة بك لبدء إنشاء المستندات.

يتكون سير العمل النموذجي من ثلاث خطوات منطقية:

  1. إعداد قالب – أنشئ Word، PDF، HTML، أو أي صيغة مدعومة تحتوي على حقول نائبة وبُنى برمجية (حلقات، شروط، حسابات). يعمل القالب كخطة أساسية للمستند النهائي.
  2. توفير مصدر بيانات – قدّم بيانات XML أو JSON تتطابق مع الحقول النائبة. يستخدم SDK صياغة تعبيرية بنمط LINQ لربط البيانات بالقالب، مما يتيح لك إنشاء جداول، قوائم، مخططات، ومحتوى ديناميكي في الوقت الفعلي.
  3. تجميع المستند – باستخدام Go SDK، تقوم بتحميل القالب إلى GroupDocs Cloud Storage، وإرسال طلب تجميع يحدد مسار القالب، مصدر البيانات، وصيغة الإخراج المطلوبة (DOCX، PDF، HTML، إلخ)، ثم تحميل المستند الناتج مباشرةً من استجابة API.

تمكّن هذه الطريقة من توليد العقود، الفواتير، قوائم الشحن، عروض المبيعات، وأي مستند حيوي للأعمال في الوقت الفعلي. كما تدعم Mail Merge لإنشاء دفعات من الرسائل المخصصة، توليد barcode، تنسيق خلفية HTML، وإنشاء مرفقات email. جميع العمليات مؤمنة بتشفير SSL/TLS ومصادقة مفتاح API، مما يضمن عدم خروج البيانات الحساسة من السحابة غير محمية.

نظرًا لأن المعالجة الثقيلة تتم في السحابة، فإن SDK يعمل على جميع أنظمة التشغيل التي يمكنها تشغيل Go (Windows macOS، Linux) ويتطلب فقط خطوة التثبيت القياسية go get. لا حاجة إلى برامج إضافية، ولا تثبيتات Office محلية، ولا معالجة يدوية لصيغ الملفات المعقدة – حيث تُجرد خدمة السحابة كل هذه التعقيدات، مما يتيح لك التركيز على منطق الأعمال.

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

تجميع المستندات السحابي يُمكن الوصول إليه عبر REST API

محرك القوالب مع حقول نائبة

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

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

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

إدراج الروابط التشعبية والإشارات المرجعية ومرفقات البريد الإلكتروني

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

كتل محتوى شرطية (IF‑ELSE) ومتغيّرات قابلة لإعادة الاستخدام

الاتصال المشفر SSL/TLS ومصادقة المفتاح API

رفع القوالب إلى GroupDocs Cloud Storage عبر REST

إنشاء مستند في Go

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

الخطوات

  1. تحميل التكوين من config.json.
  2. رفع ملف القالب إلى التخزين السحابي.
  3. قراءة مصدر البيانات (XML/JSON).
  4. تعيين AssembleOptions بمسار القالب وتنسيق الإخراج المطلوب.
  5. استدعاء AssembleDocument واستلام الملف المُجمّع.
import (
    "os"
    "io/ioutil"
    "github.com/groupdocs-assembly-cloud/groupdocs-assembly-cloud-go/api"
    "github.com/groupdocs-assembly-cloud/groupdocs-assembly-cloud-go/api/models"
)

// 1. Initialise configuration
config, _ := models.NewConfiguration("config.json")
assemblyApi, ctx, _ := api.NewAPIClient(config)

// 2. Upload template
fileName := "Input1.docx"
requestFileContent, _ := os.Open(fileName)
uploadReq := &models.UploadFileRequest{
    FileContent: requestFileContent,
    Path:        ToStringPointer(fileName),
}
_, _, _ = assemblyApi.UploadFile(ctx, uploadReq)

// 3. Read data source
dataFile := "Input2.docx" // can be XML or JSON
data, _ := ioutil.ReadFile(dataFile)

// 4. Prepare assemble options
templateInfo := api.TemplateFileInfo{FilePath: fileName}
assembleOptions := api.AssembleOptions{
    TemplateFileInfo: &templateInfo,
    SaveFormat:       "docx",
    ReportData:       string(data),
}

// 5. Generate document
output, err := assemblyApi.AssemblyApi.AssembleDocument(ctx, assembleOptions)
if err != nil {
    // handle error
}
// `output` contains the generated document

Support and Learning Resources

GroupDocs.Assembly Cloud يقدم أيضًا SDKs فردية للغات أخرى كما هو موضح أدناه:

  عربي
4f0b7297e