Ба ҳуҷҷатҳои Word эзоҳ диҳед

Бо истифода аз C# .NET шарҳҳоро ба ҳуҷҷатҳои Word илова кунед

Тавсифи ҳуҷҷат як ҷузъи муҳими ҳамкорӣ ва иртибот дар бисёр соҳаҳо мебошад. Он ба корбарон имкон медиҳад, ки дар бораи ҳуҷҷате, ки ба осонӣ бо дигарон мубодила карда шавад, фикру мулоҳизаҳо, пешниҳодҳо ва шарҳҳо пешниҳод кунанд. Бо вуҷуди ин, Microsoft Word якчанд асбобҳои эзоҳро пешниҳод мекунад, ба монанди шарҳҳо, тағиротро пайгирӣ ва илова кардани қайдҳо, то ба корбарон дар пешниҳоди фикру мулоҳизаҳо ва ҳамкорӣ дар ҳуҷҷат кӯмак расонанд. Аммо, дар ин пости блог, мо меомӯзем, ки чӣ тавр ба [ҳуҷҷатҳои Word] (https://docs.fileformat.com/word-processing/docx/) бо истифода аз .NET Cloud SDK тавзеҳот илова кунем, ки муоширати корбаронро осонтар ва дар ҳуҷҷатҳо ҳамкорӣ кунед.

REST API барои илова кардани шарҳҳои калима

Бо истифода аз Aspose.Words Cloud SDK for .NET, шумо метавонед ба осонӣ шарҳҳо, ҷавобҳо ва эзоҳҳоро ба ҳуҷҷати Word ба таври барномавӣ бо истифода аз забони C# илова кунед. SDK маҷмӯи ҳамаҷонибаи REST API-ро барои коркарди ҳуҷҷатҳои Word таъмин мекунад ва ҳама форматҳои асосии ҳуҷҷатро дастгирӣ мекунад, аз ҷумла DOC, DOCX, RTF. ://docs.fileformat.com/word-processing/rtf/) ва ғайра. Акнун бо ёрии ин SDK, шумо метавонед ҷараёни кор ва раванди ҳамкориҳои худро тавассути ба осонӣ ва самаранок илова кардани эзоҳҳо, шарҳҳо ва дигар унсурҳои барраси ба ҳуҷҷатҳои Word такмил диҳед.

Барои истифодаи SDK, дар менеҷери бастаҳои NuGet Aspose.Words-Cloud-ро ҷустуҷӯ кунед ва тугмаи Иловаи бастаро пахш кунед, то истинод ба SDK-ро дар лоиҳаи .NET илова кунед.

Эзоҳ: Барои дастрасӣ ба REST API, шумо бояд сабти ном кунед ва маълумоти шахсии худро гиред. Лутфан, дастури Оғози зуд-ро барои маълумоти дахлдор аз назар гузаронед.

Илова кардани шарҳи ҳуҷҷати Word бо истифода аз C#

Лутфан пораи коди зеринро барои илова кардани Annotation ҳуҷҷати Word бо истифода аз .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 };
// мисоли WordsApi-ро оғоз кунед
var wordsApi = new WordsApi(config);

string firstDocument = "input-sample-1.docx";
// мундариҷаи аввалин ҳуҷҷати Wordро аз диски маҳаллӣ хонед
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);
}
Пешнамоиши шарҳи ҳуҷҷати Word

Тасвир: - Пешнамоиши шарҳи ҳуҷҷати Word бо истифода аз 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);

Мундариҷаи ҳуҷҷати воридшудаи Word-ро аз диски маҳаллӣ хонед.

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 эҷод кунед, ки дар он мо мундариҷаи ҳуҷҷати воридшудаи Word, объекти CommentInsert ва номи ҳуҷҷати натиҷавии Word-ро мегузарем.

 var response = wordsApi.InsertCommentOnline(insertRequest);

Ниҳоят, ба усули InsertCommentOnline(…) занг занед, то шарҳро ба ҳуҷҷати Word дар гиреҳи муайяншуда дохил кунед.

Намунаҳои файлҳои дар мисоли боло истифодашударо аз input-sample-1.docx ва Commented.docx зеркашӣ кардан мумкин аст.

Бо истифода аз фармонҳои cURL ба ҳуҷҷати Word шарҳҳо илова кунед

Мо мефаҳмем, ки илова кардани эзоҳҳо ё шарҳҳо ба ҳуҷҷатҳои Word бо истифода аз фармонҳои cURL метавонад хеле муфид бошад, зеро он роҳи барномавии илова кардани эзоҳҳоро ба таври оммавӣ таъмин мекунад ё ба шумо имкон медиҳад, ки функсияҳоро ба ҷараёнҳои кории мавҷудаи худ ворид кунед. Бо ёрии Aspose.Words Cloud API ва фармонҳои cURL, илова кардани шарҳҳо ба ҳуҷҷати Word тавассути як қатор зангҳои API анҷом дода мешавад. Ин фиристодани дархостҳо ба Aspose.Words Cloud API-ро бо параметрҳои мувофиқ, ба монанди файли ҳуҷҷат, макон, матн ва маълумоти муаллиф барои эҷоди шарҳ дар бар мегирад.

Қадами аввал ин ба даст овардани “accessToken” тавассути фиристодани дархости 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-ро дорем, лутфан фармони зеринро иҷро кунед, то ба ҳуҷҷати Word тавзеҳ гузоред.

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}-ро бо номи ҳуҷҷати воридшудаи Word (аллакай дар анбори абр дастрас аст), {accessToken} бо аломати дастрасии JWT дар боло тавлидшуда ва {resultantFile} бо номи ҳуҷҷати натиҷавии Word, ки дорои эзоҳоти нав аст, иваз кунед. .

Хулоса

Хулоса, илова кардани эзоҳҳо ва шарҳҳо ба ҳуҷҷатҳои Word метавонад хусусияти муфид барои таҳрир ва баррасии муштарак бошад. Бо ёрии фармонҳои Aspose.Words Cloud ва cURL ё Aspose.Words Cloud SDK барои .NET, ин вазифаро метавон самаранок ва муассир иҷро кард. Новобаста аз он ки шумо истифодаи ҳалли абрӣ ё SDK-ро афзал медонед, Aspose.Words воситаи пуриқтидор ва боэътимодро барои шарҳ додани ҳуҷҷатҳои Word таъмин мекунад. Умедворем, ки ин дастур барои роҳнамоии шумо дар ин раванд муфид буд ва ба шумо тамоми тафсилоти заруриро барои оғози кор пешниҳод кардааст.

Пайвандҳои муфид

Мақолаҳои марбут

Мо тавсия медиҳем, ки аз блогҳои зерин гузаред: