Annoteer Word-dokumente

Voeg opmerkings by Word-dokumente deur C# .NET te gebruik

Die annotering van ’n dokument is ’n noodsaaklike deel van samewerking en kommunikasie in baie industrieë. Dit laat gebruikers toe om terugvoer, voorstelle en opmerkings oor ’n dokument te gee wat maklik met ander gedeel kan word. Alhoewel, Microsoft Word bied verskeie annotasie-nutsmiddels, soos opmerkings, spoor veranderinge, en die byvoeging van notas, om gebruikers te help om terugvoer te gee en saam te werk aan ’n dokument. In hierdie blogplasing sal ons egter verken hoe om ’n Word-dokumente met .NET Wolk SDK te annoteer, wat dit makliker maak vir gebruikers om te kommunikeer en saam te werk aan dokumente.

REST API om Word-kommentaar by te voeg

Deur Aspose.Words Cloud SDK vir .NET te gebruik, kan jy maklik opmerkings, antwoorde en aantekeninge by ’n Word-dokument voeg met behulp van C#-taal. Die SDK verskaf ’n omvattende stel REST API’s vir Word-dokumentmanipulasie en ondersteun alle groot dokumentformate, insluitend DOC, DOCX, [RTF](https ://docs.fileformat.com/word-processing/rtf/), en meer. Nou met die hulp van hierdie SDK kan jy jou werkvloei en samewerkingsproses verbeter deur maklik en doeltreffend aantekeninge, opmerkings en ander resensie-elemente by jou Word-dokumente te voeg.

Om die SDK te gebruik, soek Aspose.Words-Cloud in NuGet-pakketbestuurder en klik die Voeg pakket by-knoppie om die SDK-verwysing in .NET-projek by te voeg.

Let wel: om toegang tot die REST API te verkry, moet jy registreer en jou persoonlike geloofsbriewe kry. Kyk asseblief na die Quick Start gids vir verwante inligting.

Voeg Word-dokumentaantekening by met C#

Probeer asseblief om die volgende kodebrokkie te gebruik om Word-dokumentaantekening by te voeg deur .NET Cloud SDK te gebruik.

// Vir volledige voorbeelde en datalêers, gaan asseblief na 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// Kry kliëntbewyse van https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// skep konfigurasie-objek met behulp van ClinetID en Client Secret-besonderhede
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// inisialiseer WordsApi-instansie
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// lees die inhoud van die eerste Word-dokument vanaf die plaaslike skyf
var firstFile = System.IO.File.OpenRead(firstDocument);
try
{
    var requestCommentRangeStartNode = new NodeLink()
    {
        NodeId = "0.6.5.3"
    };
    var requestCommentRangeStart = new DocumentPosition()
    {
        Node = requestCommentRangeStartNode,
        Offset = 0
    };
    var requestCommentRangeEndNode = new NodeLink()
    {
        NodeId = "0.6.5.3"
    };
    var requestCommentRangeEnd = new DocumentPosition()
    {
        Node = requestCommentRangeEndNode,
        Offset = 0
    };
    var requestComment = new CommentInsert()
    {
        RangeStart = requestCommentRangeStart,
        RangeEnd = requestCommentRangeEnd,
        Initial = "NS",
        Author = "Nayyer Shahbaz",
        Text = "Second Revisions..."
    };

    var insertRequest = new InsertCommentOnlineRequest(firstFile, requestComment, destFileName: "Commented.docx");
    var response = wordsApi.InsertCommentOnline(insertRequest);
    
    if (response != null && response.Equals("OK"))
    {
        Console.WriteLine("Word Document Annotation added successfully!");
    }
}
catch(Exception ex)
{
    // enige uitsondering tydens dokumentaantekeningproses
    Console.Write(ex);
}
word-dokument-aantekeningvoorskou

Beeld: - Voorskou van Word-dokumentaantekening met behulp van REST API.

// create configuration object using ClientID and Client Secret details
var config = new Configuration { ClientId = clientID, ClientSecret = clientSecret };
// initialize WordsApi instance
var wordsApi = new WordsApi(config);

Skep ’n voorwerp van WordsApi terwyl jy gepersonaliseerde kliëntbewyse gebruik.

var firstFile = System.IO.File.OpenRead(firstDocument);

Lees die inhoud van die insette Word-dokument vanaf die plaaslike skyf.

var requestCommentRangeStartNode = new NodeLink()
{
    NodeId = "0.6.5.3"
};

Skep ’n objek van NodeLink wat NodeId vir annotasie definieer. Herhaal hierdie proses vir CommentRangeStartNode en CommentRangeEndNode gevalle.

