Pievienojiet komentārus un anotācijas Word dokumentiem, izmantojot .NET REST API

Anotējiet Word dokumentus — Pievienojiet komentārus Word dokumentiem, izmantojot C#.NET

Dokumenta anotēšana ir būtiska sadarbības un komunikācijas sastāvdaļa daudzās nozarēs. Tas ļauj lietotājiem sniegt atsauksmes, ieteikumus un komentārus par dokumentu, ko var viegli koplietot ar citiem. Lai gan Microsoft Word piedāvā vairākus anotācijas rīkus, piemēram, komentārus, izmaiņu izsekošanu un piezīmju pievienošanu, lai palīdzētu lietotājiem sniegt atsauksmes un sadarboties dokumentā. Tomēr šajā emuāra ziņojumā mēs izpētīsim, kā anotēt [Word dokumentus] (https://docs.fileformat.com/word-processing/docx/), izmantojot .NET Cloud SDK, lai lietotājiem būtu vieglāk sazināties un sadarboties ar dokumentiem.

REST API, lai pievienotu Word komentārus
Pievienojiet Word dokumenta anotāciju, izmantojot C#
Pievienojiet komentārus Word dokumentam, izmantojot cURL komandas

REST API, lai pievienotu Word komentārus

Izmantojot Aspose.Words Cloud SDK for .NET, varat viegli pievienot komentārus, atbildes un anotācijas Word dokumentam programmatiski, izmantojot C# valodu. SDK nodrošina visaptverošu REST API kopu Word dokumentu manipulācijām un atbalsta visus galvenos dokumentu formātus, tostarp DOC, DOCX, [RTF](https ://docs.fileformat.com/word-processing/rtf/) un daudz ko citu. Tagad ar šī SDK palīdzību varat uzlabot savu darbplūsmu un sadarbības procesu, vienkārši un efektīvi pievienojot saviem Word dokumentiem anotācijas, komentārus un citus pārskatīšanas elementus.

Lai izmantotu SDK, NuGet pakotņu pārvaldniekā meklējiet “Aspose.Words-Cloud” un noklikšķiniet uz pogas Pievienot pakotni, lai pievienotu SDK atsauci .NET projektā.

Piezīme: lai piekļūtu REST API, jums ir jāreģistrējas un jāiegūst savi personiskie akreditācijas dati. Lai iegūtu saistītu informāciju, lūdzu, skatiet Ātrās sākšanas rokasgrāmatu.

Pievienojiet Word dokumenta anotāciju, izmantojot C#

Lūdzu, mēģiniet izmantot šo koda fragmentu, lai pievienotu Word dokumenta anotāciju, izmantojot .NET Cloud SDK.

// Lai iegūtu pilnus piemērus un datu failus, lūdzu, dodieties uz 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// Iegūstiet klienta akreditācijas datus vietnē https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// izveidot konfigurācijas objektu, izmantojot ClinetID un Client Secret informāciju
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// inicializēt WordsApi gadījumu
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// izlasiet pirmā Word dokumenta saturu no vietējā diska
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)
{
    // jebkurš izņēmums dokumenta anotācijas procesa laikā
    Console.Write(ex);
}

Attēls: - Word dokumenta anotācijas priekšskatījums, izmantojot 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);

Izmantojot personalizētus klienta akreditācijas datus, izveidojiet WordsApi objektu.

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

Lasiet ievades Word dokumenta saturu no vietējā diska.

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

Izveidojiet NodeLink objektu, kas definē NodeId anotācijai. Atkārtojiet šo procesu CommentRangeStartNode un CommentRangeEndNode gadījumiem.

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

Izveidojiet CommentInsert gadījumu, kurā mēs norādām tādu informāciju kā iniciāļi, autora vārds un komentāra/anotācijas saturs.

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

Tagad izveidojiet InsertCommentOnlineRequest objektu, kurā mēs nododam ievades Word dokumenta saturu, CommentInsert objektu un iegūtā Word dokumenta nosaukumu.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Visbeidzot, izsauciet InsertCommentOnline(…) metodi, lai ievietotu komentāru Word dokumentā norādītajā mezglā.

Iepriekš minētajā piemērā izmantotos failu paraugus var lejupielādēt no [input-sample-1.docx] (images/input-sample-1.docx) un [Commented.docx] (images/Commented.docx).

Pievienojiet komentārus Word dokumentam, izmantojot cURL komandas

Mēs saprotam, ka anotāciju vai komentāru pievienošana Word dokumentiem, izmantojot cURL komandas, var būt ļoti izdevīga, jo tā nodrošina programmatisku veidu, kā pievienot anotācijas masveidā vai ļauj integrēt funkcionalitāti esošajās darbplūsmās. Izmantojot Aspose.Words Cloud API un cURL komandas, komentāru pievienošanu Word dokumentam var veikt, izmantojot virkni API izsaukumu. Tas ietver pieprasījumu nosūtīšanu uz Aspose.Words Cloud API ar atbilstošiem parametriem, piemēram, dokumenta failu, atrašanās vietu, tekstu un autora informāciju, lai izveidotu komentāru.

Vispirms ir jāiegūst piekļuves pilnvara, nosūtot POST pieprasījumu ar jūsu lietotnes SID un lietotnes atslēgas informāciju. Lūdzu, izpildiet šādu komandu:

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"

Kad esam ieguvuši AccessToken, lūdzu, izpildiet šo komandu, lai Word dokumentā ievietotu anotāciju.

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

Aizstāt {inputWordFile} ar ievades Word dokumenta nosaukumu (jau pieejams mākoņkrātuvē), {accessToken} ar iepriekš ģenerētu JWT piekļuves pilnvaru un {resultantFile} ar iegūtā Word dokumenta nosaukumu, kurā ir jauna anotācija. .

Secinājums

Visbeidzot, anotāciju un komentāru pievienošana Word dokumentiem var būt noderīga rediģēšanas un pārskatīšanas funkcija. Izmantojot komandas Aspose.Words Cloud un cURL vai Aspose.Words Cloud SDK, kas paredzēta .NET, šo uzdevumu var paveikt efektīvi un produktīvi. Neatkarīgi no tā, vai vēlaties izmantot mākoņa risinājumu vai SDK, Aspose.Words nodrošina jaudīgu un uzticamu rīku Word dokumentu anotēšanai. Mēs ceram, ka šī apmācība ir bijusi noderīga, palīdzot jums veikt šo procesu, un ir sniegusi visu nepieciešamo informāciju, lai sāktu.

Noderīgas saites

API atsauce

SDK avota kods

Bezmaksas produktu atbalsta forums

Saistītie raksti

Mēs ļoti iesakām apmeklēt šādus emuārus:

REST API, lai pievienotu Word komentārus#

Pievienojiet Word dokumenta anotāciju, izmantojot C##

Pievienojiet komentārus Word dokumentam, izmantojot cURL komandas#

Secinājums#

Noderīgas saites#

Saistītie raksti#