Siamo lieti di annunciare il rilascio di GroupDocs.Assembly for Java 26.11, disponibile a partire da novembre 2026. Questa versione porta le funzionalità e le correzioni di GroupDocs.Assembly per .NET 26.11 su Java:
- i modelli possono essere verificati rispetto a uno JSON Schema;
- le pagine dei modelli e dei report possono essere renderizzate in immagini;
- il caricamento delle risorse esterne è sotto il controllo dell’applicazione;
REMOVE_EMPTY_PARAGRAPHSfunziona per i modelli foglio di calcolo e testo semplice;- i tag
<<image>>funzionano nelle celle delle tabelle delle presentazioni e risolvono i percorsi relativi rispetto alla cartella del modello; - i tag colore accettano stringhe esadecimali.
I motori Aspose inclusi passano dalle loro versioni iniziali del 2026 a 26.10, e una serie di correzioni coprono licenze, codifica dei report, codici a barre e contenuto HTML. Java 8 rimane la baseline.
Novità di questa versione
| Chiave | Sommario | Categoria |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource accetta un JSON Schema: i membri dichiarati nello schema possono essere referenziati anche quando sono null, vuoti o mancanti nei dati, e i tipi di valore provengono dallo schema | Funzionalità |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview renderizza le pagine dei modelli, dei report assemblati e di altri documenti in immagini PNG, JPEG o BMP | Funzionalità |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funziona per i modelli di foglio di calcolo e i documenti di testo semplice |
Funzionalità |
| ASSEMBLYNET-140 | Le risorse esterne referenziate da modelli e dati sono sotto il controllo dell’applicazione; le risorse le cui referenze provengono dai dati vengono ignorate per impostazione predefinita | Sicurezza |
| ASSEMBLYJAVA-353 | Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 e Aspose.BarCode 26.10 sono incluse | Aggiornamento |
| ASSEMBLYJAVA-353 | I codici a barre GS1 (EAN-14, SCC-14, SSCC-18 e DataBar) mantengono l’auto‑correzione del loro testo di codice con Aspose.BarCode 26.10 | Correzione |
| ASSEMBLYNET-52 | Un tag <<image>> funziona in una cella di tabella di una presentazione, e i tag nelle forme di gruppi di forme vengono elaborati |
Miglioramento |
| ASSEMBLYNET-62 | Un percorso immagine relativo dai dati viene risolto rispetto alla cartella del modello | Miglioramento |
| ASSEMBLYNET-25 | Un colore fornito come stringa può essere un valore esadecimale in backColor e nei tag colore dei grafici |
Miglioramento |
| ASSEMBLYNET-155 | Un Boolean mancante nei dati JSON, XML o CSV conta come false in ?: e in where, count, any, all e first invece di generare un errore |
Correzione |
| ASSEMBLYNET-157 | groupBy e distinct su oggetti nidificati uniscono oggetti uguali; i riferimenti $id/$ref dei dati JSON sono supportati |
Correzione |
| ASSEMBLYNET-142 | License.setLicense(InputStream) legge un flusso che è già stato letto dall’inizio |
Correzione |
| ASSEMBLYNET-143 | Il consumo di una licenza a consumo viene segnalato al completamento di un’operazione | Correzione |
| ASSEMBLYNET-158 | I report di testo e HTML dei modelli solo ASCII sono scritti in UTF-8, così i dati non latini non vengono più persi | Correzione |
| ASSEMBLYNET-160 | I codici a barre non falliscono più con NullPointerException quando il font della loro casella di testo non è installato |
Correzione |
| ASSEMBLYNET-159 | I tag nell’oggetto della conversazione di un modello MSG sono assemblati come quelli del suo oggetto | Correzione |
| ASSEMBLYNET-152 | Un tag <<doc>> in un modello di foglio di calcolo, presentazione o testo fallisce con un messaggio chiaro; un assembleDocument fallito non lascia alcun file di output vuoto |
Correzione |
| ASSEMBLYJAVA-354 | Un tag di espressione -html che termina il suo paragrafo non lascia più un paragrafo vuoto dopo HTML che termina con un elemento di blocco |
Correzione |
Modifiche di comportamento da verificare prima dell’aggiornamento
- Le risorse esterne dai dati vengono ignorate per impostazione predefinita. Ad esempio,
<<image [item.PhotoUrl]>>dovePhotoUrlè un URI http o https ora restituisce un’immagine vuota. Aggiungi gli host aLoadSaveOptions.getWhitelistedResources(), o chiamaLoadSaveOptions.setSkipExternalResources(false)per mantenere il comportamento precedente. Le risorse referenziate dal modello stesso e i percorsi di file locali funzionano come prima. - Chiamata ambigua a
JsonDataSource.new JsonDataSource(path, null)con un secondo argomento letteralenullnon compila più. Cast l’argomento:new JsonDataSource(path, (JsonDataLoadOptions) null). Le applicazioni compilate non sono interessate. - Report di testo e HTML in UTF-8. I report di modelli di testo e HTML solo ASCII senza un byte order mark sono ora scritti in UTF-8 invece di windows-1252. Per mantenere una pagina di codifica a byte singolo, dichiara nel modello (
<meta charset>in HTML). groupByedistinctsu oggetti nidificati dei dati JSON, XML e DataSet ora uniscono oggetti uguali invece di creare un gruppo per riga.- Nessun paragrafo extra dopo HTML. Un tag
-htmlche termina il suo paragrafo non lascia più un paragrafo vuoto dopo HTML che termina con un elemento di blocco. Per mantenere una riga vuota, termina l’HTML con<p> </p>. - Codici a barre DataBar Expanded. Un codice a barre DataBar Expanded o DataBar Expanded Stacked con testo di codice solo numeri è ora codificato come GTIN con l’identificatore di applicazione (01), come gli altri tipi DataBar.
- Testo dell’eccezione modificato per un tag
<<doc>>in modelli di foglio di calcolo, presentazione e testo; il tipo di eccezione è lo stesso. - API rimossa.
ICustomFontsHandler.resetFontSources()è stata rimossa; chiama inveceFontSettings.resetFontSources().
Nuove funzionalità
Supporto JSON Schema per JsonDataSource
Un modello è verificato rispetto alla struttura dei suoi dati prima che qualsiasi <<if>> venga valutato. Con JSON, quella struttura veniva ricavata dai dati stessi, quindi un riferimento all’interno di un ramo che non viene mai renderizzato falliva quando i dati dietro di esso erano null, un array vuoto o mancanti.
JsonDataSource ora accetta un JSON Schema, allo stesso modo in cui XmlDataSource accetta un XML Schema, e il modello è verificato rispetto allo schema:
- i membri dichiarati nello schema possono essere referenziati anche se sono null, vuoti o assenti nei dati;
- i membri non dichiarati nello schema falliscono comunque, così i nomi errati vengono rilevati come prima;
- i tipi di valore provengono dallo schema, così un boolean è un
Booleane una stringa contenente cifre rimane una stringa.
Dato un cliente senza carte di pagamento e senza dati di fidelizzazione, e un numero di conto che è una stringa di cifre:
{ "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" } } }
}
}
e questo modello:
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]>>
passa lo schema accanto ai dati:
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
Il risultato è No payment card on file. con il numero di conto 00042. Senza lo schema, lo stesso modello fallisce su customer.Cards.first().Type, e il numero di conto viene letto come il numero 42.
Lo schema può essere fornito come percorso file o come InputStream, con o senza JsonDataLoadOptions. Le parole chiave supportate sono type (inclusi i tipi nullable), properties, items, format (date-time e date), enum, const, allOf e puntatori $ref locali. oneOf, anyOf, not, $ref remoti o ricorsivi, items a forma di tupla e array di array non sono supportati.
Anteprima del documento
DocumentAssembler.generatePreview renderizza le pagine di un documento in immagini PNG, JPEG o BMP: un modello, un documento assemblato da GroupDocs.Assembly, o qualsiasi altro documento di un formato supportato, da un file o da uno stream. Vengono renderizzate le pagine di documenti di elaborazione testi, testo e HTML, le pagine stampate di fogli di calcolo, le diapositive di presentazioni e i messaggi email con la loro intestazione.
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);
Quando sia setWidth che setHeight sono impostati, le pagine sono scalate per adattarsi a quella dimensione mantenendo il loro rapporto d’aspetto. Le anteprime sono generate senza caricare risorse esterne, e le immagini generate sono conteggiate dalla licenza a consumo come i documenti assemblati.
REMOVE_EMPTY_PARAGRAPHS per modelli di foglio di calcolo e testo semplice
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS ora funziona anche per i modelli di foglio di calcolo e i documenti di testo semplice. In questo caso, un paragrafo è una riga di testo: una riga del testo di una cella, o di un documento di testo, che diventa vuota dopo l’elaborazione dei tag del modello viene rimossa insieme al suo ritorno a capo. I tag come <<if>> e <<foreach>> scritti su linee proprie non lasciano più righe vuote.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
Template:
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
Result:
Prefix
Suffix
Lo stesso testo del modello in una cella di foglio di calcolo produce lo stesso risultato all’interno della cella. I documenti HTML e XML rimangono invariati.
Sicurezza: controllo delle risorse esterne
Un tag <<image>> o <<doc>> può valutare a un URI preso dai dati, e GroupDocs.Assembly lo recuperava senza possibilità di impedirlo. Un server che assembla documenti da dati forniti da altri potrebbe quindi essere indotto a richiedere indirizzi interni.
GroupDocs.Assembly ora indica da dove proviene ogni riferimento a una risorsa esterna (ExternalResourceOrigin):
TEMPLATE— il documento modello referenzia la risorsa stessa, includendo un URI letterale in un tag come<<image ["https://example.com/logo.png"]>>;DATA— il riferimento proviene dai dati, come un URI a cui una espressione del tag valuta.
Per impostazione predefinita, le risorse referenziate dal modello vengono caricate come prima, e le risorse i cui riferimenti provengono dai dati vengono ignorate. Quattro membri di LoadSaveOptions controllano questo:
setSkipExternalResources(trueper impostazione predefinita) — le risorse esterne non vengono caricate;setTrustTemplateResources(trueper impostazione predefinita) — le risorse referenziate dal modello vengono caricate anche quando il salto è attivo; impostalo afalsequando i modelli provengono da fonti non attendibili;getWhitelistedResources— nomi host o prefissi URI assoluti consentiti anche quando il salto è attivo;setExternalResourceHandler— unExternalResourceHandlerchiamato per ogni risorsa esterna prima che venga richiesta, per consentirla, saltarla o fornire il suo contenuto.
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);
}
}
}
}
Le risorse esterne sono risorse che raggiungono la rete: URI http, https e ftp, percorsi UNC e URI file con host remoto. I percorsi di file locali non sono interessati. Un’immagine ignorata di un documento è sostituita con un’immagine trasparente; un valore <<image>> o <<doc>> ignorato è trattato come valore vuoto.
Miglioramenti
Immagini nelle celle delle tabelle e nelle forme di gruppo delle presentazioni
In un modello di presentazione, un tag <<image>> poteva essere inserito solo in una casella di testo. Ora una cella di tabella è anche un contenitore di immagine: l’immagine diventa il riempimento della cella, includendo le celle delle righe ripetute da <<foreach>>, così è possibile costruire una tabella che elenca elementi con le loro immagini. Con -fitHeight, la riga cresce per mostrare l’immagine mantenendo il suo rapporto d’aspetto. I tag nelle forme di gruppi di forme, inclusi i gruppi nidificati, sono ora elaborati come le altre forme.
Percorsi immagine relativi risolti rispetto alla cartella del modello
Un tag <<image>> che ottiene un percorso file relativo dai dati, come Images/photo.png, ora lo risolve prima rispetto alla cartella del modello, per analogia con le risorse collegate dei documenti Microsoft Office. Per un modello caricato da uno stream, imposta la cartella con 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"));
}
Se non esiste alcun file lì, la directory corrente è usata come prima.
Stringhe colore esadecimali
Un colore fornito come stringa può ora essere un valore esadecimale — "#RRGGBB", "#RGB" o "#AARRGGBB" — oltre a un nome colore e a un intero ARGB, nei tag backColor e nei tag colore dei grafici. Per esempio, <<backColor [item.Color]>> con "#FF0000" proveniente dai dati ora applica il rosso.
Correzioni
- I Boolean mancanti nei dati JSON, XML e CSV ora contano come
falsenell’operatore condizionale?:e nei predicati diwhere,count,any,allefirst, invece di fallire con unNullPointerException. groupByedistinctsu oggetti nidificati dei dati JSON e XML confrontano gli oggetti per valore, così clienti uguali formano un unico gruppo. JSON scritto con riferimenti preservati ($id/$ref) è ora supportato.License.setLicense(InputStream)legge unByteArrayInputStreamdal suo segno e unFileInputStreamdalla posizione 0, così uno stream già usato per licenziare un altro prodotto GroupDocs non fallisce più con “Unexpected EOF in prolog”.- Il consumo a consumo è segnalato al completamento dell’assemblaggio di un documento o della generazione di un’anteprima, invece che più tardi da un thread in background.
- I report di testo e HTML dei modelli solo ASCII sono scritti in UTF-8, così dati come
CaféoПриветnon vengono più persi su windows-1252. - I codici a barre il cui testo è disegnato dal motore (QR, DataMatrix, Aztec e altri) non falliscono più quando il font della loro casella di testo non è installato — tipicamente Calibri su Linux. Viene usato un font di fallback.
- Modelli MSG: i tag nell’oggetto della conversazione sono elaborati come quelli dell’oggetto, così Outlook raggruppa correttamente i messaggi.
<<doc>>in modelli di foglio di calcolo, presentazione e testo fallisce con un messaggio che indica che il tag non è supportato per il formato, e unassembleDocumentfallito non lascia più un file di output vuoto.- Contenuto HTML: un tag di espressione
-htmlche termina il suo paragrafo non lascia più un paragrafo vuoto extra dopo HTML che termina con un elemento di blocco (ASSEMBLYJAVA-354). - Codici a barre GS1: GroupDocs.Assembly ora corregge autonomamente i testi di codice solo numerici dei codici a barre EAN-14, SCC-14, SSCC-18 e DataBar, poiché Aspose.BarCode 26.10 ha smesso di farlo, così questi codici a barre rimangono gli stessi di 26.10.1.
Motori Aspose aggiornati a 26.10
GroupDocs.Assembly for Java 26.10.1 include librerie Aspose dal primo 2026, quindi le vulnerabilità corrette in esse da allora sono state segnalate dagli scanner di sicurezza. I motori inclusi sono ora:
| Motore | 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 |
Il POM pubblicato continua a non dichiarare dipendenze. Poiché i motori sono stati aggiornati, i documenti rigenerati possono differire a livello di byte pur rimanendo visivamente e funzionalmente equivalenti. Se confronti byte per byte l’output generato con baseline memorizzate, aggiorna quelle baseline dopo l’aggiornamento.
Note per gli utenti Java
- Date con
Zo un offset nei dati JSON o CSV sono valorijava.util.Datedi quell’esatto istante, e un pattern di formato li stampa nel fuso orario predefinito della JVM. Per un output che non dipende dal server, esegui la JVM con un fuso orario fisso, ad esempio-Duser.timezone=UTC. ExternalResourceOriginePreviewFormatssono classi di costantiint, come le altre enumerazioni dell’API Java.CreatePageStreameReleasePageStreamsono interfacce funzionali, quindi le lambda sono adatte.
Come ottenere l’aggiornamento
Maven
Aggiungi il repository GroupDocs e la dipendenza al tuo 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>
Download diretto
Scarica il JAR dalla pagina di download di GroupDocs.Assembly for Java 26.11.