Konwersja ODS do XLSX w Pythonie - Pełny przykład kodu

Poniższy przykład pokazuje, jak przekonwertować plik ODS przechowywany w GroupDocs Cloud na XLSX przy użyciu Python SDK.

import sys
from groupdocs_conversion_cloud import (
    Configuration,
    ApiClient,
    ConvertApi,
    ConvertSettings,
    FileInfo,
    XlsxConvertOptions,
    ConversionResult
)

def main():
    # -------------------- Configuration --------------------
    config = Configuration()
    config.client_id = "YOUR_CLIENT_ID"
    config.client_secret = "YOUR_CLIENT_SECRET"

api_client = ApiClient(config)
    convert_api = ConvertApi(api_client)

# -------------------- Input File --------------------
    input_file = FileInfo()
    input_file.file_path = "input.ods"          # Path in the storage
    # input_file.storage_name = "MyStorage"    # Optional: specify storage name

# -------------------- Conversion Options --------------------
    xlsx_options = XlsxConvertOptions()
    # Example: set specific options if needed
    # xlsx_options.password = "myPassword"

# -------------------- Conversion Settings --------------------
    settings = ConvertSettings()
    settings.file_info = input_file
    settings.format = "xlsx"
    settings.output_path = "output.xlsx"
    settings.options = xlsx_options

# -------------------- Perform Conversion --------------------
    try:
        result: ConversionResult = convert_api.convert(settings)
        print(f"Conversion successful. Output file stored at: {result.path}")
    except Exception as e:
        print(f"Error during conversion: {e}", file=sys.stderr)

if __name__ == "__main__":
    main()

Uwaga: Ten przykład kodu demonstruje podstawową funkcjonalność. Przed użyciem w swoim projekcie upewnij się, że zaktualizowałeś wszystkie ścieżki plików i wartości konfiguracyjne, aby pasowały do rzeczywistego środowiska, sprawdź, czy wszystkie wymagane zależności są poprawnie 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.

Konwertowanie ODS na XLSX przy użyciu cURL i interfejsu REST API

Poniżej znajduje się szybki przewodnik po tej samej konwersji przy użyciu surowych wywołań HTTP. Zastąp wartości zastępcze swoimi rzeczywistymi danymi uwierzytelniającymi.

1. Uzyskaj token dostępu - uwierzytelnij się przy użyciu swojego identyfikatora klienta i sekretu.

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{
           "grant_type": "client_credentials",
           "client_id": "YOUR_CLIENT_ID",
           "client_secret": "YOUR_CLIENT_SECRET"
         }'

2. Prześlij plik źródłowy ODS do swojego magazynu.

curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.ods" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary @input.ods

3. Rozpocznij konwersję do XLSX.

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": "input.ods" },
           "format": "xlsx",
           "outputPath": "output.xlsx",
           "options": {}
         }'

4. Pobierz przekonwertowany plik XLSX

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

Aby uzyskać pełną listę parametrów i dodatkowych opcji, zobacz oficjalną dokumentację API.

Zrozumienie logiki konwersji ODS do XLSX w Pythonie

Przebieg pracy SDK można podzielić na kilka logicznych kroków:

1. Konfiguracja - Configuration() przechowuje Twoje poświadczenia klienta.

config = Configuration()
config.client_id = "YOUR_CLIENT_ID"
config.client_secret = "YOUR_CLIENT_SECRET"

2. Tworzenie klienta API - ApiClient(config) tworzy niskopoziomowego klienta używanego przez usługi wyższego poziomu.

api_client = ApiClient(config)

3. Instancjowanie API konwersji - ConvertApi(api_client) umożliwia dostęp do operacji konwersji.

convert_api = ConvertApi(api_client)

4. Ustawienia FileInfo - FileInfo() wskazuje na źródłowy plik ODS w magazynie GroupDocs.

input_file = FileInfo()
input_file.file_path = "input.ods"

5. Ustawienia konwersji - ConvertSettings() łączy ze sobą plik źródłowy, format docelowy, ścieżkę wyjścia oraz wszelkie opcje specyficzne dla formatu.

settings = ConvertSettings()
settings.file_info = input_file
settings.format = "xlsx"
settings.output_path = "output.xlsx"
settings.options = xxlsx_options

6. Wykonaj konwersję - convert_api.convert(settings) wysyła żądanie i zwraca ConversionResult zawierający ścieżkę do wygenerowanego pliku XLSX.

result = convert_api.convert(settings)

Każdy komponent mapuje się bezpośrednio na punkt końcowy REST, co pozwala przełączać się między SDK a surowymi wywołaniami HTTP bez zmiany ogólnej logiki.

Wymagania wstępne i konfiguracja konwersji ODS do XLSX

Zanim rozpoczniesz, upewnij się, że masz:

• Zainstalowany Python 3.7 lub nowszy.
• Konto GroupDocs Cloud z client ID i client secret.
• Dostęp do storage GroupDocs, w którym będzie przechowywany plik ODS.

Zainstaluj SDK za pomocą pip:

pip install groupdocs-conversion-cloud

Możesz również pobrać pakiet ręcznie ze strona wydania. Po instalacji skonfiguruj swoje poświadczenia, jak pokazano w przykładzie kodu.

Opcje konwersji: Dostosowywanie ustawień ODS do XLSX

Klasa XlsxConvertOptions pozwala precyzyjnie dostosować wynik. W przykładzie używamy domyślnych opcji, ale możesz włączyć funkcje takie jak ochrona hasłem:

xlsx_options = XlsxConvertOptions()
# xlsx_options.password = "myPassword"

Inne przydatne ustawienia (zobacz odniesienie API) obejmują:

• page_range - Konwertuj tylko wybrane arkusze.
• preserve_formulas - Zachowaj formuły Excel bez zmian.
• include_gridlines - Pokaż linie siatki w wygenerowanym skoroszycie.

Dostosuj te właściwości przed przypisaniem obiektu opcji do settings.options.

Podsumowanie

Ten przewodnik przeprowadził Cię przez konwersję ODS do XLSX w Pythonie przy użyciu GroupDocs.Conversion Cloud SDK for Python. Zobaczyłeś pełny przykład kodu, dowiedziałeś się, jak wykonać tę samą operację za pomocą cURL, oraz zapoznałeś się z opcjami konfiguracji, które pomagają dostosować konwersję do Twoich potrzeb. SDK jest produktem komercyjnym; szczegóły cenowe są dostępne na stronie produktu, a tymczasową licencję do oceny możesz uzyskać ze strona tymczasowej licencji. Zacznij już dziś integrować konwersję arkuszy kalkulacyjnych w swoich aplikacjach i ciesz się płynnym przetwarzaniem bez Office.

FAQs

• Jak najlepsze praktyki konwersji ODS do XLSX w Pythonie poprawiają niezawodność?
  Użyj chmurowego SDK, aby uniknąć zależności od lokalnego Office, strumieniuj pliki, aby utrzymać niskie zużycie pamięci, i zawsze określaj explicite ścieżkę wyjściową. SDK również automatycznie ponawia próby przy przejściowych błędach sieciowych.

• Co powinienem wziąć pod uwagę przy porównywaniu bibliotek konwersji ODS do XLSX w Pythonie?
  GroupDocs.Conversion Cloud oferuje dedykowane endpointy, szerokie wsparcie formatów oraz wbudowane funkcje bezpieczeństwa, których brakuje wielu ogólnym bibliotekom. Zapoznaj się ze stroną porównania bibliotek aby uzyskać szczegółową matrycę funkcji.

• Czy istnieje sposób monitorowania wydajności konwersji ODS do XLSX w Pythonie?
  Włącz logowanie SDK lub użyj nagłówka X-RateLimit-Remaining API, aby śledzić opóźnienie żądania i przepustowość. W przypadku dużych partii rozważ konwersję asynchroniczną, aby poprawić ogólną wydajność.

• Czy mogę uruchomić konwersję ODS do XLSX bez zainstalowanego Microsoft Office?
  Tak. Usługa w chmurze wykonuje konwersję w pełni na serwerach GroupDocs, więc nie jest wymagane instalowanie Office na Twoim komputerze.

Czytaj więcej

• Konwersja CSV do HTML krok po kroku w Pythonie
• Samouczek konwersji PNG do PPTX krok po kroku w Pythonie
• Samouczek konwersji PDF do DOCX w Pythonie: szybka asynchroniczność