אנו שמחים להודיע על השחרור של GroupDocs.Assembly for Java 26.11, זמין החל מ-נובמבר 2026. שחרור זה מביא את התכונות והתיקונים של GroupDocs.Assembly for .NET 26.11 ל-Java:

  • תבניות ניתנות לבדיקה מול JSON Schema;
  • דפים של תבניות ודוחות ניתנים להמרה לתמונות;
  • טעינת משאבים חיצוניים נמצאת תחת שליטת היישום;
  • REMOVE_EMPTY_PARAGRAPHS פועל עבור תבניות גיליונות אלקטרוניים וטקסט פשוט;
  • תגיות <<image>> פועלות בתאי טבלה של מצגות ומפענחות נתיבים יחסיים ביחס לתיקיית התבנית;
  • תגיות צבע מקבלות מחרוזות הקס.

מנועי Aspose המובאים עוברים מגרסאות תחילת 2026 ל-26.10, ומספר תיקונים מכסים רישוי, קידוד דוחות, ברקודים ותוכן HTML. Java 8 נשארת הבסיס.

מה חדש בשחרור זה

מפתח סיכום קטגוריה
ASSEMBLYNET-145 JsonDataSource מקבל JSON Schema: חברים שהוגדרו ב‑schema ניתנים להפניה גם כאשר הם null, ריקים או חסרים בנתונים, וסוגי הערכים נלקחים מה‑schema תכונה
ASSEMBLYNET-8 DocumentAssembler.generatePreview מציג דפים של תבניות, דוחות מורכבים ומסמכים אחרים ל‑PNG, JPEG או BMP תכונה
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS פועל עבור תבניות גיליונות אלקטרוניים ומסמכי טקסט פשוט תכונה
ASSEMBLYNET-140 משאבים חיצוניים שמופנים על ידי תבניות ונתונים נמצאים תחת שליטת היישום; משאבים שהפניות שלהם מגיעות מהנתונים מדולגים כברירת מחדל אבטחה
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 ו‑Aspose.BarCode 26.10 מובאים עדכון
ASSEMBLYJAVA-353 ברקודי GS1 (EAN-14, SCC-14, SSCC-18 ו‑DataBar) משמרים את התיקון האוטומטי של טקסט הקוד שלהם עם Aspose.BarCode 26.10 תיקון
ASSEMBLYNET-52 תגית <<image>> פועלת בתא טבלה של מצגת, ותגיות בצורות של קבוצות צורות מעובדות שיפור
ASSEMBLYNET-62 נתיב תמונה יחסי מהנתונים מפוענח ביחס לתיקיית התבנית שיפור
ASSEMBLYNET-25 צבע המוגדר כמחרוזת יכול להיות ערך הקס ב‑backColor ובתגיות צבע של גרפים שיפור
ASSEMBLYNET-155 בוליאן חסר בנתוני JSON, XML או CSV נחשב כ‑false ב‑?: וב‑where, count, any, all ו‑first במקום לגרום לשגיאה תיקון
ASSEMBLYNET-157 groupBy ו‑distinct על אובייקטים מקוננים ממזגים אובייקטים שווים; הפניות $id/$ref של נתוני JSON נתמכות תיקון
ASSEMBLYNET-142 License.setLicense(InputStream) קורא זרם שכבר נקרא מההתחלה תיקון
ASSEMBLYNET-143 צריכת רישיון מדוד מדווחת כאשר פעולה מסתיימת תיקון
ASSEMBLYNET-158 דוחות טקסט ו‑HTML של תבניות רק ASCII נכתבים ב‑UTF-8, ולכן נתונים לא לטיניים אינם אובדים יותר תיקון
ASSEMBLYNET-160 ברקודים אינם נכשלים יותר עם NullPointerException כאשר גופן תיבת הטקסט שלהם אינו מותקן תיקון
ASSEMBLYNET-159 תגיות בנושא השיחה של תבנית MSG מורכבות כמו אלו של הנושא תיקון
ASSEMBLYNET-152 תגית <<doc>> בגיליון אלקטרוני, מצגת או תבנית טקסט נכשלת עם הודעה ברורה; assembleDocument שנכשל אינו משאיר קובץ פלט ריק תיקון
ASSEMBLYJAVA-354 תג ביטוי -html שמסיים את הפסקה שלו אינו משאיר פסקה ריקה אחרי HTML שמסתיים באלמנט בלוק תיקון

שינויי התנהגות לבדיקה לפני עדכון

  1. משאבים חיצוניים מהנתונים מדולגים כברירת מחדל. לדוגמה, <<image [item.PhotoUrl]>> כאשר PhotoUrl הוא URI של http או https כעת מחזיר תמונה ריקה. הוסף את המארחים ל‑LoadSaveOptions.getWhitelistedResources(), או קרא LoadSaveOptions.setSkipExternalResources(false) כדי לשמור על ההתנהגות הקודמת. משאבים שמופנים על ידי התבנית עצמה ונתיבי קבצים מקומיים פועלים כבעבר.
  2. קריאה מעורפלת ל‑JsonDataSource. new JsonDataSource(path, null) עם ארגומנט שני null מילולי אינו מתקמפל יותר. המרה של הארגומנט: new JsonDataSource(path, (JsonDataLoadOptions) null). יישומים שכבר קומפיילו אינם מושפעים.
  3. דוחות טקסט ו‑HTML ב‑UTF-8. דוחות של תבניות טקסט ו‑HTML רק ASCII ללא סימן סדרת בתים נכתבים כעת ב‑UTF-8 במקום windows-1252. כדי לשמור על קוד עמודת בתים יחידה, הכרז על כך בתבנית (<meta charset> ב‑HTML).
  4. groupBy ו‑distinct על אובייקטים מקוננים של נתוני JSON, XML ו‑DataSet כעת ממזגים אובייקטים שווים במקום ליצור קבוצה אחת לכל שורה.
  5. אין פסקה נוספת אחרי HTML. תגית -html שמסיימת את הפסקה שלה אינה משאירה פסקה ריקה אחרי HTML שמסתיים באלמנט בלוק. כדי לשמור על שורה ריקה, סיים את ה‑HTML עם <p>&nbsp;</p>.
  6. ברקודי DataBar Expanded. ברקוד DataBar Expanded או DataBar Expanded Stacked עם טקסט קוד של ספרות בלבד מקודד כעת כ‑GTIN עם מזהה היישום (01), כמו סוגי DataBar האחרים.
  7. טקסט השגיאה השתנה עבור תגית <<doc>> בגיליון אלקטרוני, מצגת ותבנית טקסט; סוג השגיאה נשאר זהה.
  8. API הוסר. ICustomFontsHandler.resetFontSources() הוסר; במקום זאת קרא FontSettings.resetFontSources().

תכונות חדשות

תמיכה ב‑JSON Schema עבור JsonDataSource

תבנית נבדקת מול מבנה הנתונים שלה לפני שכל <<if>> מוערך. עם JSON, המבנה היה נלקח מהנתונים עצמם, ולכן הפנייה בתוך ענף שלעולם לא מוצג נכשלה כאשר הנתונים מאחוריו היו null, מערך ריק או חסרים.

JsonDataSource מקבל כעת JSON Schema, באותו אופן שבו XmlDataSource מקבל XML Schema, והתבנית נבדקת מול ה‑schema:

  • חברים שהוגדרו ב‑schema ניתנים להפניה גם אם הם null, ריקים או חסרים בנתונים;
  • חברים שלא הוגדרו ב‑schema עדיין נכשלים, ולכן שמות שגויים מזוהים כמו קודם;
  • סוגי הערכים נלקחים מה‑schema, כך שבוליאן הוא Boolean ומחרוזת שמכילה ספרות נשארת מחרוזת.

בהינתן לקוח ללא כרטיסי תשלום וללא נתוני נאמנות, ומספר חשבון שהוא מחרוזת של ספרות:

{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "Name": { "type": "string" },
    "Account": { "type": "string" },
    "Cards": {
      "type": "array",
      "items": { "type": "object", "properties": { "Type": { "type": "string" }, "Last4": { "type": "string" } } }
    },
    "Loyalty": { "type": ["object", "null"], "properties": { "Level": { "type": "string" } } }
  }
}

והתבנית הזו:

Customer: <<[customer.Name]>>
Account number: <<[customer.Account]>>
<<if [customer.Cards.count() > 0]>>Payment card: <<[customer.Cards.first().Type]>> ending in <<[customer.Cards.first().Last4]>><<else>>No payment card on file.<</if>>
Loyalty program: <<[customer.Loyalty?.Level]>>

העבר את ה‑schema לצד הנתונים:

JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));

התוצאה היא No payment card on file. עם מספר החשבון 00042. ללא ה‑schema, אותה תבנית נכשלת ב‑customer.Cards.first().Type, ומספר החשבון נקרא כמספר 42.

ה‑schema ניתן לספק כנתיב קובץ או InputStream, עם או בלי JsonDataLoadOptions. מילות מפתח נתמכות הן type (כולל סוגים ניתנים ל‑null), properties, items, format (date-time ו‑date), enum, const, allOf ו‑מצביעים $ref מקומיים. oneOf, anyOf, not, $ref מרוחק או רקורסיבי, items בצורת טופל ו‑מערכים של מערכים אינם נתמכים.

תצוגה מקדימה של מסמך

DocumentAssembler.generatePreview מציג דפים של מסמך ל‑PNG, JPEG או BMP: תבנית, מסמך שהורכב על ידי GroupDocs.Assembly, או כל מסמך אחר בפורמט נתמך, מקובץ או זרם. דפים של מסמכי עיבוד תמלילים, טקסט ו‑HTML, דפים מודפסים של גיליונות אלקטרוניים, שקופיות של מצגות והודעות דוא״ל עם הכותרת שלהם מוצגים.

DocumentAssembler assembler = new DocumentAssembler();

ByteArrayOutputStream report = new ByteArrayOutputStream();
try (InputStream template = new FileInputStream("Customer orders.docx"))
{
    assembler.assembleDocument(template, report,
        new DataSourceInfo(new JsonDataSource("Customers.json"), "customers"));
}

// A stream is created for every page and released when the page is written.
PreviewOptions options = new PreviewOptions(
    pageNumber -> new FileOutputStream("page" + pageNumber + ".png"),
    (pageNumber, pageStream) -> pageStream.close());
options.setPreviewFormat(PreviewFormats.PNG);
options.setResolution(120);                    // dots per inch; 96 by default
// options.setPageNumbers(new int[] { 1, 2 }); // all pages by default

assembler.generatePreview(new ByteArrayInputStream(report.toByteArray()), options);

כאשר גם setWidth וגם setHeight מוגדרים, הדפים מותאמים לגודל זה תוך שמירה על יחס הגובה‑רוחב. תצוגות מקדימות נוצרות ללא טעינת משאבים חיצוניים, והתמונות שנוצרו נספרות ברישיון מדוד כמו מסמכים מורכבים.

REMOVE_EMPTY_PARAGRAPHS עבור תבניות גיליונות אלקטרוניים וטקסט פשוט

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS פועל כעת גם עבור תבניות גיליונות אלקטרוניים ומסמכי טקסט פשוט. שם, פסקה היא שורת טקסט: שורה של טקסט בתא, או של מסמך טקסט, שהופכת ריקה לאחר עיבוד תגיות התבנית מוסרת יחד עם שבירת השורה שלה. תגיות כגון <<if>> ו‑<<foreach>> שנכתבות בשורות משלהן אינן משאירות שורות ריקות יותר.

DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));

תבנית:

Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix

תוצאה:

Prefix
Suffix

אותו טקסט תבנית בתא של גיליון אלקטרוני נותן את אותו תוצאה בתוך התא. מסמכי HTML ו‑XML נשארים כפי שהם.

אבטחה: שליטה במשאבים חיצוניים

תגית <<image>> או <<doc>> יכולה להעריך ל‑URI שנלקח מהנתונים, ו‑GroupDocs.Assembly היה מושך אותו ללא אפשרות למנוע זאת. שרת שמרכיב מסמכים מנתונים שמסופקים על ידי אחרים יכול היה להיבצע בקשות לכתובות פנימיות.

GroupDocs.Assembly כעת מציין מאיפה מגיעה כל הפנייה למשאב חיצוני (ExternalResourceOrigin):

  • TEMPLATE — מסמך התבנית מפנה למשאב עצמו, כולל URI מילולי בתגית כגון <<image ["https://example.com/logo.png"]>>;
  • DATA — ההפנייה מגיעה מהנתונים, כגון URI שהביטוי בתגית מוערך אליו.

בברירת מחדל, משאבים שמופנים על ידי התבנית נטענים כבעבר, ומשאבים שההפניות שלהם מגיעות מהנתונים מדולגים. ארבעה חברים של LoadSaveOptions שולטים בזה:

  • setSkipExternalResources (true כברירת מחדל) — משאבים חיצוניים אינם נטענים;
  • setTrustTemplateResources (true ברירת מחדל) — משאבים שמופנים על ידי התבנית נטענים גם כאשר הדילוג מופעל; קבע זאת ל‑false כאשר התבניות מגיעות ממקורות לא מהימנים;
  • getWhitelistedResources — שמות מארחים או קידומות URI מוחלטות המותרים גם כאשר הדילוג מופעל;
  • setExternalResourceHandler — ExternalResourceHandler שנקרא עבור כל משאב חיצוני לפני שהוא מתבקש, כדי לאפשרו, לדלג עליו או לספק את תוכנו.
final String photoUri = "https://images.example.com/photos/no-photo.jpg";
DocumentAssembler assembler = new DocumentAssembler();

// Default options: the URI comes from data, so the image is skipped and left empty.
assembler.assembleDocument("Inserting image.docx", "Skipped.docx", new DataSourceInfo(photoUri, "expression"));

// Allow a trusted host and see every decision. The handler can also provide the content itself.
LoadSaveOptions options = new LoadSaveOptions();
options.getWhitelistedResources().add("images.example.com");
options.setExternalResourceHandler(new LocalImageHandler("no-photo.jpg"));

assembler.assembleDocument("Inserting image.docx", "Provided.docx", options, new DataSourceInfo(photoUri, "expression"));
public class LocalImageHandler extends ExternalResourceHandler
{
    private final String mImagePath;

    public LocalImageHandler(String imagePath) { mImagePath = imagePath; }

    @Override
    public void onLoading(ExternalResourceLoadingArgs args)
    {
        System.out.println(ExternalResourceOrigin.toString(args.getOrigin()) + " resource " + args.getUri() + ": "
            + (args.isSkipped() ? "skipped" : "allowed"));

        // Provide the content instead of requesting it.
        if (!args.isSkipped() && args.getUri().toLowerCase().startsWith("https://images.example.com/"))
        {
            try
            {
                args.setData(Files.readAllBytes(Paths.get(mImagePath)));
            }
            catch (IOException e)
            {
                throw new UncheckedIOException(e);
            }
        }
    }
}

משאבים חיצוניים הם משאבים המגיעים לרשת: URI של http, https ו‑ftp, נתיבי UNC ו‑URI של קבצים עם מארח מרוחק. נתיבי קבצים מקומיים אינם מושפעים. תמונה מדולגת של מסמך מוחלפת בתמונה שקופה; ערך <<image>> או <<doc>> מדולג מתייחס כערך ריק.

שיפורים

תמונות בתאי טבלה ובצורות קבוצתיות של מצגות

בתבנית מצגת, תגית <<image>> יכלה להיות ממוקמת רק בתיבת טקסט. כעת תא טבלה הוא גם מכולת תמונה: התמונה הופכת למילוי תמונה של התא, כולל תאים של שורות שמוחזרות על ידי <<foreach>>, כך שניתן לבנות טבלה המפרטת פריטים עם תמונותיהם. עם -fitHeight, השורה מתרחבת כדי להציג את התמונה עם יחס הגובה‑רוחב שלה. תגיות בצורות של קבוצות צורות, כולל קבוצות מקוננות, מעובדות כעת כמו צורות אחרות.

נתיבי תמונה יחסיים מפוענחים ביחס לתיקיית התבנית

תגית <<image>> שמקבלת נתיב קובץ יחסי מהנתונים, כגון Images/photo.png, כעת מפוענחת ביחס לתיקיית התבנית תחילה, בדומה למשאבים מקושרים של מסמכי Microsoft Office. עבור תבנית שנקראה מזרם, קבע את התיקייה עם LoadSaveOptions.setResourceLoadBaseUri:

DocumentAssembler assembler = new DocumentAssembler();

// A template loaded from a stream has no folder: set it with setResourceLoadBaseUri.
LoadSaveOptions options = new LoadSaveOptions();
options.setResourceLoadBaseUri("C:\\Reports\\Templates");

try (InputStream template = new FileInputStream("C:\\Reports\\Templates\\Inserting image.docx");
     OutputStream report = new FileOutputStream("output-from-stream.docx"))
{
    assembler.assembleDocument(template, report, options, new DataSourceInfo("../Images/no-photo.jpg", "expression"));
}

אם אין קובץ שם, הספרייה הנוכחית משמשת כמו קודם.

מחרוזות צבע הקס

צבע המוגדר כמחרוזת יכול כעת להיות ערך הקס — "#RRGGBB", "#RGB" או "#AARRGGBB" — בנוסף לשם צבע ולמספר שלם ARGB, ב‑backColor ובתגיות צבע של גרפים. לדוגמה, <<backColor [item.Color]>> עם "#FF0000" שמגיע מהנתונים כעת מיישם אדום.

תיקונים

  • בוליאנים חסרים בנתוני JSON, XML ו‑CSV נחשבים כ‑false באופרטור התנאי ?: ובפרדיקטים של where, count, any, all ו‑first, במקום לגרום לשגיאה עם NullPointerException.
  • groupBy ו‑distinct על אובייקטים מקוננים של נתוני JSON ו‑XML משווים אובייקטים בערך, כך שלקוחות שווים יוצרים קבוצה אחת. JSON שנכתב עם הפניות משומרות ($id/$ref) נתמך כעת.
  • License.setLicense(InputStream) קורא ByteArrayInputStream מהסימון שלו ו‑FileInputStream ממיקום 0, כך שזרם שכבר שומש לרישיון מוצר GroupDocs אחר אינו נכשל יותר עם “Unexpected EOF in prolog”.
  • צריכת רישיון מדוד מדווחת כאשר הרכבת מסמך או יצירת תצוגה מקדימה מסתיימת, במקום מאוחר יותר מרקע.
  • דוחות טקסט ו‑HTML של תבניות רק ASCII נכתבים ב‑UTF-8, ולכן נתונים כגון Café או Привет אינם אובדים יותר ל‑windows-1252.
  • ברקודים שהטקסט שלהם מצויר על ידי המנוע (QR, DataMatrix, Aztec ואחרים) אינם נכשלים יותר כאשר גופן תיבת הטקסט שלהם אינו מותקן — בדרך כלל Calibri ב‑Linux. במקום זאת משתמשים בגופן fallback.
  • תבניות MSG: תגיות בנושא השיחה מעובדות כמו אלו של הנושא, כך ש‑Outlook מסדר את ההודעות בצורה נכונה.
  • <<doc>> בגיליון אלקטרוני, מצגת ותבנית טקסט נכשלת עם הודעה שאומרת שהתגית אינה נתמכת עבור הפורמט, ו‑assembleDocument שנכשל אינו משאיר קובץ פלט ריק.
  • תוכן HTML: תג ביטוי -html שמסיים את הפסקה שלו אינו משאיר פסקה ריקה נוספת אחרי HTML שמסתיים באלמנט בלוק (ASSEMBLYJAVA-354).
  • ברקודי GS1: GroupDocs.Assembly כעת מתקן טקסט קוד של ספרות בלבד של ברקודי EAN-14, SCC-14, SSCC-18 ו‑DataBar בעצמו, מכיוון ש‑Aspose.BarCode 26.10 הפסיק לעשות זאת, ולכן ברקודים אלה נשארים זהים ל‑26.10.1.

מנועי Aspose משודרגים ל‑26.10

GroupDocs.Assembly for Java 26.10.1 כלל ספריות Aspose מתחילת 2026, ולכן פגיעויות שתוקנו בהם מאז דווחו על ידי סורקי אבטחה. המנועים המובאים כעת:

מנוע 26.10.1 26.11
Aspose.Words for Java 26.3 26.10.1
Aspose.Cells for Java 26.3 26.10
Aspose.Slides for Java 26.2 26.10
Aspose.Email for Java 26.1 26.9
Aspose.BarCode for Java 26.6 26.10

קובץ ה‑POM שפורסם עדיין אינו מצהיר על תלותים. מכיוון שהמנועים עודכנו, מסמכים שנוצרו מחדש עשויים להיות שונים ברמת הבייט בעוד שהם נשארים זהים מבחינה ויזואלית ופונקציונלית. אם אתה משווה בייטים של הפלט שנוצר מול בסיסי נתונים שמורים, רענן את הבסיסים לאחר העדכון.

הערות למשתמשי Java

  • תאריכים עם Z או היסט בנתוני JSON או CSV הם ערכי java.util.Date של הרגע המדויק, ותבנית פורמט מדפיסה אותם באזור הזמן ברירת המחדל של ה‑JVM. עבור פלט שאינו תלוי בשרת, הפעל את ה‑JVM עם אזור זמן קבוע, לדוגמה -Duser.timezone=UTC.
  • ExternalResourceOrigin ו‑PreviewFormats הם מחלקות של קבועי int, כמו שאר המונים של API ה‑Java. CreatePageStream ו‑ReleasePageStream הם ממשקי פונקציונליים, ולכן ניתן להשתמש בלמבדות.

איך לקבל את העדכון

Maven

הוסף את מאגר GroupDocs ואת התלות ל‑pom.xml שלך:

<repositories>
    <repository>
        <id>groupdocs-artifacts-repository</id>
        <name>GroupDocs Artifacts Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-assembly</artifactId>
        <version>26.11</version>
    </dependency>
</dependencies>

הורדה ישירה

הורד את קובץ ה‑JAR מדף ההורדה של GroupDocs.Assembly for Java 26.11.

משאבים