Πώς να προσθέσετε, να διαγράψετε και να διαχειριστείτε αποτελεσματικά σχόλια χρησιμοποιώντας το .NET REST API

Στο δυναμικό πεδίο της δημιουργίας εγγράφων και της συνεργασίας, η δυνατότητα προσθήκης και διαχείρισης σχολίων στο Microsoft Word είναι απαραίτητη. Τα σχόλια χρησιμεύουν ως εικονικός πίνακας συζητήσεων, επιτρέποντας στους συνεργάτες να ανταλλάσσουν σκέψεις, να προτείνουν βελτιώσεις και να παρέχουν σχόλια χωρίς να αλλάζουν το αρχικό περιεχόμενο. Αυτή η δυνατότητα όχι μόνο διευκολύνει την αποτελεσματική επικοινωνία, αλλά επίσης ενισχύει τη διαδικασία συλλογικής επεξεργασίας, καθιστώντας την πιο βελτιωμένη και αποτελεσματική. Επομένως, σε αυτόν τον οδηγό, θα εμβαθύνουμε στις βασικές πτυχές της προσθήκης και της διαγραφής σχολίων, αποκαλύπτοντας τις δυνατότητες και τα οφέλη αυτής της ζωτικής σημασίας λειτουργίας στο MS Word χρησιμοποιώντας το .NET REST API.

Διαχειριστείτε τα σχόλια χρησιμοποιώντας το .NET REST API
Λάβετε σχόλια από τα αρχεία DOCX
Εισαγάγετε σχόλια στο έγγραφο του Word
Ενημέρωση σχολίων στο αρχείο Word
Διαγραφή σχολίων από το έγγραφο του Word

Διαχείριση σχολίων χρησιμοποιώντας το .NET REST API

Ο χειρισμός και η προσθήκη σχολίων χρησιμοποιώντας το Aspose.Words Cloud SDK για .NET αποφέρει πληθώρα πλεονεκτημάτων και ένα ευρύ φάσμα δυνατοτήτων πέρα από τη διαχείριση σχολίων. Εκτός από αυτό, το SDK προσφέρει επίσης ένα ευρύ φάσμα δυνατοτήτων, όπως δημιουργία εγγράφων Word, μετατροπή Word σε JPG, Word σε PDF, Word σε ODT κ.λπ., επεξεργασία κειμένου και μορφοποίησης, επεξεργασία εικόνας και ένα ευρύ φάσμα λειτουργιών, επιτρέποντάς σας να βελτιώσετε τις δυνατότητες επεξεργασίας εγγράφων σας για μια σειρά από σενάρια.

Λάβετε σχόλια από τα αρχεία DOCX

Μπορείτε να αξιοποιήσετε την ανάγνωση όλων ή συγκεκριμένων σχολίων από το έγγραφο. Η μέθοδος GetComments παρέχει τις δυνατότητες ανάγνωσης των σχολίων των χρηστών από το αρχείο DOCX. Παρακάτω καθορίζεται μια εντολή cURL την οποία μπορείτε να χρησιμοποιήσετε για να διαβάσετε τα σχόλια στη γραμμή εντολών.

εντολή cURL

Λάβετε υπόψη ότι για να διαβάσετε σχόλια, πρέπει να παρέχετε τις λεπτομέρειες σχετικά με τα έγγραφα που είναι αποθηκευμένα στο χώρο αποθήκευσης στο cloud, καθώς και μόνο εξουσιοδοτημένοι χρήστες που λαμβάνουν τα δικαιώματα πρόσβασης στα API. Επομένως, πρέπει πρώτα να ανακτήσετε το διακριτικό ελέγχου ταυτότητας JWT και να το χρησιμοποιήσετε στην εντολή όπως αναφέρθηκε παραπάνω.

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"

Μόλις δημιουργηθεί το διακριτικό JWT, εκτελέστε την ακόλουθη εντολή για να λάβετε όλα τα σχόλια στο έγγραφο του word.

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

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

C#.NET

Για να διαβάσετε ένα συγκεκριμένο σχόλιο από το έγγραφο, ακολουθήστε τα βήματα που καθορίζονται παρακάτω:

Αρχικοποιήστε μια παρουσία της κλάσης WordsApi.
Δημιουργήστε ένα αντικείμενο της κλάσης GetCommentRequest όπου παρέχουμε το όνομα αρχείου εισόδου Volume 1.docx και την τιμή του ευρετηρίου σχολίου ως ορίσματα εισόδου.
Τέλος, αρχικοποιήστε ένα αντικείμενο του CommentResponse μεταβιβάζοντας την τιμή που επιστράφηκε από τη μέθοδο GetComment(..).

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/

// αρχικοποίηση και αντικείμενο του WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// όνομα αρχείου εισαγωγής
String filename= "Volume 1.docx";
// ευρετήριο σχολίων
int commentIndex = 0;
// create an object of GetCommentRequest where we pass όνομα αρχείου εισαγωγής 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);
// δημιουργήστε μια παρουσία του CommentResponse και διαβάστε το σχόλιο από το έγγραφο
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.GetComment(request);
// εμφάνιση του σχολίου στην κονσόλα
Console.Write(response.Comment);

Λάβετε όλα τα σχόλια

