Megjegyzések hozzáadása, törlése és hatékony kezelése a .NET REST API használatával

A dokumentumkészítés és együttműködés dinamikus területén nélkülözhetetlen a megjegyzések hozzáadásának és kezelésének lehetősége a Microsoft Word programban. A megjegyzések virtuális vitafórumként szolgálnak, lehetővé téve az együttműködőknek, hogy gondolataikat cseréljék, fejlesztéseket javasoljanak, és visszajelzést adjanak az eredeti tartalom megváltoztatása nélkül. Ez a funkció nem csak a hatékony kommunikációt segíti elő, hanem javítja az együttműködésen alapuló szerkesztési folyamatot is, és egyszerűbbé és hatékonyabbá teszi azt. Ezért ebben az útmutatóban elmélyülünk a megjegyzések hozzáadásának és törlésének alapvető szempontjaiban, bemutatva az MS Word e létfontosságú funkciójának lehetőségeit és előnyeit a .NET REST API használatával.

A megjegyzések kezelése a .NET REST API használatával
Hozzászólások a DOCX Files szolgáltatásból
Megjegyzések beszúrása a Word dokumentumba
Frissítse a megjegyzéseket a Word-fájlban
Megjegyzések törlése a Word dokumentumból

Megjegyzések kezelése .NET REST API-val

A megjegyzések manipulálása és hozzáadása az Aspose.Words Cloud SDK for .NET használatával a megjegyzéskezelésen túl számos előnyt és lehetőségek széles skáláját kínálja. Ezen túlmenően az SDK a lehetőségek széles skáláját kínálja, beleértve a Word-dokumentumgenerálást, a Word-ből JPG-be, a Word-ből PDF-be, a Word-ből ODT-be stb. konvertálást, a szöveg- és formázási manipulációt, a képfeldolgozást és a funkciók széles skáláját, amelyek lehetővé teszik dokumentumfeldolgozási képességeinek bővítését egy sor forgatókönyv esetén.

Hozzászólások a DOCX Files szolgáltatásból

Használhatja a dokumentum összes vagy egyes megjegyzéseinek elolvasását. A GetComments metódus lehetővé teszi a felhasználói megjegyzések DOCX fájlból történő olvasását. Az alábbiakban megadunk egy cURL parancsot, amellyel elolvashatja a parancssor megjegyzéseit.

cURL parancsot

Felhívjuk figyelmét, hogy a megjegyzések olvasásához meg kell adnia a felhőalapú tárhelyen tárolt dokumentumok részleteit, valamint csak az arra jogosult felhasználóknak kell megszerezniük az API-khoz való hozzáférési engedélyeket. Ezért először le kell kérnie a JWT hitelesítési tokent, és a fent említett parancsban használnia kell.

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=xxxxxxx-1c8e-4ea4-a948-3857547232fa&client_secret=xxxxxx" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accpet: application/json"

A JWT token létrehozása után hajtsa végre a következő parancsot, hogy megkapja az összes megjegyzést a Word dokumentumban.

curl -v "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments" \
-X GET \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>"

URL kérése

https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments

C#.NET

A dokumentum egy adott megjegyzésének elolvasásához kövesse az alábbi lépéseket:

Inicializálja a WordsApi osztály egy példányát.
Hozzon létre egy objektumot a GetCommentRequest osztályból, ahol a bemeneti Volume 1.docx fájl nevét és a megjegyzés index értékét adjuk meg bemeneti argumentumként.
Végül inicializálja a CommentResponse objektumát, miközben átadja a GetComment(..) metódusból visszaadott értéket.

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// a WordsApi inicializálása és tárgya
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// beviteli fájlnév
String filename= "Volume 1.docx";
// megjegyzés indexe
int commentIndex = 0;
// create an object of GetCommentRequest where we pass beviteli fájlnév and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.GetCommentRequest request = new Aspose.Words.Cloud.Sdk.Model.Requests.GetCommentRequest(filename, commentIndex, null, null, null, null);
// hozzon létre egy CommentResponse példányt, és olvassa el a megjegyzést a dokumentumból
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// jelenítse meg a megjegyzést a konzolon
Console.Write(response.Comment);

