ספריית Java לבניית דוחות מותאמים אישית במידה גבוהה באמצעות REST API
התחל ניסיון חינםGroupDocs.Assembly Cloud היא שירות מנוהל במלואו, מבוסס על REST, המאפשר למפתחים ב‑Java ליצור מסמכים, דוחות, חוזים, חשבוניות ומכתבי מיזוג דואר מותאמים אישית במידה גבוהה ישירות מהענן. הפתרון עובד עם מגוון רחב של פורמטים קלט ופלט, ומאפשר לך לאחסן קבצי תבנית ב‑GroupDocs Cloud Storage, לקשר אותם למקורות נתונים של XML או JSON, ולקבל את המסמך המורכב בפורמט שבחרת – DOCX, PDF, HTML, PPTX, XLSX וכו’. מכיוון שכל העיבוד מתבצע בצד השרת, אין צורך להתקין תוכנה או ספריות צד שלישי במחשב הלקוח; הדרישה היחידה היא סביבת ריצה של Java ו‑Assembly Cloud SDK, המספקת עטיפות דקות סביב נקודות הקצה של API.
תהליך העבודה השגרתי של Java מורכב משלושה שלבים פשוטים. ראשית, הוסף את תלות Assembly Cloud SDK לפרויקט Maven או Gradle שלך והפעל את ApiClient עם ה‑App SID וה‑App Key האישיים שלך. שנית, העלה את קובץ התבנית ל‑GroupDocs Cloud Storage באמצעות השיטה uploadFile. שלישית, צור אובייקט AssembleOptions, ציין את נתיב התבנית, קובץ הנתונים (XML או JSON), פורמט הפלט הרצוי, והפעל את assembleDocument. השירות מחזיר את המסמך המורכב כ‑stream שניתן לשמור מקומית או לעבד הלאה. SDK גם חושף שיטות עזר לתצוגה מקדימה של תבניות, לקבלת פורמטים נתמכים, וטיפול בשגיאות. גישה פשוטה זו מאפשרת לך לשלב יצירת מסמכים באפליקציות אינטרנט, משימות עיבוד באצוות, או מיקרו‑שירותים עם מינימום קוד.
כל התקשורת מוצפנת באמצעות SSL/TLS, והגישה נשלטת על ידי מפתחות אישיים. הפלטפורמה מתרחבת אוטומטית כדי להתמודד עם נפחי בקשות גדולים ותומכת בפעולות מיזוג דואר באצווה שבהן קריאה יחידה ל‑API יכולה לייצר אלפי מכתבים מותאמים אישית. בנוסף, SDK תומך בהטמעת תמונות, תרשימים, ברקודים ויישום לוגיקה מותנית ישירות בתבנית באמצעות ביטויים בסגנון LINQ, ומעניק לך שליטה מלאה על פריסת המסמך הסופי.
הקטע הבא מדגים כיצד להעלות תבנית, להגדיר את מקור הנתונים וליצור דוח DOCX באמצעות Assembly Cloud API. שלבים
AssembleOptions – נתיב התבנית, פורמט הפלט וקובץ הנתונים.assembleDocument כדי לייצר את התוצאה.import com.groupdocs.assembly.*;
AssemblyApi assemblyApi = new AssemblyApi(new ApiClient());
ApiClient client = assemblyApi.getApiClient();
client.setAppKey("####################").setAppSid("####-####-####-####-####");
String fileName = "Input1.docx";
String dataFile = "Input2.docx";
File requestFileContent = new File(fileName);
UploadFileRequest uploadDocumentRequest =
new UploadFileRequest(requestFileContent, fileName, null);
assemblyApi.uploadFile(uploadDocumentRequest);
AssembleOptions assembleOptions = new AssembleOptions();
assembleOptions.setTemplateFileInfo(new TemplateFileInfo().filePath(fileName));
assembleOptions.setSaveFormat("docx");
assembleOptions.setReportData(Paths.get(dataFile).toString());
AssembleDocumentRequest request = new AssembleDocumentRequest(assembleOptions);
assemblyApi.assembleDocument(request);