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_PARAGRAPHS fonctionne 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

  1. Les ressources externes provenant des données sont ignorées par défaut. Par exemple, <<image [item.PhotoUrl]>> où PhotoUrl est une URI http ou https renvoie maintenant une image vide. Ajoutez les hôtes à LoadSaveOptions.getWhitelistedResources(), ou appelez LoadSaveOptions.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.
  2. Appel ambigu de JsonDataSource. new JsonDataSource(path, null) avec un second argument littéral null ne compile plus. Castiez l’argument : new JsonDataSource(path, (JsonDataLoadOptions) null). Les applications déjà compilées ne sont pas affectées.
  3. 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).
  4. groupBy et distinct sur 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.
  5. Pas de paragraphe supplémentaire après le HTML. Une balise -html terminant 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>&nbsp;</p>.
  6. 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.
  7. 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.
  8. API supprimée. ICustomFontsHandler.resetFontSources() est supprimée ; appelez FontSettings.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 Boolean et 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 (true par défaut) — les ressources externes ne sont pas chargées ;
  • setTrustTemplateResources (true par 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 sur false lorsque 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 — un ExternalResourceHandler appelé 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 false dans l’opérateur conditionnel ?: et dans les prédicats de where, count, any, all et first, au lieu d’échouer avec un NullPointerException.
  • groupBy et distinct sur 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 un ByteArrayInputStream depuis sa marque et un FileInputStream depuis 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 un assembleDocument échoué ne laisse plus de fichier de sortie vide.
  • Contenu HTML : une balise d’expression -html terminant 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 Z ou un décalage dans les données JSON ou CSV sont des valeurs java.util.Date de 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.
  • ExternalResourceOrigin et PreviewFormats sont des classes de constantes int, comme les autres énumérations de l’API Java. CreatePageStream et ReleasePageStream sont 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.

Ressources