Körlevél Word dokumentum online
A körlevél a legegyszerűbb módja annak, hogy olyan dokumentumokat állítson elő, amelyek bizonyos információk kivételével azonosak, például a címzett neve és címe. Sok szervezet levelek, hírlevelek és promóciós anyagok segítségével kommunikál ügyfeleivel/tagjaival körlevél-egyesítést használva, ezért ebben a cikkben a Word dokumentumok C# REST API-val történő levelezésének részleteiről fogunk beszélni.
Körlevél API
Az Aspose.Words Cloud lehetőséget kínál új Word-dokumentum létrehozására, meglévő dokumentum megnyitására vagy PDF, XPS, SVG, EPUB és számos más formátumra konvertálására. Mivel API-nkat a REST architektúra szerint fejlesztettük ki, így nem kell aggódnia a nyelvi vagy platformkorlátozások miatt. Az API C# .NET alkalmazásban való használatához most telepítse az Aspose.Words Cloud SDK for .NET programot a következő paranccsal:
Install-Package Aspose.Words-Cloud
A telepítés után regisztrálnunk kell egy ingyenes fiókot az Aspose.Cloud dashboard felületén GitHub- vagy Google-fiókkal, vagy egyszerűen regisztrálnunk kell, és meg kell szereznünk az ügyfél hitelesítő adatait.
Körlevél-sablon feltöltése C#-ban
Kérjük, kövesse az alábbi lépéseket a Körlevél-sablon adatfájl segítségével történő feltöltéséhez.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/
// ládába helyezze a konfigurációs osztály példányát, és adja meg személyre szabott ügyfél-azonosítóját és ügyféltitkai adatait
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// inicializálja a WordsAPI objektumot a konfigurációs példány használatával
var wordsApi = new WordsApi(config);
// első bemeneti dokumentum
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// az eredményül kapott fájl neve
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// olvassa el az adatfájl tartalmát
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// Hozzon létre ExecuteMailMergeRequest objektumot a bemeneti fájl, az adatfájl és az eredményül kapott kimeneti adatok megadásával
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// hajtsa végre a körlevél műveletet
DocumentResponse result = wordsApi.ExecuteMailMerge(request);
Levélegyesítés Word a cURL paranccsal
A cURL parancsok a REST API-k elérésének kényelmes módjai is. Mivel az Aspose.Words Cloud a REST API architektúrára épül, így a cURL parancsokon keresztül könnyen elérhetjük az API-kat. Most előfeltételként létre kell hoznunk egy JWT hozzáférési tokent az ügyfél-azonosító és az ügyféltitkos adatok alapján.
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"
További részletekért látogasson el a Hogyan szerezhető be JWT token ügyfél-azonosító és ügyféltitkos kulcs használatával oldalon.
Miután megvan a JWT hozzáférési jogkivonat, a következő cURL paranccsal feltölthetjük a Körlevél sablont. Az adatokat szöveges fájlból töltjük be.
- Az ExecuteMailMerge API végzi a fő műveletet.
- A SampleMailMergeTemplate.docx a felhőalapú tárhelyen elérhető beviteli körlevél-sablon.
- Az -F paramétert használjuk a bemeneti adatok feltöltésére a SampleMailMergeTemplateData.txt fájlból.
- A destFileName paraméterben megadott eredményfájl a felhőalapú tárhelyen tárolódik.
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>"
- kép: – Dokumentum előnézeti körlevél-összevonási művelet után.
A fenti példa mintafájljai a következő hivatkozásokon érhetők el
Következtetés
Ebben a cikkben megvitattuk azokat a részleteket, amelyek segítségével C# kódrészletet használva végezhet körlevelet Word dokumentumokban. Ugyanakkor a cURL parancsok segítségével megtanultuk a körlevél-összevonási lépéseket is. Felhívjuk figyelmét, hogy SDK-nk az MIT-licenc szerint épül fel, így teljes forráskódja letölthető a GitHub tárhelyről. Javasoljuk, hogy tekintse meg a Termékdokumentációt, és ismerkedjen meg az API által támogatott egyéb izgalmas funkciókkal.
Kapcsolódó cikkek
Javasoljuk továbbá, hogy látogassa meg az alábbi linkeket, ha többet szeretne megtudni erről: