Excel çalışma kitaplarından ham metin çıkarmak, veri boru hatları oluştururken veya basit raporlar üretirken sıkça ihtiyaç duyulan bir durumdur. Eğer Python’da Excel Çalışma Kitabını metne nasıl dönüştüreceğinizi öğrenmeniz gerekiyorsa, GroupDocs.Conversion Cloud SDK for Python bunu basitleştirir. Bu kılavuz, SDK’yı kurma, bir çalışma kitabı yükleme, dönüşüm seçeneklerini yapılandırma ve düz TXT sonucunu alma adımlarını size gösterir. Sonunda, yeniden kullanılabilir bir betiğe ve REST‑tabanlı otomasyon için bir dizi cURL komutuna sahip olacaksınız.

Başlamadan Önce: Gereksinimler ve Kurulum

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

  • Makinenizde yüklü Python 3.7 veya daha yeni bir sürüm.
  • Aktif bir GroupDocs Cloud hesabı (client ID ve client secret).
  • GroupDocs Cloud uç noktalarına ağ erişimi.

pip aracılığıyla SDK’yı kurun:

pip install groupdocs-conversion-cloud

En son paketi ayrıca resmi sürüm sayfası üzerinden indirebilirsiniz. Kurulumdan sonra, kimlik bilgilerinizi ortam değişkenleri olarak ayarlayın veya daha sonra koddaki yer tutucuları değiştirin. SDK hazır olduğunda, dönüşüm sürecine başlamaya hazırsınız.

Adım Adım Oluşturma: Python’da Excel Çalışma Kitabını Metne Dönüştürme

Adım 1: Kimlik Bilgilerini Yapılandırın

İlk olarak, bir Configuration nesnesi oluşturun ve istemci kimliğinizi ve gizlinizi sağlayın. Bu nesne, sonraki tüm API çağrıları tarafından kullanılır.

import os
from groupdocs_conversion_cloud import Configuration

client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
config.client_id = client_id
config.client_secret = client_secret

Configuration sınıfı API referansında belgelenmiştir.

Adım 2: Excel Çalışma Kitabını Yükle

Yerel Excel dosyasını GroupDocs Cloud depolama alanına yükleyin. Dosyanız zaten bulutta ise bu adım isteğe bağlıdır.

from groupdocs_conversion_cloud import ApiClient, UploadFileApi, UploadFileRequest

api_client = ApiClient(config)
upload_api = UploadFileApi(api_client)

local_excel_path = "sample.xlsx"
remote_excel_path = "sample.xlsx"

with open(local_excel_path, "rb") as f:
    upload_request = UploadFileRequest(
        path=remote_excel_path,
        file=f.read()
    )
    upload_api.upload_file(upload_request)

UploadFileApi dosya transferlerini yönetir; daha fazla ayrıntı için belgelerine bakın.

Adım 3: Dönüşüm Seçeneklerini Tanımla

Sayfa aralığı gibi isteğe bağlı parametreleri belirtmek için bir TxtConvertOptions nesnesi oluşturun. Ardından her şeyi bir araya getiren ConvertSettings nesnesini oluşturun.

from groupdocs_conversion_cloud import (
    FileInfo,
    TxtConvertOptions,
    ConvertSettings,
)

file_info = FileInfo()
file_info.file_path = remote_excel_path

txt_options = TxtConvertOptions()
# txt_options.page_number = 1   # Uncomment to start from a specific page
# txt_options.page_count = 1    # Uncomment to limit the number of pages

convert_settings = ConvertSettings()
convert_settings.file_info = file_info
convert_settings.format = "txt"
convert_settings.output_path = "sample.txt"
convert_settings.options = txt_options

TxtConvertOptions sınıfı, dönüşümü ince ayar yapmanıza olanak tanır; tüm kullanılabilir alanlar için resmi belgeler adresine bakın.

Adım 4: Dönüştürmeyi Gerçekleştir

Hazırlanan ayarlarla ConvertApi‘nin convert metodunu çağırın. Yanıt, dönüştürülen dosyayı indirmek için bir URL içerir.

from groupdocs_conversion_cloud import ConvertApi, ApiException

convert_api = ConvertApi(api_client)

try:
    conversion_result = convert_api.convert(convert_settings)
    print(f"Conversion succeeded. Download URL: {conversion_result.url}")
except ApiException as e:
    print(f"Conversion failed: {e}")

Çağrı başarılı olursa, TXT dosyası için doğrudan bir indirme bağlantısı alacaksınız.

Adım 5: Sonucu Al

Önceki adımdaki URL’yi kullanarak düz metin dosyasını yerel ortamınıza indirin veya uygulamanızda daha fazla işleyin.

İpucu: Aynı dönüşüm isteği için kullanılan erişim belirteciyle kimlik doğrulamayı ele alarak, basit bir requests.get() çağrısıyla indirmeyi otomatikleştirebilirsiniz.

Bu adımlarla, artık GroupDocs kütüphanesini kullanarak Python’da Excel Çalışma Kitabını metne nasıl dönüştüreceğiniz konusunda eksiksiz bir iş akışına sahipsiniz.

Excel Çalışma Kitabı Metin Dönüştürme - Tam Kod Örneği

Aşağıdaki örnek, baştan sona tam uygulamayı gösterir.

import os
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    UploadFileApi,
    UploadFileRequest,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    TxtConvertOptions,
    ApiException,
)

def main():
    # ----------------------------------------------------------------------
    # 1. Configure credentials (replace placeholders or set env variables)
    # ----------------------------------------------------------------------
    client_id = os.getenv("GROUPDOCS_CLIENT_ID", "YOUR_CLIENT_ID")
    client_secret = os.getenv("GROUPDOCS_CLIENT_SECRET", "YOUR_CLIENT_SECRET")

config = Configuration()
    config.client_id = client_id
    config.client_secret = client_secret

api_client = ApiClient(config)

# ----------------------------------------------------------------------
    # 2. Upload local Excel workbook to GroupDocs Cloud storage (optional)
    # ----------------------------------------------------------------------
    local_excel_path = "sample.xlsx"          # path to the Excel file on your machine
    remote_excel_path = "sample.xlsx"         # path where the file will be stored in the cloud

upload_api = UploadFileApi(api_client)
    try:
        with open(local_excel_path, "rb") as f:
            upload_request = UploadFileRequest(
                path=remote_excel_path,
                file=f.read()
            )
            upload_api.upload_file(upload_request)
        print(f"Uploaded '{local_excel_path}' to cloud storage as '{remote_excel_path}'.")
    except (ApiException, IOError) as e:
        print(f"Failed to upload file: {e}")
        return

# ----------------------------------------------------------------------
    # 3. Prepare conversion settings to transform Excel → plain text
    # ----------------------------------------------------------------------
    convert_api = ConvertApi(api_client)

file_info = FileInfo()
    file_info.file_path = remote_excel_path          # source file in cloud storage

txt_options = TxtConvertOptions()
    # (optional) you can limit conversion to specific pages:
    # txt_options.page_number = 1
    # txt_options.page_count = 1

convert_settings = ConvertSettings()
    convert_settings.file_info = file_info
    convert_settings.format = "txt"                  # target format
    convert_settings.output_path = "sample.txt"      # result file name in cloud storage
    convert_settings.options = txt_options

# ----------------------------------------------------------------------
    # 4. Execute conversion
    # ----------------------------------------------------------------------
    try:
        conversion_result = convert_api.convert(convert_settings)
        # The result contains a URL to download the converted file
        print(f"Conversion succeeded. Download URL: {conversion_result.url}")
    except ApiException as e:
        print(f"Conversion failed: {e}")

if __name__ == "__main__":
    main()