var requestComment = new CommentInsert()
{
    RangeStart = requestCommentRangeStart,
    RangeEnd = requestCommentRangeEnd,
    Initial = "NS",
    Author = "Nayyer Shahbaz",
    Text = "Second Revisions..."
};

Skep ’n instansie van CommentInsert waar ons die besonderhede soos voorletters, naam van outeur en die inhoud van kommentaar/aantekening spesifiseer.

var insertRequest = new InsertCommentOnlineRequest(firstFile, requestComment, destFileName: "Commented.docx");

Skep nou ’n objek van InsertCommentOnlineRequest waar ons die inhoud van die insette Word-dokument, CommentInsert-objek en die naam vir die gevolglike Word-dokument deurgee.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Laastens, roep die InsertCommentOnline(…) metode om ’n opmerking in ’n Word-dokument by die gespesifiseerde nodus in te voeg.

Die voorbeeldlêers wat in die voorbeeld hierbo gebruik word, kan afgelaai word vanaf input-sample-1.docx en Commented.docx.

Voeg opmerkings by Word-dokument met behulp van cURL-opdragte

Ons verstaan dat die byvoeging van aantekeninge of opmerkings by Word-dokumente met behulp van cURL-opdragte uiters voordelig kan wees, aangesien dit ’n programmatiese manier bied om aantekeninge in grootmaat by te voeg of jou in staat stel om die funksionaliteit in jou bestaande werkvloeie te integreer. Met die hulp van Aspose.Words Cloud API en cURL-opdragte, kan kommentaar by ’n Word-dokument bewerkstellig word deur ’n reeks API-oproepe. Dit behels die stuur van versoeke na die Aspose.Words Cloud API met toepaslike parameters, soos die dokumentlêer, ligging, teks en outeurinligting, om ’n opmerking te skep.

Die eerste stap is om ’n ’toegangstoken’ te verkry deur ’n POST-versoek te stuur met jou App-SID en App-sleutelbesonderhede. Voer asseblief die volgende opdrag uit:

curl -v "https://api.aspose.cloud/connect/token" \
 -X POST \
 -d "grant_type=client_credentials&client_id=ee170169-ca49-49a4-87b7-0e2ff815ea6e&client_secret=7f098199230fc5f2175d494d48f2077c" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Accept: application/json"

Sodra ons die accessToken het, voer asseblief die volgende opdrag uit om ’n aantekening by die Word-dokument in te voeg.

curl -v "https://api.aspose.cloud/v4.0/words/{inputWordFile}/comments?destFileName={resultantFile}&revisionAuthor=Nayyer%20Shahbaz" \
-X POST \
-H  "accept: application/json" \
-H  "Authorization: Bearer {accessToken}" \
-H  "Content-Type: application/json" \
-d "{  \"RangeStart\": {    \"Node\": {      \"link\": {        \"Href\":\"http://api.aspose.cloud/v4.0/words/input-sample-1.docx/sections/0/body/paragraphs/5/runs/2\",        \"Rel\": \"self\"      },      \"NodeId\": \"0.6.5.3\",\"Text\": \"dictum\",    },    \"Offset\": 0  },  \"RangeEnd\": {    \"Node\": {      \"link\": {        \"Href\": \"http://api.aspose.cloud/v4.0/words/input-sample-1.docx/sections/0/body/paragraphs/5/runs/2\",        \"Rel\": \"self\",      },      \"NodeId\": \"0.6.5.3\",\"Text\": \"dictum\",    },    \"Offset\": 0  },  \"Author\": \"Nayyer Shahbaz\",  \"Initial\": \"NS\",  \"DateTime\": \"2023-04-28T12:52:50.108Z\",  \"Text\": \"Second Revisions ....\"}"

Vervang {inputWordFile} met die naam van invoer Word-dokument (reeds beskikbaar in die Wolk-berging), {accessToken} met JWT-toegangtoken wat hierbo gegenereer is en {resultantFile} met die naam van resulterende Word-dokument wat nuwe aantekening bevat .

Afsluiting

Ten slotte kan die byvoeging van aantekeninge en opmerkings by Word-dokumente ’n nuttige kenmerk wees vir samewerkende redigering en hersiening. Met die hulp van Aspose.Words Cloud en cURL-opdragte of die Aspose.Words Cloud SDK vir .NET, kan hierdie taak doeltreffend en effektief uitgevoer word. Of jy verkies om die wolk-gebaseerde oplossing of die SDK te gebruik, Aspose.Words bied ’n kragtige en betroubare hulpmiddel om die Word-dokumente te annoteer. Ons hoop dat hierdie tutoriaal nuttig was om u deur die proses te lei en het u al die nodige besonderhede verskaf om te begin.

nuttige skakels

verwante artikels

Ons beveel sterk aan om deur die volgende blogs te gaan: