Nous sommes heureux d’annoncer la sortie de GroupDocs.Assembly for Java 26.11, disponible depuis novembre 2026. Cette version apporte les fonctionnalités et correctifs de GroupDocs.Assembly for .NET 26.11 à Java :
- les modèles peuvent être vérifiés par rapport à un JSON Schema ;
- les pages des modèles et des rapports peuvent être rendus en images ;
- le chargement des ressources externes est sous le contrôle de l’application ;
REMOVE_EMPTY_PARAGRAPHSfonctionne pour les modèles de feuilles de calcul et de texte brut ;- les balises
<<image>>fonctionnent dans les cellules de tableau des présentations et résolvent les chemins relatifs par rapport au dossier du modèle ; - les balises de couleur acceptent les chaînes hexadécimales.
Les moteurs Aspose fournis passent de leurs versions début 2026 à 26.10, et un certain nombre de correctifs couvrent la licence, l’encodage des rapports, les codes‑barres et le contenu HTML. Java 8 reste la version de référence.
Nouveautés de cette version
| Clé | Résumé | Catégorie |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource accepte un JSON Schema : les membres déclarés dans le schéma peuvent être référencés même lorsqu’ils sont null, vides ou manquants dans les données, et les types de valeur proviennent du schéma |
Fonctionnalité |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview rend les pages des modèles, des rapports assemblés et d’autres documents en images PNG, JPEG ou BMP |
Fonctionnalité |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS fonctionne pour les modèles de feuilles de calcul et les documents texte brut |
Fonctionnalité |
| ASSEMBLYNET-140 | Les ressources externes référencées par les modèles et les données sont sous le contrôle de l’application ; les ressources dont les références proviennent des données sont ignorées par défaut | Sécurité |
| ASSEMBLYJAVA-353 | Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 et Aspose.BarCode 26.10 sont fournis | Mise à jour |
| ASSEMBLYJAVA-353 | Les codes‑barres GS1 (EAN-14, SCC-14, SSCC-18 et DataBar) conservent l’auto‑correction de leur texte de code avec Aspose.BarCode 26.10 | Correction |
| ASSEMBLYNET-52 | Une balise <<image>> fonctionne dans une cellule de tableau d’une présentation, et les balises dans les formes de groupes de formes sont traitées |
Amélioration |
| ASSEMBLYNET-62 | Un chemin d’image relatif provenant des données est résolu par rapport au dossier du modèle | Amélioration |
| ASSEMBLYNET-25 | Une couleur donnée sous forme de chaîne peut être une valeur hexadécimale dans backColor et les balises de couleur de graphique |
Amélioration |
| ASSEMBLYNET-155 | Un booléen manquant dans les données JSON, XML ou CSV est considéré comme false dans ?: et dans where, count, any, all et first au lieu d’échouer avec un NullPointerException |
Correction |
| ASSEMBLYNET-157 | groupBy et distinct sur des objets imbriqués fusionnent les objets égaux ; les références $id/$ref des données JSON sont prises en charge |
Correction |
| ASSEMBLYNET-142 | License.setLicense(InputStream) lit un flux qui a déjà été lu depuis le début |
Correction |
| ASSEMBLYNET-143 | La consommation d’une licence à comptage est signalée lorsqu’une opération se termine | Correction |
| ASSEMBLYNET-158 | Les rapports texte et HTML des modèles uniquement ASCII sont écrits en UTF-8, de sorte que les données non latines ne sont plus perdues | Correction |
| ASSEMBLYNET-160 | Les codes‑barres ne génèrent plus de NullPointerException lorsque la police de leur zone de texte n’est pas installée |
Correction |
| ASSEMBLYNET-159 | Les balises dans le sujet de conversation d’un modèle MSG sont assemblées comme celles de son objet | Correction |
| ASSEMBLYNET-152 | Une balise <<doc>> dans un modèle de feuille de calcul, de présentation ou de texte échoue avec un message clair ; un assembleDocument échoué ne laisse aucun fichier de sortie vide |
Correction |
| ASSEMBLYJAVA-354 | Une balise d’expression -html terminant son paragraphe ne laisse plus de paragraphe vide après un HTML se terminant par un élément de bloc |
Correction |
Modifications de comportement à vérifier avant la mise à jour
- Les ressources externes provenant des données sont ignorées par défaut. Par exemple,
<<image [item.PhotoUrl]>>oùPhotoUrlest une URI http ou https renvoie maintenant une image vide. Ajoutez les hôtes àLoadSaveOptions.getWhitelistedResources(), ou appelezLoadSaveOptions.setSkipExternalResources(false)pour conserver le comportement précédent. Les ressources référencées par le modèle lui‑-même et les chemins de fichiers locaux fonctionnent comme avant. - Appel ambigu de
JsonDataSource.new JsonDataSource(path, null)avec un second argument littéralnullne compile plus. Castiez l’argument :new JsonDataSource(path, (JsonDataLoadOptions) null). Les applications déjà compilées ne sont pas affectées. - Rapports texte et HTML en UTF-8. Les rapports des modèles texte et HTML uniquement ASCII sans marque d’ordre des octets sont maintenant écrits en UTF-8 au lieu de windows-1252. Pour conserver une page de code à octet unique, déclarez‑la dans le modèle (
<meta charset>en HTML). groupByetdistinctsur des objets imbriqués des données JSON, XML et DataSet fusionnent désormais les objets égaux au lieu de créer un groupe par ligne.- Pas de paragraphe supplémentaire après le HTML. Une balise
-htmlterminant son paragraphe ne laisse plus de paragraphe vide après un HTML se terminant par un élément de bloc. Pour conserver une ligne vide, terminez le HTML avec<p> </p>. - Codes‑barres DataBar Expanded. Un code‑barres DataBar Expanded ou DataBar Expanded Stacked avec un texte de code composé uniquement de chiffres est maintenant encodé comme un GTIN avec l’identifiant d’application (01), comme les autres types de DataBar.
- Texte d’exception modifié pour une balise
<<doc>>dans les modèles de feuille de calcul, de présentation et de texte ; le type d’exception reste le même. - API supprimée.
ICustomFontsHandler.resetFontSources()est supprimée ; appelezFontSettings.resetFontSources()à la place.
Nouvelles fonctionnalités
Prise en charge du JSON Schema pour JsonDataSource
Un modèle est vérifié par rapport à la structure de ses données avant que tout <<if>> ne soit évalué. Avec JSON, cette structure était auparavant tirée des données elles‑mêmes, de sorte qu’une référence à l’intérieur d’une branche qui ne s’affiche jamais échouait lorsque les données correspondantes étaient null, un tableau vide ou manquantes.
JsonDataSource accepte désormais un JSON Schema, de la même manière que XmlDataSource accepte un XML Schema, et le modèle est vérifié par rapport au schéma :
- les membres déclarés dans le schéma peuvent être référencés même s’ils sont null, vides ou absents dans les données ;
- les membres non déclarés dans le schéma échouent toujours, ainsi les noms mal orthographiés sont détectés comme auparavant ;
- les types de valeur proviennent du schéma, ainsi un booléen est un
Booleanet une chaîne contenant des chiffres reste une chaîne.
Étant donné un client sans cartes de paiement et sans données de fidélité, et un numéro de compte qui est une chaîne de chiffres :
{ "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" } } }
}
}
et ce modèle :
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]>>
passez le schéma à côté des données :
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
Le résultat est No payment card on file. avec le numéro de compte 00042. Sans le schéma, le même modèle échoue sur customer.Cards.first().Type, et le numéro de compte est lu comme le nombre 42.
Le schéma peut être fourni sous forme de chemin de fichier ou d’InputStream, avec ou sans JsonDataLoadOptions. Les mots‑clés pris en charge sont type (y compris les types nullable), properties, items, format (date-time et date), enum, const, allOf et les pointeurs $ref locaux. oneOf, anyOf, not, les $ref distants ou récursifs, les items de forme tuple et les tableaux de tableaux ne sont pas pris en charge.
Aperçu de document
DocumentAssembler.generatePreview rend les pages d’un document en images PNG, JPEG ou BMP : un modèle, un document assemblé par GroupDocs.Assembly, ou tout autre document d’un format pris en charge, à partir d’un fichier ou d’un flux. Les pages des documents de traitement de texte, texte et HTML, les pages imprimées des feuilles de calcul, les diapositives des présentations et les messages électroniques avec leur en‑tête sont rendus.
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);
Lorsque setWidth et setHeight sont tous deux définis, les pages sont redimensionnées pour s’adapter à cette taille tout en conservant leur ratio d’aspect. Les aperçus sont générés sans charger de ressources externes, et les images générées sont comptées par la licence à comptage comme les documents assemblés.
REMOVE_EMPTY_PARAGRAPHS pour les modèles de feuilles de calcul et de texte brut
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS fonctionne désormais également pour les modèles de feuilles de calcul et les documents texte brut. Dans ce cas, un paragraphe est une ligne de texte : une ligne du texte d’une cellule, ou d’un document texte, qui devient vide après le traitement des balises du modèle est supprimée avec son saut de ligne. Les balises telles que <<if>> et <<foreach>> écrites sur leurs propres lignes ne laissent plus de lignes vides derrière elles.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
Modèle :
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
Résultat :
Prefix
Suffix
Le même texte de modèle dans une cellule de feuille de calcul donne le même résultat dans la cellule. Les documents HTML et XML restent tels quels.
Sécurité : contrôle des ressources externes
Une balise <<image>> ou <<doc>> peut évaluer à une URI provenant des données, et GroupDocs.Assembly la récupérait sans moyen de l’empêcher. Un serveur assemblant des documents à partir de données fournies par d’autres pourrait ainsi être amené à demander des adresses internes.
GroupDocs.Assembly indique désormais d’où provient chaque référence à une ressource externe (ExternalResourceOrigin) :
TEMPLATE— le document modèle référence la ressource elle‑même, y compris une URI littérale dans une balise comme<<image ["https://example.com/logo.png"]>>;DATA— la référence provient des données, comme une URI évaluée par une expression de balise.
Par défaut, les ressources référencées par le modèle sont chargées comme auparavant, et les ressources dont les références proviennent des données sont ignorées. Quatre membres de LoadSaveOptions contrôlent cela :
setSkipExternalResources(truepar défaut) — les ressources externes ne sont pas chargées ;setTrustTemplateResources(truepar défaut) — les ressources référencées par le modèle sont chargées même lorsque l’ignorance est activée ; réglez‑le surfalselorsque les modèles proviennent de sources non fiables ;getWhitelistedResources— noms d’hôtes ou préfixes d’URI absolus autorisés même lorsque l’ignorance est activée ;setExternalResourceHandler— unExternalResourceHandlerappelé pour chaque ressource externe avant qu’elle ne soit demandée, afin de l’autoriser, l’ignorer ou fournir son contenu.
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);
}
}
}
}
Les ressources externes sont les ressources accédant au réseau : URI http, https et ftp, chemins UNC et URI de fichiers avec un hôte distant. Les chemins de fichiers locaux ne sont pas affectés. Une image ignorée d’un document est remplacée par une image transparente ; une valeur <<image>> ou <<doc>> ignorée est traitée comme une valeur vide.
Améliorations
Images dans les cellules de tableau et les groupes de formes des présentations
Dans un modèle de présentation, une balise <<image>> ne pouvait être placée que dans une zone de texte. Une cellule de tableau est désormais également un conteneur d’image : l’image devient le remplissage de la cellule, y compris les cellules des lignes répétées par <<foreach>>, ce qui permet de créer un tableau listant les éléments avec leurs images. Avec -fitHeight, la ligne s’agrandit pour afficher l’image avec son ratio d’aspect. Les balises dans les formes de groupes de formes, y compris les groupes imbriqués, sont maintenant traitées comme les autres formes.
Chemins d’image relatifs résolus par rapport au dossier du modèle
Une balise <<image>> qui obtient un chemin de fichier relatif à partir des données, tel que Images/photo.png, résout désormais ce chemin d’abord par rapport au dossier du modèle, par analogie avec les ressources liées des documents Microsoft Office. Pour un modèle chargé depuis un flux, définissez le dossier avec 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"));
}
Si aucun fichier n’existe à cet emplacement, le répertoire courant est utilisé comme auparavant.
Chaînes de couleur hexadécimales
Une couleur donnée sous forme de chaîne peut désormais être une valeur hexadécimale — "#RRGGBB", "#RGB" ou "#AARRGGBB" — en plus d’un nom de couleur et d’un entier ARGB, dans les balises backColor et de couleur de graphique. Par exemple, <<backColor [item.Color]>> avec "#FF0000" provenant des données applique maintenant le rouge.
Corrections
- Booléens manquants dans les données JSON, XML et CSV sont maintenant comptés comme
falsedans l’opérateur conditionnel?:et dans les prédicats dewhere,count,any,alletfirst, au lieu d’échouer avec unNullPointerException. groupByetdistinctsur des objets imbriqués des données JSON et XML comparent les objets par valeur, de sorte que des clients égaux forment un seul groupe. Le JSON écrit avec des références préservées ($id/$ref) est désormais pris en charge.License.setLicense(InputStream)lit unByteArrayInputStreamdepuis sa marque et unFileInputStreamdepuis la position 0, de sorte qu’un flux déjà utilisé pour licencier un autre produit GroupDocs ne échoue plus avec « Unexpected EOF in prolog ».- Consommation à comptage est signalée lorsque l’assemblage d’un document ou la génération d’un aperçu se termine, au lieu d’être signalée plus tard par un thread en arrière‑plan.
- Rapports texte et HTML des modèles uniquement ASCII sont écrits en UTF-8, de sorte que des données comme
CaféouПриветne sont plus perdues dans windows-1252. - Codes‑barres dont le texte du code est dessiné par le moteur (QR, DataMatrix, Aztec et autres) ne génèrent plus d’erreur lorsque la police de leur zone de texte n’est pas installée — typiquement Calibri sous Linux. Une police de secours est utilisée à la place.
- Modèles MSG : les balises dans le sujet de conversation sont traitées comme celles de l’objet, de sorte qu’Outlook regroupe correctement les messages.
<<doc>>dans les modèles de feuille de calcul, de présentation et de texte échoue avec un message indiquant que la balise n’est pas prise en charge pour le format, et unassembleDocumentéchoué ne laisse plus de fichier de sortie vide.- Contenu HTML : une balise d’expression
-htmlterminant son paragraphe ne laisse plus de paragraphe vide supplémentaire après un HTML se terminant par un élément de bloc (ASSEMBLYJAVA-354). - Codes‑barres GS1 : GroupDocs.Assembly corrige désormais les textes de code composés uniquement de chiffres des codes‑barres EAN-14, SCC-14, SSCC-18 et DataBar lui‑même, car Aspose.BarCode 26.10 a cessé de le faire, de sorte que ces codes‑barres restent les mêmes qu’en 26.10.1.
Moteurs Aspose mis à jour vers 26.10
GroupDocs.Assembly for Java 26.10.1 incluait les bibliothèques Aspose du début 2026, de sorte que les vulnérabilités corrigées depuis ont été signalées par les scanners de sécurité. Les moteurs fournis sont maintenant :
| Moteur | 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 |
Le POM publié ne déclare toujours aucune dépendance. Parce que les moteurs ont été rafraîchis, les documents régénérés peuvent différer au niveau des octets tout en restant visuellement et fonctionnellement équivalents. Si vous comparez les octets de la sortie générée avec des références stockées, rafraîchissez ces références après la mise à jour.
Remarques pour les utilisateurs Java
- Dates avec
Zou un décalage dans les données JSON ou CSV sont des valeursjava.util.Datede cet instant exact, et un modèle de format les imprime dans le fuseau horaire par défaut de la JVM. Pour une sortie qui ne dépend pas du serveur, exécutez la JVM avec un fuseau horaire fixe, par exemple-Duser.timezone=UTC. ExternalResourceOriginetPreviewFormatssont des classes de constantesint, comme les autres énumérations de l’API Java.CreatePageStreametReleasePageStreamsont des interfaces fonctionnelles, donc les lambdas conviennent.
Comment obtenir la mise à jour
Maven
Ajoutez le dépôt GroupDocs et la dépendance à votre 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>
Téléchargement direct
Téléchargez le JAR depuis la page de téléchargement GroupDocs.Assembly for Java 26.11.