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
- Word dokumentum megjegyzés hozzáadása a C# használatával
- Megjegyzések hozzáadása a Word dokumentumhoz a cURL parancsokkal
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);
}
// 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\":\"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 ....\"}"
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: