כיצד להוסיף, למחוק ולנהל הערות ביעילות באמצעות .NET REST API

בתחום הדינמי של יצירת מסמכים ושיתוף פעולה, היכולת להוסיף ולנהל הערות ב-Microsoft Word היא הכרחית. הערות משמשות כלוח דיונים וירטואלי, המאפשר למשתפי פעולה להחליף מחשבות, להציע שיפורים ולספק משוב מבלי לשנות את התוכן המקורי. תכונה זו לא רק מקלה על תקשורת יעילה אלא גם משפרת את תהליך העריכה השיתופי, מה שהופך אותו ליותר יעיל ויעיל. לכן, במדריך זה, נעמיק בהיבטים החיוניים של הוספה ומחיקה של הערות, נחשוף את הפוטנציאל והיתרונות של תכונה חיונית זו ב-MS Word באמצעות .NET REST API.

נהל הערות באמצעות .NET REST API
קבל הערות מקבצי DOCX
הוסף הערות במסמך Word
עדכן הערות בקובץ וורד
מחק הערות ממסמך Word

נהל תגובות באמצעות .NET REST API

מניפולציה והוספת הערות באמצעות Aspose.Words Cloud SDK עבור .NET מביאה שפע של יתרונות ומגוון רחב של יכולות מעבר לניהול הערות בלבד. מלבד זאת, ה-SDK מציע גם מגוון רחב של יכולות כולל הפקת מסמכי Word, Word ל-JPG, Word ל-PDF, המרת Word ל-ODT וכו’, מניפולציה של טקסט ועיצוב, עיבוד תמונה ומגוון רחב של תכונות, המאפשרות לך לשפר את יכולות עיבוד המסמכים שלך עבור מגוון תרחישים.

קבל הערות מקבצי DOCX

אתה יכול למנף לקרוא את כל ההערות או ספציפיות מהמסמך. שיטת GetComments מספקת את היכולות לקרוא את הערות המשתמש מקובץ DOCX. להלן צוינה פקודת cURL שבה תוכל להשתמש כדי לקרוא את ההערות בשורת הפקודה.

פקודת cURL

שימו לב שכדי לקרוא תגובות, עליכם לספק את הפרטים לגבי מסמכים המאוחסנים באחסון בענן, כמו גם רק משתמשים מורשים, לקבל את הרשאות הגישה לממשקי ה-API. לכן, תחילה עליך לאחזר את אסימון האימות של JWT ולהשתמש בו בפקודה כפי שהוזכר לעיל.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxxxxx-1c8e-4ea4-a948-3857547232fa&client_secret=xxxxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accpet: application/json"

לאחר יצירת אסימון JWT, אנא בצע את הפקודה הבאה כדי לקבל את כל ההערות בתוך מסמך Word.

curl -v "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments" \
-X GET \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>"

בקש כתובת אתר

https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments

C#.NET

על מנת לקרוא הערה מסוימת מהמסמך, אנא בצע את השלבים המפורטים להלן:

אתחול מופע של מחלקה WordsApi.
צור אובייקט של מחלקה GetCommentRequest שבו אנו מספקים את שם הקובץ Volume 1.docx הקלט וערך אינדקס ההערה כארגומנטים לקלט.
לבסוף, אתחול אובייקט של CommentResponse תוך העברת הערך המוחזר משיטת GetComment(..).

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// אתחול ואובייקט של WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// שם קובץ קלט
String filename= "Volume 1.docx";
// אינדקס הערה
int commentIndex = 0;
// create an object of GetCommentRequest where we pass שם קובץ קלט and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.GetCommentRequest request = new Aspose.Words.Cloud.Sdk.Model.Requests.GetCommentRequest(filename, commentIndex, null, null, null, null);
// צור מופע של CommentResponse וקרא תגובה ממסמך
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// להציג את ההערה במסוף
Console.Write(response.Comment);

קבלו את כל ההערות

ה-API מציע גם את התכונה לקבל את כל ההערות מהמסמך (במקרה שלא נרצה לעבור בין אנשים).עבור דרישה זו, עליך ליצור מופע של מחלקות GetCommentsRequest, CommentsResponse, ולקרוא למתודה GetComments(..) של האובייקט WordsApi.

הוסף הערות במסמך Word

ה-API מסוגל גם להוסיף/להכניס אובייקטי הערה חדשים במסמך Word.

פקודת cURL

curl -v "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments" \
-X POST \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"RangeStart\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 2\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"RangeEnd\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/5/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 2\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"Author\":\"Nayyer Shahbaz\",\"Initial\":\"MOU\",\"DateTime\":\"2020-12-07T04:10:03.942Z\",\"Text\":\"Comments Inserted using Aspose.Words Cloud API\"}"

C#.NET

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// אתחול ואובייקט של WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// שם קובץ קלט
String filename = "Volume 1.docx";
// אינדקס הערה
int commentIndex = 0;

Aspose.Words.Cloud.Sdk.Model.NodeLink link = new Aspose.Words.Cloud.Sdk.Model.NodeLink()
{
    NodeId = "0.1.0.1.1.1.1"
};
Aspose.Words.Cloud.Sdk.Model.DocumentPosition documentPosition = new Aspose.Words.Cloud.Sdk.Model.DocumentPosition()
{
    Node = link,
    Offset = 0
};
Aspose.Words.Cloud.Sdk.Model.CommentInsert commentInsert = new Aspose.Words.Cloud.Sdk.Model.CommentInsert()
{
    Initial = "Aspose",
    Author = "Nayyer Shahbaz",
    RangeStart = documentPosition,
    RangeEnd = documentPosition,
    Text = "Comment added through API"
};


