Annota Dokumenti Word

Żid Kummenti għal Dokumenti Word billi tuża C# .NET

L-annotazzjoni ta’ dokument hija parti essenzjali mill-kollaborazzjoni u l-komunikazzjoni f’ħafna industriji. Jippermetti lill-utenti jipprovdu feedback, suġġerimenti u kummenti dwar dokument li jista ‘jinqasam faċilment ma’ oħrajn. Għalkemm, Microsoft Word toffri diversi għodod ta ‘annotazzjoni, bħal kummenti, tibdiliet track, u żżid noti, biex tgħin lill-utenti jipprovdu feedback u jikkollaboraw fuq dokument. Madankollu, f’din il-post tal-blog, aħna se nesploraw kif innotaw dokumenti Word bl-użu ta’ .NET Cloud SDK, li jagħmilha aktar faċli għall-utenti biex jikkomunikaw u jikkollaboraw fuq dokumenti.

REST API biex Żid Kummenti tal-Kelma

Billi tuża Aspose.Words Cloud SDK għal .NET, tista’ faċilment iżżid kummenti, risposti u annotazzjonijiet għal dokument Word b’mod programmatiku bl-użu tal-lingwa C#. L-SDK jipprovdi sett komprensiv ta’ REST APIs għall-manipulazzjoni tad-dokumenti tal-Word u jappoġġja l-formati ewlenin kollha tad-dokumenti, inklużi DOC, DOCX, RTF. ://docs.fileformat.com/word-processing/rtf/), u aktar. Issa bl-għajnuna ta’ dan l-SDK, tista’ ttejjeb il-fluss tax-xogħol u l-proċess ta’ kollaborazzjoni tiegħek billi żżid b’mod faċli u effiċjenti annotazzjonijiet, kummenti u elementi oħra ta’ reviżjoni mad-dokumenti Word tiegħek.

Sabiex tuża l-SDK, fittex Aspose.Words-Cloud fil-maniġer tal-pakketti NuGet u kklikkja l-buttuna Żid Pakkett biex iżżid ir-referenza tal-SDK fil-proġett .NET.

Nota: biex taċċessa l-API REST, trid tirreġistra u tikseb il-kredenzjali personali tiegħek. Jekk jogħġbok agħti ħarsa lejn Quick Start gwida għal informazzjoni relatata.

Żid Annotazzjoni tad-Dokument Word billi tuża C#

Jekk jogħġbok ipprova uża s-snippet tal-kodiċi li ġej biex iżżid dokument Word Annotation billi tuża .NET Cloud SDK.

// Għal eżempji kompluti u fajls tad-dejta, jekk jogħġbok mur 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// Ikseb kredenzjali tal-klijent minn https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// toħloq oġġett ta 'konfigurazzjoni billi tuża dettalji ClinetID u Sigriet tal-Klijent
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// initialize WordsApi istanza
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// aqra l-kontenut tal-ewwel dokument Word minn drive lokali
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)
{
    // kwalunkwe Eċċezzjoni matul il-proċess ta' annotazzjoni tad-Dokument
    Console.Write(ex);
}
preview tal-annotazzjoni tad-dokument tal-kelma

Image:- Preview tal-annotazzjoni tad-dokument Word bl-użu tal-API REST.

// 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);

Oħloq oġġett ta’ WordsApi waqt li tuża kredenzjali personalizzati tal-klijent.

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

Aqra l-kontenut tad-dokument Word input minn drive lokali.

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

Oħloq oġġett ta’ NodeLink li jiddefinixxi NodeId għal Annotation. Irrepeti dan il-proċess għall-każijiet CommentRangeStartNode u CommentRangeEndNode.

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

Oħloq eżempju ta ‘CommentInsert fejn aħna nispeċifikaw id-dettalji bħall-inizjali, l-isem tal-Awtur u, il-kontenut tal-kumment/annotazzjoni.

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

Issa oħloq oġġett ta ‘InsertCommentOnlineRequest fejn ngħaddu l-kontenut tad-dokument Word input, oġġett CommentInsert u l-isem għad-dokument Word riżultanti.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Fl-aħħarnett, sejjaħ il-metodu InsertCommentOnline(…) biex daħħal kumment f’dokument Word fin-nodu speċifikat.

Il-fajls tal-kampjun użati fl-eżempju ta’ hawn fuq jistgħu jitniżżlu minn input-sample-1.docx u Commented.docx.

Żid Kummenti mad-Dokument Word billi tuża Kmandi tal-cURL

Aħna nifhmu li ż-żieda ta’ annotazzjonijiet jew kummenti ma’ dokumenti Word bl-użu ta’ kmandi cURL tista’ tkun ta’ benefiċċju kbir, peress li tipprovdi mod programmatiku biex iżżid annotazzjonijiet bl-ingrossa jew tippermettilek tintegra l-funzjonalità fil-flussi tax-xogħol eżistenti tiegħek. Bl-għajnuna ta ‘Aspose.Words Cloud API u kmandi cURL, iż-żieda ta’ kummenti ma ‘dokument Word tista’ titwettaq permezz ta ‘serje ta’ sejħiet API. Dan jinvolvi li jintbagħtu talbiet lill-API Aspose.Words Cloud b’parametri xierqa, bħall-fajl tad-dokument, il-post, it-test u l-informazzjoni tal-awtur, biex jinħoloq kumment.

L-ewwel pass huwa li tikseb ‘accessToken’ billi tibgħat talba POST bid-dettalji tal-App SID u l-App Key tiegħek. Jekk jogħġbok wettaq il-kmand li ġej:

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"

Ladarba jkollna l-accessToken, jekk jogħġbok wettaq il-kmand li ġej biex daħħal annotazzjoni fid-dokument Word.

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 ....\"}"

Ibdel {inputWordFile} bl-isem tad-dokument Word input (diġà disponibbli fil-ħażna Cloud), {accessToken} b’token ta’ aċċess JWT iġġenerat hawn fuq u {resultantFile} bl-isem tad-dokument Word riżultanti li fih Annotazzjoni ġdida .

Konklużjoni

Bħala konklużjoni, iż-żieda ta’ annotazzjonijiet u kummenti mad-dokumenti tal-Word tista’ tkun karatteristika utli għall-editjar u r-reviżjoni kollaborattivi. Bl-għajnuna tal-kmandi Aspose.Words Cloud u cURL jew l-SDK Aspose.Words Cloud għal .NET, dan il-kompitu jista ‘jitwettaq b’mod effiċjenti u effettiv. Kemm jekk tippreferi tuża s-soluzzjoni bbażata fuq il-cloud jew l-SDK, Aspose.Words jipprovdi għodda qawwija u affidabbli għall-annotazzjoni tad-dokumenti tal-Word. Nittamaw li dan it-tutorja kien ta’ għajnuna biex jiggwidak matul il-proċess u pprovdilek id-dettalji kollha meħtieġa biex tibda.

Artikoli Relatati

Nirrakkomandaw ħafna li tgħaddi mill-blogs li ġejjin: