HTML صفحات وب را می توان در هر مرورگر موجود در دستگاه های دستی مشاهده کرد. نمایش داده‌های اکسل در صفحات HTML به نشان دادن داده‌ها به ذینفعان مربوطه بدون اشتراک‌گذاری صفحه گسترده اکسل با آنها کمک می‌کند. بنابراین، آنها می توانند اطلاعات / داده های مورد نیاز را در هر مرورگری به راحتی مشاهده کنند. در این مقاله یاد می گیریم که چگونه داده های اکسل را در HTML با استفاده از REST API در Node.js نمایش دهیم.
موضوعات زیر در این مقاله پوشش داده خواهد شد:
- Excel به HTML Viewer REST API و Node.js SDK
- نمایش داده های اکسل در HTML با استفاده از REST API در Node.js
- نمایش داده های اکسل در HTML با واترمارک در 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
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 6 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
// لطفاً شناسه مشتری و راز خود را از داشبورد دریافت کنید و کد را مطابق شکل زیر اضافه کنید:
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";
نمایش داده های اکسل در HTML با استفاده از REST API در Node.js
با دنبال کردن مراحل ساده زیر می‌توانیم داده‌های اکسل را در HTML نمایش دهیم:
- آپلود فایل XLSX در Cloud
- نمایش داده‌های اکسل در HTML با استفاده از Node.js
- دانلود فایل رندر شده
سند را آپلود کنید
ابتدا فایل XLSX را با استفاده از نمونه کد زیر در Cloud آپلود می کنیم:
// این مثال کد نحوه آپلود فایل XLSX را در Cloud نشان می دهد
// 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);
});
در نتیجه، فایل آپلود شده در بخش فایل ها داشبورد در فضای ابری در دسترس خواهد بود.
نمایش داده های اکسل در HTML با استفاده از Node.js
با دنبال کردن مراحل زیر می‌توانیم داده‌های اکسل را به صورت برنامه‌نویسی در صفحات HTML نمایش دهیم:
- ابتدا یک نمونه از ViewApi ایجاد کنید.
- سپس یک نمونه از FileInfo ایجاد کنید.
- سپس مسیر فایل ورودی را تنظیم کنید.
- بعد، یک نمونه از ViewOptions ایجاد کنید.
- سپس، FileInfo را اختصاص دهید و “HTML” را به عنوان viewFormat تنظیم کنید.
- بعد، یک نمونه از HtmlOptions ایجاد کنید.
- سپس، SpreadsheetOptions را شروع کرده و اختصاص دهید.
- سپس گزینه های مختلفی مانند paginateSheets، textOverflowMode، renderGridLines و غیره را تنظیم کنید.
- پس از آن، با فراخوانی متد CreateViewRequest با viewOptions به عنوان آرگومان، یک درخواست view ایجاد کنید.
- در نهایت، متد ViewApi.createView را با CreateViewRequest به عنوان آرگومان برای رندر HTML فراخوانی کنید.
نمونه کد زیر نحوه نمایش داده های اکسل را در HTML با استفاده از REST API در Node.js نشان می دهد.
// این مثال کد نحوه ارائه اکسل در صفحه 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);
}
نمایش داده های اکسل در HTML با استفاده از Node.js
به طور پیش فرض، یک کاربرگ در یک صفحه نمایش داده می شود. ما می توانیم رندر اکسل را با اعمال گزینه های زیر سفارشی کنیم:
- یک کاربرگ اکسل را در چندین صفحه نمایش دهید
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 از Cloud را نشان می دهد
// 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) { });
نمایش داده های اکسل در HTML با واترمارک با استفاده از Node.js
با دنبال کردن مراحل زیر می‌توانیم یک متن واترمارک اضافه کنیم در حالی که داده‌های اکسل را به صورت برنامه‌نویسی به صفحات HTML ارائه می‌کنیم:
- ابتدا، یک نمونه از ViewApi ایجاد کنید.
- سپس یک نمونه از FileInfo ایجاد کنید.
- سپس مسیر فایل ورودی را تنظیم کنید.
- بعد، یک نمونه از ViewOptions ایجاد کنید.
- سپس، FileInfo را اختصاص دهید و “HTML” را به عنوان viewFormat تنظیم کنید.
- بعد، یک نمونه از Watermark را ایجاد و اختصاص دهید.
- سپس اندازه واترمارک و متن را تنظیم کنید.
- پس از آن، با فراخوانی متد CreateViewRequest با آرگومان viewOptions، یک درخواست view ایجاد کنید.
- در نهایت، متد ViewApi.createView را با CreateViewRequest به عنوان آرگومان برای رندر HTML فراخوانی کنید.
نمونه کد زیر نحوه نمایش داده های اکسل در HTML با واترمارک با استفاده از REST API در Node.js را نشان می دهد.
// این مثال کد نحوه رندر اکسل را در صفحه 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);
}
نمایش داده های اکسل در HTML با واترمارک با استفاده از Node.js
آنلاین را امتحان کنید
لطفاً ابزار رندر آنلاین رایگان اکسل زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/viewer/xlsx
نتیجه
در این مقاله یاد گرفتیم که چگونه داده های اکسل را به صورت HTML در فضای ابری نمایش دهیم. همچنین نحوه افزودن واترمارک به صفحات HTML ارائه شده با استفاده از Node.js را دیده ایم. این مقاله همچنین نحوه آپلود برنامه‌نویسی یک فایل XLSX را در فضای ابری و سپس دانلود فایل HTML رندر شده از Cloud را توضیح داد. علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Viewer Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس بگیرید17.