ورڈ دستاویزات کی تشریح کریں۔

C# .NET کا استعمال کرتے ہوئے ورڈ دستاویزات میں تبصرے شامل کریں۔

دستاویز کی تشریح کرنا بہت سی صنعتوں میں تعاون اور مواصلات کا ایک لازمی حصہ ہے۔ یہ صارفین کو کسی دستاویز پر تاثرات، تجاویز اور تبصرے فراہم کرنے کی اجازت دیتا ہے جسے دوسروں کے ساتھ باآسانی شیئر کیا جا سکتا ہے۔ اس کے باوجود، مائیکروسافٹ ورڈ کئی تشریحی ٹولز پیش کرتا ہے، جیسے تبصرے، تبدیلیوں کو ٹریک کرنا، اور نوٹ شامل کرنا، تاکہ صارفین کو تاثرات فراہم کرنے اور دستاویز پر تعاون کرنے میں مدد ملے۔ تاہم، اس بلاگ پوسٹ میں، ہم .NET Cloud SDK کا استعمال کرتے ہوئے Word documents کی تشریح کرنے کا طریقہ دریافت کریں گے، جس سے صارفین کے لیے بات چیت کرنا آسان ہو جائے گا اور دستاویزات پر تعاون کریں۔

لفظ کے تبصرے شامل کرنے کے لیے REST API

Aspose.Words Cloud SDK for .NET کا استعمال کرتے ہوئے، آپ آسانی سے C# زبان کا استعمال کرتے ہوئے ورڈ دستاویز میں تبصرے، جوابات اور تشریحات شامل کر سکتے ہیں۔ SDK ورڈ دستاویز میں ہیرا پھیری کے لیے REST APIs کا ایک جامع سیٹ فراہم کرتا ہے اور دستاویز کے تمام بڑے فارمیٹس کو سپورٹ کرتا ہے، بشمول DOC، DOCX، [RTF](https ://docs.fileformat.com/word-processing/rtf/)، اور مزید۔ اب اس SDK کی مدد سے، آپ اپنے ورڈ دستاویزات میں تشریحات، تبصرے، اور جائزہ کے دیگر عناصر کو آسانی سے اور مؤثر طریقے سے شامل کرکے اپنے ورک فلو اور تعاون کے عمل کو بڑھا سکتے ہیں۔

SDK استعمال کرنے کے لیے، NuGet پیکیجز مینیجر میں Aspose.Words-Cloud تلاش کریں اور .NET پروجیکٹ میں SDK حوالہ شامل کرنے کے لیے پیکیج شامل کریں بٹن پر کلک کریں۔

نوٹ: REST API تک رسائی حاصل کرنے کے لیے، آپ کو رجسٹر کرنے اور اپنی ذاتی اسناد حاصل کرنے کی ضرورت ہے۔ براہ کرم متعلقہ معلومات کے لیے کوئیک اسٹارٹ گائیڈ پر ایک نظر ڈالیں۔

C# کا استعمال کرتے ہوئے ورڈ دستاویز تشریح شامل کریں

براہ کرم .NET Cloud SDK کا استعمال کرتے ہوئے Word دستاویز کی تشریح شامل کرنے کے لیے درج ذیل کوڈ کا ٹکڑا استعمال کرنے کی کوشش کریں۔

// مکمل مثالوں اور ڈیٹا فائلوں کے لیے، براہ کرم پر جائیں۔ 
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 اور کلائنٹ سیکرٹ تفصیلات کا استعمال کرتے ہوئے کنفیگریشن آبجیکٹ بنائیں
var config = new Aspose.Words.Cloud.Sdk.Configuration { ClientId = clientID, ClientSecret = clientSecret };
// WordsApi مثال شروع کریں۔
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"
};

تشریح کے لیے NodeId کی وضاحت کرنے والے NodeLink کا ایک آبجیکٹ بنائیں۔ 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 کمانڈز کی مدد سے، ورڈ دستاویز میں تبصرے شامل کرنا API کالوں کی ایک سیریز کے ذریعے مکمل کیا جا سکتا ہے۔ اس میں Aspose.Words Cloud API کو مناسب پیرامیٹرز کے ساتھ درخواستیں بھیجنا شامل ہے، جیسے کہ دستاویز کی فائل، مقام، متن، اور مصنف کی معلومات، تبصرہ کرنے کے لیے۔

پہلا قدم اپنے App SID اور App Key کی تفصیلات کے ساتھ POST کی درخواست بھیج کر ایک accessToken حاصل کرنا ہے۔ براہ کرم درج ذیل کمانڈ پر عمل کریں:

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"

ایک بار جب ہمارے پاس ایکسیس ٹوکن ہو جائے، تو براہ کرم ورڈ دستاویز میں تشریح داخل کرنے کے لیے درج ذیل کمانڈ پر عمل کریں۔

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} کو نئی تشریح پر مشتمل نتیجہ خیز ورڈ دستاویز کے نام سے تبدیل کریں۔ .

نتیجہ

آخر میں، ورڈ دستاویزات میں تشریحات اور تبصرے شامل کرنا باہمی تدوین اور جائزہ کے لیے ایک مفید خصوصیت ہو سکتا ہے۔ Aspose.Words Cloud اور cURL کمانڈز یا .NET کے لیے Aspose.Words Cloud SDK کی مدد سے، اس کام کو موثر اور مؤثر طریقے سے پورا کیا جا سکتا ہے۔ چاہے آپ کلاؤڈ بیسڈ حل یا SDK استعمال کرنے کو ترجیح دیں، Aspose.Words Word دستاویزات کی تشریح کے لیے ایک طاقتور اور قابل اعتماد ٹول فراہم کرتا ہے۔ ہمیں امید ہے کہ یہ ٹیوٹوریل اس عمل میں آپ کی رہنمائی کرنے میں مددگار ثابت ہوا ہے اور آپ کو شروع کرنے کے لیے تمام ضروری تفصیلات فراہم کر دی ہیں۔

مفید لنکس

  • [API حوالہ4
  • [SDK سورس کوڈ5
  • [مفت پروڈکٹ سپورٹ فورم6

متعلقہ مضامین

ہم مندرجہ ذیل بلاگز کے ذریعے جانے کی انتہائی سفارش کرتے ہیں: