O recurso Page Builder transforma a mesclagem de documentos ao permitir que os usuários combinem páginas de diferentes documentos de forma contínua, com precisão e facilidade. Ele possibilita a mesclagem de páginas em qualquer sequência, oferecendo controle total sobre a estrutura do documento final. Seja mesclando algumas páginas-chave ou criando um documento abrangente, esta ferramenta garante flexibilidade e eficiência. Ao reduzir o esforço manual, simplifica o processo de elaboração de documentos personalizados, economizando tempo valioso e aumentando a produtividade geral em fluxos de trabalho pessoais e profissionais.

Page Builder - como mesclar páginas de documentos

Os seguintes tópicos são discutidos aqui:

Se você estiver interessado em Merging documents online, visite a Online Merging Tool que é alimentada pelo GroupDocs.

Entendendo o Page Builder

O recurso Page Builder introduz uma maneira simplificada de criar documentos personalizados, combinando páginas de vários documentos fonte. Esse recurso permite que os desenvolvedores construam um novo documento passo a passo, adicionando páginas em qualquer sequência de dois ou mais documentos. Aqui está como o processo funciona:

  • Comece carregando o documento Word de origem usando a Merger classe e passe para o construtor um dos documentos de origem.
  • Junte os documentos um por um para mesclar usando o Join método.
  • Inicialize o Page Builder. Use o método CreatePageBuilder da instância Merger. Isso serve como o ponto de partida para construir seu novo documento.
  • O AddPage método da instância do Page Builder permite adicionar ao documento de destino qualquer página específica de documentos vinculados anteriormente.
  • para cada documento de origem, escolha as páginas específicas que você deseja incluir sobre o índice;
  • adicione estas páginas ao novo documento na sequência desejada. Você pode misturar e combinar páginas de documentos diferentes para atender às suas necessidades;
  • repita esse processo para documentos de origem adicionais, garantindo que você tenha a flexibilidade de combinar páginas de uma maneira que melhor atenda às suas necessidades;
  • Usando ApplyPageBuilder método para aplicar alterações da instância do Page Builder
  • Salve o documento mesclado em qualquer destino. Depois que todas as páginas necessárias forem adicionadas, salve o novo documento. O resultado final será um arquivo totalmente personalizado contendo páginas de várias fontes, organizadas exatamente como você deseja.

Esta abordagem passo a passo facilita a criação de documentos personalizados para casos de uso específicos, como a compilação de relatórios, a criação de apresentações personalizadas ou a montagem de documentos legais. Com o Page Builder, os desenvolvedores têm controle total sobre a ordem e o conteúdo da página, eliminando a necessidade de edições manuais que consomem tempo e garantindo precisão na saída final.

Sample case and code implementation

Vamos demonstrar como usar o recurso Page Builder no GroupDocs.Merger com um exemplo prático. Para simplificar o caso, assumimos que temos dois documentos:

  • Documento A com 4 páginas.
  • Document B com 4 páginas.

Nosso objetivo é criar um novo documento mesclando páginas destes dois documentos em diferentes sequências com base em cenários específicos.

Page Builder - Estrutura do documento de amostra A e B com 4 páginas cada

Aqui marcamos cada página do documento com a letra do documento A, B e número da página. Dos documentos A e B, precisamos receber o documento personalizado C com a seguinte estrutura

Page Builder - Estrutura do documento de amostra A e B com 4 páginas cada

O seguinte trecho de código-fonte mostra como mesclar páginas particulares de vários documentos no documento resultante.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Especificando a faixa das páginas necessárias

Ao trabalhar com manipulação de documentos, adicionar várias páginas de forma eficiente é crucial para lidar com fluxos de trabalho complexos. Em vez de adicionar páginas individualmente, você pode usar o AddPageRange método, que aceita um array de IPageInfo objetos, cada um representando uma página específica. Esta abordagem simplifica o processo, reduz o código repetitivo e melhora o desempenho, permitindo operações em lote. Abaixo está um exemplo de código demonstrando como utilizar este método para adicionar várias páginas de diferentes documentos em uma única operação simplificada.

Aqui estão os passos para combinar várias páginas de diversos documentos especificando-as como um intervalo:

  • Crie um Merger objeto e forneça o caminho ou o fluxo do arquivo de origem.
  • Use the Join para adicionar outro documento de origem. Repita esta etapa para cada documento que você deseja mesclar.
  • Crie um PageBuilder objeto chamando o CreatePageBuilder método.
  • Chame o AddPageRange método e passe um array de IPageInfo objetos descrevendo as páginas apropriadas. Por favor, note que os objetos IPageInfo usam notação baseada em zero para documentos de origem e números de página.
  • Use the ApplyPageBuilder método para aplicar a ordem especificada das páginas ao documento mesclado.
  • Salve o documento resultante chamando o Save método e fornecendo um caminho de arquivo.
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Conclusão

Esses exemplos ilustram a versatilidade do recurso Page Builder. Os desenvolvedores podem facilmente combinar páginas de múltiplos documentos em várias sequências para criar saídas personalizadas. Esse recurso reduz significativamente o trabalho manual e garante precisão na geração de documentos, tornando-se uma ferramenta essencial para diversos casos de uso.

Obtenha uma Licença de API Gratuita

Você pode  obter uma licença temporária gratuita  para usar a API sem as limitações de avaliação.

Construa Seu Próprio Aplicativo de Criador de Página de Mesclagem

Aqui estão alguns links importantes que ajudarão você na construção de sua própria aplicação de comparação de documentos.

Documentação | Referência da API | Formatos de Arquivo Suportados

Running Examples – GitHub | Free Support Forum | Release Notes

See Also

Para mais informações e recursos adicionais, você pode achar os seguintes links úteis: