Python을 사용한 단계별 ODS에서 XLSX 변환 튜토리얼

Wed, 30 Sep 2026 14:19:00 +0000

ODS 스프레드시트를 XLSX 형식으로 변환하는 것은 오픈소스 데이터를 Microsoft 중심 워크플로와 통합할 때 자주 요구되는 작업입니다. GroupDocs.Conversion Cloud SDK for Python은 로컬 Office 설치 없이도 이 작업을 처리할 수 있는 강력한 클라우드 기반 API를 제공합니다. 이 튜토리얼에서는 Python에서 ODS를 XLSX로 변환하는 방법을 단계별로 배우고, 완전한 작동 예제를 확인하며, 해당 cURL 호출을 살펴보고, 안정적인 변환을 위한 모범 사례를 발견하게 됩니다.

Python에서 ODS를 XLSX로 변환 - 전체 코드 예제

다음 예제는 GroupDocs Cloud에 저장된 ODS 파일을 Python SDK를 사용하여 XLSX로 변환하는 방법을 보여줍니다.

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

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 뒤 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에게 문의하십시오.

cURL 및 REST API를 사용한 ODS를 XLSX로 변환

아래는 원시 HTTP 호출을 사용한 동일한 변환에 대한 빠른 단계별 안내입니다. 자리 표시자 값을 실제 자격 증명으로 교체하십시오.

액세스 토큰 얻기 - 클라이언트 ID와 비밀 키로 인증합니다.

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

ODS 소스 파일을 업로드 스토리지에.

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

변환 시작 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": {}
         }'

변환된 XLSX 파일 다운로드.

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

전체 매개변수 목록 및 추가 옵션은 공식 API 문서를 참조하십시오.

Python에서 ODS를 XLSX로 변환 로직 이해

SDK 워크플로는 몇 가지 논리적 단계로 나눌 수 있습니다:

구성 - Configuration()은(는) 클라이언트 자격 증명을 보유합니다.

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

API 클라이언트 생성 - ApiClient(config) 은(는) 상위 수준 서비스에서 사용하는 저수준 클라이언트를 생성합니다.

api_client = ApiClient(config)

Convert API 인스턴스화 - ConvertApi(api_client)는 변환 작업에 대한 액세스를 제공합니다.

convert_api = ConvertApi(api_client)

FileInfo Setup - FileInfo()는 GroupDocs 저장소에 있는 원본 ODS 파일을 가리킵니다.

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

변환 설정 - ConvertSettings()는 소스 파일, 대상 형식, 출력 경로 및 형식별 옵션을 연결합니다.

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

변환 실행 - convert_api.convert(settings)는 요청을 보내고 생성된 XLSX 파일의 경로를 포함하는 ConversionResult를 반환합니다.

result = convert_api.convert(settings)

각 구성 요소는 REST 엔드포인트에 직접 매핑되므로 전체 로직을 변경하지 않고도 SDK와 순수 HTTP 호출 간에 전환할 수 있습니다.

ODS를 XLSX 변환하기 위한 전제 조건 및 설정

시작하기 전에, 다음을 확인하십시오:

Python 3.7 이상 설치됨.
클라이언트 ID와 클라이언트 비밀이 포함된 GroupDocs Cloud 계정.
ODS 파일이 저장될 GroupDocs 스토리지에 대한 액세스.

pip를 통해 SDK를 설치합니다:

pip install groupdocs-conversion-cloud

패키지는 릴리스 페이지에서 수동으로 다운로드할 수도 있습니다. 설치 후에는 코드 예제에 표시된 대로 자격 증명을 구성하십시오.

변환 옵션: ODS를 XLSX 설정으로 조정

XlsxConvertOptions 클래스는 출력물을 세밀하게 조정할 수 있게 해줍니다. 예제에서는 기본 옵션을 사용하지만, 비밀번호 보호와 같은 기능을 활성화할 수 있습니다:

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

다른 유용한 설정(자세한 내용은 API 참조를 참조하십시오) 포함:

page_range - 특정 시트만 변환합니다.
preserve_formulas - Excel 수식을 그대로 유지합니다.
include_gridlines - 생성된 워크북에 눈금을 표시합니다.

옵션 개체를 settings.options에 할당하기 전에 이러한 속성을 조정하십시오.

결론

이 가이드는 Python에서 ODS를 XLSX로 변환하는 방법을 GroupDocs.Conversion Cloud SDK for Python을 사용하여 단계별로 안내합니다. 전체 코드 예제를 확인하고, cURL을 사용하여 동일한 작업을 수행하는 방법을 배웠으며, 변환을 필요에 맞게 조정할 수 있는 구성 옵션을 살펴보았습니다. SDK는 상용 제품이며, 가격 세부 정보는 제품 페이지에서 확인할 수 있고, 임시 라이선스 페이지에서 평가용 임시 라이선스를 얻을 수 있습니다. 오늘 바로 애플리케이션에 스프레드시트 변환을 통합하고 원활하고 Office‑free 처리 경험을 누리세요.

FAQs

Python에서 ODS를 XLSX로 변환하는 모범 사례는 신뢰성을 어떻게 향상시키나요?
클라우드 SDK를 사용하여 로컬 Office 종속성을 피하고, 파일을 스트리밍하여 메모리 사용량을 낮게 유지하며, 항상 명시적인 출력 경로를 지정합니다. SDK는 일시적인 네트워크 오류를 자동으로 재시도합니다.
Python에서 ODS와 XLSX 변환 라이브러리를 비교할 때 고려해야 할 사항은 무엇인가요?
GroupDocs.Conversion Cloud는 전용 엔드포인트, 광범위한 형식 지원 및 내장 보안 기능을 제공하며, 이는 많은 일반 라이브러리에는 부족합니다. 자세한 기능 매트릭스는 라이브러리 비교 페이지를 검토하십시오.
Python에서 ODS를 XLSX로 변환 성능을 모니터링하는 방법이 있나요?
SDK 로깅을 활성화하거나 API의 X-RateLimit-Remaining 헤더를 사용하여 요청 지연 시간과 처리량을 추적하십시오. 대량 배치의 경우 전체 성능을 향상시키기 위해 비동기 변환을 고려하십시오.
Microsoft Office가 설치되지 않은 상태에서 ODS를 XLSX로 변환할 수 있나요?
예. 클라우드 서비스가 변환을 완전히 GroupDocs 서버에서 수행하므로, 귀하의 컴퓨터에 Office를 설치할 필요가 없습니다.

ods xlsx conversion on Document Processing REST APIs | GroupDocs Cloud