Temos o prazer de anunciar o lançamento do GroupDocs.Assembly for Java 26.11, disponível a partir de novembro de 2026. Esta versão traz os recursos e correções do GroupDocs.Assembly for .NET 26.11 para Java:

  • os modelos podem ser verificados contra um JSON Schema;
  • as páginas de modelos e relatórios podem ser renderizadas em imagens;
  • o carregamento de recursos externos está sob o controle da aplicação;
  • REMOVE_EMPTY_PARAGRAPHS funciona para modelos planilha e texto simples;
  • tags <<image>> funcionam em células de tabela de apresentações e resolvem caminhos relativos em relação à pasta do modelo;
  • as tags de cor aceitam hex strings.

Os motores Aspose incluídos passam de suas versões iniciais de 2026 para 26.10, e várias correções abrangem licenciamento, codificação de relatórios, códigos de barras e conteúdo HTML. O Java 8 continua como base.

Novidades nesta versão

Chave Resumo Categoria
ASSEMBLYNET-145 JsonDataSource aceita um JSON Schema: membros declarados no schema podem ser referenciados mesmo quando são nulos, vazios ou ausentes nos dados, e os tipos de valor vêm do schema Recurso
ASSEMBLYNET-8 DocumentAssembler.generatePreview renderiza páginas de modelos, relatórios montados e outros documentos para imagens PNG, JPEG ou BMP Recurso
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funciona para modelos de planilha e documentos de texto simples Recurso
ASSEMBLYNET-140 Recursos externos referenciados por modelos e dados estão sob o controle da aplicação; recursos cujas referências vêm dos dados são ignorados por padrão Segurança
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 e Aspose.BarCode 26.10 são incluídos Atualização
ASSEMBLYJAVA-353 Códigos de barras GS1 (EAN-14, SCC-14, SSCC-18 e DataBar) mantêm a autocorreção do texto do código com Aspose.BarCode 26.10 Correção
ASSEMBLYNET-52 Uma tag <<image>> funciona em uma célula de tabela de uma apresentação, e tags em formas de grupos de formas são processadas Aprimoramento
ASSEMBLYNET-62 Um caminho de imagem relativo dos dados é resolvido em relação à pasta do modelo Aprimoramento
ASSEMBLYNET-25 Uma cor fornecida como string pode ser um valor hex em backColor e nas tags de cor de gráfico Aprimoramento
ASSEMBLYNET-155 Um Boolean ausente em dados JSON, XML ou CSV conta como false em ?: e em where, count, any, all e first ao invés de falhar com um NullPointerException Correção
ASSEMBLYNET-157 groupBy e distinct sobre objetos aninhados mesclam objetos iguais; referências $id/$ref de dados JSON são suportadas Correção
ASSEMBLYNET-142 License.setLicense(InputStream) lê um stream que já foi lido desde o início Correção
ASSEMBLYNET-143 O consumo de uma licença medida é relatado quando uma operação é concluída Correção
ASSEMBLYNET-158 Relatórios de texto e HTML de modelos apenas ASCII são gravados em UTF-8, de modo que dados não latinos não são mais perdidos Correção
ASSEMBLYNET-160 Códigos de barras não falham mais com NullPointerException quando a fonte da caixa de texto não está instalada Correção
ASSEMBLYNET-159 Tags no tópico de conversa de um modelo MSG são montadas como as do seu assunto Correção
ASSEMBLYNET-152 Uma tag <<doc>> em um modelo de planilha, apresentação ou texto falha com uma mensagem clara; um assembleDocument falhado não deixa um arquivo de saída vazio Correção
ASSEMBLYJAVA-354 Uma tag de expressão -html que termina seu parágrafo não deixa mais um parágrafo vazio após HTML que termina com um elemento de bloco Correção

Alterações de comportamento a verificar antes de atualizar

  1. Recursos externos provenientes dos dados são ignorados por padrão. Por exemplo, <<image [item.PhotoUrl]>> onde PhotoUrl é um URI http ou https agora gera uma imagem vazia. Adicione os hosts a LoadSaveOptions.getWhitelistedResources(), ou chame LoadSaveOptions.setSkipExternalResources(false) para manter o comportamento anterior. Recursos referenciados pelo próprio modelo e caminhos de arquivos locais funcionam como antes.
  2. Chamada ambígua de JsonDataSource. new JsonDataSource(path, null) com um literal null como segundo argumento não compila mais. Converta o argumento: new JsonDataSource(path, (JsonDataLoadOptions) null). Aplicações compiladas não são afetadas.
  3. Relatórios de texto e HTML em UTF-8. Relatórios de modelos de texto e HTML apenas ASCII sem marca de ordem de byte agora são gravados em UTF-8 ao invés de windows-1252. Para manter uma página de código de um byte, declare-a no modelo (<meta charset> em HTML).
  4. groupBy e distinct sobre objetos aninhados de dados JSON, XML e DataSet agora mesclam objetos iguais ao invés de gerar um grupo por linha.
  5. Sem parágrafo extra após HTML. Uma tag -html que termina seu parágrafo não deixa mais um parágrafo vazio após HTML que termina com um elemento de bloco. Para manter uma linha em branco, termine o HTML com <p>&nbsp;</p>.
  6. Códigos de barras DataBar Expanded. Um código de barras DataBar Expanded ou DataBar Expanded Stacked com texto de código apenas de dígitos agora é codificado como um GTIN com o identificador de aplicação (01), como os outros tipos de DataBar.
  7. Texto da exceção alterado para uma tag <<doc>> em modelos de planilha, apresentação e texto; o tipo de exceção permanece o mesmo.
  8. API removida. ICustomFontsHandler.resetFontSources() foi removida; chame FontSettings.resetFontSources() em seu lugar.

