اسناد Word را با استفاده از REST API در Node.js ویرایش کنید

به راحتی می توانید اسناد Word خود را به صورت برنامه نویسی در فضای ابری ویرایش کنید. می‌توانید محتوای اسناد را اضافه کنید، ویرایش کنید یا می‌توانید قالب‌بندی متن را در اسناد Word به صورت برنامه‌نویسی در برنامه‌های Node.js خود اعمال کنید. این مقاله بر نحوه ویرایش اسناد Word با استفاده از REST API در Node.js تمرکز خواهد کرد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

ویرایشگر سند REST API و Node.js SDK

من از Node.js SDK of GroupDocs.Editor Cloud برای ویرایش فایل‌های DOCX استفاده خواهم کرد. این به شما امکان می دهد اسناد فرمت های پشتیبانی شده مانند Word، صفحات گسترده اکسل، پاورپوینت، TXT، HTML، XML را به صورت برنامه نویسی ویرایش کنید. API همچنین شما را قادر می سازد تا سند را برای ویرایش به HTML تبدیل کنید و پس از ویرایش سند، آن را به فرمت اصلی خود بازگردانید و ظاهر یکسانی را حفظ کنید. همچنین دات نت، جاوا، پی اچ پی، روبی، اندروید و پایتون SDK را به عنوان [اعضای خانواده ویرایشگر سند3 برای Cloud API ارائه می کند.

می توانید با استفاده از دستور زیر در کنسول، GroupDocs.Editor Cloud را در برنامه Node.js خود نصب کنید:

npm install groupdocs-editor-cloud

لطفاً قبل از انجام مراحل ذکر شده، شناسه مشتری و راز خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:

global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";

const configuration = new groupdocs_editor_cloud.Configuration(clientId, clientSecret);
configuration.apiBaseUrl = "https://api.groupdocs.cloud";

اسناد Word را با استفاده از REST API در Node.js ویرایش کنید

می توانید اسناد Word را با انجام مراحل ساده زیر ویرایش کنید:

  1. آپلود فایل Word را در Cloud
  2. ویرایش سند Word با استفاده از Node.js
  3. دانلود فایل به روز شده

سند را آپلود کنید

ابتدا سند Word (DOCX) را با استفاده از مثال کد زیر در Cloud آپلود کنید:

// FileApi را بسازید
let fileApi = groupdocs_editor_cloud.FileApi.fromConfig(configuration);
let resourcesFolder = 'C:\\Files\\sample.docx';

fs.readFile(resourcesFolder, (err, fileStream) => {
  let request = new groupdocs_editor_cloud.UploadFileRequest("sample.docx", fileStream, myStorage);
  fileApi.uploadFile(request);
});

در نتیجه، فایل DOCX آپلود شده در بخش فایل‌ها داشبورد شما در فضای ابری در دسترس خواهد بود.

سند Word را با استفاده از Node.js ویرایش کنید

لطفاً مراحل ذکر شده در زیر را برای ویرایش اسناد Word به صورت برنامه ای دنبال کنید.

  • نمونه هایی از FileAPI و [EditAPI] را ایجاد کنید (https://apireference.groupdocs.cloud/editor/#/Edit)
  • مسیر فایل ورودی را در FileInfo ارائه دهید
  • WordProcessingLoadOptions را ایجاد کنید
  • LoadRequest را با LoadOptions ایجاد کنید
  • یک فایل را با روش load() EditAPI بارگیری کنید
  • DownloadFileRequest را با فایل بارگذاری شده ایجاد کنید
  • سند HTML را با استفاده از روش downloadFile() FileAPI دانلود کنید
  • سند HTML دانلود شده را ویرایش کنید
  • UploadFileRequest را ایجاد کنید
  • با استفاده از روش uploadFile() FileAPI، HTML را دوباره آپلود کنید
  • WordProcessingSaveOptions را برای ذخیره در DOCX ارائه دهید
  • SaveRequest را با SaveOptions ایجاد کنید
  • با استفاده از روش save() Edit API، HTML را به DOCX برگردانید

قطعه کد زیر نحوه ویرایش یک سند Word را با استفاده از REST API در Node.js نشان می دهد.

// مقداردهی اولیه api
let editApi = groupdocs_editor_cloud.EditApi.fromKeys(clientId, clientSecret);
let fileApi = groupdocs_editor_cloud.FileApi.fromKeys(clientId, clientSecret);

// فایل ورودی      
let fileInfo = new groupdocs_editor_cloud.FileInfo();
fileInfo.filePath = "Sample.docx";

// گزینه های بار را تعریف کنید
let loadOptions = new groupdocs_editor_cloud.WordProcessingLoadOptions();
loadOptions.fileInfo = fileInfo;
loadOptions.outputPath = "output";

// درخواست بار ایجاد کنید
let loadRequest = new groupdocs_editor_cloud.LoadRequest(loadOptions);
let loadResult = await editApi.load(loadRequest);

// دانلود سند html
let downloadRequest = new groupdocs_editor_cloud.DownloadFileRequest(loadResult.htmlPath);
let buf = await fileApi.downloadFile(downloadRequest);
let htmlString = buf.toString("utf-8");

// چیزی را ویرایش کن...
htmlString = htmlString.replace("Title of the document", "Welcome");
htmlString = htmlString.replace("Subtitle #1", "Hello world");

// html را دوباره به فضای ذخیره سازی آپلود کنید
let uploadRequest = new groupdocs_editor_cloud.UploadFileRequest(loadResult.htmlPath, new Buffer.from(htmlString, "utf-8"));
await fileApi.uploadFile(uploadRequest);

// ذخیره html به docx
let saveOptions = new groupdocs_editor_cloud.WordProcessingSaveOptions();
saveOptions.fileInfo = fileInfo;
saveOptions.outputPath = "output/edited.docx";
saveOptions.htmlPath = loadResult.htmlPath;
saveOptions.resourcesPath = loadResult.resourcesPath;

// ایجاد درخواست ذخیره
let saveRequest = new groupdocs_editor_cloud.SaveRequest(saveOptions);
let saveResult = await editApi.save(saveRequest);
console.log("Document edited: " + saveResult.path);
اسناد Word را با استفاده از REST API در Node.js ویرایش کنید

اسناد Word را با استفاده از REST API در Node.js ویرایش کنید

فایل به روز شده را دانلود کنید

نمونه کد بالا سند ورد ویرایش شده (DOCX) را در ابر ذخیره می کند. با استفاده از نمونه کد زیر می توانید آن را دانلود کنید:

// api را مقداردهی اولیه کنید
var fileApi = groupdocs_editor_cloud.FileApi.fromConfig(configuration);

// ایجاد درخواست دانلود فایل
let request = new groupdocs_editor_cloud.DownloadFileRequest("output/edited.docx", myStorage);

// دریافت فایل
let response = await fileApi.downloadFile(request);

// ذخیره فایل تصویر در پوشه کاری
fs.writeFile("C:\\Files\\edited.docx", response, "binary", function (err) { });

با استفاده از Node.js جدول را در اسناد Word اضافه کنید

با دنبال کردن مراحل ذکر شده در زیر می توانید جدولی را به صورت برنامه نویسی در سند Word اضافه کنید:

  • نمونه هایی از FileAPI و EditAPI را ایجاد کنید
  • مسیر فایل ورودی را در FileInfo ارائه دهید
  • WordProcessingLoadOptions را ایجاد کنید
  • LoadRequest را با LoadOptions ایجاد کنید
  • یک فایل را با روش load() EditAPI بارگیری کنید
  • DownloadFileRequest را با فایل بارگذاری شده ایجاد کنید
  • سند HTML را با استفاده از روش downloadFile() FileAPI دانلود کنید
  • سند HTML دانلود شده را ویرایش کنید and add a table
  • UploadFileRequest را ایجاد کنید
  • با استفاده از روش uploadFile() FileAPI، HTML را دوباره آپلود کنید
  • WordProcessingSaveOptions را برای ذخیره در DOCX ارائه دهید
  • SaveRequest را با SaveOptions ایجاد کنید
  • ذخیره HTML به DOCX با استفاده از روش save() EditAPI

قطعه کد زیر نحوه اضافه کردن جدول به سند Word را با استفاده از REST API در Node.js نشان می دهد.

// مقداردهی اولیه api
let editApi = groupdocs_editor_cloud.EditApi.fromKeys(clientId, clientSecret);
let fileApi = groupdocs_editor_cloud.FileApi.fromKeys(clientId, clientSecret);

// فایل ورودی      
let fileInfo = new groupdocs_editor_cloud.FileInfo();
fileInfo.filePath = "Sample.docx";

// گزینه های بار را تعریف کنید
let loadOptions = new groupdocs_editor_cloud.WordProcessingLoadOptions();
loadOptions.fileInfo = fileInfo;
loadOptions.outputPath = "output";

// درخواست بار ایجاد کنید
let loadRequest = new groupdocs_editor_cloud.LoadRequest(loadOptions);
let loadResult = await editApi.load(loadRequest);

// دانلود سند html
let downloadRequest = new groupdocs_editor_cloud.DownloadFileRequest(loadResult.htmlPath);
let buf = await fileApi.downloadFile(downloadRequest);
let htmlString = buf.toString("utf-8");

// جدول اضافه کنید
htmlString = htmlString.replace("left-aligned.", "left-aligned. <br/><table style=\"width: 100%;background-color: #dddddd;\">"
		+ "<caption style=\"font-weight:bold;\"> Persons List</caption>"
		+ "<tr><th>First Name</th><th>Last Name</th><th>Age</th></tr>"
		+ "<tr><td>Jill</td><td>Smith</td><td>50</td></tr>"
		+ "<tr><td>Eve</td><td>Jackson</td><td>94</td></tr>"
		+ "</table>");

// html را دوباره به فضای ذخیره سازی آپلود کنید
let uploadRequest = new groupdocs_editor_cloud.UploadFileRequest(loadResult.htmlPath, new Buffer.from(htmlString, "utf-8"));
await fileApi.uploadFile(uploadRequest);

// ذخیره html به docx
let saveOptions = new groupdocs_editor_cloud.WordProcessingSaveOptions();
saveOptions.fileInfo = fileInfo;
saveOptions.outputPath = "output/edited.docx";
saveOptions.htmlPath = loadResult.htmlPath;
saveOptions.resourcesPath = loadResult.resourcesPath;

// ایجاد درخواست ذخیره
let saveRequest = new groupdocs_editor_cloud.SaveRequest(saveOptions);
let saveResult = await editApi.save(saveRequest);
console.log("Document edited: " + saveResult.path);
با استفاده از Node.js جدول را در اسناد Word اضافه کنید

با استفاده از Node.js جدول را در اسناد Word اضافه کنید

درج تصویر در اسناد Word با استفاده از Node.js

با انجام مراحل ذکر شده در زیر می توانید یک تصویر را به صورت برنامه نویسی در سند Word وارد کنید:

  • نمونه هایی از FileAPI و [EditAPI] را ایجاد کنید (https://apireference.groupdocs.cloud/editor/#/Edit)
  • مسیر فایل ورودی را در FileInfo ارائه دهید
  • WordProcessingLoadOptions را ایجاد کنید
  • LoadRequest را با LoadOptions ایجاد کنید
  • یک فایل را با روش load() EditAPI بارگیری کنید
  • DownloadFileRequest را با فایل Loaded ایجاد کنید
  • سند HTML را با استفاده از روش downloadFile() FileAPI دانلود کنید
  • سند HTML دانلود شده را ویرایش کنید and insert an image
  • UploadFileRequest را ایجاد کنید
  • با استفاده از روش uploadFile() در FileAPI، HTML را دوباره آپلود کنید
  • WordProcessingSaveOptions را برای ذخیره در DOCX ارائه دهید
  • SaveRequest را با SaveOptions ایجاد کنید
  • ذخیره HTML به DOCX با استفاده از روش save() EditAPI

قطعه کد زیر نحوه درج یک تصویر در سند Word را با استفاده از REST API در Node.js نشان می دهد.

// مقداردهی اولیه api
let editApi = groupdocs_editor_cloud.EditApi.fromKeys(clientId, clientSecret);
let fileApi = groupdocs_editor_cloud.FileApi.fromKeys(clientId, clientSecret);

// فایل ورودی   
let fileInfo = new groupdocs_editor_cloud.FileInfo();
fileInfo.filePath = "Sample.docx";

// گزینه های بار را تعریف کنید
let loadOptions = new groupdocs_editor_cloud.WordProcessingLoadOptions();
loadOptions.fileInfo = fileInfo;
loadOptions.outputPath = "output";

// درخواست بار ایجاد کنید
let loadRequest = new groupdocs_editor_cloud.LoadRequest(loadOptions);
let loadResult = await editApi.load(loadRequest);

// دانلود سند html
let downloadRequest = new groupdocs_editor_cloud.DownloadFileRequest(loadResult.htmlPath);
let buf = await fileApi.downloadFile(downloadRequest);
let htmlString = buf.toString("utf-8");

// یک تصویر درج کنید
htmlString = htmlString.replace("left-aligned.", "left-aligned. <br/> <img src=\"sample.png\" alt=\"signatures\" style=\"width: 128px; height: 128px;\">");

// html را دوباره به فضای ذخیره سازی آپلود کنید
let uploadRequest = new groupdocs_editor_cloud.UploadFileRequest(loadResult.htmlPath, new Buffer.from(htmlString, "utf-8"));
await fileApi.uploadFile(uploadRequest);

// ذخیره html به docx
let saveOptions = new groupdocs_editor_cloud.WordProcessingSaveOptions();
saveOptions.fileInfo = fileInfo;
saveOptions.outputPath = "output/edited.docx";
saveOptions.htmlPath = loadResult.htmlPath;
saveOptions.resourcesPath = loadResult.resourcesPath;

// ایجاد درخواست ذخیره
let saveRequest = new groupdocs_editor_cloud.SaveRequest(saveOptions);
let saveResult = await editApi.save(saveRequest);
console.log("Document edited: " + saveResult.path);
درج تصویر در اسناد Word با استفاده از Node.js

درج تصویر در اسناد Word با استفاده از Node.js

آنلاین را امتحان کنید

لطفاً ابزار ویرایش آنلاین رایگان DOCX زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/editor/docx

نتیجه

در این مقاله با نحوه ویرایش اسناد Word در فضای ابری آشنا شدید. همچنین نحوه اضافه کردن جدول به فایل DOCX را با استفاده از REST API در Node.js یاد گرفته‌اید. علاوه بر این، شما یاد گرفته اید که چگونه یک تصویر را به صورت برنامه نویسی در یک سند Word وارد کنید. این مقاله همچنین نحوه آپلود برنامه‌نویسی یک فایل DOCX را در فضای ابری و سپس دانلود فایل ویرایش شده از Cloud توضیح داد. می‌توانید با استفاده از مستندات درباره GroupDocs.Editor Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می دهیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در تالار گفتمان تماس بگیرید.

همچنین ببینید