شما به راحتی می توانید داده های Microsoft Excel را به صورت HTML در فضای ابری مشاهده کنید. ممکن است نمایش داده ها به ذینفعان مربوطه را بدون به اشتراک گذاشتن فایل های واقعی داده اکسل با آنها تسهیل کند. بهعنوان یک توسعهدهنده پایتون، میتوانید دادههای صفحهگسترده را از فایلهای XLS یا XLSX در HTML بهصورت برنامهنویسی بر روی ابر ارائه دهید. این مقاله بر نحوه ارائه داده های اکسل به HTML با استفاده از REST API در پایتون تمرکز خواهد داشت.
Document Viewer REST API و Python SDK
برای رندر کردن صفحات گسترده XLS یا XLSX، از Python SDK of GroupDocs.Viewer Cloud API استفاده خواهم کرد. این امکان را به شما می دهد تا انواع اسناد محبوب و فرمت های فایل تصویری را بصورت برنامه نویسی و مشاهده کنید. همچنین SDK های .NET، جاوا، PHP، Ruby، Android و Node.js را به عنوان [اعضای خانواده نمایشگر اسناد4 برای Cloud API ارائه می دهد.
می توانید GroupDocs.Viewer Cloud را در پروژه پایتون خود با استفاده از دستور زیر در کنسول نصب کنید:
pip install groupdocs_viewer_cloud
لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز مشتری خود را از داشبورد دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کدی را که در زیر نشان داده شده است اضافه کنید:
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
my_storage = ""
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
داده های اکسل را با استفاده از یک REST API در پایتون به HTML ارائه دهید
میتوانید با دنبال کردن مراحل ساده زیر، دادههای صفحهگسترده مایکروسافت اکسل را در HTML ارائه دهید:
- آپلود فایل XLSX را در Cloud
- رندر اکسل به HTML
- اکسل را با واترمارک به HTML ارائه دهید
- دانلود فایل PDF رندر شده
سند را آپلود کنید
ابتدا فایل XLSX را با استفاده از نمونه کد زیر در Cloud آپلود کنید:
# نمونه ای از API ایجاد کنید
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
request = groupdocs_viewer_cloud.UploadFileRequest("sample.xlsx", "C:\\Files\\sample.xlsx", my_storage)
response = file_api.upload_file(request)
در نتیجه، فایل sample.xlsx در فضای ذخیرهسازی ابری آپلود میشود و در بخش فایلها داشبورد شما در دسترس خواهد بود.
اکسل را به HTML در پایتون رندر کنید
لطفاً مراحل ذکر شده در زیر را دنبال کنید تا داده های اکسل را به صورت برنامه نویسی به HTML ارائه دهید.
- یک نمونه از [View API] ایجاد کنید (https://apireference.groupdocs.cloud/viewer/#/View/)
- ViewOptions را تعریف کنید
- مسیر فایل و فرمت نمایش را به عنوان “HTML” تنظیم کنید
- RenderOptions را به عنوان HtmlOptions تنظیم کنید
- در صورت وجود گزینههای رندر صفحهگسترده را تعریف کنید
- با فراخوانی متد CreateViewRequest یک درخواست view ایجاد کنید
- با فراخوانی روش createview پاسخ دریافت کنید
قطعه کد زیر نحوه ارائه داده های صفحه گسترده اکسل را با استفاده از REST API به HTML نشان می دهد.
# نمونه ای از API ایجاد کنید
api_instance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های View را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.xlsx"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
# گزینه های رندر صفحه گسترده را تعریف کنید
view_options.render_options.spreadsheet_options = groupdocs_viewer_cloud.SpreadsheetOptions()
view_options.render_options.spreadsheet_options.paginate_sheets = False
# درخواست را آماده کنید
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
# تبدیل
response = api_instance.create_view(request)
به طور پیش فرض، یک کاربرگ در یک صفحه نمایش داده می شود. شما می توانید رندر اکسل را با اعمال گزینه های زیر سفارشی کنید:
- یک کاربرگ اکسل را به چندین صفحه ارائه دهید
view_options.render_options.spreadsheet_options.paginate_sheets = True
view_options.render_options.spreadsheet_options.count_rows_per_page = 45
- نمایش خطوط شبکه در HTML
view_options.render_options.spreadsheet_options.render_grid_lines = True
- سطرها و ستون های خالی را رندر کنید
view_options.render_options.spreadsheet_options.render_empty_rows = True
view_options.render_options.spreadsheet_options.render_empty_columns = True
- نمایش سطرها و ستون های پنهان
view_options.render_options.spreadsheet_options.render_hidden_columns = True
view_options.render_options.spreadsheet_options.render_hidden_rows = True
- فقط منطقه چاپ را رندر کنید
view_options.render_options.spreadsheet_options.render_print_area_only = True
- حالت سرریز متن را تنظیم کنید
view_options.render_options.spreadsheet_options.text_overflow_mode = "HideText"
اکسل را با واترمارک به HTML ارائه دهید
لطفاً مراحل ذکر شده در زیر را برای افزودن متن واترمارک در حین رندر کردن دادههای اکسل به HTML به صورت برنامهنویسی دنبال کنید.
- یک نمونه از [View API] ایجاد کنید (https://apireference.groupdocs.cloud/viewer/#/View/)
- ViewOptions را تعریف کنید
- مسیر فایل و view\ format را به عنوان “HTML” تنظیم کنید
- گزینه مشاهده واترمارک را تعریف کنید
- متن و اندازه واترمارک را تنظیم کنید
- با فراخوانی متد CreateViewRequest یک درخواست view ایجاد کنید
- با فراخوانی روش create\view پاسخ دریافت کنید
قطعه کد زیر نحوه افزودن متن واترمارک به HTML ارائه شده با استفاده از REST API را نشان می دهد.
# نمونه ای از API ایجاد کنید
api_instance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های View را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.xlsx"
view_options.view_format = "HTML"
# اضافه کردن واترمارک
view_options.watermark = groupdocs_viewer_cloud.Watermark()
view_options.watermark.size = 70
view_options.watermark.text = "This is a watermark"
# درخواست را آماده کنید
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
# تبدیل
response = api_instance.create_view(request)
فایل به روز شده را دانلود کنید
نمونه کد بالا فایل HTML ارائه شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر می توانید آنها را دانلود کنید:
# نمونه ای از API ایجاد کنید
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
for page in response.pages:
# صفحه HTML را دانلود کنید
request = groupdocs_viewer_cloud.DownloadFileRequest(page.path, my_storage)
response = file_api.download_file(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Html\\")
آنلاین را امتحان کنید
لطفاً ابزار رندر صفحه گسترده آنلاین رایگان زیر را که با استفاده از API بالا توسعه داده شده است، امتحان کنید. https://products.groupdocs.app/viewer/xlsx
نتیجه
در این مقاله، نحوه رندر کردن داده های صفحه گسترده اکسل را به HTML در فضای ابری با Document Viewer REST API با استفاده از پایتون آموختید. همچنین یاد گرفتید که چگونه فایل XLSX را به صورت برنامهنویسی در فضای ابری آپلود کنید و سپس فایلهای HTML ارائهشده را از ابر دانلود کنید. با استفاده از مستندات میتوانید درباره GroupDocs.Viewer Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه میکنیم که به شما امکان میدهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید14.