گزارش ساز برای Go
برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API به کتابخانه Go بروید
برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API به کتابخانه Go بروید
GroupDocs.Assembly Cloud SDK for Go به شما امکان می‌دهد قابلیت‌های قدرتمند تولید سند را بدون نیاز به کتابخانه‌های سنگین شخص ثالث، در هر برنامه Go تعبیه کنید. این سرویس کاملاً مبتنی بر ابر است و از طریق یک API ساده REST ارتباط برقرار می‌کند، به این معنی که برای شروع ایجاد اسناد، فقط به اتصال اینترنت و اعتبارنامه‌های API خود نیاز دارید.
گردش کار معمول شامل سه مرحله منطقی است:
آماده‌سازی یک الگو - ایجاد یک Word، PDF، HTML یا هر فرمت پشتیبانی شده‌ای که حاوی فیلدهای placeholder و ساختارهای برنامه‌نویسی (حلقه‌ها، شرط‌ها، محاسبات) باشد. الگو به عنوان یک طرح برای سند نهایی عمل می‌کند.
ارائه یک منبع داده - ارائه داده‌های XML یا JSON که با placeholderها مطابقت دارند. SDK از سینتکس عبارت به سبک LINQ برای اتصال داده‌ها به الگو استفاده می‌کند و به شما امکان می‌دهد جداول، لیست‌ها، نمودارها و محتوای پویا را در لحظه تولید کنید. ۳. سرهم‌بندی سند – با استفاده از Go SDK، قالب را در GroupDocs Cloud Storage آپلود می‌کنید، یک درخواست سرهم‌بندی ارسال می‌کنید که مسیر قالب، منبع داده و فرمت خروجی مورد نظر (DOCX، PDF، HTML و غیره) را مشخص می‌کند و در نهایت سند حاصل را مستقیماً از پاسخ API دانلود می‌کنید.
این رویکرد امکان تولید قراردادها، فاکتورها، مانیفست‌های حمل و نقل، پیشنهادات فروش و هر سند مهم تجاری دیگر را به صورت بلادرنگ فراهم می‌کند. همچنین از ادغام پستی برای ایجاد دسته‌ای نامه‌های شخصی‌سازی شده، تولید بارکد، طراحی پس‌زمینه HTML و پیوست ایمیل پشتیبانی می‌کند. همه عملیات با رمزگذاری SSL/TLS و احراز هویت با کلید API ایمن شده‌اند و تضمین می‌کنند که داده‌های حساس هرگز بدون محافظت از ابر خارج نمی‌شوند.
از آنجا که عملیات سنگین در ابر انجام می‌شود، SDK روی هر سیستم عاملی که می‌تواند Go را اجرا کند (ویندوز macOS، لینوکس) کار می‌کند و فقط به مرحله نصب استاندارد «go get» نیاز دارد. هیچ نرم‌افزار اضافی، هیچ نصب آفیس بومی و هیچ مدیریت دستی فرمت‌های پیچیده فایل مورد نیاز نیست - سرویس ابری تمام این پیچیدگی‌ها را حذف می‌کند و به شما امکان می‌دهد روی منطق کسب‌وکار تمرکز کنید.
قابلیت‌های اصلی GroupDocs.Assembly Cloud API برای Go - عناوین مختصر ویژگی‌ها (هر کدام ۲ تا ۳ کلمه).
فرمت‌های ورودی و خروجی پشتیبانی شده توسط اسمبلی اسناد
سیستم عامل‌ها و چارچوب‌های توسعه پشتیبانی شده.
قطعه کد زیر نحوه آپلود یک الگو، خواندن منبع داده و فراخوانی رابط برنامه‌نویسی اسمبلی برای تولید یک سند با استفاده از Go را نشان می‌دهد.
مراحل
۱. بارگذاری پیکربندی از config.json.
۲. آپلود فایل الگو در فضای ذخیره‌سازی ابری.
۳. خواندن منبع داده (XML/JSON).
۴. تنظیم AssembleOptions با مسیر الگو و فرمت خروجی دلخواه.
۵. فراخوانی 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