Not: Bu kod örneği temel işlevselliği gösterir. Projenizde kullanmadan önce, tüm dosya yollarını ve yapılandırma değerlerini gerçek ortamınıza uygun şekilde güncellediğinizden, gerekli tüm 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 dokümantasyon veya destek ekibi ile iletişime geçin.

cURL ve REST API Kullanarak Excel’den Metne Dönüştürme

Saf bir REST yaklaşımını tercih ediyorsanız, aynı dönüşüm cURL komutlarıyla gerçekleştirilebilir.

  1. Erişim belirteci alın
curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Kaynak Excel dosyasını yükleyin
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @sample.xlsx
  1. TXT’ye dönüşümü başlat
curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "sample.xlsx" },
           "format": "txt",
           "outputPath": "sample.txt",
           "options": {}
         }'
  1. Dönüştürülmüş TXT dosyasını indirin
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Bu komutlar kimlik doğrulamadan indirmeye kadar tam yaşam döngüsünü gösterir. Ek parametreler ve hata işleme için, API referansı adresine bakın.

Excel için Dönüştürme Ayarlarını Yapılandırma

SDK, çıktıyı özelleştirmek için çeşitli seçenekler sunar. Aşağıda Excel‑to‑TXT dönüşümü için en faydalı ayarlar yer almaktadır:

  • Sayfa Numarası - Dönüştürmeye belirli bir sayfa veya çalışma sayfasından başlayın.
txt_options.page_number = 1
  • Sayfa Sayısı - Dönüştürülecek sayfa/çalışma sayfası sayısını sınırlayın.
txt_options.page_count = 2
  • Çıktı Yolu - Bulut depolamada oluşturulan TXT dosyasının adını ve konumunu belirleyin.
convert_settings.output_path = "output/sample.txt"

API referansında encoding veya preserveFormatting gibi diğer gelişmiş seçenekler mevcuttur; tam gereksinimlerinize uyması için bunları keşfedin.

Son Düşünceler

Python’da bir Excel çalışma kitabını düz metne dönüştürmek artık GroupDocs.Conversion Cloud SDK for Python sayesinde basit ve tekrarlanabilir bir süreç. SDK, kimlik doğrulama, dosya depolama ve dönüşümü arka planda yönetir, böylece iş mantığına odaklanabilirsiniz. Üretime geçmeden önce değerlendirme amaçlı bir geçici lisans almayı ve fiyatlandırma sayfasındaki lisans seçeneklerini gözden geçirmeyi unutmayın. Sağlanan kod ve cURL örnekleriyle, Excel‑to‑TXT dönüşümünü herhangi bir Python‑tabanlı iş akışı veya mikro hizmete entegre edebilirsiniz.

Sık Sorulan Sorular

  • Python’da bir Excel çalışma kitabını metne dönüştürmenin en kolay yolu nedir?
    GroupDocs.Conversion Cloud SDK for Python’ı kullanın. REST çağrılarını soyutlar ve dosyaları yükleme, dönüştürme ve indirme için temiz bir Pythonic API sağlar.

  • Excel çalışma kitabının yalnızca belirli sayfalarını veya sayfalarını dönüştürebilir miyim?
    Evet. Belirli sayfaları hedeflemek için TxtConvertOptions nesnesinde page_number ve page_count ayarlayın. Tam detaylar için API referansı adresine bakın.

  • GroupDocs hesabına SDK’yı kullanmak için ihtiyacım var mı?
    Geçerli bir GroupDocs Cloud hesabı, istemci kimliği ve gizli anahtar ile gereklidir. Bir hesabı GroupDocs portalında oluşturabilir ve kimlik bilgilerini kontrol panelinden alabilirsiniz.

  • Excel’ten TXT’ye dönüşüm için dosya boyutu sınırlaması var mı?
    Bulut hizmeti, dönüşüm için 200 MB’a kadar dosyaları destekler. Daha büyük dosyalar, yüklemeden önce bölünmeli veya parçalara ayrılarak işlenmelidir.

Daha Fazla Okuma