Nos complace anunciar el lanzamiento de GroupDocs.Assembly for Java 26.11, disponible a partir de noviembre de 2026. Esta versión trae las características y correcciones de GroupDocs.Assembly for .NET 26.11 a Java:
- Las plantillas pueden verificarse contra un JSON Schema;
- Las páginas de plantillas e informes pueden renderizarse a imágenes;
- La carga de recursos externos está bajo el control de la aplicación;
REMOVE_EMPTY_PARAGRAPHSfunciona para plantillas de hoja de cálculo y texto plano;- Las etiquetas
<<image>>funcionan en celdas de tabla de presentaciones y resuelven rutas relativas contra la carpeta de la plantilla; - Las etiquetas de color aceptan cadenas hex.
Los motores Aspose incluidos pasan de sus versiones de principios de 2026 a 26.10, y una serie de correcciones cubren licencias, codificación de informes, códigos de barras y contenido HTML. Java 8 sigue siendo la base.
Novedades en esta versión
| Clave | Resumen | Categoría |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource acepta un JSON Schema: los miembros declarados en el esquema pueden ser referenciados incluso cuando son nulos, vacíos o faltan en los datos, y los tipos de valor provienen del esquema |
Funcionalidad |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview renderiza páginas de plantillas, informes ensamblados y otros documentos a imágenes PNG, JPEG o BMP |
Funcionalidad |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funciona para plantillas de hoja de cálculo y documentos de texto plano |
Funcionalidad |
| ASSEMBLYNET-140 | Los recursos externos referenciados por plantillas y datos están bajo el control de la aplicación; los recursos cuyas referencias provienen de los datos se omiten por defecto | Seguridad |
| ASSEMBLYJAVA-353 | Se incluyen Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 y Aspose.BarCode 26.10 | Actualización |
| ASSEMBLYJAVA-353 | Los códigos de barras GS1 (EAN-14, SCC-14, SSCC-18 y DataBar) mantienen la autocorrección de su texto de código con Aspose.BarCode 26.10 | Corrección |
| ASSEMBLYNET-52 | Una etiqueta <<image>> funciona en una celda de tabla de una presentación, y las etiquetas en formas de grupos de formas son procesadas |
Mejora |
| ASSEMBLYNET-62 | Una ruta de imagen relativa proveniente de los datos se resuelve contra la carpeta de la plantilla | Mejora |
| ASSEMBLYNET-25 | Un color dado como cadena puede ser un valor hex en backColor y en etiquetas de color de gráficos |
Mejora |
| ASSEMBLYNET-155 | Un Booleano ausente en datos JSON, XML o CSV cuenta como false en ?: y en where, count, any, all y first en lugar de fallar con un NullPointerException |
Corrección |
| ASSEMBLYNET-157 | groupBy y distinct sobre objetos anidados fusionan objetos iguales; se admiten referencias $id/$ref de datos JSON |
Corrección |
| ASSEMBLYNET-142 | License.setLicense(InputStream) lee un flujo que ya ha sido leído desde su comienzo |
Corrección |
| ASSEMBLYNET-143 | El consumo de una licencia medida se informa cuando una operación se completa | Corrección |
| ASSEMBLYNET-158 | Los informes de texto y HTML de plantillas solo ASCII se escriben en UTF-8, por lo que los datos no latinos ya no se pierden | Corrección |
| ASSEMBLYNET-160 | Los códigos de barras ya no fallan con NullPointerException cuando la fuente de su cuadro de texto no está instalada |
Corrección |
| ASSEMBLYNET-159 | Las etiquetas en el tema de conversación de una plantilla MSG se ensamblan como las de su asunto | Corrección |
| ASSEMBLYNET-152 | Una etiqueta <<doc>> en una hoja de cálculo, presentación o plantilla de texto falla con un mensaje claro; un assembleDocument fallido no deja un archivo de salida vacío |
Corrección |
| ASSEMBLYJAVA-354 | Una etiqueta de expresión -html que finaliza su párrafo ya no deja un párrafo vacío después de HTML que termina con un elemento de bloque |
Corrección |
Cambios de comportamiento a revisar antes de actualizar
- Los recursos externos provenientes de datos se omiten por defecto. Por ejemplo,
<<image [item.PhotoUrl]>>dondePhotoUrles una URI http o https ahora devuelve una imagen vacía. Añada los hosts aLoadSaveOptions.getWhitelistedResources(), o llame aLoadSaveOptions.setSkipExternalResources(false)para mantener el comportamiento anterior. Los recursos referenciados por la propia plantilla y las rutas de archivo locales funcionan como antes. - Llamada ambigua a
JsonDataSource.new JsonDataSource(path, null)con un literalnullcomo segundo argumento ya no compila. Convierta el argumento:new JsonDataSource(path, (JsonDataLoadOptions) null). Las aplicaciones compiladas no se ven afectadas. - Informes de texto y HTML en UTF-8. Los informes de plantillas de texto y HTML solo ASCII sin marca de orden de bytes ahora se escriben en UTF-8 en lugar de windows-1252. Para mantener una página de códigos de un solo byte, declárela en la plantilla (
<meta charset>en HTML). groupByydistinctsobre objetos anidados de datos JSON, XML y DataSet ahora fusionan objetos iguales en lugar de dar un grupo por fila.- Sin párrafo extra después de HTML. Una etiqueta
-htmlque finaliza su párrafo ya no deja un párrafo vacío después de HTML que termina con un elemento de bloque. Para mantener una línea en blanco, termine el HTML con<p> </p>. - Códigos de barras DataBar Expanded. Un código de barras DataBar Expanded o DataBar Expanded Stacked con texto de código solo de dígitos ahora se codifica como un GTIN con el identificador de aplicación (01), como los otros tipos de DataBar.
- Texto de excepción cambiado para una etiqueta
<<doc>>en plantillas de hoja de cálculo, presentación y texto; el tipo de excepción es el mismo. - API eliminada.
ICustomFontsHandler.resetFontSources()se elimina; llame aFontSettings.resetFontSources()en su lugar.
Nuevas funcionalidades
Soporte de JSON Schema para JsonDataSource
Una plantilla se verifica contra la estructura de sus datos antes de que se evalúe cualquier <<if>>. Con JSON, esa estructura se obtenía de los propios datos, por lo que una referencia dentro de una rama que nunca se renderiza fallaba cuando los datos detrás de ella eran nulos, una matriz vacía o estaban ausentes.
JsonDataSource ahora acepta un JSON Schema, de la misma manera que XmlDataSource acepta un XML Schema, y la plantilla se verifica contra el esquema:
- los miembros declarados en el esquema pueden ser referenciados incluso si son nulos, vacíos o ausentes en los datos;
- los miembros no declarados en el esquema siguen fallando, por lo que los nombres mal escritos se detectan como antes;
- los tipos de valor provienen del esquema, por lo que un booleano es un
Booleany una cadena que contiene dígitos sigue siendo una cadena.
Dado un cliente sin tarjetas de pago y sin datos de lealtad, y un número de cuenta que es una cadena de dígitos:
{ "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" } } }
}
}
y esta plantilla:
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]>>
pase el esquema junto a los datos:
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
El resultado es No payment card on file. con el número de cuenta 00042. Sin el esquema, la misma plantilla falla en customer.Cards.first().Type, y el número de cuenta se lee como el número 42.
El esquema puede proporcionarse como una ruta de archivo o un InputStream, con o sin JsonDataLoadOptions. Las palabras clave admitidas son type (incluidos tipos anulables), properties, items, format (date-time y date), enum, const, allOf y punteros locales $ref. No se admiten oneOf, anyOf, not, $ref remoto o recursivo, items en forma de tupla y matrices de matrices.
Vista previa de documentos
DocumentAssembler.generatePreview renderiza páginas de un documento a imágenes PNG, JPEG o BMP: una plantilla, un documento ensamblado por GroupDocs.Assembly, o cualquier otro documento de un formato compatible, desde un archivo o un flujo. Se renderizan páginas de documentos de procesamiento de texto, texto y HTML, páginas impresas de hojas de cálculo, diapositivas de presentaciones y mensajes de correo electrónico con su encabezado.
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);
Cuando se establecen tanto setWidth como setHeight, las páginas se escalan para ajustarse a ese tamaño manteniendo su relación de aspecto. Las vistas previas se generan sin cargar recursos externos, y las imágenes generadas se contabilizan mediante licencias medidas como los documentos ensamblados.
REMOVE_EMPTY_PARAGRAPHS para plantillas de hoja de cálculo y texto plano
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS ahora funciona también para plantillas de hoja de cálculo y documentos de texto plano. Allí, un párrafo es una línea de texto: una línea del texto de una celda, o de un documento de texto, que queda vacía después de procesar las etiquetas de la plantilla se elimina junto con su salto de línea. Las etiquetas como <<if>> y <<foreach>> escritas en sus propias líneas ya no dejan líneas vacías detrás.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
Plantilla:
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
Resultado:
Prefix
Suffix
El mismo texto de plantilla en una celda de hoja de cálculo da el mismo resultado dentro de la celda. Los documentos HTML y XML permanecen como están.
Seguridad: control de recursos externos
Una etiqueta <<image>> o <<doc>> puede evaluarse a una URI tomada de los datos, y GroupDocs.Assembly solía recuperarla sin forma de impedirlo. Un servidor que ensambla documentos a partir de datos suministrados por otros podría, por lo tanto, ser inducido a solicitar direcciones internas.
GroupDocs.Assembly ahora indica de dónde proviene cada referencia a un recurso externo (ExternalResourceOrigin):
TEMPLATE— el documento de la plantilla referencia el recurso directamente, incluyendo una URI literal en una etiqueta como<<image ["https://example.com/logo.png"]>>;DATA— la referencia proviene de los datos, como una URI que evalúa una expresión de etiqueta.
Por defecto, los recursos referenciados por la plantilla se cargan como antes, y los recursos cuyas referencias provienen de los datos se omiten. Cuatro miembros de LoadSaveOptions controlan esto:
setSkipExternalResources(truepor defecto) — los recursos externos no se cargan;setTrustTemplateResources(truepor defecto) — los recursos referenciados por la plantilla se cargan incluso cuando la omisión está activada; establézcalo enfalsecuando las plantillas provienen de fuentes no confiables;getWhitelistedResources— nombres de host o prefijos de URI absolutos permitidos incluso cuando la omisión está activada;setExternalResourceHandler— unExternalResourceHandlerllamado para cada recurso externo antes de que se solicite, para permitirlo, omitirlo o proporcionar su contenido.
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);
}
}
}
}
Los recursos externos son recursos que alcanzan la red: URIs http, https y ftp, rutas UNC y URIs de archivo con un host remoto. Las rutas de archivo locales no se ven afectadas. Una imagen omitida de un documento se reemplaza con una imagen transparente; un valor omitido de <<image>> o <<doc>> se trata como un valor vacío.
Mejoras
Imágenes en celdas de tabla y grupos de formas de presentaciones
En una plantilla de presentación, una etiqueta <<image>> solo podía colocarse en un cuadro de texto. Ahora una celda de tabla también es un contenedor de imagen: la imagen se convierte en el relleno de la celda, incluidas las celdas de filas repetidas por <<foreach>>, de modo que se puede construir una tabla que enumere elementos con sus imágenes. Con -fitHeight, la fila crece para mostrar la imagen con su relación de aspecto. Las etiquetas en formas de grupos de formas, incluidos los grupos anidados, ahora se procesan como otras formas.
Rutas de imagen relativas resueltas contra la carpeta de la plantilla
Una etiqueta <<image>> que obtiene una ruta de archivo relativa de los datos, como Images/photo.png, ahora la resuelve primero contra la carpeta de la plantilla, por analogía con los recursos vinculados de los documentos de Microsoft Office. Para una plantilla cargada desde un flujo, establezca la carpeta 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"));
}
Si no existe un archivo allí, se usa el directorio actual como antes.
Cadenas de color hex
Un color dado como cadena ahora puede ser un valor hex — "#RRGGBB", "#RGB" o "#AARRGGBB" — además de un nombre de color y un entero ARGB, en backColor y en etiquetas de color de gráficos. Por ejemplo, <<backColor [item.Color]>> con "#FF0000" proveniente de los datos ahora aplica rojo.
Correcciones
- Los Booleanos ausentes en datos JSON, XML y CSV ahora cuentan como
falseen el operador condicional?:y en los predicados dewhere,count,any,allyfirst, en lugar de fallar con unNullPointerException. groupByydistinctsobre objetos anidados de datos JSON y XML comparan objetos por valor, de modo que clientes iguales forman un solo grupo. JSON escrito con referencias preservadas ($id/$ref) ahora es compatible.License.setLicense(InputStream)lee unByteArrayInputStreamdesde su marca y unFileInputStreamdesde la posición 0, por lo que un flujo ya usado para licenciar otro producto GroupDocs ya no falla con “Unexpected EOF in prolog”.- El consumo medido se informa cuando se completa el ensamblado de un documento o la generación de una vista previa, en lugar de después desde un hilo en segundo plano.
- Los informes de texto y HTML de plantillas solo ASCII se escriben en UTF-8, por lo que datos como
CaféoПриветya no se pierden a windows-1252. - Los códigos de barras cuyo texto de código es dibujado por el motor (QR, DataMatrix, Aztec y otros) ya no fallan cuando la fuente de su cuadro de texto no está instalada — típicamente Calibri en Linux. En su lugar se usa una fuente de respaldo.
- Plantillas MSG: las etiquetas en el tema de conversación se procesan como las del asunto, de modo que Outlook encadena los mensajes correctamente.
<<doc>>en plantillas de hoja de cálculo, presentación y texto falla con un mensaje que indica que la etiqueta no es compatible con el formato, y unassembleDocumentfallido ya no deja un archivo de salida vacío.- Contenido HTML: una etiqueta de expresión
-htmlque finaliza su párrafo ya no deja un párrafo vacío adicional después de HTML que termina con un elemento de bloque (ASSEMBLYJAVA-354). - Códigos de barras GS1: GroupDocs.Assembly ahora corrige por sí mismo los textos de código solo de dígitos de los códigos de barras EAN-14, SCC-14, SSCC-18 y DataBar, porque Aspose.BarCode 26.10 dejó de hacerlo, por lo que estos códigos de barras permanecen igual que en 26.10.1.
Motores Aspose actualizados a 26.10
GroupDocs.Assembly for Java 26.10.1 incluía bibliotecas Aspose de principios de 2026, por lo que vulnerabilidades corregidas en ellas desde entonces fueron detectadas por escáneres de seguridad. Los motores incluidos ahora son:
| Motor | 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 |
El POM publicado sigue sin declarar dependencias. Debido a que los motores se actualizaron, los documentos regenerados pueden diferir a nivel de bytes mientras siguen siendo visual y funcionalmente equivalentes. Si compara byte a byte la salida generada con bases de referencia almacenadas, actualice esas bases de referencia después de actualizar.
Notas para usuarios de Java
- Fechas con
Zo un desplazamiento en datos JSON o CSV son valoresjava.util.Datede ese instante exacto, y un patrón de formato los imprime en la zona horaria predeterminada de la JVM. Para una salida que no dependa del servidor, ejecute la JVM con una zona horaria fija, por ejemplo-Duser.timezone=UTC. ExternalResourceOriginyPreviewFormatsson clases de constantesint, como las demás enumeraciones de la API Java.CreatePageStreamyReleasePageStreamson interfaces funcionales, por lo que las lambdas encajan.
Cómo obtener la actualización
Maven
Añada el repositorio de GroupDocs y la dependencia a su 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>
Descarga directa
Descargue el JAR desde la página de descarga de GroupDocs.Assembly for Java 26.11.