عرض بيانات Excel بتنسيق HTML باستخدام REST API في Node.js

يمكن عرض صفحات الويب HTML في أي متصفح متاح على الأجهزة المحمولة. يساعد عرض بيانات Excel على صفحات HTML في إظهار البيانات لأصحاب المصلحة المعنيين دون مشاركة [جدول بيانات Excel] الفعلي 2 معهم. لذلك ، يمكنهم عرض المعلومات / البيانات المطلوبة في أي متصفح بسهولة. في هذه المقالة ، سنتعلم كيفية عرض بيانات Excel بتنسيق HTML باستخدام واجهة برمجة تطبيقات REST في Node.js.

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

Excel إلى HTML Viewer REST API و Node.js SDK

لعرض جداول بيانات XLS أو XLSX ، سأستخدم Node.js SDK of GroupDocs.Viewer Cloud API. يتيح عرض جميع أنواع المستندات الشائعة وتنسيقات ملفات الصور وعرضها برمجيًا. الرجاء تثبيته باستخدام الأمر التالي في وحدة التحكم:

npm install groupdocs-conversion-cloud

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

// يرجى الحصول على معرف العميل والسرية من لوحة التحكم وإضافة الرمز كما هو موضح أدناه:
global.clientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
global.clientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
global.myStorage = "";

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

عرض بيانات Excel بتنسيق HTML باستخدام REST API في Node.js

يمكننا عرض بيانات Excel بتنسيق HTML باتباع الخطوات البسيطة الواردة أدناه:

  1. تحميل ملف XLSX إلى السحابة
  2. عرض بيانات Excel بتنسيق HTML باستخدام Node.js
  3. تحميل الملف المقدم

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

أولاً ، سنقوم بتحميل ملف XLSX إلى السحابة باستخدام مثال الكود الموضح أدناه:

// يوضح مثال الكود هذا كيفية تحميل ملف XLSX إلى السحابة
// بناء FileApi
let fileApi = groupdocs_viewer_cloud.FileApi.fromConfig(configuration);
let resourcesFolder = 'C:\\Files\\viewer\\sample.xlsx';

// اقرأ الملفات واحدا تلو الآخر
fs.readFile(resourcesFolder, (err, fileStream) => {
  // طلب إنشاء ملف تحميل
  let request = new groupdocs_viewer_cloud.UploadFileRequest("sample.xlsx", fileStream, myStorage);
  // رفع ملف
  fileApi.uploadFile(request);
});

نتيجة لذلك ، سيكون الملف الذي تم تحميله متاحًا في قسم الملفات من لوحة القيادة على السحابة.

عرض بيانات Excel بتنسيق HTML باستخدام Node.js

يمكننا تقديم أو عرض بيانات Excel على صفحات HTML برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ ViewApi.
  • بعد ذلك ، قم بإنشاء مثيل FileInfo.
  • ثم قم بتعيين مسار ملف الإدخال.
  • بعد ذلك ، قم بإنشاء مثيل لـ ViewOptions.
  • بعد ذلك ، قم بتعيين FileInfo وقم بتعيين “HTML” كتنسيق العرض.
  • بعد ذلك ، قم بإنشاء مثيل HtmlOptions.
  • بعد ذلك ، ابدأ في SpreadsheetOptions وقم بتعيينها.
  • بعد ذلك ، قم بتعيين خيارات متنوعة مثل paginateSheets و textOverflowMode و renderGridLines وما إلى ذلك.
  • بعد ذلك ، قم بإنشاء طلب عرض عن طريق استدعاء طريقة CreateViewRequest مع viewOptions كوسيطة.
  • أخيرًا ، قم باستدعاء الأسلوب ViewApi.createView باستخدام CreateViewRequest كوسيطة لعرض HTML.

يوضح نموذج التعليمات البرمجية التالي كيفية عرض بيانات Excel بتنسيق HTML باستخدام واجهة برمجة تطبيقات REST في Node.js.

// يوضح مثال التعليمات البرمجية هذا كيفية عرض Excel في صفحة HTML
// تهيئة API
let viewApi = groupdocs_viewer_cloud.ViewApi.fromKeys(clientId, clientSecret);

// ملف الإدخال
let fileInfo = new groupdocs_viewer_cloud.FileInfo();
fileInfo.filePath = "sample.xlsx";

// تحديد خيارات العرض
let viewOptions = new groupdocs_viewer_cloud.ViewOptions();
viewOptions.fileInfo = fileInfo;
viewOptions.viewFormat = groupdocs_viewer_cloud.ViewOptions.ViewFormatEnum.HTML;

// تحديد خيارات التجسيد
viewOptions.renderOptions = new groupdocs_viewer_cloud.HtmlOptions();

// تحديد خيارات عرض جدول البيانات
viewOptions.renderOptions.spreadsheetOptions = new groupdocs_viewer_cloud.SpreadsheetOptions();
viewOptions.renderOptions.spreadsheetOptions.paginateSheets = false;
viewOptions.renderOptions.spreadsheetOptions.textOverflowMode = groupdocs_viewer_cloud.SpreadsheetOptions.TextOverflowModeEnum.HideText;
viewOptions.renderOptions.spreadsheetOptions.renderGridLines = true;
viewOptions.renderOptions.spreadsheetOptions.renderHiddenColumns = true;
viewOptions.renderOptions.spreadsheetOptions.renderHiddenRows = true;

// إنشاء طلب عرض
let request = new groupdocs_viewer_cloud.CreateViewRequest(viewOptions);
// إنشاء عرض
let response = await viewApi.createView(request);

// عرض مسار صفحات HTML المقدمة
for (let page = 0; page < response.pages.length; page++) {
  console.log("Document rendered: " + response.pages[page].path);
}
عرض بيانات Excel بتنسيق HTML باستخدام Node.js

عرض بيانات Excel بتنسيق HTML باستخدام Node.js

بشكل افتراضي ، يتم تقديم ورقة عمل واحدة في صفحة واحدة. يمكننا تخصيص عرض Excel من خلال تطبيق الخيارات التالية:

  • اعرض أوراق عمل Excel في صفحات متعددة
viewOptions.renderOptions.spreadsheetOptions.paginateSheets = true;
viewOptions.renderOptions.spreadsheetOptions.countRowsPerPage = 45;
  • إظهار خطوط الشبكة في HTML
viewOptions.renderOptions.spreadsheetOptions.renderGridLines = true;
  • تجسيد صفوف وأعمدة فارغة
viewOptions.renderOptions.spreadsheetOptions.renderEmptyRows = true;
viewOptions.renderOptions.spreadsheetOptions.renderEmptyColumns = true;
  • إظهار الصفوف والأعمدة المخفية
viewOptions.renderOptions.spreadsheetOptions.renderHiddenColumns = true;
viewOptions.renderOptions.spreadsheetOptions.renderHiddenRows = true;
  • تقديم منطقة الطباعة فقط
viewOptions.renderOptions.spreadsheetOptions.renderPrintAreaOnly = true;
  • تعيين وضع تجاوز النص
viewOptions.renderOptions.spreadsheetOptions.textOverflowMode = "HideText";

قم بتنزيل صفحات HTML

سيحفظ نموذج التعليمات البرمجية أعلاه صفحة (صفحات) HTML المعروضة على السحابة. يمكن تنزيله باستخدام مثال الكود التالي:

// يوضح مثال التعليمات البرمجية هذا كيفية تنزيل صفحة HTML من السحابة
// تهيئة api
var fileApi = groupdocs_viewer_cloud.FileApi.fromConfig(configuration);

// إنشاء طلب تنزيل الملف
let request = new groupdocs_viewer_cloud.DownloadFileRequest("/viewer/sample_xlsx/sample_page_1.html", myStorage);

// تحميل الملف
let response = await fileApi.downloadFile(request);

// حفظ ملف الصورة في دليل العمل
fs.writeFile("C:\\Files\\viewer\\sample_xlsx\\sample_page_1.html", response, "binary", function (err) { });

عرض بيانات Excel بتنسيق HTML مع علامة مائية باستخدام Node.js

يمكننا إضافة نص علامة مائية أثناء عرض بيانات Excel على صفحات HTML برمجيًا باتباع الخطوات الواردة أدناه:

  • أولاً ، قم بإنشاء مثيل لـ ViewApi.
  • بعد ذلك ، قم بإنشاء مثيل FileInfo.
  • ثم قم بتعيين مسار ملف الإدخال.
  • بعد ذلك ، قم بإنشاء مثيل لـ ViewOptions.
  • بعد ذلك ، قم بتعيين FileInfo وقم بتعيين “HTML” كتنسيق العرض.
  • بعد ذلك ، قم بإنشاء وتعيين مثيل للعلامة المائية.
  • ثم قم بتعيين حجم العلامة المائية والنص.
  • بعد ذلك ، قم بإنشاء طلب عرض عن طريق استدعاء طريقة CreateViewRequest مع viewOptions كوسيطة.
  • أخيرًا ، قم باستدعاء الأسلوب ViewApi.createView باستخدام CreateViewRequest كوسيطة لعرض HTML.

يوضح نموذج التعليمات البرمجية التالي كيفية عرض بيانات Excel بتنسيق HTML مع العلامة المائية باستخدام واجهة برمجة تطبيقات REST في Node.js.

// يوضح مثال التعليمات البرمجية هذا كيفية عرض Excel في صفحة HTML باستخدام علامة مائية
// تهيئة API
let viewApi = groupdocs_viewer_cloud.ViewApi.fromKeys(clientId, clientSecret);

// ملف الإدخال
let fileInfo = new groupdocs_viewer_cloud.FileInfo();
fileInfo.filePath = "sample.xlsx";

// تحديد خيارات العرض
let viewOptions = new groupdocs_viewer_cloud.ViewOptions();
viewOptions.fileInfo = fileInfo;
viewOptions.viewFormat = groupdocs_viewer_cloud.ViewOptions.ViewFormatEnum.HTML;

// أضف علامة مائية
viewOptions.watermark = new groupdocs_viewer_cloud.Watermark();
viewOptions.watermark.size = 100;
viewOptions.watermark.text = "This is a sample watermark!";

// إنشاء طلب عرض
let request = new groupdocs_viewer_cloud.CreateViewRequest(viewOptions);
// إنشاء عرض
let response = await viewApi.createView(request);

// عرض مسار صفحات HTML المقدمة
for (let page = 0; page < response.pages.length; page++) {
  console.log("Document rendered: " + response.pages[page].path);
}
عرض بيانات Excel بتنسيق HTML مع علامة مائية باستخدام Node.js

عرض بيانات Excel بتنسيق HTML مع علامة مائية باستخدام Node.js

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

يرجى تجربة أداة عرض Excel المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/viewer/xlsx

خاتمة

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

أنظر أيضا