Το API προσφέρει επίσης τη δυνατότητα λήψης όλων των σχολίων από το έγγραφο (σε περίπτωση που δεν θέλουμε να διασχίσουμε άτομα).Για αυτήν την απαίτηση, πρέπει να δημιουργήσετε μια παρουσία κλάσεων GetCommentsRequest, CommentsResponse και να καλέσετε τη μέθοδο GetComments(..) του αντικειμένου WordsApi.

Εισαγάγετε σχόλια στο έγγραφο του Word

Το API έχει επίσης τη δυνατότητα προσθήκης/εισαγωγής νέων αντικειμένων σχολίων σε ένα έγγραφο του Word.

εντολή cURL

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/

// αρχικοποίηση και αντικείμενο του WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// όνομα αρχείου εισαγωγής
String filename = "Volume 1.docx";
// ευρετήριο σχολίων
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 όνομα αρχείου εισαγωγής 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);
// δημιουργήστε μια παρουσία του CommentResponse και διαβάστε το σχόλιο από το έγγραφο
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.InsertComment(request);

Εισαγωγή προεπισκόπησης σχολίων. — Εικόνα 1: - προεπισκόπηση του σχολίου που εισήχθη πρόσφατα

Ενημέρωση σχολίων στο αρχείο Word

Εκτός από την ανάλυση και την προσθήκη σχολίων, το API υποστηρίζει επίσης τη δυνατότητα ενημέρωσης των υπαρχόντων σχολίων μέσα στο έγγραφο του Word.

εντολή cURL

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

Για να ενημερώσετε μέσω προγραμματισμού τα σχόλια στο έγγραφο του Word, ακολουθήστε τις οδηγίες που καθορίζονται παρακάτω.

Δημιουργήστε μια παρουσία της κλάσης WordsApi.
Δημιουργήστε ένα αντικείμενο του NodeLink που ορίζει το σχόλιο NodeID.
Δημιουργείται ένα νέο αντικείμενο της κλάσης DocumentPosition που ορίζει τις τιμές RangeStart και RangeEnd.
Δημιουργήστε ένα αντικείμενο του CommentUpdate το οποίο ορίζει, σχολιάζει Αρχικά, Όνομα συγγραφέα, λεπτομέρειες RangeStart & RangeEnd εκχωρώντας την τιμή παρουσίας DocumentPosition και το κείμενο που θα ενημερωθεί στο σχόλιο.

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/

// αρχικοποίηση και αντικείμενο του WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// όνομα αρχείου εισαγωγής
String filename = "Volume 1.docx";
// ευρετήριο σχολίων
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 όνομα αρχείου εισαγωγής 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);
// δημιουργήστε μια παρουσία του CommentResponse και διαβάστε το σχόλιο από το έγγραφο
Aspose.Words.Cloud.Sdk.Model.CommentResponse response = wordsApi.UpdateComment(request);

Ενημέρωση προεπισκόπησης σχολίων — Εικόνα 2: - προεπισκόπηση ενημερωμένων σχολίων

Το έγγραφο που προκύπτει Τόμος 1 - updated.docx επισυνάπτεται επίσης.

Διαγραφή σχολίων από το έγγραφο του Word

Μπορείτε επίσης να αφαιρέσετε/διαγράψετε τα σχόλια από το αρχείο word χρησιμοποιώντας το REST cloud API.

εντολή cURL

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

C#.NET

Δημιουργήστε ένα αντικείμενο κλάσης WordsApi.
Δημιουργήστε μια παρουσία της κλάσης DeleteCommentRequest που λαμβάνει ένα αρχείο εισόδου και ένα ευρετήριο σχολίου ως όρισμα.
Τέλος, η μέθοδος DeleteComment(…) που έχει ως όρισμα το αντικείμενο DeleteCommentRequest.

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/

// αρχικοποίηση και αντικείμενο του WordsApi
Aspose.Words.Cloud.Sdk.WordsApi wordsApi = new Aspose.Words.Cloud.Sdk.WordsApi(clientID, clientSecret);

// όνομα αρχείου εισαγωγής
String filename = "Volume 1.docx";
// ευρετήριο σχολίων
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);

Προεπισκόπηση διαγραμμένων σχολίων — Εικόνα 3: - προεπισκόπηση των διαγραμμένων σχολίων

Διαχείριση σχολίων χρησιμοποιώντας το .NET REST API#

Λάβετε σχόλια από τα αρχεία DOCX#

εντολή cURL#

C#.NET#

Εισαγάγετε σχόλια στο έγγραφο του Word#

εντολή cURL#

C#.NET#

Ενημέρωση σχολίων στο αρχείο Word#

εντολή cURL#

C#.NET#

Διαγραφή σχολίων από το έγγραφο του Word#

εντολή cURL#

C#.NET#

Διαχείριση σχολίων χρησιμοποιώντας το .NET REST API

Λάβετε σχόλια από τα αρχεία DOCX

εντολή cURL

C#.NET

Εισαγάγετε σχόλια στο έγγραφο του Word

εντολή cURL

C#.NET

Ενημέρωση σχολίων στο αρχείο Word

εντολή cURL

C#.NET

Διαγραφή σχολίων από το έγγραφο του Word

εντολή cURL

C#.NET