ספריית Python לבניית דוחות מותאמים אישית מאוד באמצעות REST API
התחל ניסיון חינםערכת פיתוח הענן GroupDocs.Assembly עבור Python מאפשרת למפתחים להפוך את יצירתם של מסמכים מעוצבים עשירים לאוטומטית, כגון חוזים, חשבוניות, דוחות משלוח, הצעות מכירה, מלאי ופרטים רבים אחרים הקשורים לעסקים. הפתרון מבוסס ענן לחלוטין ונגיש דרך REST API, מה שאומר שכל יישום Python המסוגל לשלוח בקשות HTTP יכול ליצור מסמכים לפי דרישה מבלי להתקין תוכנה בצד השרת או כלים של צד שלישי.
בליבה, הפלטפורמה עובדת עם תבניות מסמכים המכילות שדות placeholder מיוחדים ומבני תכנות. placeholders אלה מוחלפים אוטומטית בערכים שנלקחו ממקור נתונים (XML או JSON) באמצעות תחביר ביטוי בסגנון LINQ. גישה עוצמתית זו מאפשרת לך להטמיע תמונות, תרשימים, ברקודים, להגדיר צבעי רקע לפלט HTML, ליצור טבלאות ורשימות דינמיות מנתוני מערך, ולהחיל לוגיקה מותנית כדי לכלול או לא לכלול מקטעים מהמסמך. מכיוון שה-SDK תומך במגוון רחב של פורמטי קלט ופלט, אתה יכול ליצור PDF מתבנית DOCX, לייצר דוחות HTML או להפיק קבצי OpenDocument ללא שלבי המרה נוספים.
תהליך העבודה האופייני בפייתון מורכב משלושה שלבים פשוטים:
1️⃣ יצירת תבנית – עיצוב קובץ Word, Excel, PowerPoint או כל קובץ Office/OpenOffice נתמך והוספת שדות placeholder וכללי יצירה.
2️⃣ הכנת מקור נתונים – ספקו את הנתונים שלכם בפורמט XML או JSON, בהתאם ל-placeholders המוגדרים בתבנית.
3️⃣ כתיבת מספר שורות קוד של פייתון – שימוש בחבילת groupdocsassemblycloud כדי להעלות את התבנית ל-GroupDocs Cloud Storage, העברה של מקור הנתונים יחד עם פורמט הפלט הרצוי, והפעלת פעולת AssembleDocument. ה-API מחזיר את המסמך המורכב ישירות בתגובה או מאחסן אותו בענן לאחזור מאוחר יותר.
כל האינטראקציות מאובטחות באמצעות הצפנת SSL/TLS, והאימות מתבצע באמצעות מזהה ה-SID האישי ומפתח האפליקציה שלכם. זה מבטיח שהמסמכים והנתונים שלכם יישארו מוגנים בזמן שהם מעובדים בענן. האופי חוצת הפלטפורמות של ערכת הפיתוח (SDK) מאפשר לך לשלב יצירת מסמכים בשירותי אינטרנט, משימות אצווה, יישומי שולחן עבודה או פונקציות ללא שרת, ולספק מסמכים להדפסה, מוכנים לאינטרנט או לדוא"ל באופן מיידי ואמיין.
דוגמה זו של Python מדגימה כיצד להעלות תבנית, לאגד קובץ נתונים וליצור מסמך פלט באמצעות GroupDocs Assembly Cloud SDK.
שלבים
אתחול ה-AssemblyApi עם ה-SID של האפליקציה ומפתח האפליקציה שלך.
העלאת קובץ התבנית לאחסון ענן.
פתח את קובץ מקור הנתונים.
צור את 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)