מיזוג דואר מסמך word באינטרנט
מיזוג הדואר הוא הדרך הקלה ביותר ליצור קבוצה של מסמכים זהים למעט מידע מסוים, כלומר השם והכתובת של הנמען. ארגונים רבים מתקשרים עם הלקוחות/חברים שלהם באמצעות מכתבים, ניוזלטרים ופריטים פרסומיים באמצעות מיזוג דואר, אז במאמר זה, אנו הולכים לדון בפרטים על אופן מיזוג דואר של מסמכי Word באמצעות C# REST API.
ממשק API למיזוג דואר
Aspose.Words Cloud מציע את היכולות ליצור מסמך Word חדש, לפתוח מסמך קיים או להמיר אותו ל-PDF, XPS, SVG, EPUB ופורמטים שונים אחרים. מכיוון שה-API שלנו פותח לפי ארכיטקטורת REST, כך שאתה לא צריך לדאוג לגבי מגבלות שפה או פלטפורמה. כעת על מנת להשתמש ב-API ביישום C# .NET, אנא התקן את Aspose.Words Cloud SDK עבור .NET באמצעות הפקודה הבאה:
Install-Package Aspose.Words-Cloud
לאחר ההתקנה, עלינו לרשום חשבון בחינם דרך מרכז השליטה של Aspose.Cloud באמצעות GitHub או חשבון Google או פשוט הירשם וקבל את אישורי הלקוח שלך.
אכלוס תבנית מיזוג דואר ב-C#
אנא בצע את השלבים המפורטים להלן כדי לאכלס את תבנית מיזוג הדואר באמצעות קובץ נתונים.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get MyClientID from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get MyClientSecret from https://dashboard.aspose.cloud/
// ארגז מופע של מחלקת תצורה וספק את מזהה הלקוח המותאם אישית שלך ופרטי סוד הלקוח
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// אתחול אובייקט WordsAPI באמצעות מופע Configuration
var wordsApi = new WordsApi(config);
// מסמך קלט ראשון
string inputDocument = "SampleMailMergeTemplate.docx";
string inputDataFile = "SampleMailMergeTemplateData.txt";
// שם הקובץ שנוצר
string resultantFile = "TestPostDocumentExecuteMailMerge.docx";
// קרא את התוכן של קובץ הנתונים
string data = File.ReadAllText("/Downloads/" + inputDataFile, System.Text.Encoding.UTF8);
// צור אובייקט ExecuteMailMergeRequest על ידי מתן קובץ קלט, קובץ נתונים ופרטי פלט כתוצאה מכך
Requests.ExecuteMailMergeRequest request = new Requests.ExecuteMailMergeRequest(inputDocument, data, null, null, null, null, null, null, null, null, resultantFile);
// לבצע את פעולת מיזוג הדואר
DocumentResponse result = wordsApi.ExecuteMailMerge(request);
מיזוג דואר Word באמצעות פקודת cURL
פקודות cURL הן גם דרך נוחה לגשת לממשקי REST API. מאז Aspose.Words Cloud פותח על גבי ארכיטקטורת REST API, כך שנוכל לגשת בקלות לממשקי ה-API באמצעות פקודות cURL. כעת, כדרישה מוקדמת, עלינו ליצור אסימון גישה ל-JWT המבוסס על זיהוי הלקוח ופרטי סוד הלקוח.
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"
לפרטים נוספים, בקר בכתובת כיצד להשיג אסימון JWT באמצעות זיהוי לקוח ומפתח סודי לקוח.
ברגע שיש לנו את אסימון הגישה של JWT, נוכל להשתמש בפקודה cURL הבאה כדי לאכלס את תבנית מיזוג הדואר. אנו טוענים את הנתונים מקובץ טקסט.
- ה-API של ExecuteMailMerge מבצע את הפעולה הראשית.
- SampleMailMergeTemplate.docx היא תבנית מיזוג הדואר הזמינה באחסון הענן.
- אנו משתמשים בפרמטר -F הוא העלאת נתוני קלט מקובץ SampleMailMergeTemplateData.txt.
- הקובץ שנוצר כנגד הפרמטר destFileName יאוחסן באחסון בענן.
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>"
תמונה 1:- תצוגה מקדימה של מסמך לאחר פעולת מיזוג דואר.
הקבצים לדוגמה מהדוגמה לעיל זמינים בקישורים הבאים
מַסְקָנָה
במאמר זה, דנו בפרטים כיצד לבצע מיזוג דואר במסמכי Word באמצעות קטע קוד C#. במקביל, למדנו גם שלבי מיזוג דואר באמצעות פקודות cURL. שימו לב שה-SDK שלנו בנוי לפי רישיון MIT, כך שקוד המקור המלא שלו זמין להורדה דרך מאגר GitHub. אנו מציעים לך לחקור את תיעוד המוצר וללמוד על תכונות מרגשות אחרות הנתמכות על ידי ה-API.
מאמרים קשורים
אנו ממליצים גם לבקר בקישורים הבאים כדי ללמוד עוד על: