Come aggiungere, eliminare e gestire i commenti in modo efficace utilizzando .NET REST API

Nel dinamico regno della creazione e collaborazione di documenti, la capacità di aggiungere e gestire commenti in Microsoft Word è indispensabile. I commenti servono come una bacheca di discussione virtuale, consentendo ai collaboratori di scambiare idee, suggerire miglioramenti e fornire feedback senza alterare il contenuto originale. Questa funzionalità non solo facilita una comunicazione efficace, ma migliora anche il processo di modifica collaborativa, rendendolo più snello ed efficiente. Pertanto, in questa guida, approfondiremo gli aspetti essenziali dell’aggiunta e dell’eliminazione di commenti, svelando il potenziale e i vantaggi di questa funzionalità vitale in MS Word utilizzando .NET REST API.

Gestisci i commenti utilizzando .NET REST API
Ottieni commenti dai file DOCX
Inserire commenti nel documento Word
Aggiorna i commenti nel file Word
Eliminare i commenti dal documento Word

Gestisci i commenti usando .NET REST API

La manipolazione e l’aggiunta di commenti tramite Aspose.Words Cloud SDK per .NET offre una vasta gamma di vantaggi e una vasta gamma di funzionalità che vanno oltre la semplice gestione dei commenti. Oltre a questo, l’SDK offre anche una vasta gamma di funzionalità, tra cui la generazione di documenti Word, la conversione da Word a JPG, da Word a PDF, da Word a ODT ecc., la manipolazione di testo e formattazione, l’elaborazione delle immagini e una vasta gamma di funzionalità, che consentono di migliorare le capacità di elaborazione dei documenti per una serie di scenari.

Ottieni commenti dai file DOCX

Puoi fare leva per leggere tutti o solo alcuni commenti dal documento. Il metodo GetComments fornisce le capacità per leggere i commenti utente dal file DOCX. Di seguito è specificato un comando cURL che puoi usare per leggere i commenti sul prompt dei comandi.

comando cURL

Si prega di notare che per leggere i commenti, è necessario fornire i dettagli relativi ai documenti archiviati nel cloud storage, e solo gli utenti autorizzati devono ottenere i permessi per accedere alle API. Pertanto, è necessario prima recuperare il token di autenticazione JWT e utilizzarlo nel comando come menzionato sopra.

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"

Una volta generato il token JWT, eseguire il seguente comando per ottenere tutti i commenti nel documento 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>"

Richiedi URL

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

C#.NET

Per leggere un commento specifico dal documento, seguire i passaggi specificati di seguito:

Inizializza un’istanza della classe WordsApi.
Creiamo un oggetto della classe GetCommentRequest in cui forniamo il nome del file di input Volume 1.docx e il valore dell’indice del commento come argomenti di input.
Infine, inizializza un oggetto di CommentResponse passando il valore restituito dal metodo 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/

// inizializza e oggetto di WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// nome del file di input
String filename= "Volume 1.docx";
// indice di commento
int commentIndex = 0;
// create an object of GetCommentRequest where we pass nome del file di input 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);
// crea un'istanza di CommentResponse e leggi il commento dal documento
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// visualizza il commento nella console
Console.Write(response.Comment);

Ottieni tutti i commenti

L’API offre anche la funzionalità di ottenere tutti i commenti dal documento (nel caso in cui non si voglia passare da un individuo all’altro).Per questo requisito, è necessario creare un’istanza delle classi GetCommentsRequest, CommentsResponse e chiamare il metodo GetComments(..) dell’oggetto WordsApi.

Inserire commenti nel documento Word

L’API è anche in grado di aggiungere/inserire nuovi oggetti commento in un documento Word.

comando 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/

// inizializza e oggetto di WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// nome del file di input
String filename = "Volume 1.docx";
// indice di commento
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 nome del file di input 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);
// crea un'istanza di CommentResponse e leggi il commento dal documento
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);

Anteprima dell'inserimento dei commenti. — Immagine 1:- anteprima del commento appena inserito

Aggiorna i commenti nel file Word

Oltre all’analisi e all’aggiunta di commenti, l’API supporta anche la funzionalità di aggiornamento dei commenti esistenti all’interno del documento Word.

comando 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

Per aggiornare a livello di programmazione i commenti nel documento Word, seguire le istruzioni specificate di seguito.

Crea un’istanza della classe WordsApi.
Crea un oggetto di NodeLink che definisce il commento NodeID.
Viene creato un nuovo oggetto della classe DocumentPosition che definisce i valori RangeStart e RangeEnd.
Crea un oggetto di CommentUpdate che definisce le iniziali del commento, il nome dell’autore, i dettagli di RangeStart e RangeEnd assegnando il valore dell’istanza DocumentPosition e il testo da aggiornare nel commento.

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/

// inizializza e oggetto di WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// nome del file di input
String filename = "Volume 1.docx";
// indice di commento
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 nome del file di input 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);
// crea un'istanza di CommentResponse e leggi il commento dal documento
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);

Aggiorna anteprima commenti — Immagine 2:- anteprima dei commenti aggiornati

È allegato anche il documento risultante Volume 1 - updated.docx.

Eliminare i commenti dal documento Word

È anche possibile rimuovere/eliminare i commenti dal file Word utilizzando la REST Cloud API.

comando 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

Crea un oggetto della classe WordsApi.
Crea un’istanza della classe DeleteCommentRequest che accetta un file di input e l’indice del commento come argomento.
Infine il metodo DeleteComment(…) che ha l’oggetto DeleteCommentRequest come argomento.

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/

// inizializza e oggetto di WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// nome del file di input
String filename = "Volume 1.docx";
// indice di commento
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);

Anteprima commenti eliminati — Immagine 3:- anteprima dei commenti eliminati

Gestisci i commenti usando .NET REST API#

Ottieni commenti dai file DOCX#

comando cURL#

C#.NET#

Inserire commenti nel documento Word#

comando cURL#

C#.NET#

Aggiorna i commenti nel file Word#

comando cURL#

C#.NET#

Eliminare i commenti dal documento Word#

comando cURL#

C#.NET#

Gestisci i commenti usando .NET REST API

Ottieni commenti dai file DOCX

comando cURL

C#.NET

Inserire commenti nel documento Word

comando cURL

C#.NET

Aggiorna i commenti nel file Word

comando cURL

C#.NET

Eliminare i commenti dal documento Word

comando cURL

C#.NET