Fusion et publipostage d'un document Word

Fusionner et publiposter un document Word en ligne

Le publipostage est le moyen le plus simple de générer un ensemble de documents identiques à l’exception de certaines informations, comme le nom et l’adresse du destinataire. De nombreuses organisations communiquent avec leurs clients/membres au moyen de lettres, de bulletins d’information et de documents promotionnels à l’aide du publipostage. Dans cet article, nous allons donc discuter en détail de la manière de fusionner des documents Word à l’aide de l’API REST C#.

API de publipostage

Aspose.Words Cloud offre la possibilité de créer un nouveau document Word, d’ouvrir un document existant ou de le convertir en PDF, XPS, SVG, EPUB et divers autres formats. Comme notre API est développée selon l’architecture REST, vous n’avez pas à vous soucier des limitations de langue ou de plate-forme. Désormais, pour utiliser l’API dans une application C# .NET, veuillez installer Aspose.Words Cloud SDK pour .NET à l’aide de la commande suivante :

 Install-Package Aspose.Words-Cloud

Après l’installation, nous devons enregistrer un compte gratuit sur tableau de bord Aspose.Cloud en utilisant GitHub ou un compte Google ou simplement vous inscrire et obtenir vos informations d’identification client.

Remplir le modèle de publipostage en C#

Veuillez suivre les étapes ci-dessous pour remplir le modèle de publipostage à l’aide d’un fichier de données.

String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/

// créez une instance de la classe Configuration et fournissez vos détails d'ID client et de secret client personnalisés
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// initialiser l'objet WordsAPI à l'aide de l'instance de configuration
var wordsApi = new WordsApi(config);
// premier document d'entrée
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// nom du fichier résultant
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// lire le contenu du fichier de données
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// Créez un objet ExecuteMailMergeRequest en fournissant le fichier d'entrée, le fichier de données et les détails de sortie résultants
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// effectuer l'opération de publipostage
DocumentResponse result = wordsApi.ExecuteMailMerge(request);

Fusionner et publiposter Word à l’aide de la commande cURL

Les commandes cURL sont également un moyen pratique d’accéder aux API REST. Étant donné qu’Aspose.Words Cloud est développé sur la base de l’architecture de l’API REST, nous pouvons facilement accéder aux API via les commandes cURL. À présent, comme condition préalable, nous devons générer un jeton d’accès JWT basé sur les détails de l’ID client et du secret client.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=c235e685-1aab-4cda-a95b-54afd63eb87f&client_secret=b8da4ee37494f2ef8da3c727f3a0acb9" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

Pour plus de détails, veuillez consulter Comment obtenir un jeton JWT à l’aide d’un ID client et d’une clé secrète client.

Une fois que nous avons le jeton d’accès JWT, nous pouvons utiliser la commande cURL suivante pour remplir le modèle de publipostage. Nous chargeons les données à partir d’un fichier texte.

  • L’API ExecuteMailMerge effectue l’opération principale.
  • SampleMailMergeTemplate.docx est le modèle de publipostage d’entrée disponible sur le stockage cloud.
  • Nous utilisons le paramètre -F pour télécharger les données d’entrée à partir du fichier SampleMailMergeTemplateData.txt.
  • Le fichier résultant donné contre le paramètre destFileName sera stocké sur le stockage cloud.
curl -v "https://api.aspose.cloud/v4.0/words/SampleMailMergeTemplate.docx/MailMerge?withRegions=false&destFileName=TestPostDocumentExecuteMailMerge.docx" \
-X PUT  \
-F data=@/Downloads/SampleMailMergeTemplateData.txt \
-H "Content-Type: multipart/form-data" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>"
Aperçu du publipostage

Image 1 : Aperçu du document après une opération de publipostage.

Les fichiers d’exemple de l’exemple ci-dessus sont disponibles sur les liens suivants

Conclusion

Dans cet article, nous avons abordé en détail la manière d’effectuer un publipostage dans des documents Word à l’aide d’un extrait de code C#. En même temps, nous avons également appris les étapes de publipostage à l’aide de commandes cURL. Veuillez noter que notre SDK est construit selon la licence MIT, son code source complet est donc disponible en téléchargement sur le référentiel GitHub. Nous vous suggérons d’explorer la Documentation produit et de découvrir d’autres fonctionnalités intéressantes prises en charge par l’API.

Articles connexes

Nous vous recommandons également de visiter les liens suivants pour en savoir plus sur :