Novos recursos

Suporte a JSON Schema para JsonDataSource

Um modelo é verificado contra a estrutura de seus dados antes que qualquer <<if>> seja avaliado. Com JSON, essa estrutura era obtida dos próprios dados, de modo que uma referência dentro de um ramo que nunca é renderizado falhava quando os dados por trás dela eram nulos, um array vazio ou ausentes.

JsonDataSource agora aceita um JSON Schema, da mesma forma que XmlDataSource aceita um XML Schema, e o modelo é verificado contra o schema:

  • membros declarados no schema podem ser referenciados mesmo se forem nulos, vazios ou ausentes nos dados;
  • membros não declarados no schema ainda falham, portanto nomes digitados incorretamente são detectados como antes;
  • os tipos de valor vêm do schema, então um booleano é um Boolean e uma string contendo dígitos permanece uma string.

Dado um cliente sem cartões de pagamento e sem dados de fidelidade, e um número de conta que é uma sequência 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" } } }
  }
}

e este modelo:

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

passe o schema ao lado dos dados:

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

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

O resultado é No payment card on file. com o número da conta 00042. Sem o schema, o mesmo modelo falha em customer.Cards.first().Type, e o número da conta é lido como o número 42.

O schema pode ser fornecido como um caminho de arquivo ou um InputStream, com ou sem JsonDataLoadOptions. Palavras‑chave suportadas são type (incluindo tipos anuláveis), properties, items, format (date-time e date), enum, const, allOf e ponteiros $ref locais. oneOf, anyOf, not, $ref remoto ou recursivo, items em forma de tupla e arrays de arrays não são suportados.

Pré‑visualização de documento

DocumentAssembler.generatePreview renderiza páginas de um documento para imagens PNG, JPEG ou BMP: um modelo, um documento montado pelo GroupDocs.Assembly, ou qualquer outro documento de um formato suportado, a partir de um arquivo ou stream. Páginas de documentos de processamento de texto, texto e HTML, páginas impressas de planilhas, slides de apresentações e mensagens de email com seu cabeçalho são renderizadas.

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 setWidth e setHeight são definidos, as páginas são escaladas para caber naquele tamanho mantendo sua proporção. As pré‑visualizações são geradas sem carregar recursos externos, e as imagens geradas são contabilizadas pela licença medida como documentos montados.

REMOVE_EMPTY_PARAGRAPHS para modelos de planilha e texto simples

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS agora funciona também para modelos de planilha e documentos de texto simples. Nesses casos, um parágrafo é uma linha de texto: uma linha do texto de uma célula, ou de um documento de texto, que se torna vazia após o processamento das tags do modelo é removida juntamente com sua quebra de linha. Tags como <<if>> e <<foreach>> escritas em linhas próprias não deixam mais linhas vazias.

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

Modelo:

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

Resultado:

Prefix
Suffix

O mesmo texto de modelo em uma célula de planilha produz o mesmo resultado dentro da célula. Documentos HTML e XML permanecem como estão.

Segurança: controle de recursos externos

Uma tag <<image>> ou <<doc>> pode avaliar para um URI obtido dos dados, e o GroupDocs.Assembly costumava buscá‑lo sem forma de impedir. Um servidor que monta documentos a partir de dados fornecidos por terceiros poderia, assim, ser induzido a solicitar endereços internos.

O GroupDocs.Assembly agora indica de onde vem cada referência a um recurso externo (ExternalResourceOrigin):

  • TEMPLATE — o documento modelo referencia o recurso em si, incluindo um URI literal em uma tag como <<image ["https://example.com/logo.png"]>>;
  • DATA — a referência vem dos dados, como um URI que uma expressão de tag avalia.

Por padrão, recursos referenciados pelo modelo são carregados como antes, e recursos cujas referências vêm dos dados são ignorados. Quatro membros de LoadSaveOptions controlam isso:

  • setSkipExternalResources (true por padrão) — recursos externos não são carregados;
  • setTrustTemplateResources (true por padrão) — recursos referenciados pelo modelo são carregados mesmo quando a ignorância está ativada; defina como false quando os modelos vêm de fontes não confiáveis;
  • getWhitelistedResources — nomes de host ou prefixos de URI absolutos permitidos mesmo quando a ignorância está ativada;
  • setExternalResourceHandler — um ExternalResourceHandler chamado para cada recurso externo antes de ser solicitado, para permiti‑lo, ignorá‑lo ou fornecer seu conteúdo.
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);
            }
        }
    }
}

Recursos externos são recursos que alcançam a rede: URIs http, https e ftp, caminhos UNC e URIs de arquivo com host remoto. Caminhos de arquivos locais não são afetados. Uma imagem ignorada de um documento é substituída por uma imagem transparente; um valor <<image>> ou <<doc>> ignorado é tratado como um valor vazio.

Aprimoramentos

Imagens em células de tabela e grupos de formas de apresentações

Em um modelo de apresentação, uma tag <<image>> só podia ser colocada em uma caixa de texto. Uma célula de tabela agora também é um contêiner de imagem: a imagem torna‑se o preenchimento da célula, incluindo células de linhas repetidas por <<foreach>>, permitindo construir uma tabela listando itens com suas imagens. Com -fitHeight, a linha cresce para mostrar a imagem com sua proporção. Tags em formas de grupos de formas, incluindo grupos aninhados, agora são processadas como outras formas.

Caminhos de imagem relativos resolvidos em relação à pasta do modelo

Uma tag <<image>> que obtém um caminho de arquivo relativo dos dados, como Images/photo.png, agora o resolve primeiro em relação à pasta do modelo, por analogia com recursos vinculados de documentos Microsoft Office. Para um modelo carregado a partir de um stream, defina a pasta com 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 nenhum arquivo existir lá, o diretório atual é usado como antes.

Strings de cor hex

Uma cor fornecida como string agora pode ser um valor hex — "#RRGGBB", "#RGB" ou "#AARRGGBB" — além de um nome de cor e um inteiro ARGB, em backColor e nas tags de cor de gráfico. Por exemplo, <<backColor [item.Color]>> com "#FF0000" vindo dos dados agora aplica vermelho.

Correções

  • Booleans ausentes em dados JSON, XML e CSV agora contam como false no operador condicional ?: e nos predicados de where, count, any, all e first, ao invés de falhar com um NullPointerException.
  • groupBy e distinct sobre objetos aninhados de dados JSON e XML comparam objetos por valor, de modo que clientes iguais formam um grupo. JSON escrito com referências preservadas ($id/$ref) agora é suportado.
  • License.setLicense(InputStream) lê um ByteArrayInputStream a partir de sua marca e um FileInputStream a partir da posição 0, de modo que um stream já usado para licenciar outro produto GroupDocs não falha mais com “Unexpected EOF in prolog”.
  • Consumo medido é relatado quando a montagem de um documento ou a geração de uma pré‑visualização termina, ao invés de depois por uma thread em segundo plano.
  • Relatórios de texto e HTML de modelos apenas ASCII são gravados em UTF-8, de modo que dados como Café ou Привет não são mais perdidos para windows-1252.
  • Códigos de barras cujo texto do código é desenhado pelo motor (QR, DataMatrix, Aztec e outros) não falham mais quando a fonte da caixa de texto não está instalada — tipicamente Calibri no Linux. Uma fonte de reserva é usada em seu lugar.
  • Modelos MSG: tags no tópico de conversa são processadas como as do assunto, de modo que o Outlook encadeia as mensagens corretamente.
  • <<doc>> em modelos de planilha, apresentação e texto falha com uma mensagem dizendo que a tag não é suportada para o formato, e um assembleDocument falhado não deixa mais um arquivo de saída vazio.
  • Conteúdo HTML: uma tag de expressão -html que termina seu parágrafo não deixa mais um parágrafo vazio extra após HTML que termina com um elemento de bloco (ASSEMBLYJAVA-354).
  • Códigos de barras GS1: o GroupDocs.Assembly agora corrige textos de código apenas numéricos de códigos de barras EAN-14, SCC-14, SSCC-18 e DataBar por conta própria, porque o Aspose.BarCode 26.10 deixou de fazê‑lo, de modo que esses códigos de barras permanecem os mesmos que em 26.10.1.

Motores Aspose atualizados para 26.10

O GroupDocs.Assembly for Java 26.10.1 incluía bibliotecas Aspose de início de 2026, de modo que vulnerabilidades corrigidas nelas desde então foram reportadas por scanners de segurança. Os motores incluídos agora são:

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

O POM publicado ainda não declara dependências. Como os motores foram atualizados, documentos regenerados podem diferir ao nível de byte, embora permaneçam visual e funcionalmente equivalentes. Se você comparar byte a byte a saída gerada com bases de referência armazenadas, atualize essas bases após a atualização.

Observações para usuários Java

  • Datas com Z ou um deslocamento em dados JSON ou CSV são valores java.util.Date daquele instante exato, e um padrão de formato os imprime no fuso horário padrão da JVM. Para saída que não dependa do servidor, execute a JVM com um fuso horário fixo, por exemplo -Duser.timezone=UTC.
  • ExternalResourceOrigin e PreviewFormats são classes de constantes int, como as outras enumerações da API Java. CreatePageStream e ReleasePageStream são interfaces funcionais, portanto lambdas se encaixam.

Como obter a atualização

Maven

Adicione o repositório GroupDocs e a dependência ao seu 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 direto

Baixe o JAR da página de download do GroupDocs.Assembly for Java 26.11.

Recursos