Das Extrahieren von Rohtext aus Excel‑Arbeitsmappen ist ein häufiger Bedarf beim Aufbau von Datenpipelines oder beim Erstellen einfacher Berichte. Wenn Sie wissen möchten wie man ein Excel‑Workbook in Python in Text konvertiert, macht das GroupDocs.Conversion Cloud SDK for Python das ganz einfach. Dieser Leitfaden führt Sie durch die Installation des SDK, das Hochladen einer Arbeitsmappe, die Konfiguration der Konvertierungsoptionen und das Abrufen des reinen TXT Ergebnisses. Am Ende haben Sie ein wiederverwendbares Skript und eine Reihe von cURL‑Befehlen für die REST‑basierte Automatisierung.

Bevor Sie beginnen: Voraussetzungen und Installation

Bevor Sie beginnen, stellen Sie sicher, dass Sie Folgendes haben:

  • Python 3.7 oder neuer auf Ihrem Rechner installiert.
  • Ein aktives GroupDocs Cloud-Konto (client ID und client secret).
  • Netzwerkzugriff auf die GroupDocs Cloud-Endpunkte.

Installieren Sie das SDK über pip:

pip install groupdocs-conversion-cloud

Sie können das neueste Paket auch von der offiziellen Release‑Seite herunterladen. Nach der Installation setzen Sie Ihre Anmeldeinformationen als Umgebungsvariablen oder ersetzen später die Platzhalter im Code. Mit dem bereitgestellten SDK sind Sie bereit, den Konvertierungsprozess zu starten.

Schritt für Schritt: So konvertieren Sie eine Excel‑Arbeitsmappe in Text mit Python

Schritt 1: Anmeldeinformationen konfigurieren

Zuerst erstellen Sie ein Configuration‑Objekt und geben Ihre Client‑ID und Ihr Geheimnis an. Dieses Objekt wird von allen nachfolgenden API‑Aufrufen verwendet.

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

Die Configuration-Klasse ist in der API-Referenz dokumentiert.

Schritt 2: Excel-Arbeitsmappe hochladen

Laden Sie die lokale Excel‑Datei in den GroupDocs Cloud‑Speicher hoch. Dieser Schritt ist optional, wenn Ihre Datei bereits in der Cloud ist.

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)

Die UploadFileApi verarbeitet Dateiübertragungen; siehe die Dokumentation für weitere Details.

Schritt 3: Konvertierungsoptionen definieren

Erstellen Sie ein TxtConvertOptions‑Objekt, um optionale Parameter wie den Seitenbereich anzugeben. Erstellen Sie anschließend das ConvertSettings‑Objekt, das alles zusammenführt.

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

Die TxtConvertOptions‑Klasse ermöglicht es Ihnen, die Konvertierung fein abzustimmen; siehe die offizielle Dokumentation für alle verfügbaren Felder.

Schritt 4: Konvertierung ausführen

Rufen Sie die convert‑Methode von ConvertApi mit den vorbereiteten Einstellungen auf. Die Antwort enthält eine URL zum Herunterladen der konvertierten Datei.

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}")

Wenn der Aufruf erfolgreich ist, erhalten Sie einen direkten Download‑Link für die TXT‑Datei.

Schritt 5: Ergebnis abrufen

Verwenden Sie die URL aus dem vorherigen Schritt, um die Textdatei in Ihre lokale Umgebung herunterzuladen oder sie weiter in Ihrer Anwendung zu verarbeiten.

Tipp: Sie können den Download mit einem einfachen requests.get()‑Aufruf automatisieren und die Authentifizierung über dasselbe Zugriffstoken durchführen, das für die Konvertierungsanfrage verwendet wird.

Mit diesen Schritten haben Sie nun einen vollständigen Workflow für wie man eine Excel-Arbeitsmappe in Text in Python konvertiert unter Verwendung der GroupDocs library.

Excel-Arbeitsmappe Textkonvertierung - Vollständiges Codebeispiel

Das folgende Beispiel demonstriert die vollständige Implementierung von Anfang bis Ende.

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()

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie alle Dateipfade und Konfigurationswerte an Ihre tatsächliche Umgebung anpassen, dass alle erforderlichen Abhängigkeiten ordnungsgemäß installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

Excel-zu-Text-Konvertierung mit cURL und der REST-API

Wenn Sie einen reinen REST‑Ansatz bevorzugen, kann dieselbe Konvertierung mit cURL‑Befehlen durchgeführt werden.

  1. Ein Zugriffstoken erhalten
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. Laden Sie die Quell‑Excel‑Datei hoch
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. Starten Sie die Konvertierung zu TXT
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. Laden Sie die konvertierte TXT-Datei herunter
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Diese Befehle veranschaulichen den vollständigen Lebenszyklus von der Authentifizierung bis zum Download. Für zusätzliche Parameter und Fehlerbehandlung konsultieren Sie die API-Referenz.

Konfigurieren von Konvertierungseinstellungen für Excel

Das SDK bietet mehrere Optionen, um die Ausgabe anzupassen. Nachfolgend finden Sie die nützlichsten Einstellungen für die Excel‑zu‑TXT-Konvertierung:

  • Seitenzahl - Starten Sie die Konvertierung ab einem bestimmten Blatt oder einer bestimmten Seite.
    txt_options.page_number = 1
  • Seitenanzahl - Begrenzen Sie die Anzahl der zu konvertierenden Blätter/Seiten.
    txt_options.page_count = 2
  • Ausgabepfad - Definieren Sie den Namen und den Speicherort der resultierenden TXT-Datei im Cloud‑Speicher.
    convert_settings.output_path = "output/sample.txt"

Weitere erweiterte Optionen wie encoding oder preserveFormatting sind in der API‑Referenz verfügbar; prüfen Sie sie, um Ihre genauen Anforderungen zu erfüllen.

Abschließende Gedanken

Das Konvertieren einer Excel‑Arbeitsmappe in Klartext in Python ist dank des GroupDocs.Conversion Cloud SDK for Python jetzt ein einfacher, wiederholbarer Vorgang. Das SDK übernimmt Authentifizierung, Dateispeicherung und Konvertierung im Hintergrund, sodass Sie sich auf die Geschäftslogik konzentrieren können. Denken Sie daran, die Lizenzierungsoptionen auf der Preisseite zu prüfen und eine temporäre Lizenz für die Evaluierung zu erhalten, bevor Sie in die Produktion gehen. Mit dem bereitgestellten Code und den cURL‑Beispielen können Sie die Excel‑zu‑TXT‑Konvertierung in jeden Python‑basierten Workflow oder Microservice integrieren.

Häufige Fragen

  • Wie lässt sich ein Excel‑Arbeitsbuch am einfachsten in Text in Python konvertieren?
    Verwenden Sie das GroupDocs.Conversion Cloud SDK for Python. Es abstrahiert die REST‑Aufrufe und bietet eine saubere, pythonische API zum Hochladen, Konvertieren und Herunterladen von Dateien.

  • Kann ich nur bestimmte Arbeitsblätter oder Seiten einer Excel‑Arbeitsmappe konvertieren?
    Ja. Setzen Sie page_number und page_count im TxtConvertOptions‑Objekt, um bestimmte Arbeitsblätter anzusprechen. Siehe die API‑Referenz für weitere Details.

  • Benötige ich ein GroupDocs-Konto, um das SDK zu verwenden?
    Ein gültiges GroupDocs Cloud-Konto mit client ID und Secret ist erforderlich. Sie können ein Konto im GroupDocs-Portal erstellen und die Anmeldeinformationen im Dashboard abrufen.

  • Gibt es ein Dateigrößen‑Limit für die Excel‑zu‑TXT-Konvertierung?
    Der Cloud‑Dienst unterstützt Dateien bis zu 200 MB für die Konvertierung. Größere Dateien sollten vor dem Hochladen aufgeteilt oder in Teilen verarbeitet werden.

Weiterführende Lektüre