> 로컬 Excel 설치 필요 없음. 유지 관리할 변환 서버 없음. XLSX → PDF, Excel → CSV/JSON/이미지/HTML을 일반 REST 호출로 변환하고 약 3분 안에 첫 번째 “클라우드 스프레드시트 변환기"를 실행하세요. “스프레드시트를 다른 형식으로 변환하세요"는 일상 개발에서 가장 일반적인 요구 사항 중 하나입니다: - 재무 및 법률 팀은 누구나 편집할 수 있는 .xlsx 대신 읽기 전용, 변조 방지 PDF 보고서를 원합니다; - 데이터 팀은 다운스트림 시스템으로 CSV / JSON 형식으로 표 형식 데이터를 가져와야 합니다; - 웹 및 모바일 앱은 워크시트 — 심지어 차트까지 — PNG / SVG로 직접 렌더링하기를 원합니다; - 포털은 삽입할 수 있는 깔끔한 HTML / HTML-테이블 스니펫을 원합니다; - 누군가는 .xls / .xlsx / .csv / .ods 파일 더미를 하나의 형식으로 정규화해야 합니다. 구식 답변 — 매크로가 포함된 로컬 Excel 설치 또는 자체 서버의 무거운 COM 구성 요소 — 는 확장하기 어렵고 크로스 플랫폼 유지 관리가 어렵습니다. Aspose.Cells Cloud는 이를 모두 순수 REST API로 대체합니다: 파일을 업로드하고, 새 형식의 파일을 받으세요. 이 게시물은 Aspose.Cells Cloud 마이크로서비스의 핵심 ConversionController에서 노출된 세 가지 변환 API를 다루며 (출처: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), cURL, C# (.NET), Python 및 Java의 실행 가능한 예제가 포함되어 있습니다. — ## 1. Convert 기능은 무엇을 할 수 있나요? ConversionController는 _형식 변환 / 내보내기_에 전념하는 컨트롤러입니다. 엔진 수준의 고충실도 변환을 세 가지 HTTP API 세트로 래핑합니다: | # | 시나리오 | 일반 엔드포인트 | 수행하는 작업 | | — | ———————————————————— | ———————————————— | —————————————————————————————————————————- | | 1 | 클라우드 저장소에 이미 있는 파일 → 새 형식 다운로드 | GET /v4.0/cells/{name}?format=pdf | 클라우드 저장소에서 워크북을 직접 변환하고 결과를 스트리밍합니다 — 대형 파일은 절대적으로 사용자의 기기로 이동하지 않습니다 | | 2 | 로컬 파일 → 온라인 변환 (주요 기능) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | 요청 본문에 파일을 업로드합니다 (멀티파트); 서버가 변환하고 결과 파일을 직접 반환합니다 | | 3 | 클라우드 파일 → 새 형식으로 저장, 클라우드 저장소로 | PUT /v4.0/cells/{name}/saveas?format=pdf | 변환된 파일이 클라우드 저장소에 바로 기록됩니다 — 자동화된 파이프라인에 이상적입니다 | > 구현 참고: 소스 경로는 API 버전 4.0과 함께 v{version}/cells 접두사를 사용하므로 실시간 호출은 https://api.aspose.cloud/v4.0/cells/...와 같습니다. ### 변환 세분화는 “전체 파일"을 넘어갑니다 전체 워크북을 변환하는 것 외에도 컨트롤러는 _단일 요소_를 내보낼 수 있습니다: - 특정 워크시트 → PDF / 이미지 / CSV / JSON / HTML - 특정 셀 범위 (예: A1:C12) → PDF / 이미지 / CSV / JSON / HTML - 특정 테이블 → PDF / 이미지 / CSV / JSON / HTML - 특정 차트 → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF 따라서 한 차트를 가져오기 위해 전체 50MB 워크북을 변환할 필요가 없습니다 — 필요한 것만 변환하고 대역폭과 컴퓨팅을 절약하세요. — ## 2. 지원되는 형식은 무엇인가요? 컨트롤러의 내장 ExportData 레지스트리를 기반으로 변환 매트릭스는 대략 다음과 같습니다: | 유형 | 형식 | | —————————————– | ———————————————————————————————————————- | | 가져오기 및 내보내기 (양방향) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | 내보내기 전용 | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL 등 | 간단히 말해: 스프레드시트-스프레드시트 변환의 모든 종류, 또한 스프레드시트 → PDF / 이미지 / 웹 데이터 출력의 전체 패밀리 — 모두 하나의 API 표면 뒤에 있습니다. — ## 3. 시작하기 전에 필요한 두 가지 1. Aspose Cloud Dashboard에서 무료 계정을 등록하고 애플리케이션을 생성하여 Client ID 및 Client Secret을 얻으세요 (SDK가 이를 JWT로 자동 교환합니다 — 인증 헤더를 직접 작성할 필요가 없습니다). 2. 선호하는 언어에 맞는 SDK를 설치하세요: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — 참고: Maven Central에 없음, 따라서 아래 Aspose 저장소가 필요합니다 --> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://repository.aspose.cloud/repo/</url> </repository> </repositories> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-cells-cloud</artifactId> <version>26.8</version> </dependency> > SDK가 필요 없나요? 모든 것이 일반 REST이므로 cURL도 잘 작동합니다 (아래 참조). — ## 4. 시나리오 1: 로컬 Excel 파일을 온라인으로 변환하기 (주요 Convert API) 이것은 PUT /v4.0/cells/convert/spreadsheet — 플래그십 “Convert” API: 요청 본문에 로컬 파일을 업로드하면 서버가 변환하고 새 파일을 스트리밍합니다. 클라우드 저장소에 지속적으로 저장되지 않으며 업로드 복사본이 남지 않습니다 — “이것을 변환해 주세요” 순간에 완벽합니다. ### ① cURL bash # 1) 먼저, 토큰을 가져옵니다 curl -X POST "https://api.aspose.cloud/connect/token" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" # 2) XLSX -> PDF curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -F "file=@Book1.xlsx" \ -o Book1.pdf format을 csv, json, png, xlsx 등으로 바꾸면 해당 형식을 얻을 수 있습니다. 하나의 매개변수, 하나의 출력 형식. ### ② C# / .NET csharp using Aspose.Cells.Cloud.SDK.Api; using Aspose.Cells.Cloud.SDK.Request; var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); var request = new ConvertSpreadsheetRequest( spreadsheet: "C:/invoices/Book1.xlsx", // 로컬 파일 경로 format: "pdf"); // 대상: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // 변환된 파일 스트림 using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // 더 간단하게: SDK를 출력 경로에 지정하고 파일을 작성하게 할 수 있습니다 // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > 배치 작업이 필요하신가요? 이를 디렉토리 반복문에 넣으면 “전체 폴더 XLSX → PDF 변환"이 가능합니다. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # 로컬 XLSX -> PDF, 결과가 로컬에 기록됨 instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # 다른 형식: 매개변수만 변경하면 됩니다 — json / csv / xlsx / png ... ### ④ Java java import com.aspose.cloud.cells.api.CellsApi; import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest; import java.io.File; public class ConvertDemo { public static void main(String[] args) throws Exception { CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest(); req.setSpreadsheet("C:/invoices/Book1.xlsx"); // 로컬 파일 경로 req.setFormat("pdf"); // 대상: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // 변환된 결과를 파일로 out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("변환됨: " + out.getAbsolutePath()); } } 네 가지 언어, 하나의 작업: 경로 + 형식 매개변수를 제공하면 → 대상 파일을 반환받습니다. 이것이 Convert API의 전체 판매 포인트입니다 — 호출 측에 Excel 의존성이 전혀 없으며, 템플릿이나 COM 구성 요소가 필요 없습니다. — ## 5. 시나리오 2: 클라우드 저장 파일 직접 변환 파일이 이미 Aspose Cloud Storage (또는 귀하의 객체 저장소)에 있는 경우, 대형 파일을 다운로드/업로드할 필요가 없습니다 — 변환은 클라우드에서 발생하여 데이터 전송을 최소화하고 대형 워크북의 성능을 개선합니다: bash # 클라우드 Book1.xlsx -> PDF, 로컬로 다운로드 curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=pdf" \ --data-urlencode "folder=Reports" \ -o Book1.pdf python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # 클라우드 저장 워크북을 PDF로 직접 변환 instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) 단일 요소로도 드릴다운할 수 있습니다 — 예를 들어 “Sheet1의 3번째 차트"를 PNG로 렌더링: bash # 차트 -> PNG curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=png" \ -o chart.png 세분화된 클라우드 엔드포인트를 한눈에: | 대상 | 엔드포인트 | 예제 format | | —————- | ——————————————————- | —————————– | | 전체 워크북 | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | 단일 워크시트 | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | 단일 범위 | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | 단일 테이블 | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | 단일 차트 | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. 시나리오 3: SaveAs — 결과를 클라우드 저장소에 다시 쓰기 변환된 파일을 클라우드 저장소에 지속적으로 저장하려면 PUT /v4.0/cells/{name}/saveas를 사용하세요. 이는 “오늘의 보고서를 PDF로 아카이브하기 위해 매일 내보내기"와 같은 자동화에 자연스럽게 적합합니다: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import SaveSpreadsheetAsRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") instance.save_spreadsheet_as( SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports")) # 결과가 클라우드 저장소에 직접 저장됩니다; CellsCloudResponse(Code=200, Status="OK") 반환 SaveOptionsData 요청 본문을 통해 세밀한 저장 옵션을 전달할 수 있으며, 출력 파일 이름, 출력 저장소, 사용자 정의 글꼴, 지역/로케일, 비밀번호 등을 쿼리 매개변수를 통해 제어할 수 있습니다 — 아래 _엔지니어링 세부사항_에서 더 많은 정보를 확인하세요. — ## 7. 더 많은 준비된 “온라인 변환” 엔드포인트 워크북 수준 변환 외에도 컨트롤러는 전체 세트의 전용 로컬 파일 → 특정 대상 엔드포인트를 노출합니다 (시나리오 1과 동일한 요청 본문 업로드), 이는 더 세분화되고 대역폭이 저렴합니다: | 목표 | 엔드포인트 (PUT, 접두사 /v4.0/cells/convert/) | | ———————————————— | ——————————————————————————————————– | | 워크북 → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | 워크시트 → PDF / JSON / CSV / HTML / HTML-테이블 | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | 워크시트 → 이미지 | worksheet/image?worksheet=Sheet1&format=png | | 범위 → PDF / CSV / HTML / JSON / 이미지 | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | 테이블 → PDF / CSV / HTML / JSON / 이미지 | table/pdf, table/csv, table/html, table/json, table/image | | 차트 → 이미지 / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | 예를 들어, “이 범위를 CSV로 내보내서 다운스트림 시스템에 사용하세요”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "worksheet=Sheet1" \ --data-urlencode "range=A1:C100" \ -F "file=@data.xlsx" \ -o data.csv 이 엔드포인트는 convert/spreadsheet와 동일한 본문 업로드 패턴을 사용합니다. .NET SDK의 차트 사례는 이러한 v4.0 경로에 매핑되는 유형 래퍼가 있습니다 — ConvertChartToImage (convert/chart/image) 및 ConvertChartToPdf (convert/chart/pdf). worksheet/*, range/* 및 table/* 변형은 아직 v4.0 래퍼가 없으므로 위의 cURL과 같이 일반 REST를 통해 호출하세요. — ## 8. 엔지니어링 세부사항 및 오류 처리 ### 알아두어야 할 변환 옵션 (쿼리 매개변수) - password — 비밀번호로 보호된 워크북 열기; - fontsLocation / 사용자 정의 글꼴 지원 — PDF/이미지를 렌더링할 때 글리프를 올바르게 유지; - 행/열 자동 맞춤 및 행/열 제목 인쇄 여부 (printHeadings), 지역/페이지 설정 (region) 등; - 출력 측: outPath / outStorageName은 결과가 클라우드 저장소에 어디에 위치하는지를 결정합니다. ### 오류 코드 (컨트롤러가 문서화한 계약) | 상태 | 의미 | 일반적인 원인 | | ——- | ———— | ———————————————————– | | 400 | 잘못된 요청 | 잘못된 URL / 매개변수 또는 지원되지 않는 format | | 401 | 인증 실패 | 인증 실패 또는 유효한 자격 증명이 제공되지 않음 | | 404 | 찾을 수 없음 | 클라우드 저장소에서 소스 파일에 접근할 수 없음 | | 500 | 서버 오류 | 변환 데이터를 가져오는 동안 서비스에서 이상 발생 | ### 인증 모든 SDK는 OAuth 2.0 client_credentials 및 JWT로 자동 인증되며, 원시 cURL을 사용할 때는 /connect/token을 한 번 호출해야 합니다 (시나리오 1, ① 참조). — ## 9. 왜 Aspose.Cells Cloud Convert인가요? - ✅ 로컬 의존성 제로 — Office/Excel 필요 없음, COM 없음. 모든 언어 및 모든 플랫폼 (Linux, 컨테이너, 서버리스)에서 호출 가능; - ✅ 고충실도 렌더링 — Aspose.Cells 엔진에 의해 구동되므로 수식, 차트, 스타일 및 페이지 매김이 전문 품질로 PDF/이미지로 렌더링됩니다; - ✅ 클라우드 네이티브 — 변환 중 파일이 클라우드에 남아 대형 페이로드를 전송하지 않도록 하며, 순수 온라인 변환은 클라우드 저장소가 전혀 필요 없습니다; - ✅ 유연한 세분화 — 워크북 / 워크시트 / 범위 / 테이블 / 차트: 필요한 조각만 정확히 변환하세요; - ✅ 모든 SDK에서 동일한 형태 — cURL, .NET, Python 및 Java 예제가 1:1로 매핑되므로 마음에 드는 패턴을 복사할 수 있습니다. 지금 시작하세요: Aspose Cloud Dashboard에서 등록하고 애플리케이션을 생성한 후, 위의 어떤 코드 조각에든 자격 증명을 입력하고 실행하세요 — 몇 분 안에 나만의 “클라우드 Excel 변환기"를 갖게 될 것입니다. 유용하셨나요? 별표, 북마크 또는 공유하세요 — 그리고 댓글로 여러분의 스프레드시트 변환 사용 사례에 대해 알려주세요.