La funzione Page Builder trasforma la fusione dei documenti consentendo agli utenti di combinare senza sforzo le pagine di documenti diversi con precisione e facilità. Consente di unire le pagine in qualsiasi sequenza, dando il controllo completo sulla struttura del documento finale. Che si tratti di unire alcune pagine chiave o di creare un documento completo, questo strumento garantisce flessibilità ed efficienza. Riducendo lo sforzo manuale, semplifica il processo di creazione di documenti su misura, risparmiando tempo prezioso e aumentando la produttività complessiva sia nei flussi di lavoro personali che professionali.

Page Builder - come unire le pagine dai documenti

I seguenti argomenti sono discussi qui:

Se sei interessato a Merging documents online, visita il Online Merging Tool che è alimentato da GroupDocs.

Comprendere il Page Builder

La funzione Page Builder introduce un modo semplificato per creare documenti personalizzati combinando pagine da più documenti sorgente. Questa funzione consente agli sviluppatori di creare un nuovo documento passo dopo passo, aggiungendo pagine in qualsiasi sequenza da due o più documenti. Ecco come funziona il processo:

  • Inizia caricando il documento Word di origine utilizzando la Merger classe e passando al costruttore uno dei documenti sorgente.
  • Unisci i documenti uno per uno per unirli utilizzando il Join metodo.
  • Inizializza il Page Builder. Utilizza il metodo CreatePageBuilder dall’istanza Merger. Questo serve come punto di partenza per costruire il tuo nuovo documento.
  • Il AddPage metodo dell’istanza del Page Builder consente di aggiungere nel documento di destinazione qualsiasi pagina particolare dei documenti uniti in precedenza.
  • per ciascun documento sorgente, scegli le pagine specifiche che desideri includere nell’indice;
  • aggiungi queste pagine al nuovo documento nell’ordine desiderato. Puoi mescolare e abbinare le pagine da documenti diversi per soddisfare le tue esigenze;
  • ripeti questo processo per ulteriori documenti di origine, assicurandoti di avere la flessibilità di combinare le pagine in un modo che soddisfi al meglio le tue esigenze;
  • Utilizzando ApplyPageBuilder metodo per applicare le modifiche dall’istanza di Page Builder
  • Salva il documento unito in qualsiasi destinazione. Una volta aggiunte tutte le pagine necessarie, salva il nuovo documento. L’output finale sarà un file completamente personalizzato contenente pagine provenienti da più fonti, organizzate esattamente come desideri.

Questo approccio passo dopo passo rende facile creare documenti su misura per casi d’uso specifici, come la compilazione di relazioni, la creazione di presentazioni personalizzate o l’assemblaggio di documenti legali. Con Page Builder, gli sviluppatori hanno il completo controllo sull’ordine e sul contenuto delle pagine, eliminando la necessità di modifiche manuali che richiedono tempo e garantendo precisione nell’output finale.

Esempio di caso e implementazione del codice

Dimostriamo come utilizzare la funzione Page Builder in GroupDocs.Merger con un esempio pratico. Per semplificare il caso, assumiamo di avere due documenti:

  • Document A con 4 pagine.
  • Document B con 4 pagine.

Vogliamo creare un nuovo documento unendo pagine di questi due documenti in sequenze diverse in base a scenari specifici.

Page Builder - Struttura del documento campione A e B con 4 pagine ciascuno

Qui abbiamo contrassegnato ogni pagina del documento con la lettera del documento A, B e numero di pagina. Dai documenti A e B dobbiamo ricevere il documento personalizzato C con la seguente struttura

Page Builder - Struttura del documento campione A e B con 4 pagine ciascuno

Il seguente frammento di codice sorgente mostra come unire pagine particolari da diversi documenti nel documento risultante.

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);
}

Specificare l’intervallo delle pagine richieste

Quando si lavora con la manipolazione dei documenti, aggiungere più pagine in modo efficiente è cruciale per gestire flussi di lavoro complessi. Invece di aggiungere pagine singolarmente, puoi utilizzare il AddPageRange metodo, che accetta un array di IPageInfo oggetti, ciascuno dei quali rappresenta una pagina specifica. Questo approccio semplifica il processo, riduce il codice ripetitivo e migliora le prestazioni consentendo operazioni in batch. Di seguito è riportato un esempio di codice che dimostra come utilizzare questo metodo per aggiungere più pagine da documenti diversi in un’unica operazione semplificata.

Ecco i passaggi per combinare più pagine da vari documenti specificandole come un intervallo:

  • Crea un oggetto Merger e fornisci il percorso o lo stream del file di origine.
  • Usa il Join per aggiungere un altro documento sorgente. Ripeti questo passaggio per ogni documento che desideri unire.
  • Crea un oggetto PageBuilder chiamando il metodo CreatePageBuilder.
  • Chiama il AddPageRange metodo e passa un array di IPageInfo oggetti che descrivono le pagine appropriate. Si prega di notare che gli oggetti IPageInfo utilizzano la notazione a zero per i documenti sorgente e i numeri di pagina.
  • Usa il ApplyPageBuilder metodo per applicare l’ordine specificato delle pagine al documento unito.
  • Salva il documento risultante chiamando il Save metodo e fornendo un percorso di file.
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);
}

Conclusione

Questi esempi illustrano la versatilità della funzionalità Page Builder. Gli sviluppatori possono facilmente combinare pagine da più documenti in varie sequenze per creare output personalizzati. Questa funzionalità riduce significativamente il lavoro manuale e garantisce precisione nella generazione di documenti, rendendola uno strumento essenziale per una varietà di casi d’uso.

Ottieni una licenza API gratuita

Puoi get a free temporary license per utilizzare l’API senza le limitazioni di valutazione.

Costruisci la tua applicazione di Builder di Pagina di Merge

Ecco alcuni collegamenti importanti che ti aiuteranno nella creazione della tua applicazione di confronto documenti.

Documentazione | Riferimento API | Formati di file supportati

Running Examples – GitHub | Free Support Forum | Release Notes

Vedi anche

Per ulteriori informazioni e risorse aggiuntive, potresti trovare utili i seguenti link: