.NET REST API'yi kullanarak Yorumları Etkili Şekilde Nasıl Ekler, Silir ve Yönetirsiniz

Belge oluşturma ve işbirliğinin dinamik alanında, Microsoft Word’de yorum ekleme ve yönetme yeteneği vazgeçilmezdir. Yorumlar, işbirlikçilerin orijinal içeriği değiştirmeden düşüncelerini paylaşmalarına, iyileştirmeler önermelerine ve geri bildirim sağlamalarına olanak tanıyan sanal bir tartışma panosu görevi görür. Bu özellik yalnızca etkili iletişimi kolaylaştırmakla kalmaz, aynı zamanda işbirlikçi düzenleme sürecini de geliştirerek daha akıcı ve verimli hale getirir. Bu nedenle, bu kılavuzda, yorum ekleme ve silmenin temel yönlerini ele alacağız ve .NET REST API’sini kullanarak MS Word’deki bu hayati özelliğin potansiyelini ve faydalarını ortaya çıkaracağız.

.NET REST API’sini kullanarak Yorumları Yönetin
DOCX Dosyalarından Yorumlar Alın
Word belgesine yorum ekle
Word dosyasındaki yorumları güncelle
Word belgesinden yorumları sil

.NET REST API’yi kullanarak Yorumları Yönetin

Aspose.Words Cloud SDK for .NET kullanarak yorumları düzenlemek ve eklemek, yorum yönetiminin ötesinde çok sayıda avantaj ve geniş bir yetenek yelpazesi sunar. Bunun dışında SDK, Word belgesi oluşturma, Word’den JPG’ye, Word’den PDF’ye, Word’den ODT’ye vb. dönüştürme, metin ve biçimlendirme düzenleme, görüntü işleme ve çok çeşitli özellikler dahil olmak üzere geniş bir yetenek yelpazesi sunarak, çeşitli senaryolar için belge işleme yeteneklerinizi geliştirmenize olanak tanır.

DOCX Dosyalarından Yorumlar Alın

Belgedeki tüm veya belirli yorumları okumak için kaldıraç kullanabilirsiniz. GetComments yöntemi, DOCX dosyasından kullanıcı yorumlarını okuma yeteneklerini sağlar. Aşağıda, komut istemindeki yorumları okumak için kullanabileceğiniz bir cURL komutu belirtilmiştir.

cURL komutu

Yorumları okuyabilmek için bulut depolamada saklanan belgelerle ilgili ayrıntıları sağlamanız gerektiğini ve yalnızca yetkili kullanıcıların API’lere erişim iznine sahip olduğunu lütfen unutmayın. Bu nedenle, önce JWT kimlik doğrulama belirtecini almanız ve yukarıda belirtildiği gibi komutta kullanmanız gerekir.

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 token’ı oluşturulduktan sonra, Word belgesindeki tüm yorumları almak için lütfen aşağıdaki komutu çalıştırın.

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

İstek URL’si

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

C#.NET

Belgedeki belirli bir yorumu okuyabilmek için lütfen aşağıda belirtilen adımları izleyin:

WordsApi sınıfının bir örneğini başlatın.
Giriş argümanları olarak Volume 1.docx dosya adını ve yorum indeksi değerini sağladığımız GetCommentRequest sınıfının bir nesnesini oluşturun.
Son olarak GetComment(..) metodundan dönen değeri geçirirken CommentResponse nesnesini başlatın.

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'nin başlatılması ve nesnesi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// giriş dosya adı
String filename= "Volume 1.docx";
// yorum dizini
int commentIndex = 0;
// create an object of GetCommentRequest where we pass giriş dosya adı 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'un bir örneğini oluşturun ve belgeden yorumu okuyun
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// yorumu konsolda göster
Console.Write(response.Comment);

Tüm yorumları al

API ayrıca belgedeki tüm yorumları alma özelliğini de sunar (bireyler arasında geçiş yapmak istemediğimiz durumlarda).Bu gereksinim için, GetCommentsRequest, CommentsResponse sınıflarının bir örneğini oluşturmanız ve WordsApi nesnesinin GetComments(..) metodunu çağırmanız gerekir.

Word belgesine yorum ekle

API aynı zamanda Word belgesine yeni yorum nesneleri ekleme/yerleştirme yeteneğine de sahiptir.

cURL komutu

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'nin başlatılması ve nesnesi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// giriş dosya adı
String filename = "Volume 1.docx";
// yorum dizini
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 giriş dosya adı 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'un bir örneğini oluşturun ve belgeden yorumu okuyun
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);

Yorumların önizlemesini ekle. — Resim 1:- Yeni eklenen yorumun önizlemesi

Word dosyasındaki yorumları güncelle

API, yorumların ayrıştırılması ve eklenmesinin yanı sıra, Word belgesi içindeki mevcut yorumların güncellenmesi özelliğini de destekliyor.

cURL komutu

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 belgesinde yorumları programlı olarak güncelleyebilmek için lütfen aşağıda belirtilen talimatları izleyin.

WordsApi sınıfının bir örneğini oluşturun.
Yorum NodeID’sini tanımlayan bir NodeLink nesnesi oluşturun.
RangeStart ve RangeEnd değerlerini tanımlayan DocumentPosition sınıfının yeni bir nesnesi oluşturulur.
Yorumun baş harflerini, yazar adını, aralık başlangıcını ve aralık bitişini tanımlayan bir CommentUpdate nesnesi oluşturun; bunun için DocumentPosition örneği değerini ve yorumda güncellenecek metni atayın.

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'nin başlatılması ve nesnesi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// giriş dosya adı
String filename = "Volume 1.docx";
// yorum dizini
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 giriş dosya adı 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'un bir örneğini oluşturun ve belgeden yorumu okuyun
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);

Yorum önizlemesini güncelle — Resim 2:- Güncellenen yorumların önizlemesi

Sonuç belgesi Cilt 1 - güncellendi.docx de ektedir.

Word belgesinden yorumları sil

Ayrıca REST bulut API’sini kullanarak word dosyasındaki yorumları kaldırabilir/silebilirsiniz.

cURL komutu

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 sınıfından bir nesne oluşturun.
Bir girdi dosyasını ve yorumun dizinini argüman olarak alan DeleteCommentRequest sınıfının bir örneğini oluşturun.
Son olarak DeleteCommentRequest nesnesini argüman olarak kullanan DeleteComment(…) metodu.

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'nin başlatılması ve nesnesi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// giriş dosya adı
String filename = "Volume 1.docx";
// yorum dizini
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’yi kullanarak Yorumları Yönetin#

DOCX Dosyalarından Yorumlar Alın#

cURL komutu#

C#.NET#

Word belgesine yorum ekle#

cURL komutu#

C#.NET#

Word dosyasındaki yorumları güncelle#

cURL komutu#

C#.NET#

Word belgesinden yorumları sil#

cURL komutu#

C#.NET#

.NET REST API’yi kullanarak Yorumları Yönetin

DOCX Dosyalarından Yorumlar Alın

cURL komutu

C#.NET

Word belgesine yorum ekle

cURL komutu

C#.NET

Word dosyasındaki yorumları güncelle

cURL komutu

C#.NET

Word belgesinden yorumları sil

cURL komutu

C#.NET