نحوه افزودن، حذف و مدیریت موثر نظرات با استفاده از NET REST API

در حوزه پویای ایجاد سند و همکاری، امکان افزودن و مدیریت نظرات در 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 ایجاد کنید و متد 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 را تعریف می کند.
با تخصیص مقدار نمونه DocumentPosition و متنی که باید در نظر به‌روزرسانی شود، یک شی از CommentUpdate ایجاد کنید که مقدمات اولیه، نام نویسنده، جزئیات RangeStart و RangeEnd را تعریف می‌کند.

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#

به روز رسانی نظرات در فایل Word#

دستور cURL#

C#.NET#

نظرات را از سند Word حذف کنید#

دستور cURL#

C#.NET#

مدیریت نظرات با استفاده از NET REST API

نظرات را از فایل های DOCX دریافت کنید

دستور cURL

C#.NET

درج نظرات در سند Word

دستور cURL

C#.NET

به روز رسانی نظرات در فایل Word

دستور cURL

C#.NET

نظرات را از سند Word حذف کنید

دستور cURL

C#.NET