Microsoft Word یک عملکرد داخلی برای ردیابی تغییرات و حفظ ویرایش ها در اسناد Word ارائه می دهد. با این حال، ممکن است تغییرات ردیابی شده اسناد Word (DOC یا DOCX) را به صورت برنامه‌نویسی در فضای ابری بپذیریم یا رد کنیم. در این مقاله، نحوه پذیرش یا رد تغییرات ردیابی شده در یک سند Word را با استفاده از REST API در Node.js خواهیم آموخت.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- REST API و Node.js SDK برای پذیرش یا رد تغییرات
- پذیرش یا رد تغییرات پیگیری شده با استفاده از REST API در Node.js
- همه تغییرات در Node.js را بپذیرید یا رد کنید
REST API و Node.js SDK برای پذیرش یا رد تغییرات
برای پذیرش یا رد تغییرات ردیابی شده در یک سند Word، از Node.js SDK of GroupDocs.Comparison Cloud API استفاده خواهیم کرد. این امکان مقایسه دو یا چند سند از فرمت‌های پشتیبانی شده و ردیابی تغییرات آنها را فراهم می‌کند. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:
npm install groupdocs-comparison-cloud
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 5 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";
const config = new groupdocs_comparison_cloud.Configuration(clientId, clientSecret);
config.apiBaseUrl = "https://api.groupdocs.cloud";
پذیرش یا رد تغییرات پیگیری شده با استفاده از REST API در Node.js
با دنبال کردن مراحل ساده زیر می‌توانیم ویرایش‌های خاصی را در اسناد Word بپذیریم یا رد کنیم:
- آپلود فایل‌های DOCX در Cloud
- پذیرش یا رد تغییرات در اسناد Word
- دانلود فایل خروجی
سند را آپلود کنید
در ابتدا، ما سند Word را با بازبینی‌هایی در فضای ابری با استفاده از نمونه کد زیر بارگذاری می‌کنیم:
// FileApi را بسازید
let fileApi = groupdocs_comparison_cloud.FileApi.fromConfig(config);
// مسیر فایل ورودی
let file = 'C:\\Files\\source_with_revisions.docx';
// فایل را بخوانید
fs.readFile(file, (err, fileStream) => {
// درخواست فایل آپلود ایجاد کنید
let request = new groupdocs_comparison_cloud.UploadFileRequest("source_with_revisions.docx", fileStream, myStorage);
// آپلود فایل
fileApi.uploadFile(request);
});
در نتیجه، فایل DOCX آپلود شده در بخش فایل‌ها داشبورد در فضای ابری در دسترس خواهد بود.
پذیرش یا رد تغییرات در اسناد Word
اکنون، با دنبال کردن مراحل زیر، تغییرات ردیابی شده را به صورت برنامه‌نویسی می‌پذیریم یا رد می‌کنیم:
- ابتدا یک نمونه از ReviewApi ایجاد کنید.
- در مرحله بعد، مسیر فایل DOCX آپلود شده را ارائه دهید.
- سپس، ویرایش‌ها را دریافت کنید و ویرایش‌های مورد نظر را در یک حلقه بپذیرید یا رد کنید.
- در نهایت، ویرایش ها را اعمال کنید و فایل به روز شده را به عنوان “output.docx” ذخیره کنید.
نمونه کد زیر نحوه پذیرش تغییرات ردیابی شده در یک سند Word را با استفاده از REST API در Node.js نشان می دهد.
// یک نمونه از API ایجاد کنید
let reviewApi = groupdocs_comparison_cloud.ReviewApi.fromKeys(clientId, clientSecret);
// فایل منبع ورودی
let source = new groupdocs_comparison_cloud.FileInfo();
source.filePath = "source_with_revisions.docx";
// گزینه های اعمال تجدید نظر را تعریف کنید
let options = new groupdocs_comparison_cloud.ApplyRevisionsOptions();
options.sourceFile = source;
options.outputPath = "output.docx";
// درخواست دریافت بازبینی ایجاد کنید
let request = new groupdocs_comparison_cloud.GetRevisionsRequest(source);
// دریافت همه ویرایش ها
let revisions = await reviewApi.getRevisions(request);
// پذیرش یا رد ویرایش ها
revisions.forEach(revision => {
revision.action = groupdocs_comparison_cloud.RevisionInfo.ActionEnum.Accept;
});
options.revisions = revisions;
// درخواست تجدید نظر را ایجاد کنید
let applyRequest = new groupdocs_comparison_cloud.ApplyRevisionsRequest(options);
// بازبینی ها را اعمال کنید
let response = await reviewApi.applyRevisions(applyRequest);
console.log("Output file link: " + response.href);
پذیرش یا رد تغییرات پیگیری شده با استفاده از REST API در Node.js
به همین ترتیب، می‌توانیم با دنبال کردن مراحلی که قبلاً ذکر شد، هرگونه تغییر را رد کنیم. با این حال، ما فقط باید گزینه های ویرایش زیر را اعمال کنیم:
revisions.forEach(revision => {
revision.action = groupdocs_comparison_cloud.RevisionInfo.ActionEnum.Reject;
});
فایل نتیجه را دانلود کنید
در نتیجه، مثال کد بالا یک فایل DOCX جدید ایجاد شده را با تغییرات در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:
// FileApi را بسازید
let fileApi = groupdocs_comparison_cloud.FileApi.fromConfig(config);
// درخواست فایل دانلود را ایجاد کنید
let request = new groupdocs_comparison_cloud.DownloadFileRequest("output.docx", myStorage);
// دریافت فایل
let response = await fileApi.downloadFile(request);
// در پوشه کاری ذخیره کنید
fs.writeFile("C:\\Files\\output.docx", response, "binary", function (err) { });
تمام تغییرات Node.js را بپذیرید یا رد کنید
با دنبال کردن مراحل زیر می توانیم همه تغییرات را به یکباره بپذیریم یا رد کنیم:
- ابتدا یک نمونه از ReviewApi ایجاد کنید.
- در مرحله بعد، مسیر فایل DOCX آپلود شده را ارائه دهید.
- سپس، بازبینی‌ها را دریافت کنید و همه ویرایش‌ها را بپذیرید یا رد کنید.
- در نهایت، ویرایش ها را اعمال کنید و فایل به روز شده را به عنوان “output.docx” ذخیره کنید.
نمونه کد زیر نحوه پذیرش تمام تغییرات با استفاده از REST API را نشان می دهد. لطفاً برای آپلود و دانلود فایل مراحل ذکر شده قبلی را دنبال کنید.
// یک نمونه از API ایجاد کنید
let reviewApi = groupdocs_comparison_cloud.ReviewApi.fromKeys(clientId, clientSecret);
// فایل منبع ورودی
let source = new groupdocs_comparison_cloud.FileInfo();
source.filePath = "source_with_revisions.docx";
// گزینه های اعمال تجدید نظر را تعریف کنید
let options = new groupdocs_comparison_cloud.ApplyRevisionsOptions();
options.sourceFile = source;
options.outputPath = "output.docx";
// همه بازنگری ها را بپذیرید
options.acceptAll = true;
// همه تجدید نظرها را رد کنید
// options.rejectAll = true;
// درخواست تجدید نظر را ایجاد کنید
let request = new groupdocs_comparison_cloud.ApplyRevisionsRequest(options);
// بازبینی ها را اعمال کنید
let response = await reviewApi.applyRevisions(request);
console.log("Output file link: " + response.href);
آنلاین را امتحان کنید
لطفاً ابزار مقایسه آنلاین رایگان DOCX زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/comparison/docx
نتیجه
در این مقاله نحوه پذیرش یا رد تغییرات ردیابی شده در اسناد Word را با استفاده از REST API در فضای ابری آموختیم. همچنین دیده‌ایم که چگونه می‌توان همه ویرایش‌ها را به صورت یکجا به صورت برنامه‌ریزی پذیرفت یا رد کرد. این مقاله همچنین نحوه آپلود برنامه‌ای یک فایل DOCX در فضای ابری و سپس دانلود فایل حاصل از ابر را توضیح داد. علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Comparison Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هر گونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید12.