การแสดงตัวอย่างความคิดเห็นในไฟล์ MS Word

ในโลกแห่งการสร้างและการทำงานร่วมกันของเอกสาร ความสามารถในการเพิ่มและจัดการความคิดเห็นใน Microsoft Word เป็นสิ่งที่ขาดไม่ได้ ความคิดเห็นทำหน้าที่เป็นกระดานสนทนาเสมือนจริง ช่วยให้ผู้ร่วมงานแลกเปลี่ยนความคิดเห็น เสนอแนะแนวทางปรับปรุง และให้ข้อเสนอแนะได้โดยไม่ต้องเปลี่ยนแปลงเนื้อหาเดิม คุณลักษณะนี้ไม่เพียงแต่ช่วยให้การสื่อสารมีประสิทธิภาพ แต่ยังช่วยปรับปรุงกระบวนการแก้ไขร่วมกัน ทำให้ราบรื่นและมีประสิทธิภาพมากขึ้น ดังนั้น ในคู่มือนี้ เราจะเจาะลึกถึงประเด็นสำคัญของการเพิ่มและลบความคิดเห็น รวมถึงเปิดเผยศักยภาพและประโยชน์ของคุณลักษณะสำคัญนี้ใน MS Word โดยใช้ .NET REST API

จัดการความคิดเห็นโดยใช้ .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 และเรียกใช้เมธอด 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:- ดูตัวอย่างความคิดเห็นที่แทรกใหม่

อัปเดตความคิดเห็นในไฟล์ 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

คุณสามารถลบ/ลบความคิดเห็นจากไฟล์คำได้โดยใช้ 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:- ดูตัวอย่างความคิดเห็นที่ถูกลบ