forhåndsvisning af kommentarer i ms word-fil

I den dynamiske verden af dokumentoprettelse og samarbejde er evnen til at tilføje og administrere kommentarer i Microsoft Word uundværlig. Kommentarer fungerer som et virtuelt diskussionsforum, der giver samarbejdspartnere mulighed for at udveksle tanker, foreslå forbedringer og give feedback uden at ændre det originale indhold. Denne funktion letter ikke kun effektiv kommunikation, men forbedrer også den kollaborative redigeringsproces, hvilket gør den mere strømlinet og effektiv. Derfor vil vi i denne guide dykke ned i de væsentlige aspekter af tilføjelse og sletning af kommentarer og afsløre potentialet og fordelene ved denne vitale funktion i MS Word ved hjælp af .NET REST API.

Administrer kommentarer ved hjælp af .NET REST API

Manipulering og tilføjelse af kommentarer ved hjælp af Aspose.Words Cloud SDK til .NET giver et væld af fordele og en bred vifte af muligheder ud over blot kommentarstyring. Bortset fra dette tilbyder SDK også en bred vifte af muligheder, herunder Word-dokumentgenerering, Word til JPG, Word til PDF, Word til ODT osv. konvertering, tekst- og formateringsmanipulation, billedbehandling og en bred vifte af funktioner, der gør det muligt for dig at forbedre dine dokumentbehandlingskapaciteter til en række scenarier.

Få kommentarer fra DOCX-filer

Du kan bruge til at læse alle eller specifikke kommentarer fra dokumentet. GetComments-metoden giver mulighed for at læse brugerkommentarer fra DOCX-filen. Nedenfor er specificeret en cURL-kommando, som du kan bruge til at læse kommentarerne til kommandoprompten.

cURL kommando

Bemærk venligst, at for at læse kommentarer, skal du give detaljerne vedrørende dokumenter, der er gemt på cloud storage, samt kun autoriserede brugere, der får tilladelserne til at få adgang til API’erne. Derfor skal du først hente JWT-godkendelsestokenet og bruge det i kommandoen som nævnt ovenfor.

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"

Når JWT-tokenet er blevet genereret, skal du udføre følgende kommando for at få alle kommentarerne i word-dokumentet.

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

Anmod om URL

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

C#.NET

For at læse en bestemt kommentar fra dokumentet, følg venligst nedenstående trin:

  • Initialiser en forekomst af WordsApi-klassen.
  • Opret et objekt af klassen GetCommentRequest, hvor vi giver input Volume 1.docx filnavn og kommentarindeksværdi som input-argumenter.
  • Til sidst initialiseres et objekt af CommentResponse, mens du sender værdien returneret fra GetComment(..)-metoden.
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/

// initialisere og objekt af WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// indtast filnavn
String filename= "Volume 1.docx";
// indeks over kommentar
int commentIndex = 0;
// create an object of GetCommentRequest where we pass indtast filnavn 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);
// opret en forekomst af CommentResponse og læs kommentar fra dokument
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// vis kommentaren i konsollen
Console.Write(response.Comment);

Få alle kommentarer

API’en tilbyder også funktionen til at få alle kommentarer fra dokumentet (i tilfælde af at vi ikke ønsker at krydse mellem enkeltpersoner).Til dette krav skal du oprette en forekomst af GetCommentsRequest, CommentsResponse-klasser og kalde GetComments(..)-metoden for WordsApi-objektet.

Indsæt kommentarer i Word-dokument

API’et er også i stand til at tilføje/indsætte nye kommentarobjekter i et word-dokument.

cURL kommando

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/

// initialisere og objekt af WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// indtast filnavn
String filename = "Volume 1.docx";
// indeks over kommentar
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 indtast filnavn 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);
// opret en forekomst af CommentResponse og læs kommentar fra dokument
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);
Indsæt forhåndsvisning af kommentarer.

Billede 1:- forhåndsvisning af nyligt indsat kommentar

Opdater kommentarer i Word-fil

Ud over at analysere og tilføje kommentarer understøtter API’en også funktionen til at opdatere de eksisterende kommentarer inde i word-dokumentet.

cURL kommando

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

For at opdatere kommentarerne i Word-dokument programmæssigt skal du følge instruktionerne nedenfor.

  • Opret en forekomst af WordsApi-klassen.
  • Opret et objekt af NodeLink, som definerer kommentaren NodeID.
  • Der oprettes et nyt objekt af klassen DocumentPosition, der definerer RangeStart- og RangeEnd-værdier.
  • Opret et objekt af CommentUpdate, som definerer, kommentere initialer, forfatternavn, RangeStart & RangeEnd detaljer ved at tildele DocumentPosition-forekomstværdien og teksten, der skal opdateres i kommentaren.
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/

// initialisere og objekt af WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// indtast filnavn
String filename = "Volume 1.docx";
// indeks over kommentar
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 indtast filnavn 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);
// opret en forekomst af CommentResponse og læs kommentar fra dokument
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);
Opdater forhåndsvisning af kommentarer

Billede 2:- forhåndsvisning af opdaterede kommentarer

Det resulterende dokument Volume 1 - updated.docx er også vedhæftet.

Slet kommentarer fra Word-dokument

Du kan også fjerne/slette kommentarerne fra word-filen ved hjælp af REST cloud API.

cURL kommando

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

C#.NET

  • Opret et objekt af WordsApi-klassen.
  • Opret en forekomst af DeleteCommentRequest-klassen, som tager en inputfil og et indeks af kommentar som et argument.
  • Endelig metoden DeleteComment(…) med DeleteCommentRequest-objektet som argument.
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/

// initialisere og objekt af WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// indtast filnavn
String filename = "Volume 1.docx";
// indeks over kommentar
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);
Forhåndsvisning af slettede kommentarer

Billede 3:- forhåndsvisning af slettede kommentarer