گزارش ساز برای پایتون
کتابخانه پایتون برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API
کتابخانه پایتون برای ساخت گزارش‌های بسیار سفارشی با استفاده از REST API
GroupDocs.Assembly Cloud SDK برای پایتون، توسعه‌دهندگان را قادر می‌سازد تا ایجاد اسناد با فرمت غنی مانند قراردادها، فاکتورها، گزارش‌های حمل و نقل، پیشنهادهای فروش، موجودی‌ها و بسیاری دیگر از مصنوعات حیاتی کسب و کار را خودکار کنند. این راهکار کاملاً مبتنی بر ابر است و از طریق یک REST API قابل دسترسی است، به این معنی که هر برنامه پایتون که قادر به ارسال درخواست‌های HTTP باشد، می‌تواند اسناد را بر اساس تقاضا و بدون نصب نرم‌افزار سمت سرور یا ابزارهای شخص ثالث تولید کند.
در هسته خود، این پلتفرم با قالب‌های سند کار می‌کند که حاوی فیلدهای نگهدارنده مکان خاص و ساختارهای برنامه‌نویسی هستند. این نگهدارنده‌های مکان به طور خودکار با مقادیر گرفته شده از یک منبع داده (XML یا JSON) با استفاده از سینتکس عبارت به سبک LINQ جایگزین می‌شوند. این رویکرد قدرتمند به شما امکان می‌دهد تصاویر، نمودارها، بارکدها را جاسازی کنید، رنگ‌های پس‌زمینه را برای خروجی HTML تنظیم کنید، جداول و لیست‌های پویا را از داده‌های آرایه ایجاد کنید و منطق شرطی را برای گنجاندن یا حذف بخش‌هایی از سند اعمال کنید. از آنجا که SDK از طیف گسترده‌ای از فرمت‌های ورودی و خروجی پشتیبانی می‌کند، می‌توانید از یک قالب DOCX یک PDF تولید کنید، گزارش‌های HTML تهیه کنید یا فایل‌های OpenDocument را بدون مراحل تبدیل اضافی خروجی بگیرید.
گردش کار معمول در پایتون شامل سه مرحله ساده است:
1️⃣ ایجاد یک قالب - طراحی یک فایل Word، Excel، PowerPoint یا هر فایل پشتیبانی شده Office/OpenOffice و وارد کردن فیلدهای placeholder و قوانین تولید.
2️⃣ آماده‌سازی یک منبع داده - ارائه داده‌های خود در قالب XML یا JSON، مطابق با placeholderهای تعریف شده در قالب.
3️⃣ نوشتن چند خط کد پایتون - استفاده از بسته groupdocsassemblycloud برای آپلود قالب در GroupDocs Cloud Storage، ارسال منبع داده به همراه فرمت خروجی مورد نظر و فراخوانی عملیات AssembleDocument. API سند مونتاژ شده را مستقیماً در پاسخ برمی‌گرداند یا آن را برای بازیابی بعدی در Cloud ذخیره می‌کند.
تمام تعاملات با رمزگذاری SSL/TLS ایمن شده‌اند و احراز هویت از طریق App SID و App Key شخصی شما انجام می‌شود. این امر تضمین می‌کند که اسناد و داده‌های شما هنگام پردازش در فضای ابری محافظت شده باقی می‌مانند. ماهیت چند پلتفرمی SDK به شما امکان می‌دهد تولید اسناد را در سرویس‌های وب، کارهای دسته‌ای، برنامه‌های دسکتاپ یا توابع بدون سرور ادغام کنید و اسناد قابل چاپ، آماده برای وب یا آماده برای ایمیل را فوراً و با اطمینان ارائه دهید.
مروری بر ویژگی‌های پشتیبانی‌شده توسط رابط برنامه‌نویسی کاربردی (API) اسمبلی کلود.
فرمت‌های سند پشتیبانی‌شده برای رابط برنامه‌نویسی کاربردی اسمبلی کلود.
سیستم عامل‌ها و محیط‌های توسعه پشتیبانی‌شده
این مثال پایتون نحوه آپلود یک الگو، اتصال یک فایل داده و تولید یک سند خروجی با استفاده از GroupDocs Assembly Cloud SDK را نشان می‌دهد.
مراحل
مقداردهی اولیه AssemblyApi با App SID و App Key شما.
فایل الگو را در Cloud Storage آپلود کنید.
فایل منبع داده را باز کنید.
TemplateFileInfo و AssembleOptions را ایجاد کنید.
برای تولید نتیجه، assemble_document را فراخوانی کنید.
import groupdocsassemblycloud
# Initialize API client (replace with your credentials)
assembly_api = groupdocsassemblycloud.AssemblyApi('......##', '......##')
# 1️⃣ Upload the template
file_name = 'Input1.docx'
with open(file_name, 'rb') as request_file_content:
upload_request = groupdocsassemblycloud.models.requests.UploadFileRequest(
file_content=request_file_content,
path=file_name
)
assembly_api.upload_file(upload_request)
# 2️⃣ Load data source (could be XML, JSON or DOCX)
data_file = 'Input2.docx'
with open(data_file, 'rb') as data:
template_info = groupdocsassemblycloud.models.TemplateFileInfo(file_name)
# 3️⃣ Set assemble options (output format: docx)
assemble_options = groupdocsassemblycloud.models.AssembleOptions(
template_info,
"docx",
data
)
# 4️⃣ Assemble the document
request = groupdocsassemblycloud.models.requests.AssembleDocumentRequest(assemble_options)
result = assembly_api.assemble_document(request)
print("Document generated successfully:", result.path)