اکسل را با استفاده از REST API در پایتون به CSV تبدیل کنید

در این مقاله، روش‌های مختلف سریع و کارآمد برای صادرات داده‌ها از اکسل به CSV در فضای ابری را بررسی خواهیم کرد. ما از فایل‌های اکسل برای نگهداری فاکتورها، دفتر کل، موجودی، حساب‌ها و سایر داده‌ها به صورت جدولی استفاده می‌کنیم. از سوی دیگر، یک فایل CSV (مقادیر جدا شده با کاما) داده های جدولی (اعداد و متن) را به صورت متن ساده ذخیره می کند و از کاما برای جداسازی مقادیر استفاده می کند. در CSV، هر خط در یک فایل یک رکورد داده است و هر رکورد شامل یک یا چند فیلد است که با کاما از هم جدا شده اند. تبدیل اکسل به CSV اجازه می دهد تا داده ها را به برنامه های دیگر وارد کنید. این مقاله بر روی نحوه تبدیل فایل‌های اکسل به CSV با استفاده از REST API در پایتون تمرکز دارد.

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

تبدیل Excel به CSV REST API و Python SDK

برای تبدیل XLSX به CSV، از Python SDK of GroupDocs.Conversion Cloud API استفاده خواهیم کرد. این به ما امکان می‌دهد اسناد و تصاویر را از هر فرمت فایل پشتیبانی شده به هر فرمتی که نیاز داریم تبدیل کنیم. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:

pip install groupdocs_converison_cloud

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

# مثال کد زیر نشان می دهد که چگونه می توان شناسه مشتری و رمز را در کد اضافه کرد.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"

configuration = groupdocs_conversion_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""

اکسل را با استفاده از REST API در پایتون به CSV تبدیل کنید

با دنبال کردن مراحل ساده زیر می‌توانیم به راحتی فایل‌های Excel را به CSV در فضای ابری تبدیل کنیم:

  1. آپلود فایل XLSX را در ابر.
  2. تبدیل اکسل به CSV.
  3. دانلود فایل CSV تبدیل شده.

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

ابتدا فایل XLSX را با استفاده از نمونه کد زیر در فضای ابری آپلود می کنیم:

# این مثال کد نحوه آپلود یک فایل XLSX را در فضای ابری نشان می دهد.
# یک نمونه از API ایجاد کنید
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# درخواست آپلود فایل
request = groupdocs_conversion_cloud.UploadFileRequest("Sample.xlsx", "C:\\Files\\Conversion\\Sample.xlsx", my_storage)

# فایل نمونه را آپلود کنید
response = file_api.upload_file(request)

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

تبدیل اکسل به CSV در پایتون

اکنون XLSX آپلود شده را با انجام مراحل زیر به صورت برنامه‌نویسی به CSV تبدیل می‌کنیم:

  • یک نمونه از ConvertApi ایجاد کنید.
  • شی ConvertSettings را راه اندازی کنید.
  • مسیر فایل XLSX را تنظیم کنید.
  • “csv” را به فرمت اختصاص دهید.
  • مسیر فایل خروجی را ارائه دهید.
  • ConvertDocumentRequest را با ConvertSettings ایجاد کنید.
  • با فراخوانی متد convert\document() تبدیل کنید.

نمونه کد زیر نحوه تبدیل فایل اکسل به CSV را با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه تبدیل اکسل به CSV را نشان می دهد.
# نمونه API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "Sample.xlsx"  # Input file
settings.format = "csv"             # Output format
settings.output_path = "output"     # Folder path to save converted file

# تبدیل درخواست سند
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# تبدیل سند
result = convert_api.convert_document(request)

# انجام شده
print("Document converted: " + result[0].path)
اکسل را با استفاده از REST API در پایتون به CSV تبدیل کنید.

اکسل را با استفاده از REST API در پایتون به CSV تبدیل کنید.

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

نمونه کد بالا فایل CSV تبدیل شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:

# این مثال کد نحوه دانلود CSV از ابر را نشان می دهد.
# مقداردهی اولیه API
file_api = groupdocs_conversion_cloud.FileApi.from_config(configuration)

# درخواست دانلود فایل
request = groupdocs_conversion_cloud.DownloadFileRequest("output/Sample.csv", my_storage)

# دریافت فایل
response = file_api.download_file(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Conversion\\")

تبدیل اکسل به CSV و دانلود مستقیم فایل

ما می توانیم XLSX را به CSV تبدیل کرده و فایل CSV تبدیل شده را مستقیماً با دنبال کردن مراحل زیر دانلود کنیم:

  • ابتدا یک نمونه از ConvertApi ایجاد کنید.
  • سپس ConvertSettings را تعریف کرده و مسیر فایل XLSX آپلود شده را تنظیم کنید.
  • سپس، “csv” را به فرمت اختصاص دهید.
  • مسیر فایل خروجی را به صورت None تنظیم کنید.
  • پس از آن، ConvertDocumentRequest را با ConvertSettings به عنوان آرگومان ایجاد کنید.
  • در نهایت، متد convert\document\download() را فراخوانی کنید تا فایل تبدیل شده روی دیسک محلی ذخیره شود.

نمونه کد زیر نحوه تبدیل فایل اکسل به CSV و دانلود مستقیم آن را با استفاده از REST API در پایتون نشان می دهد. API باید فایل CSV تبدیل شده را در پاسخ بازگرداند. لطفاً برای آپلود فایل مراحل ذکر شده قبلی را دنبال کنید.

# این مثال کد نحوه تبدیل اکسل به CSV و دانلود مستقیم فایل تبدیل شده را نشان می دهد.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.ConvertApi.from_keys(client_id, client_secret)

# تنظیمات تبدیل را آماده کنید
settings = groupdocs_conversion_cloud.ConvertSettings()
settings.file_path = "sample.xlsx"
settings.format = "csv"
settings.output_path = None    # leave OutputPath will result the output as document IOStream

# درخواست را آماده کنید
request = groupdocs_conversion_cloud.ConvertDocumentRequest(settings)

# تبدیل و دانلود کنید
response = convert_api.convert_document_download(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Conversion\\")

تبدیل اکسل به CSV بدون استفاده از فضای ذخیره سازی ابری

همچنین می‌توانیم با دنبال کردن مراحل زیر، یک فایل اکسل را بدون استفاده از فضای ذخیره‌سازی ابری به CSV تبدیل کنیم:

  • ابتدا یک نمونه از ConvertApi ایجاد کنید.
  • سپس، ConvertDocumentDirectRequest را با فرمت هدف ایجاد کنید و مسیر فایل XLSX را به عنوان آرگومان وارد کنید.
  • سپس، متد convert\document\direct() را با ConvertDocumentDirectRequest به عنوان آرگومان فراخوانی کنید.
  • در نهایت، فایل CSV خروجی تبدیل شده را با استفاده از روش FileStream.writeFile() در مسیر محلی ذخیره کنید.

نمونه کد زیر نحوه تبدیل XLSX به CSV را بدون استفاده از فضای ذخیره سازی ابری در پایتون نشان می دهد. یعنی فایل ورودی را در بدنه درخواست ارسال می کنیم و فایل خروجی را در پاسخ API دریافت می کنیم.

# این مثال کد نحوه تبدیل اکسل به CSV و بدون استفاده از فضای ذخیره سازی ابری را نشان می دهد.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)

# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentDirectRequest("csv", "C:\\Files\\Conversion\\sample.xlsx")

# تبدیل
result = convert_api.convert_document_direct(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(result, "C:\\Files\\Conversion\\")

CSV را با استفاده از REST API در پایتون به اکسل تبدیل کنید

ما همچنین می‌توانیم داده‌های جدا شده با کاما را از یک CSV به یک فایل Excel با فرمت خوب در فضای ابری صادر کنیم. برای تبدیل CSV به Excel، لطفا مراحل زیر را دنبال کنید:

  • ابتدا یک نمونه از ConvertApi ایجاد کنید.
  • سپس، ConvertDocumentDirectRequest را با فرمت هدف ایجاد کنید و مسیر فایل CSV را به عنوان آرگومان وارد کنید.
  • سپس، متد convert\document\direct() را با ConvertDocumentDirectRequest به عنوان آرگومان فراخوانی کنید.
  • در نهایت با استفاده از روش FileStream.writeFile() فایل خروجی XLSX تبدیل شده را در مسیر محلی ذخیره کنید.

نمونه کد زیر نحوه تبدیل CSV به فایل اکسل را با استفاده از REST API در پایتون نشان می دهد.

# این مثال کد نحوه تبدیل CSV به اکسل را نشان می دهد.
# نمونه های API لازم را ایجاد کنید
convert_api = groupdocs_conversion_cloud.تبدیلApi.from_keys(client_id, client_secret)

# درخواست را آماده کنید
request = groupdocs_conversion_cloud.تبدیلDocumentDirectRequest("xlsx", "C:\\Files\\Conversion\\sample.csv")

# تبدیل
result = convert_api.convert_document_direct(request)

# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(result, "C:\\Files\\Conversion\\")

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

لطفاً ابزارهای آنلاین رایگان تبدیل XLSX به CSV و CSV به XLSX را که با استفاده از API فوق توسعه داده شده اند، امتحان کنید.

نتیجه

در این مقاله یاد گرفتیم که چگونه:

  • تبدیل اکسل به CSV و CSV به اکسل در پایتون.
  • XLSX را به CSV تبدیل کنید و فایل تبدیل شده را مستقیما دانلود کنید.
  • تبدیل XLSX به CSV بدون استفاده از فضای ذخیره سازی ابری.
  • آپلود برنامه ای فایل XLSX در فضای ابری؛
  • فایل CSV را از ابر دانلود کنید.

علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Conversion Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می دهیم که به شما امکان می دهد API های ما را مستقیماً از طریق مرورگر تجسم کنید و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید15.

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