
დოკუმენტების შექმნისა და თანამშრომლობის დინამიურ სფეროში, Microsoft Word-ში კომენტარების დამატებისა და მართვის შესაძლებლობა შეუცვლელია. კომენტარები ემსახურება როგორც ვირტუალური სადისკუსიო დაფა, რომელიც საშუალებას აძლევს კოლაბორატორებს გაცვალონ აზრები, შესთავაზონ გაუმჯობესებები და უზრუნველყონ გამოხმაურება ორიგინალური შინაარსის შეცვლის გარეშე. ეს ფუნქცია არა მხოლოდ ხელს უწყობს ეფექტურ კომუნიკაციას, არამედ აძლიერებს ერთობლივი რედაქტირების პროცესს, რაც მას უფრო გამარტივებულს და ეფექტურს ხდის. ამიტომ, ამ სახელმძღვანელოში ჩვენ განვიხილავთ კომენტარების დამატებისა და წაშლის არსებით ასპექტებს, გამოვავლენთ ამ სასიცოცხლო ფუნქციის პოტენციალს და უპირატესობებს MS Word-ში .NET REST API-ს გამოყენებით.
- მართეთ კომენტარები .NET REST API-ს გამოყენებით
- მიიღეთ კომენტარები DOCX ფაილებიდან
- ჩადეთ კომენტარები Word დოკუმენტში
- განაახლეთ კომენტარები Word ფაილში
- წაშალეთ კომენტარები Word დოკუმენტიდან
მართეთ კომენტარები .NET REST API-ის გამოყენებით
Aspose.Words Cloud SDK for .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>"
მოითხოვეთ URL
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 კლასების ინსტანცია და გამოიძახოთ WordsApi ობიექტის GetComments(..) მეთოდი.
ჩადეთ კომენტარები 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: - ახლად ჩასმული კომენტარის გადახედვა
განაახლეთ კომენტარები Word ფაილში
ისევე როგორც კომენტარების გაანალიზება და დამატება, 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 - განახლებულია.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);

სურათი 3: - წაშლილი კომენტარების გადახედვა