// create an object of GetCommentRequest where we pass שם קובץ קלט and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.InsertCommentRequest request = 
  new Aspose.Words.Cloud.Sdk.Model.Requests.InsertCommentRequest(filename, commentInsert, null, null, null);
// צור מופע של CommentResponse וקרא תגובה ממסמך
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);

הוסף תצוגה מקדימה של הערות. — תמונה 1:- תצוגה מקדימה של הערה חדשה שהוכנסה

עדכן הערות בקובץ וורד

בנוסף לניתוח והוספה של הערות, ה-API תומך גם בתכונה לעדכון ההערות הקיימות בתוך מסמך ה-word.

פקודת cURL

curl -X PUT "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments/1" \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"RangeStart\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 1\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"RangeEnd\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"string\",\"Type\":\"string\",\"Title\":\"Heading 1\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"Author\":\"Nayyer Shahbaz\",\"Initial\":\"Aspose.Words\",\"DateTime\":\"2020-12-07T06:18:31.348Z\",\"Text\":\"Comments updated using Aspose.Words Cloud API\"}"

C#.NET

על מנת לעדכן באופן תוכנתי את ההערות במסמך Word, אנא עקוב אחר ההוראות המפורטות להלן.

צור מופע של מחלקה WordsApi.
צור אובייקט של NodeLink שמגדיר את ההערה NodeID.
נוצר אובייקט חדש של מחלקה DocumentPosition המגדיר ערכי RangeStart ו-RangeEnd.
צור אובייקט של CommentUpdate שמגדיר, ראשי תיבות של הערות, שם מחבר, RangeStart ו-RangeEnd פרטי על ידי הקצאת ערך מופע DocumentPosition והטקסט שיש לעדכן בהערה.

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// אתחול ואובייקט של WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// שם קובץ קלט
String filename = "Volume 1.docx";
// אינדקס הערה
int commentIndex = 1;

Aspose.Words.Cloud.Sdk.Model.NodeLink link = new Aspose.Words.Cloud.Sdk.Model.NodeLink()
{
    NodeId = "0.1.0.1.1.1.1"
};
Aspose.Words.Cloud.Sdk.Model.DocumentPosition documentPosition = new Aspose.Words.Cloud.Sdk.Model.DocumentPosition()
{
    Node = link,
    Offset = 0
};
Aspose.Words.Cloud.Sdk.Model.CommentUpdate commentUpdate = new Aspose.Words.Cloud.Sdk.Model.CommentUpdate()
{
    Initial = "Aspose",
    Author = "Nayyer Shahbaz",
    RangeStart = documentPosition,
    RangeEnd = documentPosition,
    Text = "Comments updated using Aspose.Words Cloud API"
};

// create an object of GetCommentRequest where we pass שם קובץ קלט and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.UpdateCommentRequest request =
                    new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateCommentRequest(filename, commentIndex, commentUpdate, null, null, null);
// צור מופע של CommentResponse וקרא תגובה ממסמך
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);

עדכן את התצוגה המקדימה של הערות — תמונה 2:- תצוגה מקדימה של הערות מעודכנות

מצורף גם המסמך שנוצר כרך 1 - updated.docx.

מחק הערות ממסמך Word

אתה יכול גם להסיר/למחוק את ההערות מקובץ ה-word באמצעות REST Cloud API.

פקודת cURL

curl -X DELETE "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments/0" \
-H "accept: /" \
-H "Authorization: Bearer <JWT Token>"

C#.NET

צור אובייקט של המחלקה WordsApi.
צור מופע של מחלקה DeleteCommentRequest שלוקח קובץ קלט ואינדקס של הערה כארגומנט.
לבסוף, שיטת DeleteComment(…) עם אובייקט DeleteCommentRequest כארגומנט.

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// אתחול ואובייקט של WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// שם קובץ קלט
String filename = "Volume 1.docx";
// אינדקס הערה
int commentIndex = 0;


Aspose.Words.Cloud.Sdk.Model.Requests.DeleteCommentRequest request = 
  new Aspose.Words.Cloud.Sdk.Model.Requests.DeleteCommentRequest(filename, commentIndex, null, null, null, null, null, null, null);
wordsApi.DeleteComment(request);

נהל תגובות באמצעות .NET REST API#

קבל הערות מקבצי DOCX#

פקודת cURL#

C#.NET#

הוסף הערות במסמך Word#

פקודת cURL#

C#.NET#

עדכן הערות בקובץ וורד#

פקודת cURL#

C#.NET#

מחק הערות ממסמך Word#

פקודת cURL#

C#.NET#

נהל תגובות באמצעות .NET REST API

קבל הערות מקבצי DOCX

פקודת cURL

C#.NET

הוסף הערות במסמך Word

פקודת cURL

C#.NET

עדכן הערות בקובץ וורד

פקודת cURL

C#.NET

מחק הערות ממסמך Word

פקודת cURL

C#.NET