אַנאַטייט וואָרט דאָקומענטן

לייג באַמערקונגען צו וואָרט דאָקומענטן ניצן C#. נעץ

אַנאַטייטינג אַ דאָקומענט איז אַ יקערדיק טייל פון מיטאַרבעט און קאָמוניקאַציע אין פילע ינדאַסטריז. עס אַלאַוז ניצערס צו צושטעלן באַמערקונגען, פֿירלייגן און באַמערקונגען אויף אַ דאָקומענט וואָס קענען זיין לייכט שערד מיט אנדערע. כאָטש, Microsoft Word אָפפערס עטלעכע אַנאָטאַציע מכשירים, אַזאַ ווי באַמערקונגען, שפּור ענדערונגען און אַדינג הערות, צו העלפֿן ניצערס צו צושטעלן באַמערקונגען און מיטאַרבעטן אויף אַ דאָקומענט. אָבער, אין דעם בלאָג פּאָסטן, מיר וועלן ויספאָרשן ווי צו אַנאַטייט אַ [וואָרט דאָקומענטן] (https://docs.fileformat.com/word-processing/docx/) ניצן .NET Cloud SDK, מאכן עס גרינגער פֿאַר יוזערז צו יבערגעבן און מיטאַרבעטן אויף דאָקומענטן.

REST API צו לייגן וואָרט באַמערקונגען

מיט [Aspose.Words Cloud SDK פֿאַר. די SDK גיט אַ פולשטענדיק גאַנג פון REST אַפּיס פֿאַר וואָרט דאָקומענט מאַניפּיאַליישאַן און שטיצט אַלע הויפּט דאָקומענט פֿאָרמאַטירונגען, אַרייַנגערעכנט דאָק, DOCX, RTF, ://docs.fileformat.com/word-processing/rtf/), און מער. איצט מיט די הילף פון דעם SDK, איר קענען פאַרבעסערן דיין וואָרקפלאָוו און מיטאַרבעט פּראָצעס דורך לייכט און יפישאַנטלי לייגן אַנאַטיישאַנז, באַמערקונגען און אנדערע רעצענזיע עלעמענטן צו דיין וואָרט דאָקומענטן.

אין סדר צו נוצן די SDK, זוכן Aspose.Words-Cloud אין NuGet פּאַקידזשיז פאַרוואַלטער און גיט די לייג פּאַקקאַגע קנעפּל צו לייגן די SDK רעפֿערענץ אין. נעץ פּרויעקט.

באַמערקונג: צו אַקסעס די REST API, איר דאַרפֿן צו פאַרשרייַבן און באַקומען דיין פערזענלעכע קראַדענטשאַלז. ביטע קוק אין [שנעל אָנהייב] (https://docs.aspose.cloud/words/getting-started/quickstart/) פירער פֿאַר פֿאַרבונדענע אינפֿאָרמאַציע.

לייג וואָרט דאָקומענט אַנאַטיישאַן ניצן C#

פּרוּווט ניצן די פאלגענדע קאָד סניפּאַט צו לייגן וואָרט דאָקומענט אַנאַטיישאַן ניצן .NET Cloud SDK.

// פֿאַר גאַנץ ביישפילן און דאַטן טעקעס, ביטע גיין צו 
https://github.com/aspose-words-cloud/aspose-words-cloud-dotnet

// באַקומען קליענט קראַדענטשאַלז פֿון https://dashboard.aspose.cloud/
string clientSecret = "7f098199230fc5f2175d494d48f2077c";
string clientID = "ee170169-ca49-49a4-87b7-0e2ff815ea6e";

// שאַפֿן קאַנפיגיעריישאַן כייפעץ ניצן ClinetID און Client Secret דעטאַילס
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// ינישאַלייז וואָרדסאַפּי בייַשפּיל
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// לייענען די אינהאַלט פון דער ערשטער וואָרט דאָקומענט פון היגע פאָר
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)
{
    // קיין ויסנעם בעשאַס דאָקומענט אַנאַטיישאַן פּראָצעס
    Console.Write(ex);
}
וואָרט דאָקומענט אַנאַטיישאַן פאָרויסיקע ווייַזונג

בילד: - פאָרויסיקע ווייַזונג פון וואָרט דאָקומענט אַנאַטיישאַן ניצן 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);

שאַפֿן אַן אָביעקט פון WordsApi בשעת ניצן פערזענליכען קליענט קראַדענטשאַלז.

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

לייענען די אינהאַלט פון אַרייַנשרייַב וואָרט דאָקומענט פון היגע פאָר.

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

שאַפֿן אַן אָבדזשעקט פון NodeLink דיפיינינג NodeId פֿאַר אַנאַטיישאַן. איבערחזרן דעם פּראָצעס פֿאַר ינסטאַנסיז פון CommentRangeStartNode און CommentRangeEndNode.

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

שאַפֿן אַ בייַשפּיל פון CommentInsert ווו מיר ספּעציפיצירן די דעטאַילס ווי איניציאלן, נאָמען פון מחבר און דער אינהאַלט פון באַמערקונג / אַנאָטאַציע.

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

איצט שאַפֿן אַ כייפעץ פון InsertCommentOnlineRequest, ווו מיר פאָרן די אינהאַלט פון אַרייַנשרייַב וואָרט דאָקומענט, CommentInsert כייפעץ און די נאָמען פֿאַר דער רעזולטאַט וואָרט דאָקומענט.

 var response = wordsApi.InsertCommentOnline(insertRequest);

צום סוף, רופן די InsertCommentOnline (…) אופֿן צו אַרייַנלייגן אַ באַמערקונג אין אַ וואָרט דאָקומענט אין די ספּעסאַפייד נאָדע.

די מוסטער טעקעס געניצט אין די אויבן בייַשפּיל קענען זיין דאַונלאָודיד פֿון input-sample-1.docx און Commented.docx.

לייג באַמערקונגען צו וואָרט דאָקומענט ניצן cURL קאַמאַנדז

מיר פֿאַרשטיין אַז אַדינג אַנאַטיישאַנז אָדער באַמערקונגען צו וואָרט דאָקומענטן ניצן cURL קאַמאַנדז קענען זיין זייער וווילטויק, ווייַל עס גיט אַ פּראָגראַממאַטיק וועג צו לייגן אַנאַטיישאַנז אין פאַרנעם אָדער ינייבאַלז איר צו ויסשטימען די פאַנגקשאַנאַליטי אין דיין יגזיסטינג וואָרקפלאָוז. מיט די הילף פון Aspose.Words Cloud API און CURL קאַמאַנדז, אַדינג באַמערקונגען צו אַ וואָרט דאָקומענט קענען זיין דורכגעקאָכט דורך אַ סעריע פון אַפּי קאַללס. דאָס ינוואַלווז שיקן ריקוועס צו די Aspose.Words Cloud API מיט צונעמען פּאַראַמעטערס, אַזאַ ווי די דאָקומענט טעקע, אָרט, טעקסט און מחבר אינפֿאָרמאַציע, צו שאַפֿן אַ באַמערקונג.

דער ערשטער שריט איז צו קריגן אַ “אַקסעסטאָקען” דורך שיקן אַ POST בעטן מיט דיין אַפּ SID און אַפּ שליסל דעטאַילס. ביטע ויספירן די פאלגענדע באַפֿעל:

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"

אַמאָל מיר האָבן די accessToken, ביטע ויספירן די פאלגענדע באַפֿעל צו ינסעט אַן אַנאָטאַציע צו די וואָרט דאָקומענט.

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

פאַרבייַטן {inputWordFile} מיט די נאָמען פון אַרייַנשרייַב וואָרט דאָקומענט (שוין בנימצא אין די קלאָוד סטאָרידזש), {accessToken} מיט JWT אַקסעס סימען דזשענערייטאַד אויבן און {resultantFile} מיט די נאָמען פון רעזולטאַט וואָרט דאָקומענט מיט נייַע אַנאַטיישאַן .

מסקנא

אין מסקנא, אַדינג אַנאַטיישאַנז און באַמערקונגען צו וואָרט דאָקומענטן קענען זיין אַ נוציק שטריך פֿאַר קאַלאַבערייטיוו עדיטינג און רעצענזיע. מיט די הילף פון אַספּאָסע.וואָרדס קלאָוד און קערל קאַמאַנדז אָדער די אַספּאָסע.וואָרדס קלאָוד סדק פֿאַר. נעץ, דעם אַרבעט קענען זיין אַטשיווד יפישאַנטלי און יפעקטיוולי. צי איר בעסער וועלן צו נוצן די וואָלקן-באזירט לייזונג אָדער די SDK, Aspose.Words גיט אַ שטאַרק און פאַרלאָזלעך געצייַג פֿאַר אַנאַטייטינג די וואָרט דאָקומענטן. מיר האָפן אַז דער טוטאָריאַל איז געווען נוציק צו פירן איר דורך דעם פּראָצעס און צוגעשטעלט איר מיט אַלע די נייטיק דעטאַילס צו אָנהייבן.

נוציק לינקס

שייַכות אַרטיקלען

מיר רעקאָמענדירן צו גיין דורך די פאלגענדע בלאָגס: