Írjon megjegyzéseket a Word-dokumentumokhoz

Megjegyzések hozzáadása a Word dokumentumokhoz a C# .NET használatával

A dokumentumok kommentálása számos iparágban elengedhetetlen része az együttműködésnek és a kommunikációnak. Lehetővé teszi a felhasználók számára, hogy visszajelzéseket, javaslatokat és megjegyzéseket adjanak egy dokumentumhoz, amelyet könnyen megoszthatnak másokkal. Bár a Microsoft Word számos jegyzetkészítő eszközt kínál, például megjegyzéseket, változások nyomon követését és megjegyzések hozzáadását, hogy segítse a felhasználókat visszajelzésben és a dokumentumokon való együttműködésben. Ebben a blogbejegyzésben azonban megvizsgáljuk, hogyan lehet megjegyzéseket fűzni Word-dokumentumokhoz .NET Cloud SDK használatával, megkönnyítve a felhasználók kommunikációját és kommunikációját. együttműködni a dokumentumokon.

REST API Word-megjegyzések hozzáadásához

Az [Aspose.Words Cloud SDK for .NET] (https://products.aspose.cloud/words/net/) használatával egyszerűen, programozottan, C# nyelven fűzhet megjegyzéseket, válaszokat és megjegyzéseket egy Word-dokumentumhoz. Az SDK a REST API-k átfogó készletét kínálja a Word-dokumentumkezeléshez, és támogatja az összes főbb dokumentumformátumot, beleértve a DOC, a DOCX, az RTF ://docs.fileformat.com/word-processing/rtf/), és így tovább. Most ennek az SDK-nak a segítségével javíthatja munkafolyamatait és együttműködési folyamatait, mivel egyszerűen és hatékonyan ad hozzá megjegyzéseket, megjegyzéseket és egyéb felülvizsgálati elemeket Word-dokumentumaihoz.

Az SDK használatához keressen az “Aspose.Words-Cloud” kifejezésre a NuGet csomagkezelőben, és kattintson a Csomag hozzáadása gombra az SDK hivatkozás hozzáadásához a .NET projektben.

Megjegyzés: a REST API eléréséhez regisztrálnia kell, és meg kell szereznie személyes hitelesítő adatait. Kérjük, tekintse meg a Quick Start útmutatót a kapcsolódó információkért.

Word dokumentum megjegyzés hozzáadása a C# használatával

Kérjük, próbálja meg a következő kódrészletet használni a Word-dokumentum megjegyzés hozzáadásához a .NET Cloud SDK használatával.

// A teljes példákért és adatfájlokért látogasson el ide 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// Szerezze be az ügyfél hitelesítő adatait a https://dashboard.aspose.cloud/ webhelyről
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// hozzon létre konfigurációs objektumot a ClinetID és a Client Secret részleteivel
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// inicializálja a WordsApi példányt
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// olvassa el az első Word-dokumentum tartalmát a helyi meghajtóról
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)
{
    // minden kivétel a dokumentum megjegyzések készítése során
    Console.Write(ex);
}
Word dokumentum annotáció előnézete

Kép: - A Word-dokumentum annotációjának előnézete a REST API használatával.

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

Hozzon létre egy WordsApi objektumot személyre szabott ügyfél-hitelesítő adatok használatával.

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

Olvassa be a bemeneti Word dokumentum tartalmát a helyi meghajtóról.

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

Hozzon létre egy NodeLink objektumot, amely meghatározza a NodeId for Annotation azonosítót. Ismételje meg ezt a folyamatot a CommentRangeStartNode és CommentRangeEndNode példányoknál.

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

Hozzon létre egy CommentInsert példányt, ahol megadjuk a részleteket, például a kezdőbetűket, a szerző nevét és a megjegyzés/annotáció tartalmát.

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

Most hozzon létre egy InsertCommentOnlineRequest objektumot, ahol átadjuk a bemeneti Word dokumentum tartalmát, a CommentInsert objektumot és az eredményül kapott Word dokumentum nevét.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Végül hívja meg az InsertCommentOnline(…) metódust, hogy megjegyzést szúrjon be egy Word dokumentumba a megadott csomóponton.

A fenti példában használt mintafájlok letölthetők az input-sample-1.docx és a Commented.docx oldalról.

Megjegyzések hozzáadása a Word dokumentumhoz a cURL parancsokkal

Tisztában vagyunk vele, hogy megjegyzések vagy megjegyzések hozzáadása a Word-dokumentumokhoz cURL-parancsok segítségével rendkívül előnyös lehet, mivel ez programozott módot biztosít a kommentárok tömeges hozzáadására, vagy lehetővé teszi a funkciók integrálását a meglévő munkafolyamatokba. Az Aspose.Words Cloud API és a cURL parancsok segítségével egy sor API-híváson keresztül megjegyzéseket fűzhet a Word-dokumentumokhoz. Ez magában foglalja a kérések elküldését az Aspose.Words Cloud API-nak megfelelő paraméterekkel, például a dokumentumfájllal, a hellyel, a szöveggel és a szerzői adatokkal, hogy megjegyzést hozzon létre.

Az első lépés az “accessToken” beszerzése egy POST-kérés elküldésével az alkalmazás SID-je és az alkalmazáskulcs adataival. Kérjük, hajtsa végre a következő parancsot:

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"

Ha megvan az accessToken, kérjük, hajtsa végre a következő parancsot, hogy megjegyzést illesszen be a Word dokumentumba.

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

Cserélje ki az {inputWordFile} szót a bemeneti Word-dokumentum nevére (már elérhető a felhőtárolóban), az {accessToken}'-t a fent generált JWT-hozzáférési tokenre, a {resultantFile}`-t pedig az eredményül kapott Word-dokumentum nevére, amely új megjegyzést tartalmaz. .

Következtetés

Összefoglalva, a megjegyzések és megjegyzések hozzáadása a Word-dokumentumokhoz hasznos funkció lehet a közös szerkesztéshez és áttekintéshez. Az Aspose.Words Cloud és a cURL parancsok vagy az Aspose.Words Cloud SDK for .NET segítségével ezt a feladatot hatékonyan és eredményesen lehet végrehajtani. Akár a felhőalapú megoldást, akár az SDK-t részesíti előnyben, az Aspose.Words hatékony és megbízható eszközt biztosít a Word-dokumentumok megjegyzéseinek rögzítéséhez. Reméljük, hogy ez az oktatóanyag hasznos volt a folyamaton keresztül, és minden szükséges részletet biztosított a kezdéshez.

Hasznos Linkek

kapcsolódó cikkek

Javasoljuk, hogy olvassa el az alábbi blogokat: