S potěšením oznamujeme vydání GroupDocs.Assembly for Java 26.11, dostupné od listopadu 2026. Toto vydání přináší funkce a opravy z GroupDocs.Assembly pro .NET 26.11 do Javy:

  • šablony mohou být kontrolovány vůči JSON Schema;
  • stránky šablon a zpráv mohou být vykresleny do obrázků;
  • načítání externích zdrojů je pod kontrolou aplikace;
  • REMOVE_EMPTY_PARAGRAPHS funguje pro šablony tabulek a prostý text;
  • tagy <<image>> fungují v buňkách tabulky prezentací a rozřeší relativní cesty vůči složce šablony;
  • tagy barev přijímají hex řetězce.

Balíčkové enginy Aspose přecházejí ze svých raných verzí 2026 na 26.10 a řada oprav zahrnuje licencování, kódování reportů, čárové kódy a HTML obsah. Java 8 zůstává výchozím.

Co je nového v tomto vydání

Klíč Shrnutí Kategorie
ASSEMBLYNET-145 JsonDataSource přijímá JSON Schema: členové deklarovaní ve schématu mohou být odkazováni i když jsou v datech null, prázdní nebo chybějící, a typy hodnot pocházejí ze schématu Funkce
ASSEMBLYNET-8 DocumentAssembler.generatePreview vykresluje stránky šablon, sestavených zpráv a dalších dokumentů do PNG, JPEG nebo BMP obrázků Funkce
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funguje pro šablony tabulek a prosté textové dokumenty Funkce
ASSEMBLYNET-140 Externí zdroje odkazované šablonami a daty jsou pod kontrolou aplikace; zdroje, jejichž odkazy pocházejí z dat, jsou ve výchozím nastavení přeskočeny Zabezpečení
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 a Aspose.BarCode 26.10 jsou zahrnuty Aktualizace
ASSEMBLYJAVA-353 GS1 čárové kódy (EAN-14, SCC-14, SSCC-18 a DataBar) zachovávají automatickou korekci textu kódu s Aspose.BarCode 26.10 Oprava
ASSEMBLYNET-52 <<image>> tag funguje v buňce tabulky prezentace a tagy ve tvarech skupinových tvarů jsou zpracovány Vylepšení
ASSEMBLYNET-62 Relativní cesta k obrázku z dat je rozřešena vůči složce šablony Vylepšení
ASSEMBLYNET-25 Barva zadaná jako řetězec může být hexadecimální hodnota v backColor a tagy barvy grafu Vylepšení
ASSEMBLYNET-155 Chybějící Boolean v JSON, XML nebo CSV datech se počítá jako false v ?: a v where, count, any, all a first místo selhání Oprava
ASSEMBLYNET-157 groupBy a distinct nad vnořenými objekty slučují stejné objekty; $id/$ref odkazy v JSON datech jsou podporovány Oprava
ASSEMBLYNET-142 License.setLicense(InputStream) čte proud, který již byl čten od jeho začátku Oprava
ASSEMBLYNET-143 Spotřeba měřené licence je hlášena po dokončení operace Oprava
ASSEMBLYNET-158 Textové a HTML zprávy ASCII‑only šablon jsou zapisovány v UTF‑8, takže ne‑latinská data již nejsou ztracena Oprava
ASSEMBLYNET-160 Čárové kódy již nepadnou s NullPointerException, když není nainstalováno písmo jejich textového pole Oprava
ASSEMBLYNET-159 Tagy v tématu konverzace MSG šablony jsou sestaveny jako tagy v předmětu Oprava
ASSEMBLYNET-152 <<doc>> tag v tabulce, prezentaci nebo textové šabloně selže s jasnou zprávou; neúspěšný assembleDocument nenechá prázdný výstupní soubor Oprava
ASSEMBLYJAVA-354 -html výrazový tag ukončující svůj odstavec již nenechává prázdný odstavec po HTML končícím blokovým elementem Oprava

Změny chování, které je třeba zkontrolovat před aktualizací

  1. Externí zdroje z dat jsou ve výchozím nastavení přeskočeny. Například <<image [item.PhotoUrl]>>, kde PhotoUrl je http nebo https URI, nyní vrátí prázdný obrázek. Přidejte hosty do LoadSaveOptions.getWhitelistedResources(), nebo zavolejte LoadSaveOptions.setSkipExternalResources(false), abyste zachovali předchozí chování. Zdroje odkazované samotnou šablonou a lokální souborové cesty fungují jako dříve.
  2. Nejednoznačné volání JsonDataSource. new JsonDataSource(path, null) s doslovným null jako druhým argumentem již nekompiluje. Přetypujte argument: new JsonDataSource(path, (JsonDataLoadOptions) null). Zkompilované aplikace nejsou ovlivněny.
  3. UTF-8 textové a HTML zprávy. Zprávy ASCII‑only textových a HTML šablon bez BOM jsou nyní zapisovány v UTF‑8 místo windows-1252. Pro zachování jednojádrové znakové sady ji deklarujte v šabloně (<meta charset> v HTML).
  4. groupBy a distinct nad vnořenými objekty JSON, XML a DataSet dat nyní slučují stejné objekty místo vytváření jedné skupiny na řádek.
  5. Žádný extra odstavec po HTML. -html tag ukončující svůj odstavec již nenechává prázdný odstavec po HTML končícím blokovým elementem. Pro zachování prázdného řádku ukončete HTML pomocí <p>&nbsp;</p>.
  6. DataBar Expanded čárové kódy. DataBar Expanded nebo DataBar Expanded Stacked čárový kód s textem kódu pouze z číslic je nyní kódován jako GTIN s aplikátorem (01), stejně jako ostatní typy DataBar.
  7. Změněný text výjimky pro <<doc>> tag v tabulce, prezentaci a textových šablonách; typ výjimky zůstává stejný.
  8. Odstraněné API. ICustomFontsHandler.resetFontSources() je odstraněno; místo toho použijte FontSettings.resetFontSources().

Nové funkce

Podpora JSON Schema pro JsonDataSource

Šablona je kontrolována vůči struktuře svých dat před vyhodnocením jakéhokoli <<if>>. U JSON se struktura dříve brala přímo z dat, takže odkaz uvnitř větve, která se nikdy nevykreslí, selhal, pokud data za ním byla null, prázdné pole nebo chybějící.

JsonDataSource nyní přijímá JSON Schema, stejně jako XmlDataSource přijímá XML Schema, a šablona je kontrolována proti schématu:

  • členové deklarovaní ve schématu mohou být odkazováni i když jsou v datech null, prázdní nebo chybějící;
  • členové nedeklarovaní ve schématu stále selžou, takže překlepy jsou detekovány jako dříve;
  • typy hodnot pocházejí ze schématu, takže boolean je Boolean a řetězec obsahující číslice zůstává řetězcem.

Příklad dat:

{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }

Schéma:

{
  "$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" } } }
  }
}

Šablona:

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]>>

Použijte schéma vedle dat:

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

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

Výsledek je No payment card on file. s číslem účtu 00042. Bez schématu selže stejná šablona na customer.Cards.first().Type a číslo účtu se načte jako číslo 42.

Schéma může být zadáno jako cesta k souboru nebo InputStream, s nebo bez JsonDataLoadOptions. Podporovaná klíčová slova jsou type (včetně nullable typů), properties, items, format (date-time a date), enum, const, allOf a lokální $ref ukazatele. oneOf, anyOf, not, vzdálené nebo rekurzivní $ref, tuple‑form items a pole polí nejsou podporovány.

Náhled dokumentu

DocumentAssembler.generatePreview vykresluje stránky dokumentu do PNG, JPEG nebo BMP obrázků: šablonu, dokument sestavený GroupDocs.Assembly nebo jakýkoli jiný podporovaný formát, ze souboru nebo proudu. Vykreslují se stránky textových, HTML dokumentů, tištěné stránky tabulek, snímky prezentací a e‑mailové zprávy s hlavičkou.

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);

Když jsou nastaveny jak setWidth, tak setHeight, stránky jsou škálovány tak, aby se vešly do dané velikosti při zachování poměru stran. Náhledy jsou generovány bez načítání externích zdrojů a generované obrázky jsou počítány v rámci měřené licence stejně jako sestavené dokumenty.

REMOVE_EMPTY_PARAGRAPHS pro šablony tabulek a prostého textu

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS nyní funguje i pro šablony tabulek a prosté textové dokumenty. Zde je odstavec řádek textu: řádek textu buňky nebo textového dokumentu, který po zpracování tagů šablony zůstane prázdný, je odstraněn spolu s koncem řádku. Tagy jako <<if>> a <<foreach>> psané na samostatných řádcích již nenechávají prázdné řádky.

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

Šablona:

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

Výsledek:

Prefix
Suffix

Stejný text šablony v buňce tabulky dává stejný výsledek v rámci buňky. HTML a XML dokumenty zůstávají beze změny.

Zabezpečení: kontrola externích zdrojů

Tag <<image>> nebo <<doc>> může vyhodnotit URI převzaté z dat a GroupDocs.Assembly jej dříve načítal bez možnosti zamezit tomu. Server, který sestavuje dokumenty z dat poskytnutých třetími stranami, tak mohl být přiměn požadovat interní adresy.

GroupDocs.Assembly nyní uvádí, odkud každá reference na externí zdroj pochází (ExternalResourceOrigin):

  • TEMPLATE — dokument šablony odkazuje na zdroj sám, včetně doslovného URI v tagu jako <<image ["https://example.com/logo.png"]>>;
  • DATA — reference pochází z dat, například URI, které vyhodnotí výraz tagu.

Ve výchozím nastavení jsou zdroje odkazované šablonou načítány jako dříve a zdroje, jejichž reference pocházejí z dat, jsou přeskočeny. Čtyři členové LoadSaveOptions toto řídí:

  • setSkipExternalResources (true ve výchozím nastavení) — externí zdroje nejsou načítány;
  • setTrustTemplateResources (true ve výchozím nastavení) — zdroje odkazované šablonou jsou načteny i při zapnutém přeskočení; nastavte na false, pokud šablony pocházejí z nedůvěryhodných zdrojů;
  • getWhitelistedResources — názvy hostitelů nebo absolutní URI prefixy povolené i při zapnutém přeskočení;
  • setExternalResourceHandler — ExternalResourceHandler volaný pro každý externí zdroj před jeho požadavkem, aby jej povolil, přeskočil nebo poskytl jeho obsah.
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);
            }
        }
    }
}

Externí zdroje jsou zdroje, které se dostanou na síť: http, https a ftp URI, UNC cesty a file URI s vzdáleným hostitelem. Lokální souborové cesty nejsou ovlivněny. Přeskočený obrázek v dokumentu je nahrazen transparentním obrázkem; přeskočená hodnota <<image>> nebo <<doc>> je považována za prázdnou.

Vylepšení

Obrázky v buňkách tabulky a skupinových tvarech prezentací

V šabloně prezentace mohl být tag <<image>> umístěn jen do textového pole. Buňka tabulky je nyní také kontejnerem pro obrázek: obrázek se stane výplní buňky, včetně buněk řádků opakovaných pomocí <<foreach>>, takže lze vytvořit tabulku s položkami a jejich obrázky. S -fitHeight řádek roste, aby zobrazil obrázek v poměru stran. Tagy ve tvarech skupinových tvarů, včetně vnořených skupin, jsou nyní zpracovány jako ostatní tvary.

Relativní cesty k obrázkům rozřešené vůči složce šablony

Tag <<image>>, který získá relativní cestu k souboru z dat, například Images/photo.png, ji nyní nejprve rozřeší vůči složce šablony, podobně jako propojené zdroje dokumentů Microsoft Office. Pro šablonu načtenou ze streamu nastavte složku pomocí 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"));
}

Pokud tam soubor neexistuje, použije se aktuální adresář jako dříve.

Hexadecimální řetězce barev

Barva zadaná jako řetězec může nyní být hexadecimální hodnota — "#RRGGBB", "#RGB" nebo "#AARRGGBB" — kromě názvu barvy a ARGB celého čísla, v backColor a tagy barvy grafu. Například <<backColor [item.Color]>> s "#FF0000" pocházejícím z dat nyní aplikuje červenou.

Opravy

  • Chybějící Booleany v JSON, XML a CSV datech se nyní počítají jako false v podmínkovém operátoru ?: a v predikátech where, count, any, all a first, místo selhání s NullPointerException.
  • groupBy a distinct nad vnořenými objekty JSON a XML dat porovnávají objekty podle hodnot, takže stejní zákazníci tvoří jednu skupinu. JSON zapisovaný s zachovanými odkazy ($id/$ref) je nyní podporován.
  • License.setLicense(InputStream) čte ByteArrayInputStream od svého marku a FileInputStream od pozice 0, takže proud již použitý k licencování jiného GroupDocs produktu již nehlásí “Unexpected EOF in prolog”.
  • Spotřeba měřené licence je hlášena po dokončení sestavení dokumentu nebo generování náhledu, místo později z background threadu.
  • Textové a HTML zprávy ASCII‑only šablon jsou zapisovány v UTF‑8, takže data jako Café nebo Привет již nejsou ztracena na windows‑1252.
  • Čárové kódy, jejichž text je kreslen enginem (QR, DataMatrix, Aztec a další) již nepadnou, když není nainstalováno písmo jejich textového pole — typicky Calibri na Linuxu. Místo toho se použije náhradní písmo.
  • MSG šablony: tagy v tématu konverzace jsou zpracovány jako tagy v předmětu, takže Outlook správně řetězí zprávy.
  • <<doc>> v tabulce, prezentaci a textových šablonách selže s hláškou, že tag není podporován pro daný formát, a neúspěšný assembleDocument již nenechá prázdný výstupní soubor.
  • HTML obsah: -html výrazový tag ukončující svůj odstavec již nenechává extra prázdný odstavec po HTML končícím blokovým elementem (ASSEMBLYJAVA-354).
  • GS1 čárové kódy: GroupDocs.Assembly nyní sám opravuje texty kódu pouze s číslicemi u EAN‑14, SCC‑14, SSCC‑18 a DataBar čárových kódů, protože Aspose.BarCode 26.10 to přestal dělat, takže tyto kódy zůstávají stejné jako v 26.10.1.

Aspose enginy aktualizovány na 26.10

GroupDocs.Assembly for Java 26.10.1 zahrnoval Aspose knihovny z počátku roku 2026, takže zranitelnosti opravené v nich od té doby byly nahlášeny bezpečnostními skenery. Zahrnuté enginy jsou nyní:

Engine 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

Publikovaný POM stále neuvádí žádné závislosti. Protože byly enginy obnoveny, mohou se vygenerované dokumenty lišit na úrovni bajtů, i když zůstávají vizuálně i funkčně ekvivalentní. Pokud porovnáváte bajty výstupu s uloženými referenčními soubory, po aktualizaci tyto referenční soubory obnovte.

Poznámky pro uživatele Javy

  • Data s Z nebo offsetem v JSON nebo CSV datech jsou java.util.Date hodnoty přesně v daném okamžiku a formátovací vzor je vypisuje ve výchozím časovém pásmu JVM. Pro výstup nezávislý na serveru spusťte JVM s pevně nastaveným časovým pásmem, např. -Duser.timezone=UTC.
  • ExternalResourceOrigin a PreviewFormats jsou třídy int konstant, podobně jako ostatní výčty Java API. CreatePageStream a ReleasePageStream jsou funkční rozhraní, takže lambda výrazy fungují.

Jak získat aktualizaci

Maven

Přidejte repozitář GroupDocs a závislost do svého 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>

Přímé stažení

Stáhněte JAR ze GroupDocs.Assembly for Java 26.11 download page.

Zdroje