Annoteer Word-documenten

Voeg opmerkingen toe aan Word-documenten met C# .NET

Het annoteren van een document is in veel branches een essentieel onderdeel van samenwerking en communicatie. Hiermee kunnen gebruikers feedback, suggesties en opmerkingen over een document geven die gemakkelijk met anderen kunnen worden gedeeld. Hoewel Microsoft Word verschillende annotatietools biedt, zoals opmerkingen, wijzigingen bijhouden en notities toevoegen, om gebruikers te helpen feedback te geven en samen te werken aan een document. In dit blogbericht zullen we echter onderzoeken hoe u een Word-document kunt annoteren met behulp van .NET Cloud SDK, waardoor het voor gebruikers gemakkelijker wordt om te communiceren en samenwerken aan documenten.

REST API om woordopmerkingen toe te voegen

Met behulp van Aspose.Words Cloud SDK voor .NET, kunt u eenvoudig programmatisch opmerkingen, antwoorden en annotaties toevoegen aan een Word-document met behulp van C#-taal. De SDK biedt een uitgebreide set REST API’s voor het manipuleren van Word-documenten en ondersteunt alle belangrijke documentindelingen, waaronder DOC, DOCX, [RTF](https //docs.fileformat.com/word-processing/rtf/), en meer. Nu kunt u met behulp van deze SDK uw workflow en samenwerkingsproces verbeteren door eenvoudig en efficiënt annotaties, opmerkingen en andere revisie-elementen aan uw Word-documenten toe te voegen.

Om de SDK te gebruiken, zoekt u naar Aspose.Words-Cloud in NuGet-pakkettenbeheer en klikt u op de knop Pakket toevoegen om de SDK-referentie toe te voegen aan het .NET-project.

Opmerking: om toegang te krijgen tot de REST API, moet u zich registreren en uw persoonlijke inloggegevens ontvangen. Bekijk de Quick Start gids voor gerelateerde informatie.

Annotatie van Word-documenten toevoegen met C#

Probeer het volgende codefragment te gebruiken om Word-documentannotatie toe te voegen met behulp van .NET Cloud SDK.

// Ga voor volledige voorbeelden en databestanden naar 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

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

// maak een configuratieobject met behulp van ClinetID en Client Secret-details
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// initialiseer de WordsApi-instantie
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// lees de inhoud van het eerste Word-document van de lokale schijf
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)
{
    // elke uitzondering tijdens het documentannotatieproces
    Console.Write(ex);
}
annotatievoorbeeld van word-document

Afbeelding: - Voorbeeld van annotatie van Word-documenten 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);

Maak een object van WordsApi terwijl u gepersonaliseerde klantreferenties gebruikt.

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

Lees de inhoud van het ingevoerde Word-document van de lokale schijf.

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

Maak een object van NodeLink dat NodeId definieert voor annotatie. Herhaal dit proces voor de instanties CommentRangeStartNode en CommentRangeEndNode.

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

Maak een instantie van CommentInsert waar we de details specificeren zoals initialen, naam van de auteur en de inhoud van commentaar/annotatie.

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

Maak nu een object van InsertCommentOnlineRequest waar we de inhoud van het invoer-Word-document, het CommentInsert-object en de naam voor het resulterende Word-document doorgeven.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Roep ten slotte de methode InsertCommentOnline(…) aan om een opmerking in een Word-document in te voegen op het opgegeven knooppunt.

De voorbeeldbestanden die in het bovenstaande voorbeeld worden gebruikt, kunnen worden gedownload van input-sample-1.docx en Commented.docx.

Voeg opmerkingen toe aan Word-document met behulp van cURL-opdrachten

We begrijpen dat het toevoegen van annotaties of opmerkingen aan Word-documenten met behulp van cURL-opdrachten zeer nuttig kan zijn, omdat het een programmatische manier biedt om annotaties in bulk toe te voegen of u in staat stelt de functionaliteit te integreren in uw bestaande workflows. Met behulp van Aspose.Words Cloud API en cURL-opdrachten kan het toevoegen van opmerkingen aan een Word-document worden bereikt door middel van een reeks API-aanroepen. Dit omvat het verzenden van verzoeken naar de Aspose.Words Cloud API met de juiste parameters, zoals het documentbestand, de locatie, tekst en auteursinformatie, om een opmerking te maken.

De eerste stap is het verkrijgen van een ‘accessToken’ door een POST-verzoek te verzenden met uw App SID en App Key-gegevens. Voer de volgende opdracht 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"

Zodra we het accessToken hebben, voert u de volgende opdracht uit om een annotatie in het Word-document in te voegen.

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} door de naam van het ingevoerde Word-document (al beschikbaar in de cloudopslag), {accessToken} door JWT-toegangstoken dat hierboven is gegenereerd en {resultantFile} door de naam van het resulterende Word-document met nieuwe annotatie .

Conclusie

Concluderend kan het toevoegen van annotaties en opmerkingen aan Word-documenten een handige functie zijn voor gezamenlijke bewerking en beoordeling. Met behulp van Aspose.Words Cloud- en cURL-opdrachten of de Aspose.Words Cloud SDK voor .NET kan deze taak efficiënt en effectief worden uitgevoerd. Of u nu liever de cloudgebaseerde oplossing of de SDK gebruikt, Aspose.Words biedt een krachtige en betrouwbare tool voor het annoteren van Word-documenten. We hopen dat deze tutorial nuttig is geweest om u door het proces te leiden en u alle benodigde details heeft gegeven om aan de slag te gaan.

gerelateerde artikelen

We raden ten zeerste aan om de volgende blogs door te nemen: