تحرير مستندات Word باستخدام REST API في Node.js

يمكنك بسهولة تحرير مستندات Word برمجيًا على السحابة. يمكنك إضافة محتوى المستندات أو تحريره أو يمكنك تطبيق تنسيق النص في مستندات Word برمجيًا في تطبيقات Node.js الخاصة بك. ستركز هذه المقالة على كيفية تحرير مستندات Word باستخدام واجهة برمجة تطبيقات REST في Node.js.

سيتم تناول الموضوعات التالية في هذه المقالة:

محرر المستندات REST API و Node.js SDK
قم بتحرير مستند Word باستخدام REST API في Node.js
أضف جدولاً في مستندات Word باستخدام Node.js
أدخل الصورة في مستندات Word باستخدام Node.js

محرر المستندات REST API و Node.js SDK

سأستخدم Node.js SDK من GroupDocs.Editor Cloud API لتحرير ملفات DOCX. يسمح لك بتحرير مستندات التنسيقات المدعومة برمجيًا مثل Word وجداول بيانات Excel و PowerPoint و TXT و HTML و XML. تمكّنك واجهة برمجة التطبيقات أيضًا من تحويل المستند إلى HTML للتحرير وتحويله مرة أخرى إلى تنسيقه الأصلي مع الاحتفاظ بنفس المظهر بعد تحرير المستند. كما أنها توفر تطبيقات .NET و Java و PHP و Ruby و Android و Python SDK باعتبارها أعضاء عائلة محرر المستندات لواجهة برمجة التطبيقات السحابية.

يمكنك تثبيت 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 باتباع الخطوات البسيطة المذكورة أدناه:

تحميل ملف Word على السحابة
تحرير مستند Word باستخدام Node.js
تنزيل الملف المحدث

قم بتحميل المستند

أولاً ، قم بتحميل مستند Word (DOCX) إلى السحابة باستخدام مثال الرمز الموضح أدناه:

// بناء 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
قم بتوفير مسار ملف الإدخال في FileInfo
قم بإنشاء WordProcessingLoadOptions
قم بإنشاء LoadRequest باستخدام LoadOptions
قم بتحميل ملف بطريقة load() من EditAPI
قم بإنشاء DownloadFileRequest بالملف الذي تم تحميله
قم بتنزيل مستند HTML باستخدام طريقة downloadFile() من FileAPI
قم بتحرير مستند HTML الذي تم تنزيله
قم بإنشاء UploadFileRequest
قم بتحميل HTML مرة أخرى باستخدام طريقة uploadFile() من FileAPI
قم بتوفير WordProcessingSaveOptions للحفظ في ملف DOCX
قم بإنشاء SaveRequest باستخدام SaveOptions
احفظ HTML مرة أخرى إلى DOCX باستخدام طريقة save() لتحرير API

يوضح مقتطف الشفرة التالي كيفية تحرير مستند Word باستخدام واجهة برمجة تطبيقات REST في 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 في Node.js

قم بتنزيل الملف المحدث

سيحفظ نموذج الكود أعلاه مستند Word المحرر (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) { });

أضف جدولاً في مستندات Word باستخدام Node.js

يمكنك إضافة جدول في مستند Word برمجيًا باتباع الخطوات المذكورة أدناه:

إنشاء مثيلات من FileAPI و EditAPI
قم بتوفير مسار ملف الإدخال في FileInfo
قم بإنشاء WordProcessingLoadOptions
قم بإنشاء LoadRequest باستخدام LoadOptions
تحميل ملف بأسلوب load() من EditAPI
قم بإنشاء DownloadFileRequest بالملف الذي تم تحميله
قم بتنزيل مستند HTML باستخدام طريقة downloadFile() الخاصة بـ FileAPI
قم بتحرير مستند HTML الذي تم تنزيله and add a table
قم بإنشاء UploadFileRequest
قم بتحميل HTML مرة أخرى باستخدام طريقة uploadFile() من FileAPI
قم بتوفير WordProcessingSaveOptions للحفظ في ملف DOCX
قم بإنشاء SaveRequest باستخدام SaveOptions
احفظ HTML مرة أخرى إلى DOCX باستخدام طريقة save() من EditAPI

يوضح مقتطف الشفرة التالي كيفية إضافة جدول في مستند Word باستخدام واجهة برمجة تطبيقات REST في 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);

أضف جدولاً في مستندات Word باستخدام Node.js

أدخل صورة في مستندات Word باستخدام Node.js

يمكنك إدراج صورة في مستند Word برمجيًا باتباع الخطوات المذكورة أدناه:

إنشاء مثيلات من FileAPI و EditAPI
قم بتوفير مسار ملف الإدخال في FileInfo
قم بإنشاء WordProcessingLoadOptions
قم بإنشاء LoadRequest باستخدام LoadOptions
قم بتحميل ملف باستخدام أسلوب load() من EditAPI
قم بإنشاء DownloadFileRequest بالملف الذي تم تحميله
قم بتنزيل مستند HTML باستخدام طريقة downloadFile() الخاصة بـ FileAPI
قم بتحرير مستند HTML الذي تم تنزيله and insert an image
قم بإنشاء UploadFileRequest
قم بتحميل HTML مرة أخرى باستخدام طريقة uploadFile() من FileAPI
قم بتوفير WordProcessingSaveOptions للحفظ في ملف DOCX
قم بإنشاء SaveRequest باستخدام SaveOptions
احفظ HTML مرة أخرى إلى DOCX باستخدام طريقة save() من EditAPI

يوضح مقتطف التعليمات البرمجية التالي كيفية إدراج صورة في مستند Word باستخدام واجهة برمجة تطبيقات REST في 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

جرب عبر الإنترنت

يرجى تجربة أداة تحرير DOCX المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/editor/docx

خاتمة

في هذه المقالة ، تعلمت كيفية تحرير مستندات Word على السحابة. لقد تعلمت أيضًا كيفية إضافة جدول في ملف DOCX باستخدام واجهة برمجة تطبيقات REST في Node.js. علاوة على ذلك ، لقد تعلمت كيفية إدراج صورة في مستند Word برمجيًا. توضح هذه المقالة أيضًا كيفية تحميل ملف DOCX برمجيًا على السحابة ثم تنزيل الملف المحرر من السحابة. يمكنك معرفة المزيد حول GroupDocs.Editor Cloud API باستخدام التوثيق. نقدم أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا

تحرير مستندات Word و Excel و PPT والويب برمجيًا

محرر المستندات REST API و Node.js SDK#

قم بتحرير مستندات Word باستخدام REST API في Node.js#

قم بتحميل المستند#

تحرير مستند Word باستخدام Node.js#

قم بتنزيل الملف المحدث#

أضف جدولاً في مستندات Word باستخدام Node.js#

أدخل صورة في مستندات Word باستخدام Node.js#

جرب عبر الإنترنت#

خاتمة#

أنظر أيضا#