Microsoft Word תומכת באפשרות “השוואה” המאפשרת למשתמשים להשוות מסמכי Word ולזהות את השינויים החדשים שנוספו. תכונה זו שימושית מכיוון שתוכל לבצע פעולת השוואת טקסט במסמכי Word זה לצד זה. עם זאת, פתרון פרוגרמטי של בודק הבדלי טקסט יכול להיות הרבה יותר מהיר ויעיל ויכול לבצע בקלות פעולות הבדל טקסט בכמות גדולה. במאמר זה, אנו הולכים לבצע פעולת השוואת טקסט באמצעות REST-API כדי שנוכל למצוא את ההבדלים.
API להשוואת טקסט
Aspose.Words Cloud SDK עבור .NET מאפשר לך ליצור, לתפעל ולשנות פורמטים מובילים של MS Word (DOC, DOCX, DOCM וכו’) לפורמטים נתמכים אחרים. במקביל, הוא גם מספק את היכולת להשוות מסמכי Word ולהדגיש את ההבדל. כעת על מנת להשתמש ב-SDK, אנא התקן אותו מתוך ספריית NuGet באמצעות הפקודה הבאה במסוף מנהל החבילות:
Install-Package Aspose.Words-Cloud
למידע נוסף, תוכל לשקול לבקר בקישור הבא לקבלת מידע נוסף על כיצד להתקין ערכות SDK של Aspose.Cloud. כעת, לאחר ההתקנה, עלינו גם ליצור חשבון חינמי על ידי ביקור במרכז השליטה של Aspose.Cloud. כל שעליך לעשות הוא להירשם עם חשבון GitHub או Google שלך או לחץ על הלחצן צור חשבון חדש. אישורי הלקוח המוצגים בדף ישמשו בסעיפים הבאים.
השווה טקסט באינטרנט באמצעות C#
להלן השלבים וקטע הקוד המסבירים את הפרטים כיצד להשוות בין שני מסמכי Word באמצעות קטע קוד C# .NET.
- ראשית, עלינו להגדיר את פרטי ClientID ו-ClientSecret בקוד.
- שנית, צור אובייקט של מחלקה Configuration על ידי מתן פרטי ClientID ופרטי ClientSecret כארגומנטים.
- שלישית, צור אובייקט של מחלקה WordsApi והעבר את מופע ה-Configuration כארגומנט.
- כעת צור מופע של מחלקה CompareData.
- על מנת לזהות ספציפית את שם האדם כפי שזוהה בקובץ שנוצר, השתמש במאפיין Author של מחלקה CompareData.
- המאפיין ComparingWithDocument של מחלקת CompareData משמש לציון מסמך היעד להשוואת התוכן.
- כעת צור מופע של מחלקה CompareDocumentRequest אשר לוקח את קובץ הקלט/מקור, אובייקט CompareData ושם הקובץ שנוצר כארגומנטים.
- לבסוף, קרא לשיטת CompareDocument(..) כדי להתחיל את פעולת ההשוואה.
String MyClientID = "c235e685-1aab-4cda-a95b-54afd63eb87f"; // Get Client Id from https://dashboard.aspose.cloud/
String MyClientSecret = "b8da4ee37494f2ef8da3c727f3a0acb9"; // Get Client Secret from https://dashboard.aspose.cloud/
// ארגז מופע של מחלקה Configuration
// וספק את פרטי הלקוח המותאם אישית שלך ואת פרטי סוד הלקוח
var config = new Configuration { ClientId = MyClientID, ClientSecret = MyClientSecret };
// אתחול אובייקט WordsAPI באמצעות מופע Configuration
var wordsApi = new WordsApi(config);
// מסמך קלט ראשון
string firstDocument = "file-sample.docx";
// מסמך שני שיש להשוות איתו
string secondFile = "file-sample-updated.docx";
// שם הקובץ שנוצר
string resultantFile = "Out_ComparedTestDocs.docx";
// צור מופע של מחלקה CompareData
CompareData compareData = new CompareData();
// שם שישמש כמחבר המזהה את ההבדלים
compareData.Author = "Nayyer";
// ציין את המסמך שיש להשוות איתו
compareData.ComparingWithDocument = secondFile;
compareData.DateTime = DateTime.Now;
// צור מופע Request על ידי מתן מקור, מסמך להשוואה ושם הקובץ שנוצר
CompareDocumentRequest request = new CompareDocumentRequest(firstDocument, compareData, null, null, null, null, resultantFile);
// ליזום את השוואת המסמכים
DocumentResponse result = wordsApi.CompareDocument(request);
ניתן להוריד את הקבצים לדוגמה המשמשים בדוגמאות לעיל מהקישורים הבאים
השווה בין מסמכי Word באמצעות פקודות cURL
בסעיף זה, אנו הולכים ללמוד את השלבים כיצד להשוות מסמכי Word באמצעות פקודות cURL. מכיוון שממשקי ה-API שלנו נגישים רק לצוות מורשה בלבד, אז אנא בצע את הפקודה הבאה כדי ליצור אסימון גישה ל-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"
להלן פקודת cURL מראה כיצד לבצע השוואת קבצים מקוונת באמצעות פקודת cURL. הוא ניגש לשיטת CompareDocument והתוצאה של פעולה זו נכתבת למסמך הפלט המכיל שינויים במסלול כמספר גרסאות עריכה ופורמט. שים לב שאם אינך מספק את פרטי מסמך הפלט, התיקונים נשמרים במסמך המקורי.
curl -X PUT "https://api.aspose.cloud/v4.0/words/file-sample.docx/compareDocument?destFileName=ComparisonResult.docx" \
-H "accept: application/json"
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"ComparingWithDocument\":\"file-sample-updated.docx\",\"Author\":\"Nayyer\",\"DateTime\":\"2021-04-27T16:50:55.869Z\",\"CompareOptions\":{\"IgnoreCaseChanges\":true,\"IgnoreTables\":true,\"IgnoreFields\":true,\"IgnoreFootnotes\":true,\"IgnoreComments\":true,\"IgnoreTextboxes\":true,\"IgnoreFormatting\":true,\"IgnoreHeadersAndFooters\":true,\"Target\":\"Current\"}}"
לאחר ביצוע הפקודה, המידע שנמחק מצוין בנפרד והתוכן החדש שנוסף מודגש בצבע צהוב.
תמונה 1:- תצוגה מקדימה של מסמך מקורי ומסמך שונה.
תמונה 2:- תצוגה מקדימה של השוואת טקסט.
מַסְקָנָה
במאמר זה, הסברנו את השלבים להשוואת מסמכי Word באמצעות Aspose.Words Cloud API. שים לב שניתן לגשת אל ממשקי ה-API גם דרך ממשק ה-swagger. כמו כן, ערכות ה-Cloud SDK שלנו הן בקוד פתוח וניתן להוריד את קוד המקור המלא שלהן מ-GitHub.
אנו ממליצים גם לבקר במוצר תיעוד לפרטים נוספים על תכונות מרגשות אחרות המוצעות על ידי API. המשוב שלך חשוב לנו מאוד. אז, אנא אל תהסס לפנות אלינו באמצעות פורומי התמיכה שלנו.
ראה גם
תוכל לשקול לבקר בקישורים הבאים לקבלת מידע על: