💡 Exemple complet fonctionnel disponible sur GitHub : one-line-document-merge-and-split-dotnet
Où les tâches de documents du back‑office résident réellement
Un service financier clôture le mois en agrafant une page de garde au PDF du relevé du mois précédent. Une équipe de contrats ajoute un avenant signé à l’accord original avant qu’il ne soit archivé. Un assistant des ventes‑ops extrait deux diapositives d’une présentation de soixante diapositives parce qu’un intervenant n’a jamais eu besoin que de la page tarifaire. Un archiviste supprime une page qui n’aurait jamais dû être expédiée, juste avant que le fichier ne quitte le bâtiment.
Aucun de ces cas n’est un projet de fusion. Chaque opération porte sur un seul fichier et une seule action, exécutée de la même façon à chaque exécution, généralement par quelqu’un qui n’a aucun intérêt à apprendre une API de documents à usage général juste pour y parvenir.
GroupDocs.Merger.LowCode est un package .NET qui transforme une telle tâche – une jonction, une division ou une suppression de page – en un appel unique au constructeur, distinct de la classe générale Merger dont ces tâches n’ont jamais besoin. Chacun de ses sept produits reçoit sa source et ses options dans le constructeur, en C#, et s’exécute uniquement lorsque Save est appelé, que la tâche porte sur un PDF, un document Word ou une présentation PowerPoint.
Pourquoi les correctifs génériques ne fonctionnent pas ici
Les équipes confrontées à l’une de ces tâches essaient généralement l’une des trois approches avant de se tourner vers un package spécialisé :
- Faire manuellement dans un éditeur de bureau : acceptable pour un seul document, impossible à planifier, et personne ne valide une étape manuelle exécutée à 2 h du matin.
- Écrire un script ponctuel contre les API de fichiers brutes : fonctionne jusqu’à ce qu’un nouveau format d’entrée apparaisse, et le script finit par devenir exactement le client à usage général qu’il était censé éviter.
- Utiliser la classe complète
Mergerpour un appel unique : correct, mais cela ajoute une surface d’API plus large que ne nécessite jamais une seule opération.
GroupDocs.Merger.LowCode comble exactement ce dernier vide : un appel par opération, rien d’autre à apprendre d’abord.
La solution : GroupDocs.Merger.LowCode pour les pipelines du back‑office
GroupDocs.Merger.LowCode regroupe sept produits à usage unique derrière ce modèle « constructeur‑puis‑Save ». JoinPdf et JoinDocx ajoutent un document à un autre ; JoinPptx fait de même pour les présentations ; SplitPdf, SplitDocx et SplitPptx extraient les pages ou diapositives choisies dans des fichiers séparés ; RemovePagesPdf supprime des pages sans toucher à la source. Chacun des sept accepte sa source sous forme de chemin ou de flux et vérifie cette source, ainsi que chaque fichier fourni, contre son propre format avant d’écrire quoi que ce soit, de sorte qu’un pipeline n’a jamais à deviner pourquoi une sortie est incorrecte.
Pour suivre l’implémentation ci‑dessous, vous aurez besoin :
- .NET 6.0 ou version ultérieure (le projet d’exemple cible net8.0)
- Le package NuGet séparé
GroupDocs.Merger.LowCode - Une licence temporaire, si vous voulez voir la sortie sans les limites d’évaluation décrites plus loin
dotnet add package GroupDocs.Merger.LowCode
Le package vit séparément sur NuGet du principal GroupDocs.Merger.
Implémentation de l’étape de travail du Reporting‑Pack, pas à pas
Voici la forme que suivent les sept produits, illustrée avec la jonction qui ajoute une page de garde à un PDF mensuel.
Étape 1 : Pointer le produit vers sa source
Le constructeur de JoinPdf prend le document source, chaque fichier à ajouter, et une instance JoinOptions ; rien ne s’exécute encore.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Étape 2 : Décider où le résultat doit aller
Save(outputPath) est l’endroit où la tâche enregistre réellement le résultat. Un chemin relatif est résolu par rapport au répertoire de travail actuel du processus, et Save crée le dossier de sortie s’il n’existe pas déjà, de sorte qu’un pipeline écrivant dans le dossier d’un nouveau mois à chaque exécution n’a pas besoin d’une étape séparée pour le créer.
string outputPath = "output/monthly/report-with-appendix.pdf";
Pourquoi cela importe pour une tâche non supervisée :
- Un chemin que vous contrôlez : construisez le chemin de sortie à partir de la configuration ou d’un paramètre de tâche, jamais directement à partir d’une entrée non validée ;
SavelèveArgumentNullExceptionsi le chemin est nul ou vide. - Le dossier qu’il crée : une tâche planifiée qui écrit vers une nouvelle destination à chaque exécution n’a pas besoin d’une étape « s’assurer que le répertoire existe » distincte.
Étape 3 : Lancer l’opération et capturer le résultat
Appeler Save exécute immédiatement la jonction ; il n’y a pas d’étape distincte de construction puis d’exécution.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
Dans notre propre exécution sur les fichiers d’exemple, cet appel a joint un report.pdf de 2 pages à un appendix.pdf de 2 pages, produisant un report-with-appendix.pdf de 4 pages et de 257 987 octets.
Étape 4 : Réinjecter le résultat dans le pipeline
La taille du fichier lue immédiatement après Save suffit généralement à un planificateur avant de marquer la tâche comme terminée, ou avant de la comparer à une taille minimale pour décider si la sortie est suffisamment fiable pour poursuivre.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
GroupDocs.Merger.LowCode accepte‑t‑il un flux au lieu d’un chemin de fichier ?
Oui, du côté entrée. Chacun des sept produits accepte sa source sous forme de flux à la même position de constructeur où un chemin de fichier serait fourni, ce qui est pratique lorsqu’une tâche reçoit son entrée depuis un stockage blob ou une file d’attente plutôt que depuis le disque local. Save écrit toujours le résultat vers un chemin de sortie, quel que soit le mode d’entrée ; le streaming de la sortie elle‑même reste dans la classe complète Merger.
Cas réel : rejeter un fichier avant qu’il n’atteigne l’archive
Une équipe de contrats qui ajoute des avenants à des accords signés ne peut pas risquer d’accepter n’importe quel fichier arrivant dans la boîte de réception ; un avenant .docx mal placé à côté d’une jonction PDF produirait sinon une entrée d’archive corrompue. JoinPdf vérifie la source et chaque fichier ajouté contre le format PDF avant d’écrire quoi que ce soit, et lève FileTypeNotSupportedException dès qu’un fichier ne correspond pas.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
Dans l’exécution d’exemple, où les chemins sont construits à partir du dossier resources, le message était : Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
La tâche ci‑dessus n’écrit jamais output/mixed.pdf lorsque l’exception est interceptée, de sorte qu’un pipeline de contrats peut acheminer ce message directement vers l’alerte ou la file de tickets déjà utilisée, au lieu de découvrir une mauvaise entrée d’archive plusieurs jours plus tard.
Autres scénarios du back‑office où ce modèle s’applique
Une fois la jonction ci‑dessus fonctionnelle, le même modèle « constructeur‑puis‑Save » couvre plusieurs tâches qu’un back‑office exécute selon un planning :
- Retirer une page avant que le document ne quitte le bâtiment :
RemovePagesPdfsupprime les pages choisies et écrit un nouveau fichier sans toucher à la source, de sorte que l’original reste disponible pour audit après l’expédition de la copie tronquée. Dans notre propre test, la suppression de la page 2 dereport.pdfa produit un fichierreport-without-page-2.pdfd’une page et de 86 647 octets, tandis quereport.pdfest resté inchangé. - Diviser une présentation pour un intervenant :
SplitPptxextrait les diapositives demandées dans des fichiers séparés, nommés à l’aide d’un jeton{0}dans le modèle de sortie ou, en son absence, par un numéro de partie ajouté dans le même dossier, suivant le même modèle queSplitPdfutilise pour diviser les pages PDF. - Fusionner des documents Word au lieu de PDFs :
JoinDocxsuit exactement la forme constructeur‑puis‑SavedeJoinPdf, plaçant le document ajouté après la dernière page de la source.
Sans licence, chacune de ces exécutions se fait en mode évaluation. Dans notre exécution non licenciée, les PDF et Word fusionnés ont été réduits à 3 pages chacun, bien que les six sorties d’exemple aient tout de même été générées ; appliquez une licence avec License.Set avant que ces opérations ne s’exécutent de façon autonome en production.
Démarrer dans votre pipeline du back‑office
Vous disposez d’un modèle de fusion de documents low‑code fonctionnant de bout en bout, ainsi que d’une preuve que la vérification de format s’exécute à chaque appel. Voici les prochaines étapes :
- Voir la vue d’ensemble : le guide d’utilisation compagnon parcourt chacune des six opérations de l’exemple, méthode par méthode, avec une FAQ complète.
- Approfondir lorsqu’une tâche grandit : l’API complète GroupDocs.Merger couvre plus de terrain que ce modèle ne nécessite dès qu’un pipeline dépasse une seule opération.
- Explorer le code : le sample complet sur GitHub inclut tous les fichiers d’entrée utilisés ci‑dessus.
- Installer le package : la page d’installation décrit le package séparé et les frameworks cibles pris en charge.
- Supprimer les limites d’évaluation : obtenez une licence temporaire avant de déployer quoi que ce soit en production.
- Questions : le forum d’assistance est l’endroit où l’équipe répond aux questions d’implémentation.