مولد گزارش برای Python
کتابخانه Python برای ساخت گزارشهای بسیار سفارشی با استفاده از REST API
کتابخانه Python برای ساخت گزارشهای بسیار سفارشی با استفاده از REST API
GroupDocs.Assembly Cloud SDK برای Python به توسعهدهندگان امکان میدهد تا ایجاد اسناد با قالببندی غنی مانند قراردادها، فاکتورها، گزارشهای حملونقل، پیشنهادهای فروش، موجودیها و بسیاری دیگر از artefacts حیاتی کسبوکار را خودکار کنند. این راهحل کاملاً ابری است و از طریق یک REST API قابل دسترسی است، به این معنی که هر برنامهٔ Python که قادر به ارسال درخواستهای HTTP باشد میتواند اسناد را بهصورت درخواستشده تولید کند بدون اینکه نیاز به نصب نرمافزار سمت سرور یا ابزارهای شخص ثالث داشته باشد.
در هستهٔ این پلتفرم، با قالبهای سند کار میشود که شامل فیلدهای جایدار خاص و ساختارهای برنامهنویسی هستند. این جایدارها بهصورت خودکار با مقادیر استخراجشده از یک منبع داده (XML یا JSON) با استفاده از سینتکس عبارت‑مانند LINQ جایگزین میشوند. این رویکرد قدرتمند به شما اجازه میدهد تا تصاویر، نمودارها، بارکدها را جاسازی کنید، رنگ پسزمینه برای خروجی HTML تنظیم کنید، جداول و فهرستهای پویا را از دادههای آرایهای ایجاد کنید و منطق شرطی را برای گنجاندن یا حذف بخشهای سند اعمال کنید. چون SDK از طیف گستردهای از فرمتهای ورودی و خروجی پشتیبانی میکند، میتوانید یک PDF را از یک قالب DOCX تولید کنید، گزارشهای HTML ایجاد کنید یا فایلهای OpenDocument را بدون گامهای تبدیل اضافی خروجی بگیرید.
گردش کار معمول در Python شامل سه گام ساده است:
1️⃣ ایجاد یک قالب – یک فایل Word، Excel، PowerPoint یا هر فایل پشتیبانیشدهٔ Office/OpenOffice را طراحی کنید و فیلدهای جایدار و قوانین تولید را وارد کنید.
2️⃣ آمادهسازی منبع داده – دادههای خود را در قالب XML یا JSON فراهم کنید، بهطوری که با جایدارهای تعریفشده در قالب مطابقت داشته باشد.
3️⃣ نوشتن چند خط کد Python – از بستهٔ groupdocsassemblycloud برای بارگذاری قالب به GroupDocs Cloud Storage استفاده کنید، منبع داده را همراه با فرمت خروجی موردنظر پاس دهید و عملیات AssembleDocument را فراخوانی کنید. API سند ترکیبشده را مستقیماً در پاسخ برمیگرداند یا آن را در ابر برای بازیابی بعدی ذخیره میکند.
تمام تعاملات با رمزنگاری SSL/TLS ایمن شدهاند و احراز هویت از طریق SID برنامهٔ شخصی شما و App Key انجام میشود. این اطمینان میدهد که اسناد و دادههای شما در حین پردازش در ابر محافظت میشوند. طبیعت چندپلتفرمی SDK به شما اجازه میدهد تا تولید سند را در سرویسهای وب، کارهای دستهای، برنامههای دسکتاپ یا توابع بدون سرور یکپارچه کنید و اسنادی چاپی، آماده برای وب یا آماده برای ایمیل را بهصورت فوری و قابل اطمینان ارائه دهید.
مروری بر ویژگیهای پشتیبانیشده توسط Assembly Cloud API.
قالبهای سند پشتیبانیشده برای Assembly Cloud API.
سیستمعاملها و محیطهای توسعه پشتیبانیشده
این مثال Python نشان میدهد که چگونه یک قالب را بارگذاری کنید، یک فایل داده را بایند کنید و با استفاده از GroupDocs Assembly Cloud SDK یک سند خروجی تولید کنید.
مراحل
AssemblyApi را با SID برنامه خود و App Key مقداردهی اولیه کنید.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)