Jak przekonwertować skoroszyt Excel na tekst w Pythonie

Ekstrahowanie surowego tekstu z arkuszy Excel jest częstą potrzebą przy budowaniu potoków danych lub generowaniu prostych raportów. Jeśli chcesz dowiedzieć się jak przekonwertować skoroszyt Excel na tekst w Pythonie, GroupDocs.Conversion Cloud SDK for Python ułatwia to zadanie. Ten przewodnik przeprowadzi Cię przez instalację SDK, przesyłanie skoroszytu, konfigurowanie opcji konwersji oraz pobieranie wyniku w formacie TXT. Po zakończeniu będziesz mieć wielokrotnego użytku skrypt oraz zestaw poleceń cURL do automatyzacji opartej na REST‑.

Przed rozpoczęciem: Wymagania wstępne i instalacja

Zanim rozpoczniesz, upewnij się, że masz następujące:

• Python 3.7 lub nowszy zainstalowany na Twoim komputerze.
• Aktywne konto GroupDocs Cloud (client ID i client secret).
• Dostęp sieciowy do punktów końcowych GroupDocs Cloud.

Zainstaluj SDK za pomocą pip:

pip install groupdocs-conversion-cloud

Możesz również pobrać najnowszy pakiet ze strony oficjalnych wydań. Po instalacji ustaw swoje dane uwierzytelniające jako zmienne środowiskowe lub później zamień symbole zastępcze w kodzie. Gdy SDK jest gotowe, jesteś gotowy, aby rozpocząć proces konwersji.

Tworzenie krok po kroku: jak przekonwertować skoroszyt Excel na tekst w Pythonie

Krok 1: Skonfiguruj poświadczenia

Najpierw utwórz obiekt Configuration i podaj swój identyfikator klienta oraz sekret. Ten obiekt jest używany we wszystkich kolejnych wywołaniach API.

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

Klasa Configuration jest udokumentowana w referencji API.

Krok 2: Prześlij skoroszyt Excel

Prześlij lokalny plik Excel do magazynu GroupDocs Cloud. Ten krok jest opcjonalny, jeśli Twój plik jest już w chmurze.

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 obsługuje transfery plików; zobacz jego dokumentację, aby uzyskać więcej szczegółów.

Krok 3: Zdefiniuj opcje konwersji

Utwórz obiekt TxtConvertOptions, aby określić dowolne opcjonalne parametry, takie jak zakres stron. Następnie zbuduj obiekt ConvertSettings, który łączy wszystko razem.

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

Klasa TxtConvertOptions pozwala precyzyjnie dostosować konwersję; odwołaj się do oficjalnej dokumentacji aby uzyskać wszystkie dostępne pola.

Krok 4: Wykonaj konwersję

Wywołaj metodę convert klasy ConvertApi z przygotowanymi ustawieniami. Odpowiedź zawiera adres URL do pobrania przekonwertowanego pliku.

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

Jeśli wywołanie się powiedzie, otrzymasz bezpośredni link do pobrania pliku TXT.

Krok 5: Pobierz wynik

Użyj adresu URL z poprzedniego kroku, aby pobrać plik tekstowy do swojego lokalnego środowiska lub przetworzyć go dalej w swojej aplikacji.

Wskazówka: Możesz zautomatyzować pobieranie za pomocą prostego wywołania requests.get(), obsługując uwierzytelnianie przy użyciu tego samego tokenu dostępu, który jest używany w żądaniu konwersji.

Dzięki tym krokom masz teraz kompletny przepływ pracy jak przekonwertować skoroszyt Excel na tekst w Pythonie przy użyciu biblioteki GroupDocs.

Konwersja tekstu w skoroszycie Excel - Pełny przykład kodu

Poniższy przykład demonstruje pełną implementację od początku do końca.

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

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem go w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby odpowiadały rzeczywistemu środowisku, sprawdź, czy wszystkie wymagane zależności są prawidłowo zainstalowane, oraz dokładnie przetestuj w środowisku deweloperskim. Jeśli napotkasz jakiekolwiek problemy, odwołaj się do oficjalnej dokumentacji lub skontaktuj się z zespołem wsparcia w celu uzyskania pomocy.

Konwersja plików Excel do tekstu przy użyciu cURL i REST API

Jeśli wolisz czyste podejście REST, tę samą konwersję można wykonać przy użyciu poleceń cURL.

1. Uzyskaj token dostępu

   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"

2. Prześlij plik Excel źródłowy

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

3. Rozpocznij konwersję do 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": {}
         }'

4. Pobierz przekonwertowany plik TXT

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.txt" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.txt

Te polecenia ilustrują pełny cykl życia od uwierzytelniania do pobierania. Aby uzyskać dodatkowe parametry i informacje o obsłudze błędów, zapoznaj się z referencją API.

Konfigurowanie ustawień konwersji dla Excela

SDK oferuje kilka opcji dostosowania wyjścia. Poniżej znajdują się najprzydatniejsze ustawienia konwersji z Excel‑to‑TXT:

• Numer strony – Rozpocznij konwersję od określonego arkusza lub strony.

  txt_options.page_number = 1
  

• Liczba stron – Ogranicz liczbę arkuszy/stron do konwersji.

  txt_options.page_count = 2
  

• Ścieżka wyjścia – Określ nazwę i lokalizację wynikowego pliku TXT w magazynie w chmurze.

  convert_settings.output_path = "output/sample.txt"
  

Inne zaawansowane opcje, takie jak encoding lub preserveFormatting, są dostępne w dokumentacji API; zapoznaj się z nimi, aby dopasować je do swoich dokładnych wymagań.

Końcowe przemyślenia

Konwersja skoroszytu Excel do zwykłego tekstu w Pythonie jest teraz prostym, powtarzalnym procesem dzięki GroupDocs.Conversion Cloud SDK for Python. SDK obsługuje uwierzytelnianie, przechowywanie plików i konwersję w tle, pozwalając skupić się na logice biznesowej. Pamiętaj, aby zapoznać się z opcjami licencjonowania na stronie cenowej i uzyskać tymczasową licencję do oceny przed przejściem do produkcji. Dzięki dostarczonemu kodowi i przykładom cURL możesz zintegrować konwersję Excel‑to‑TXT w dowolnym przepływie pracy lub mikroserwisie opartym na Pythonie.

Częste pytania

• Jaki jest najprostszy sposób konwersji skoroszytu Excel na tekst w Pythonie?
  Użyj GroupDocs.Conversion Cloud SDK for Python. Abstrahuje wywołania REST i zapewnia czyste, pythoniczne API do przesyłania, konwertowania i pobierania plików.

• Czy mogę konwertować tylko określone arkusze lub strony skoroszytu Excel?
  Tak. Ustaw page_number i page_count w obiekcie TxtConvertOptions, aby skierować konwersję na konkretne arkusze. Zobacz referencję API po pełne szczegóły.

• Czy potrzebuję konta GroupDocs, aby używać SDK?
  Wymagane jest ważne konto GroupDocs Cloud z identyfikatorem klienta i sekretem. Możesz utworzyć konto w portalu GroupDocs i uzyskać poświadczenia z panelu.

• Czy istnieje limit rozmiaru pliku dla konwersji Excel do TXT?
  Usługa w chmurze obsługuje pliki do 200 MB przy konwersji. Większe pliki należy podzielić lub przetwarzać w partiach przed przesłaniem.

Dalsza lektura

• Jak przekonwertować dokumenty Word do HTML w Pythonie
• Konwertuj skoroszyt Excel na plik tekstowy przy użyciu .NET REST API
• Jak przekonwertować DOCX na MD w Javie