Az összes megjegyzés megszerzése

Az API azt a funkciót is kínálja, hogy az összes megjegyzést megkapja a dokumentumból (ha nem akarunk áthaladni az egyének között).Ehhez a követelményhez létre kell hoznia a GetCommentsRequest, a CommentsResponse osztályok egy példányát, és meghívnia kell a WordsApi objektum GetComments(..) metódusát.

Megjegyzések beszúrása a Word dokumentumba

Az API képes új megjegyzésobjektumok hozzáadására/beszúrására egy Word dokumentumba.

cURL parancsot

curl -v "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments" \
-X POST \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"RangeStart\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 2\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"RangeEnd\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/5/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 2\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"Author\":\"Nayyer Shahbaz\",\"Initial\":\"MOU\",\"DateTime\":\"2020-12-07T04:10:03.942Z\",\"Text\":\"Comments Inserted using Aspose.Words Cloud API\"}"

C#.NET

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// a WordsApi inicializálása és tárgya
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// bemeneti fájlnév
String filename = "Volume 1.docx";
// megjegyzés indexe
int commentIndex = 0;

Aspose.Words.Cloud.Sdk.Model.NodeLink link = new Aspose.Words.Cloud.Sdk.Model.NodeLink()
{
    NodeId = "0.1.0.1.1.1.1"
};
Aspose.Words.Cloud.Sdk.Model.DocumentPosition documentPosition = new Aspose.Words.Cloud.Sdk.Model.DocumentPosition()
{
    Node = link,
    Offset = 0
};
Aspose.Words.Cloud.Sdk.Model.CommentInsert commentInsert = new Aspose.Words.Cloud.Sdk.Model.CommentInsert()
{
    Initial = "Aspose",
    Author = "Nayyer Shahbaz",
    RangeStart = documentPosition,
    RangeEnd = documentPosition,
    Text = "Comment added through API"
};


// create an object of GetCommentRequest where we pass bemeneti fájlnév and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.InsertCommentRequest request = 
  new Aspose.Words.Cloud.Sdk.Model.Requests.InsertCommentRequest(filename, commentInsert, null, null, null);
// hozzon létre egy CommentResponse példányt, és olvassa el a megjegyzést a dokumentumból
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);

Megjegyzések előnézetének beszúrása. — kép: - az újonnan beillesztett megjegyzés előnézete

Frissítse a megjegyzéseket a Word-fájlban

A megjegyzések elemzése és hozzáadása mellett az API támogatja a Word dokumentumon belüli megjegyzések frissítésének funkcióját is.

cURL parancsot

curl -X PUT "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments/1" \
-H "accept: application/json" \
-H "Authorization: Bearer <JWT Token>" \
-H "Content-Type: application/json" \
-d "{\"RangeStart\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"self\",\"Type\":\"string\",\"Title\":\"Heading 1\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"RangeEnd\":{\"Node\":{\"link\":{\"Href\":\"https://api.aspose.cloud/v4.0/words/Volume 1.docx/sections/0/body/tables/0/rows/1/cells/1/paragraphs/1/runs/0\",\"Rel\":\"string\",\"Type\":\"string\",\"Title\":\"Heading 1\"},\"NodeId\":\"0.1.0.1.1.1.1\"},\"Offset\":0},\"Author\":\"Nayyer Shahbaz\",\"Initial\":\"Aspose.Words\",\"DateTime\":\"2020-12-07T06:18:31.348Z\",\"Text\":\"Comments updated using Aspose.Words Cloud API\"}"

C#.NET

A Word-dokumentum megjegyzéseinek programozott frissítéséhez kövesse az alábbi utasításokat.

Hozzon létre egy WordsApi osztály példányt.
Hozzon létre egy NodeLink objektumot, amely meghatározza a megjegyzés NodeID-t.
Létrejön a DocumentPosition osztály új objektuma, amely meghatározza a RangeStart és a RangeEnd értékeket.
Hozzon létre egy CommentUpdate objektumot, amely meghatározza a megjegyzés kezdőbetűit, a szerző nevét, a RangeStart és a RangeEnd részleteit a DocumentPosition példányérték és a megjegyzésben frissítendő szöveg hozzárendelésével.

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// a WordsApi inicializálása és tárgya
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// bemeneti fájlnév
String filename = "Volume 1.docx";
// megjegyzés indexe
int commentIndex = 1;

Aspose.Words.Cloud.Sdk.Model.NodeLink link = new Aspose.Words.Cloud.Sdk.Model.NodeLink()
{
    NodeId = "0.1.0.1.1.1.1"
};
Aspose.Words.Cloud.Sdk.Model.DocumentPosition documentPosition = new Aspose.Words.Cloud.Sdk.Model.DocumentPosition()
{
    Node = link,
    Offset = 0
};
Aspose.Words.Cloud.Sdk.Model.CommentUpdate commentUpdate = new Aspose.Words.Cloud.Sdk.Model.CommentUpdate()
{
    Initial = "Aspose",
    Author = "Nayyer Shahbaz",
    RangeStart = documentPosition,
    RangeEnd = documentPosition,
    Text = "Comments updated using Aspose.Words Cloud API"
};

// create an object of GetCommentRequest where we pass bemeneti fájlnév and comment index value
Aspose.Words.Cloud.Sdk.Model.Requests.UpdateCommentRequest request =
                    new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateCommentRequest(filename, commentIndex, commentUpdate, null, null, null);
// hozzon létre egy CommentResponse példányt, és olvassa el a megjegyzést a dokumentumból
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);

Frissítse a megjegyzések előnézetét — kép: - a frissített megjegyzések előnézete

Az eredményül kapott dokumentum 1. kötet - updated.docx szintén mellékelve.

Megjegyzések törlése a Word dokumentumból

A REST felhő API használatával is eltávolíthatja/törölheti a megjegyzéseket a szófájlból.

cURL parancsot

curl -X DELETE "https://api.aspose.cloud/v4.0/words/Volume%201.docx/comments/0" \
-H "accept: /" \
-H "Authorization: Bearer <JWT Token>"

C#.NET

Hozzon létre egy WordsApi osztály objektumot.
Hozzon létre egy példányt a DeleteCommentRequest osztályból, amely argumentumként egy bemeneti fájlt és egy megjegyzés indexet vesz fel.
Végül a DeleteComment(…) metódus, amelynek argumentuma a DeleteCommentRequest objektum.

const string clientID = "xxxxxxxxx";   // Get AppKey and AppSID from https://dashboard.aspose.cloud/
const string clientSecret = "xxxxxxxx";    // Get AppKey and AppSID from https://dashboard.aspose.cloud/

// a WordsApi inicializálása és tárgya
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// bemeneti fájlnév
String filename = "Volume 1.docx";
// megjegyzés indexe
int commentIndex = 0;


Aspose.Words.Cloud.Sdk.Model.Requests.DeleteCommentRequest request = 
  new Aspose.Words.Cloud.Sdk.Model.Requests.DeleteCommentRequest(filename, commentIndex, null, null, null, null, null, null, null);
wordsApi.DeleteComment(request);

A törölt megjegyzések előnézete — kép: - a törölt megjegyzések előnézete

Megjegyzések kezelése .NET REST API-val#

Hozzászólások a DOCX Files szolgáltatásból#

cURL parancsot#

C#.NET#

Megjegyzések beszúrása a Word dokumentumba#

cURL parancsot#

C#.NET#

Frissítse a megjegyzéseket a Word-fájlban#

cURL parancsot#

C#.NET#

Megjegyzések törlése a Word dokumentumból#

cURL parancsot#

C#.NET#

Megjegyzések kezelése .NET REST API-val

Hozzászólások a DOCX Files szolgáltatásból

cURL parancsot

C#.NET

Megjegyzések beszúrása a Word dokumentumba

cURL parancsot

C#.NET

Frissítse a megjegyzéseket a Word-fájlban

cURL parancsot

C#.NET

Megjegyzések törlése a Word dokumentumból

cURL parancsot

C#.NET