Tablo verilerini görsel varlıklara dönüştürmek, gösterge panoları, raporlar veya otomatik e-posta özetleri oluştururken sıkça ihtiyaç duyulan bir gereksinimdir. GroupDocs.Conversion Cloud SDK for Python yüksek kaliteli JPG görüntüleri olarak CSV satırlarını işlemek için ağır işi üstlenen sağlam bir kütüphane sağlar. Bu rehberde SDK’yı nasıl kuracağınızı, özlü bir betik yazmayı, asenkron senaryolar için cURL ile REST API’yi çağırmayı ve hızlı, otomatik raporlama için dönüşüm seçeneklerini nasıl ince ayar yapacağınızı öğreneceksiniz.
CSV’den JPG Dönüştürmesinin Uygulamanızdan Gerektirdiği Şartlar
Veri odaklı uygulamalar geliştiren geliştiriciler genellikle CSV raporlarını PDF’lerde, PowerPoint slaytlarında veya web sayfalarında gömülebilecek statik görüntülere dönüştürmeleri gerekir. İş akışı tipik olarak şunları gerektirir:
- Görsel boyutları ve kenar boşlukları üzerinde hassas kontrol, böylece tablolar farklı çıktı ortamlarında tutarlı görünür.
- Büyük CSV dosyalarını belleği tüketmeden işleme yeteneği, bu da dönüşüm kütüphanesinin satırları verimli bir şekilde akıtması gerektiği anlamına gelir.
- Toplu işleme için otomasyon desteği, tek bir işte onlarca ya da yüzlerce CSV dosyasının dönüştürülmesine olanak tanır.
Manuel ekran görüntüsü alma veya genel görüntü kütüphanelerini kullanma, CSV şeması değiştiğinde veya işlemi GUI’siz bir sunucuda çalıştırmanız gerektiğinde özellikle kırılgan ve bakımı zor hale gelir.
GroupDocs.Conversion Cloud SDK for Python, CSV’den JPG Dönüşümüne Nasıl Uyum Sağlar
SDK, GroupDocs depolama alanında saklanan bir CSV dosyasını kabul eden ve yapılandırılabilir yazı tipleri, sayfa boyutu ve kenar boşluklarıyla oluşturulan JPG görüntüleri döndüren bulut tabanlı bir dönüştürme motoru sunar. Gereksinimlerle eşleşen temel yetenekler şunlardır:
- Configurable
CsvConvertOptions- sayfa genişliği, yüksekliği, kenar boşlukları, yazı tipi adı ve boyutunu görsel tasarımınıza uygun şekilde ayarlayın. - Batch processing support - API, tek bir istekte birden fazla dosyayı işleyebilir, otomatik boru hatları için idealdir.
- Async REST endpoints - bir dönüşüm işi başlatın ve tamamlanmayı sorgulayın, web hizmetlerinde engellemeyen iş akışlarını etkinleştirir.
Python istemci kitaplığı ile birlikte, bu özellikleri sadece birkaç satır kodla entegre edebilirsiniz. Ayrıntılı kullanım, resmi belgelerde ve API referansında açıklanmıştır.
Python’da CSV’den JPG’ye Dönüştürme: Uygulama
SDK ve Bağımlılıkları Kur
İlk olarak, GroupDocs Conversion Cloud kütüphanesini ve yerel test için ihtiyaç duyabileceğiniz isteğe bağlı paketleri kurun.
pip install groupdocs-conversion-cloud
Python ile birlikte gelen standart os modülüne de ihtiyacınız var.
Kimlik Doğrulama Bilgilerini Yapılandırma
İstemci kimliğiniz ve gizli anahtarınızla bir yapılandırma nesnesi oluşturun. Bu, her API çağrısını kimlik doğrular.
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)
Daha fazla ayrıntı için, Configuration için API referansı adresine bakın.
CSV’den JPG’ye Dönüşüm Ayarlarını Tanımlama
Kaynak dosyayı, çıktı formatını ve CSV‑özel işleme seçeneklerini ayarlayın.
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` sınıfı [API referansında](https://reference.groupdocs.cloud/conversion/#csvconvertoptions) belgelenmiştir.
### Dönüştürme İsteğini Çalıştır
Bir istek nesnesi oluşturun ve dönüştürme metodunu çağırın.
<!--[CODE_SNIPPET_START]-->
```python
request = ConvertDocumentRequest(settings)
result_files = convert_api.convert_document(request)
<!--[CODE_SNIPPET_END]-->
Yöntem, oluşturulan JPG görüntüleri için dosya tanımlayıcılarının bir listesini döndürür.
### Sonuç Dosyalarını İnceleyin
Oluşturulan görüntülerin yollarını yazdırarak işlemi doğrulayın.
```python
print(f"CSV to JPG conversion completed. Files saved in '{output_dir}':")
for file_info in result_files:
print(f" - {file_info.path}")
Dönüştürme tamamlandığında, görüntüleri raporlama hattınıza taşıyabilir veya görüntü‑düzenleme araçlarıyla daha fazla işleyebilirsiniz.
Tam Kod Örneği: Python’da CSV’den JPG’ye Dönüştürme Betiği
Aşağıdaki kod, yukarıda açıklanan tam uçtan uca süreci gösterir.
import os
from groupdocs_conversion_cloud import (
ConvertApi,
ConvertSettings,
ConvertDocumentRequest,
ApiClient,
Configuration
)
from groupdocs_conversion_cloud.models import CsvConvertOptions
——————– Yapılandırma ——————–
Gerçek GroupDocs Conversion Cloud kimlik bilgilerinizi buraya ekleyin
configuration = Configuration() configuration.client_id = “YOUR_CLIENT_ID” configuration.client_secret = “YOUR_CLIENT_SECRET”
api_client = ApiClient(configuration) convert_api = ConvertApi(api_client)
——————– Dosya Yolları ——————–
input_csv = “sample.csv” # Kaynak CSV dosyasının yolu output_dir = “converted_images” # JPG’lerin kaydedileceği dizin
Çıktı dizininin mevcut olduğundan emin olun
os.makedirs(output_dir, exist_ok=True)
——————– Dönüştürme Ayarları ——————–
settings = ConvertSettings() settings.file_path = input_csv # Depolamadaki kaynak dosya settings.format = “jpg” # İstenen çıktı formatı settings.output_path = output_dir # Depolamadaki hedef klasör
Görüntü görünümü ve performansını kontrol etmek için CSV‑özel seçenekler
csv_options = CsvConvertOptions() csv_options.page_width = 1024 # Oluşturulan görüntünün genişliği (piksel) csv_options.page_height = 768 # Oluşturulan görüntünün yüksekliği (piksel) csv_options.margin = 10 # Tablo etrafındaki kenar boşluğu (piksel) csv_options.font_name = “Arial” # Metin işleme için kullanılan yazı tipi csv_options.font_size = 12 # Yazı tipi boyutu (puan)
settings.convert_options = csv_options
——————– Dönüşümü Yürüt ——————–
request = ConvertDocumentRequest(settings) result_files = convert_api.convert_document(request)
——————– Sonuç Çıktısı ——————–
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]-->
> **Not:** Bu kod örneği temel işlevselliği göstermektedir. Projenizde kullanmadan önce dosya yollarını (`input.csv`, `output_dir` vb.) gerçek dosya konumlarınıza göre güncellediğinizden, tüm gerekli bağımlılıkların doğru şekilde yüklendiğinden emin olun ve geliştirme ortamınızda kapsamlı bir şekilde test edin. Herhangi bir sorunla karşılaşırsanız, lütfen [resmi belgeler](https://docs.groupdocs.cloud/conversion/) sayfasına bakın veya [destek ekibi](https://forum.groupdocs.cloud/c/conversion/11) ile iletişime geçin.
## CSV'den JPG'ye Dönüştürme – REST API ile cURL Kullanarak Asenkron
Bloklamayan işlem gerektiğinde, REST API bir asenkron iş başlatmanıza ve durumunu sorgulamanıza olanak tanır.
1. **Kimlik Doğrulama ve Erişim Token'ı Alın**
```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"}'
- Kaynak CSV Dosyasını Yükleyin
curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@sample.csv"
- Asenkron Dönüştürme İşini Başlatın
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
}
}'
Yanıt, ilerlemeyi kontrol etmek için kullanabileceğiniz bir jobId içerir.
- İşin Tamamlanmasını Sorgulayın
curl -X GET "https://api.groupdocs.cloud/v2.0/conversion/jobs/JOB_ID/status" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
- Oluşturulan JPG Dosyalarını İndirin
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/converted_images/result.jpg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o result.jpg
Tam referans için resmi API belgelerine bakın.
CSV’den JPG’ye Dönüştürme – Pandas Seçenekleri ve Ayarları
Dönüştürmeden önce CSV verilerini pandas ile ön işleme tabi tutmak isterseniz, SDK seçeneklerini buna göre ayarlayabilirsiniz.
- Özel Sayfa Boyutu – Daha büyük sayfalar daha fazla sütun barındırabilir.
csv_options.page_width = 1280
csv_options.page_height = 960
- Yazı Tipi Özelleştirme – Kurumsal stilinize uygun bir yazı tipi kullanın.
csv_options.font_name = "Calibri"
csv_options.font_size = 14
- Kenar Boşluğu Ayarı – Kullanılabilir alanı maksimize etmek için kenar boşluklarını azaltın.
csv_options.margin = 5
Bu özellikler, API referansında belgelenen CsvConvertOptions sınıfının bir parçasıdır.
Sonuç
Python’da CSV’den JPG’ye dönüşüm, GroupDocs.Conversion Cloud SDK for Python sayesinde oldukça basittir. Yukarıdaki adımları izleyerek görüntü üretimini otomatikleştirebilir, asenkron işleme entegre edebilir ve performansı artırmak için render ayarlarını ince ayar yapabilirsiniz. Üretim ortamı için geçerli bir lisans almayı unutmayın; fiyatlandırma seçeneklerini ürün sayfasında inceleyebilir ve geçici bir lisans için geçici lisans sayfasından faydalanabilirsiniz. CSV raporlarınızı bugün dönüştürmeye başlayın ve görsel analiz iş akışınızı zenginleştirin.
SSS
Python’da GroupDocs.Conversion Cloud SDK ile CSV’den JPG’ye dönüşüm nasıl çalışır?
SDK, CSV dosyasını depodan okur, her satırı CsvConvertOptions ayarlarınıza göre bir JPG görüntüsü olarak render eder ve görüntü dosyalarını döndürür. İşlem GroupDocs sunucularında gerçekleşir, bu nedenle yerel bir render motoruna ihtiyaç duyulmaz.
Python’da CSV’den JPG’ye dönüşümü asenkron olarak çalıştırabilir miyim?
Evet. cURL bölümünde gösterildiği gibi REST API’nin asenkron uç noktalarını kullanın. Bir dönüşüm işi başlatın, bir jobId alın ve iş tamamlanana kadar durumu sorgulayarak uygulamanızın yanıt verebilir kalmasını sağlayın.
Büyük CSV dosyaları için performansı artıran dönüşüm seçenekleri nelerdir?page_width, page_height ve margin ayarlarını optimize etmek, her görüntünün içermesi gereken veri miktarını azaltır. font_size değerini düşürmek de render süresini hızlandırabilir. Çok büyük dosyalar için verileri partiler halinde işleyin ve işi paralelleştirmek amacıyla asenkron API’yı kullanın.
SDK’yı üretimde kullanmak için lisansa ihtiyacım var mı?
Üretim ortamları için geçerli bir lisans zorunludur. Ürün sayfasından bir abonelik satın alabilir veya değerlendirme amacıyla geçici lisans sayfasından geçici bir lisans talep edebilirsiniz.