کتابخانه داتنت برای ساخت گزارشهای بسیار سفارشی با استفاده از REST API
آزمایش رایگان را شروع کنیدGroupDocs.Assembly Cloud یک سرویس کاملاً مدیریتشده و مبتنی بر REST است که به توسعهدهندگان امکان میدهد اسناد با فرمت غنی را به صورت برنامهنویسی تولید کنند.
این سرویس با فایلهای قالب - Word، Excel، PowerPoint، HTML، PDF یا هر یک از فرمتهای پشتیبانیشده OpenOffice - که حاوی برچسبهای نگهدارنده خاص هستند، کار میکند. در زمان اجرا، دادهها از منابع XML یا JSON با استفاده از یک سینتکس عبارت به سبک LINQ به آن نگهدارندهها متصل میشوند و به شما امکان میدهند مقادیر ساده، جداول، تصاویر، نمودارها، بارکدها، هایپرلینکها و حتی محتوای شرطی را تزریق کنید. زیرساخت ابری تمام کارهای سنگین را انجام میدهد: تجزیه قالب، انجام محاسبات، رندر گرافیک و در نهایت ارائه سند مونتاژ شده در قالبی که شما درخواست میکنید (DOCX، PDF، HTML، PNG و غیره).
از آنجا که API مستقل از پلتفرم است، میتوانید آن را از هر زبانی که میتواند درخواستهای HTTP صادر کند، فراخوانی کنید. .NET SDK فراخوانیهای REST را در یک API بومی و شیءگرا قرار میدهد، جزئیات احراز هویت را پنهان میکند و مدلهای درخواست/پاسخ با نوع دادهی قوی ارائه میدهد.
گردش کار معمول .NET
نصب SDK - بستهی NuGet groupdocs.GroupDocs.Assembly-Cloud را به پروژهی خود اضافه کنید.
پیکربندی اعتبارنامهها - یک شیء Configuration با App SID و App Key خود (که از داشبورد GroupDocs Cloud دریافت کردهاید) ایجاد کنید.
آپلود قالب - از UploadFile برای قرار دادن قالب در GroupDocs Cloud Storage استفاده کنید.
آمادهسازی منبع داده - فایل XML یا JSON خود (مثلاً دادههای فاکتور) را در یک رشته بخوانید.
تنظیم AssembleOptions - فرمت خروجی، رشته داده و مسیر قالب آپلود شده را مشخص کنید. ۶. فراخوانی 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# شما ارائه میدهد.
این قطعه کد نحوه آپلود یک فایل الگو، اتصال یک منبع داده و تولید یک سند با استفاده از رابط برنامهنویسی کاربردی کلود اسمبلی را نشان میدهد.
مراحل
۱. پیکربندی SDK با App SID و App Key شما.
۲. آپلود فایل الگو در فضای ذخیرهسازی کلود.
۳. آمادهسازی AssembleOptions - مشخص کردن فرمت خروجی، دادهها و مسیر الگو.
۴. فراخوانی 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);