La fonction Page Builder transforme la fusion de documents en permettant aux utilisateurs de combiner sans effort des pages de différents documents avec précision et aisance. Elle permet de fusionner les pages dans n’importe quelle séquence, offrant un contrôle total sur la structure du document final. Que ce soit pour fusionner quelques pages clés ou pour créer un document complet, cet outil garantit flexibilité et efficacité. En réduisant l’effort manuel, il simplifie le processus de création de documents sur mesure, économisant ainsi du temps précieux et améliorant la productivité globale tant dans les flux de travail personnels que professionnels.

Page Builder - comment fusionner des pages à partir de documents

Les sujets suivants sont discutés ici :

If you are interested in Merging documents online, visit the Online Merging Tool that is powered by GroupDocs.

Comprendre Page Builder

La fonctionnalité Page Builder introduit une méthode simplifiée pour créer des documents personnalisés en combinant des pages de plusieurs documents sources. Cette fonctionnalité permet aux développeurs de créer un nouveau document étape par étape, en ajoutant des pages dans n’importe quel ordre à partir de deux documents ou plus. Voici comment le processus fonctionne :

  • Commencez par charger le document Word source en utilisant la Merger classe et passez à son constructeur l’un des documents source.
  • Rejoignez les documents un par un pour les fusionner en utilisant la Join méthode.
  • Initialisez le Page Builder. Utilisez la méthode CreatePageBuilder de l’instance Merger. Cela sert de point de départ pour construire votre nouveau document.
  • La méthode AddPage de l’instance Page Builder permet d’ajouter dans le document de destination n’importe quelle page particulière des documents joints précédemment.
  • pour chaque document source, choisissez les pages spécifiques que vous souhaitez inclure dans l’index ;
  • ajoutez ces pages au nouveau document dans l’ordre souhaité. Vous pouvez mélanger et assortir des pages de différents documents pour répondre à vos besoins ;
  • répétez ce processus pour des documents sources supplémentaires, en veillant à avoir la flexibilité de combiner les pages de manière à répondre au mieux à vos besoins ;
  • Utiliser ApplyPageBuilder méthode pour appliquer les modifications de l’instance Page Builder.
  • Enregistrez le document fusionné à n’importe quelle destination. Une fois que toutes les pages nécessaires ont été ajoutées, enregistrez le nouveau document. Le résultat final sera un fichier entièrement personnalisé contenant des pages provenant de plusieurs sources, organisé exactement comme vous le souhaitez.

Cette approche étape par étape facilite la création de documents adaptés à des cas d’utilisation spécifiques, tels que la compilation de rapports, la création de présentations personnalisées ou l’assemblage de documents juridiques. Avec Page Builder, les développeurs ont un contrôle total sur l’ordre des pages et le contenu, éliminant ainsi le besoin de modifications manuelles chronophages et garantissant la précision dans le produit final.

Exemple de cas et mise en œuvre du code

Démontrons comment utiliser la fonctionnalité Page Builder dans GroupDocs.Merger avec un exemple pratique. Pour simplifier le cas, supposons que nous avons deux documents :

  • Document A avec 4 pages.
  • Document B avec 4 pages.

Nous visons à créer un nouveau document en fusionnant des pages de ces deux documents dans des séquences différentes en fonction de scénarios spécifiques.

Page Builder - Structure de document d'échantillon A et B avec 4 pages chacune

Ici, nous avons marqué chaque page de document avec la lettre de document A, B et le numéro de page. À partir des documents A et B, nous devons recevoir le document personnalisé C avec la structure suivante.

Page Builder - Structure de document d'échantillon A et B avec 4 pages chacune

Le fragment de code source suivant montre comment fusionner des pages particulières de plusieurs documents dans le document résultant.

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

Spécifiant la gamme des pages requises

Lorsque vous travaillez avec la manipulation de documents, ajouter plusieurs pages de manière efficace est crucial pour gérer des flux de travail complexes. Au lieu d’ajouter des pages individuellement, vous pouvez utiliser la AddPageRange méthode, qui accepte un tableau d’ IPageInfo objets, chacun représentant une page spécifique. Cette approche simplifie le processus, réduit le code répétitif et améliore les performances en permettant des opérations par lots. Ci-dessous un exemple de code démontrant comment utiliser cette méthode pour ajouter plusieurs pages provenant de différents documents en une seule opération rationalisée.

Voici les étapes pour combiner plusieurs pages de divers documents en les spécifiant comme une plage :

  • Créer un objet Merger et fournir le chemin ou le flux du fichier source.
  • Utilisez le Join pour ajouter un autre document source. Répétez cette étape pour chaque document que vous souhaitez fusionner.
  • Créez un PageBuilder objet en appelant la CreatePageBuilder méthode.
  • Appelez la AddPageRange méthode et passez un tableau d’IPageInfo objets décrivant les pages appropriées. Veuillez noter que les objets IPageInfo utilisent une notation basée sur zéro pour les documents source et les numéros de page.
  • Utilisez la ApplyPageBuilder méthode pour appliquer l’ordre spécifié des pages au document fusionné.
  • Enregistrez le document résultant en appelant la Save méthode et en fournissant un chemin de fichier.
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);
}

Conclusion

Ces exemples illustrent la polyvalence de la fonctionnalité Page Builder. Les développeurs peuvent facilement combiner des pages de plusieurs documents dans différentes séquences pour créer des sorties sur mesure. Cette fonctionnalité réduit considérablement le travail manuel et garantit la précision dans la génération de documents, ce qui en fait un outil essentiel pour des cas d’utilisation variés.

Obtenez une licence API gratuite

Vous pouvez get a free temporary license pour utiliser l’API sans les limitations d’évaluation.

Créer votre propre application de créateur de pages de fusion

Voici quelques liens importants qui vous aideront à créer votre propre application de comparaison de documents.

Documentation | API Reference | Supported File Formats

Exemples en cours – GitHub | Forum de support gratuit | Notes de version

Voir aussi

Pour plus d’informations et des ressources supplémentaires, vous pouvez trouver les liens suivants utiles :