تحويل البيانات الجدولية إلى أصول بصرية هو مطلب شائع عند بناء لوحات التحكم، التقارير، أو ملخصات البريد الإلكتروني الآلية. GroupDocs.Conversion Cloud SDK for Python يوفر مكتبة قوية تتعامل مع الجزء الثقيل من عملية تحويل صفوف CSV إلى صور JPG عالية الجودة. في هذا الدليل ستتعلم كيفية إعداد SDK، كتابة سكريبت مختصر، استدعاء واجهة REST API باستخدام cURL لسيناريوهات غير المتزامنة، وضبط خيارات التحويل بدقة للحصول على تقارير سريعة وآلية.

ما تتطلبه عملية تحويل CSV إلى JPG من تطبيقك

غالبًا ما يحتاج المطورون الذين يبنون تطبيقات تعتمد على البيانات إلى تحويل تقارير CSV إلى صور ثابتة يمكن تضمينها في ملفات PDF أو شرائح PowerPoint أو صفحات الويب. عادةً ما يتطلب سير العمل ما يلي:

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

التقاط لقطات الشاشة يدويًا أو استخدام مكتبات الصور العامة يصبح سريعًا هشًا وصعب الصيانة، خاصةً عندما يتغير مخطط CSV أو عندما تحتاج إلى تشغيل العملية على خادم بدون واجهة رسومية.

كيف يتناسب GroupDocs.Conversion Cloud SDK for Python مع تحويل CSV إلى JPG

يوفر SDK محرك تحويل سحابي يقبل ملف CSV مخزن في تخزين GroupDocs ويعيد صور JPG مُصدَّرة بخطوط قابلة للتكوين، وحجم الصفحة، والهوامش. القدرات الرئيسية التي تتطابق مع المتطلبات هي:

  • قابل للتكوين CsvConvertOptions - ضبط عرض الصفحة، الارتفاع، الهوامش، اسم الخط، وحجمه لتتناسب مع التصميم البصري الخاص بك.
  • دعم المعالجة الدفعية - يمكن للواجهة البرمجية التعامل مع ملفات متعددة في طلب واحد، وهو مثالي لسلاسل الأنابيب الآلية.
  • نقاط النهاية REST غير المتزامنة - ابدأ مهمة تحويل وقم بالاستطلاع للتحقق من الانتهاء، مما يتيح سير عمل غير محجوب في خدمات الويب.

مع مكتبة عميل بايثون، يمكنك دمج هذه الميزات ببضع أسطر من الشيفرة فقط. يتم وصف الاستخدام التفصيلي في الوثائق الرسمية ومرجع API.

تحويل CSV إلى JPG في بايثون: التنفيذ

تثبيت SDK والاعتمادات

أولاً، قم بتثبيت مكتبة GroupDocs Conversion Cloud وأي حزم اختيارية قد تحتاجها للاختبار المحلي.

pip install groupdocs-conversion-cloud

ستحتاج أيضًا إلى وحدة os القياسية، والتي يتم تضمينها مع بايثون.

تكوين بيانات الاعتماد للمصادقة

أنشئ كائن تكوين باستخدام معرف العميل والسر. هذا يصدق كل استدعاء API.

from groupdocs_conversion_cloud import Configuration, ApiClient

configuration = Configuration() configuration.client_id = “YOUR_CLIENT_ID” configuration.client_secret = “YOUR_CLIENT_SECRET”

api_client = ApiClient(configuration)

لمزيد من التفاصيل، راجع مرجع API لـ Configuration.

تحديد إعدادات التحويل من CSV إلى JPG

حدد ملف المصدر، وتنسيق الإخراج، وخيارات العرض الخاصة بـ CSV.

from groupdocs_conversion_cloud import ConvertApi, ConvertSettings, ConvertDocumentRequest, CsvConvertOptions

convert_api = ConvertApi(api_client)

input_csv = "sample.csv"
output_dir = "converted_images"

settings = ConvertSettings()
settings.file_path = input_csv
settings.format = "jpg"
settings.output_path = output_dir

csv_options = CsvConvertOptions()
csv_options.page_width = 1024
csv_options.page_height = 768
csv_options.margin = 10
csv_options.font_name = "Arial"
csv_options.font_size = 12

settings.convert_options = csv_options

<!--[CODE_SNIPPET_END]-->

تم توثيق الفئة `CsvConvertOptions` في [مرجع API](https://reference.groupdocs.cloud/conversion/#csvconvertoptions).

### تنفيذ طلب التحويل

إنشاء كائن طلب واستدعاء طريقة التحويل.

<!--[CODE_SNIPPET_START]-->
```python
request = ConvertDocumentRequest(settings)
result_files = convert_api.convert_document(request)

<!--[CODE_SNIPPET_END]-->

ترجع الطريقة قائمة بأوصاف الملفات للصور JPG التي تم إنشاؤها.

### مراجعة ملفات النتائج

اطبع مسارات الصور التي تم إنشاؤها للتحقق من العملية.

```python
print(f"CSV to JPG conversion completed. Files saved in '{output_dir}':")
for file_info in result_files:
    print(f" - {file_info.path}")

مع اكتمال التحويل، يمكنك الآن نقل الصور إلى خط أنابيب التقارير الخاص بك أو معالجتها لاحقًا باستخدام أدوات تحرير الصور.

مثال كامل على الكود: برنامج تحويل CSV إلى JPG باستخدام Python

الكود التالي يوضح العملية الكاملة من البداية إلى النهاية كما هو موضح أعلاه.

import os
from groupdocs_conversion_cloud import (
    ConvertApi,
    ConvertSettings,
    ConvertDocumentRequest,
    ApiClient,
    Configuration
)
from groupdocs_conversion_cloud.models import CsvConvertOptions

——————– التكوين ——————–

استبدل ببيانات اعتماد GroupDocs Conversion Cloud الفعلية الخاصة بك

configuration = Configuration() configuration.client_id = “YOUR_CLIENT_ID” configuration.client_secret = “YOUR_CLIENT_SECRET”

api_client = ApiClient(configuration) convert_api = ConvertApi(api_client)

——————– مسارات الملفات ——————–

input_csv = “sample.csv” # المسار إلى ملف CSV المصدر output_dir = “converted_images” # الدليل حيث سيتم حفظ ملفات JPG

تأكد من وجود دليل الإخراج

os.makedirs(output_dir, exist_ok=True)

——————– إعدادات التحويل ——————–

settings = ConvertSettings() settings.file_path = input_csv # ملف المصدر في التخزين settings.format = “jpg” # تنسيق الإخراج المطلوب settings.output_path = output_dir # مجلد الوجهة في التخزين

خيارات CSV‑المحددة للتحكم في مظهر الصورة والأداء

csv_options = CsvConvertOptions() csv_options.page_width = 1024 # عرض الصورة المولدة (بكسل) csv_options.page_height = 768 # ارتفاع الصورة المولدة (بكسل) csv_options.margin = 10 # الهوامش حول الجدول (بكسل) csv_options.font_name = “Arial” # الخط المستخدم في عرض النص csv_options.font_size = 12 # حجم الخط (نقطة)

settings.convert_options = csv_options

——————– تنفيذ التحويل ——————–

request = ConvertDocumentRequest(settings) result_files = convert_api.convert_document(request)

——————– نتيجة الإخراج ——————–

print(f"CSV to JPG conversion completed. Files saved in ‘{output_dir}’:") for file_info in result_files: print(f" - {file_info.path}")

<!--[COMPLETE_CODE_SNIPPET_END]-->

> **ملاحظة:** يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث مسارات الملفات (`input.csv`، `output_dir`، إلخ) لتتناسب مع المواقع الفعلية للملفات لديك، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر الشيفرة بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشكلات، يرجى الرجوع إلى [الوثائق الرسمية](https://docs.groupdocs.cloud/conversion/) أو التواصل مع [فريق الدعم](https://forum.groupdocs.cloud/c/conversion/11) للحصول على المساعدة.

## تحويل CSV إلى JPG بشكل غير متزامن عبر REST API باستخدام cURL

عند الحاجة إلى معالجة غير محجوبة، يتيح لك REST API بدء مهمة تحويل غير متزامنة ومتابعة حالتها.

1. **المصادقة والحصول على رمز الوصول**

```bash
   curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. رفع ملف CSV المصدر
   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@sample.csv"
  1. بدء مهمة التحويل غير المتزامنة
   curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/jobs" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "sourceFilePath":"sample.csv",
              "outputPath":"converted_images/",
              "format":"jpg",
              "options":{
                  "pageWidth":1024,
                  "pageHeight":768,
                  "margin":10,
                  "fontName":"Arial",
                  "fontSize":12
              }
            }'

تحتوي الاستجابة على jobId يمكنك استخدامه للتحقق من التقدم.

  1. التحقق من إكمال المهمة
   curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/jobs/JOB_ID/status" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  1. تنزيل ملفات JPG التي تم إنشاؤها
   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/converted_images/result.jpg" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o result.jpg

للحصول على مرجع كامل، راجع وثائق API الرسمية.

خيارات وإعدادات تحويل CSV إلى JPG باستخدام Pandas

إذا كنت تفضل معالجة بيانات CSV مسبقًا باستخدام pandas قبل التحويل، يمكنك تعديل خيارات SDK وفقًا لذلك.

  • حجم الصفحة المخصص – الصفحات الأكبر تستوعب أعمدة أكثر.
   csv_options.page_width = 1280
   csv_options.page_height = 960
  • تخصيص الخط – استخدم خطًا يتماشى مع نمط شركتك.
   csv_options.font_name = "Calibri"
   csv_options.font_size = 14
  • تعديل الهوامش – قلل الهوامش لتعظيم مساحة الاستخدام.
   csv_options.margin = 5

هذه الخصائص جزء من الفئة CsvConvertOptions الموضحة في مرجع API.

الخلاصة

يصبح تحويل CSV إلى JPG في Python بسيطًا مع GroupDocs.Conversion Cloud SDK for Python. باتباع الخطوات أعلاه، يمكنك أتمتة إنشاء الصور، دمج المعالجة غير المتزامنة، وضبط خيارات العرض لتحقيق أفضل أداء. تذكر تأمين ترخيص مناسب للاستخدام في بيئة الإنتاج؛ يمكنك استكشاف خيارات التسعير على صفحة المنتج والحصول على ترخيص مؤقت من صفحة الترخيص المؤقت. ابدأ بتحويل تقارير CSV إلى صور اليوم و enrich تحليلاتك البصرية.

الأسئلة الشائعة

كيف يعمل تحويل CSV إلى JPG في Python باستخدام GroupDocs.Conversion Cloud SDK؟
يقوم SDK بقراءة ملف CSV من التخزين، ويعرض كل صف كصورة JPG بناءً على CsvConvertOptions التي تحددها، ثم يُعيد ملفات الصور. تُجرى العملية على خوادم GroupDocs، لذا لا يلزم وجود محرك عرض محلي.

هل يمكن تشغيل تحويل CSV إلى JPG بشكل غير متزامن في Python؟
نعم. استخدم نقاط النهاية غير المتزامنة لواجهة REST كما هو موضح في قسم cURL. ابدأ مهمة تحويل، احصل على jobId، وتابع الحالة حتى تكتمل المهمة، مما يسمح لتطبيقك بالبقاء مستجيبًا.

ما الخيارات التي تحسن الأداء عند تحويل ملفات CSV الكبيرة؟
تعديل page_width و page_height و margin يقلل من كمية البيانات التي يجب أن تحتويها كل صورة. خفض font_size يمكن أن يسرّع عملية العرض أيضًا. للملفات الضخمة، يُنصح بالمعالجة على دفعات واستخدام API غير المتزامن لتوزيع العمل.

هل أحتاج إلى ترخيص لاستخدام SDK في الإنتاج؟
يتطلب الاستخدام في بيئات الإنتاج ترخيصًا صالحًا. يمكنك شراء اشتراك من صفحة المنتج أو طلب ترخيص مؤقت للتقييم من صفحة الترخيص المؤقت.

اقرأ المزيد