> Yerel Excel kurulumu yok. Bakım gerektiren dönüşüm sunucusu yok. XLSX → PDF, Excel → CSV/JSON/görüntüler/HTML’yi basit REST çağrılarına dönüştürün — ve yaklaşık üç dakikada ilk “bulut hesap tablosu dönüştürücünüzü” çalıştırın. “Hesap tablosunu farklı bir formata dönüştür” günlük geliştirmede en yaygın gereksinimlerden biridir: - Finans ve hukuk ekipleri, herkesin düzenleyebileceği bir .xlsx yerine salt okunur, değiştirilmesi zor bir PDF raporu ister; - Veri ekipleri, tablo verilerini aşağı akış sistemlerine CSV / JSON olarak çekmek ister; - Web ve mobil uygulamalar, çalışma sayfalarını — hatta grafikleri — doğrudan PNG / SVG olarak işlemek ister; - Portallar, gömme için temiz HTML / HTML-Tablo parçaları ister; - Birisi, bir yığın .xls / .xlsx / .csv / .ods dosyasını tek bir formata normalize etmelidir. Eski usul cevaplar — yerel bir Excel kurulumu ile makrolar veya kendi sunucunuzda ağır bir COM bileşeni — ölçeklendirmesi zor ve çapraz platformda tutması zordur. Aspose.Cells Cloud bunların hepsini saf bir REST API ile değiştirir: bir dosya yükleyin, yeni format dosyasını geri alın. Bu yazı, Aspose.Cells Cloud mikro hizmetindeki temel ConversionController tarafından sunulan üç dönüşüm API’sini, cURL, C# (.NET), Python ve Java‘da çalıştırılabilir örneklerle birlikte ele alıyor. — ## 1. Dönüştürme özelliği ne yapabilir? ConversionController, format dönüşümü / dışa aktarma için özel bir denetleyicidir. Yüksek doğrulukta dönüşümü üç set HTTP API’sine sarar: | # | Senaryo | Tipik uç nokta | Ne yapar | | — | ———————————————————— | ———————————————— | —————————————————————————————————————————- | | 1 | Bulut depolamada zaten bulunan dosya → yeni formatı indirin | GET /v4.0/cells/{name}?format=pdf | Bulut depolamada doğrudan bir çalışma kitabını dönüştürür ve sonucu geri akıtır — büyük dosyalar asla makinenize gitmez | | 2 | Yerel dosya → çevrimiçi dönüşüm (başlık özelliği) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | Dosyayı isteğin gövdesinde (çok parçalı) yüklersiniz; sunucu bunu dönüştürür ve sonucu doğrudan geri döner | | 3 | Bulut dosyası → yeni formatta kaydet, bulut depolamaya geri | PUT /v4.0/cells/{name}/saveas?format=pdf | Dönüştürülen dosya doğrudan bulut depolamaya yazılır — otomatikleştirilmiş boru hatları için idealdir | > Uygulama notu: kaynak yolları, API sürümü 4.0 ile v{version}/cells ön ekini kullanır, bu nedenle canlı çağrılar https://api.aspose.cloud/v4.0/cells/... gibi görünür. ### Dönüşüm ayrıntısı “tüm dosya"dan çok daha fazlasını kapsar Tüm bir çalışma kitabını dönüştürmenin yanı sıra, denetleyici bir tek öğeyi de dışa aktarabilir: - Belirli bir çalışma sayfası → PDF / görüntü / CSV / JSON / HTML - Belirli bir hücre aralığı (örneğin A1:C12) → PDF / görüntü / CSV / JSON / HTML - Belirli bir tablo → PDF / görüntü / CSV / JSON / HTML - Belirli bir grafik → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF Bu nedenle, yalnızca bir grafiği almak için 50 MB’lık bir çalışma kitabını dönüştürmek zorunda kalmazsınız — sadece ihtiyacınız olanı dönüştürün ve bant genişliğini ve hesaplamayı kaydedin. — ## 2. Hangi formatlar destekleniyor? Denetleyicideki yerleşik ExportData kaydına dayanarak, dönüşüm matrisinin görünümü kabaca şöyle: | Tür | Formatlar | | —————————————– | ———————————————————————————————————————- | | İçeri aktarma ve dışarı aktarma (iki yönlü) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | Sadece dışarı aktarma | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL, vb. | Kısacası: hesap tablosu-hesap tablosu dönüşümlerinin her türü, artı hesap tablosu → PDF / görüntü / web verisi çıktılarının tüm ailesi — hepsi tek bir API yüzeyinin arkasında. — ## 3. Başlamadan önce bilmeniz gereken iki şey 1. Aspose Cloud Dashboard üzerinde ücretsiz bir hesap kaydedin ve bir Uygulama oluşturun, böylece bir Client ID ve Client Secret alın (SDK’lar bunları otomatik olarak bir JWT ile değiştirir — kendi kimlik doğrulama başlıklarınızı oluşturmanıza gerek yoktur). 2. Tercih ettiğiniz dil için SDK’yı yükleyin: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — not: Maven Central'da YOK, bu nedenle aşağıdaki Aspose deposu gereklidir --> <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 gerekmez mi? Her şey saf REST, bu nedenle cURL de aynı şekilde çalışır (aşağıya bakın). — ## 4. Senaryo 1: Yerel bir Excel dosyasını çevrimiçi dönüştürün (başlık Dönüştür API’si) Bu PUT /v4.0/cells/convert/spreadsheet — amiral gemisi “Dönüştür” API’si: yerel dosyanızı isteğin gövdesinde yükleyin, sunucu bunu dönüştürür ve yeni dosyayı geri akıtır. Bulut depolamada hiçbir şey saklanmaz ve yükleme kopyası kalmaz — “bunu benim için sadece dönüştür” anları için mükemmel. ### ① cURL bash # 1) Önce bir token alın 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 parametresini csv, json, png, xlsx ile değiştirin… ve o formatı alırsınız. Bir parametre, bir çıktı formatı. ### ② 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", // yerel dosya yolu format: "pdf"); // hedef: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // dönüştürülmüş dosya akışı using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // Daha da basit: SDK'yı bir çıktı yoluna yönlendirin ve dosyayı yazmasına izin verin // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > Bir toplu iş mi gerekiyor? Bunu bir dizin üzerinde döngüye koyun ve “tüm klasörü XLSX → PDF’ye dönüştür” elde edersiniz. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # Yerel XLSX -> PDF, sonuç yerel olarak yazılır instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # Diğer formatlar: sadece parametreyi değiştirin — 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"); // yerel dosya yolu req.setFormat("pdf"); // hedef: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // dönüştürülmüş sonuç bir Dosya olarak out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("Dönüştürüldü: " + out.getAbsolutePath()); } } Dört dil, bir eylem: bir yol + bir format parametresi verin → hedef dosyayı geri alın. Bu, Dönüştür API’sinin tüm satış noktasıdır — çağıran tarafta sıfır Excel bağımlılığı, şablon yok, COM bileşeni yok. — ## 5. Senaryo 2: Bulut depolanan bir dosyayı doğrudan dönüştürün Bir dosya zaten Aspose Bulut Depolama’da (veya nesne depolamanızda) yaşıyorsa, büyük dosyaları indirme/yükleme yapmanıza gerek yoktur — dönüşüm bulutta gerçekleşir, veri transferini en aza indirir ve büyük çalışma kitaplarında performansı artırır: bash # bulut Book1.xlsx -> PDF, yerel olarak indirildi 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") # Bulut depolanan bir çalışma kitabını doğrudan PDF'ye dönüştür instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) Ayrıca tek bir öğeye inebilir — örneğin “Sheet1’deki 3. grafiği” PNG olarak işlemek: bash # grafik -> 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 Ayrıntılı bulut uç noktaları bir bakışta: | Hedef | Uç Nokta | Örnek format | | —————- | ——————————————————- | —————————– | | Tüm çalışma kitabı | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | Tek çalışma sayfası | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | Tek aralık | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | Tek tablo | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | Tek grafik | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. Senaryo 3: SaveAs — sonucu bulut depolamaya yazın Dönüştürülen dosyanın bulut depolamaya geri saklanmasını istediğinizde, PUT /v4.0/cells/{name}/saveas kullanın. Bu, “bugünün raporunu PDF olarak arşivle, her gün” gibi otomasyonlar için doğal bir uyumdur: 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")) # Sonuç doğrudan bulut depolamada kaydedilir; CellsCloudResponse(Code=200, Status="OK") döner SaveOptionsData isteği gövdesi aracılığıyla ince ayar kaydetme seçeneklerini geçebilir ve çıktı dosyası adı, çıktı depolama, özel yazı tipleri, bölge/yerel ayar, şifre vb. gibi sorgu parametreleri aracılığıyla kontrol edebilirsiniz — bunlar hakkında daha fazla bilgi aşağıda Mühendislik detayları altında. — ## 7. Daha fazla hazır “çevrimiçi dönüştür” uç noktası Yukarıdaki çalışma kitabı düzeyindeki dönüşümlerin yanı sıra, denetleyici, tam bir set özel yerel dosya → belirli hedef uç noktaları sunar (Senaryo 1’deki gibi aynı isteğin gövdesi yüklemesi), daha ayrıntılı ve bant genişliği açısından daha ucuzdur: | Hedef | Uç Nokta (PUT, /v4.0/cells/convert/ ön eki ile) | | ———————————————— | ——————————————————————————————————– | | Çalışma kitabı → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | Çalışma sayfası → PDF / JSON / CSV / HTML / HTML-Tablo | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | Çalışma sayfası → görüntü | worksheet/image?worksheet=Sheet1&format=png | | Aralık → PDF / CSV / HTML / JSON / görüntü | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | Tablo → PDF / CSV / HTML / JSON / görüntü | table/pdf, table/csv, table/html, table/json, table/image | | Grafik → görüntü / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | Örneğin, “sadece bu aralığı CSV olarak dışa aktarın” için aşağıdaki gibi bir çağrı yapabilirsiniz: 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 Bu uç noktalar, convert/spreadsheet ile aynı yükleme-gövdesi desenini kullanır. .NET SDK’sında grafik durumları, bu v4.0 yollarına karşılık gelen tipli sarmalayıcılarla birlikte gelir — ConvertChartToImage (convert/chart/image) ve ConvertChartToPdf (convert/chart/pdf). worksheet/*, range/* ve table/* varyantlarının henüz v4.0 sarmalayıcısı yoktur, bu nedenle yukarıdaki cURL gibi doğrudan REST üzerinden çağırın. — ## 8. Mühendislik detayları ve hata yönetimi ### Bilinmesi gereken dönüşüm seçenekleri (sorgu parametreleri) - password — şifre korumalı çalışma kitaplarını açın; - fontsLocation / özel yazı tipi desteği — PDF/görüntüleri işlerken glyph’lerin doğru kalmasını sağlar; - satır/sütunları otomatik olarak sığdırma ve satır/sütun başlıklarını yazdırma (printHeadings), bölge/kağıt ayarı (region) vb.; - çıktı tarafında: outPath / outStorageName sonuçların bulut depolamada nerede yer alacağını belirler. ### Hata kodları (denetleyicinin belgeleri) | Durum | Anlam | Tipik sebep | | ——- | ———— | ———————————————————– | | 400 | Kötü İstek | Geçersiz URL / parametreler veya desteklenmeyen format | | 401 | Yetkisiz | Kimlik doğrulama başarısız oldu veya geçerli kimlik bilgileri sağlanmadı | | 404 | Bulunamadı | Kaynak dosya bulut depolamada erişilemez durumda | | 500 | Sunucu Hatası | Dönüşüm verilerini alırken hizmet bir anomali ile karşılaştı | ### Kimlik doğrulama Tüm SDK’lar, OAuth 2.0 client_credentials ve bir JWT ile otomatik olarak kimlik doğrulaması yapar; ham cURL kullanırken, önce /connect/token çağrısını bir kez yapın (bkz. Senaryo 1, ① yukarıda). — ## 9. Neden Aspose.Cells Cloud Convert? - ✅ Sıfır yerel bağımlılık — Office/Excel yok, COM yok. Herhangi bir dil ve her platformdan (Linux, konteynerler, sunucusuz) çağrılabilir; - ✅ Yüksek doğrulukta işleme — Aspose.Cells motoru tarafından desteklenir, bu nedenle formüller, grafikler, stiller ve sayfalama profesyonel kalitede PDF/görüntülere işlenir; - ✅ Bulut yerel — dosyalar dönüşüm sırasında bulutta kalabilir, büyük yükleri taşımaktan kaçınmak için; saf çevrimiçi dönüşüm hiç bulut depolama gerektirmez; - ✅ Esnek ayrıntı düzeyi — çalışma kitabı / çalışma sayfası / aralık / tablo / grafik: tam olarak ihtiyacınız olan parçayı dönüştürün; - ✅ SDK’lar arasında tek şekil — cURL, .NET, Python ve Java örnekleri 1:1 eşleşir, bu nedenle gerçekten beğendiğiniz deseni kopyalayabilirsiniz. Hemen başlayın: Aspose Cloud Dashboard üzerinde kaydolun, bir Uygulama oluşturun, kimlik bilgilerinizi yukarıdaki herhangi bir parçaya yerleştirin ve çalıştırın — birkaç dakika içinde kendi “bulut Excel dönüştürücünüzü” elde edeceksiniz. Bunu faydalı buldunuz mu? Yıldız verin, yer imleyin veya paylaşın — ve kendi hesap tablosu dönüşüm kullanım durumlarınızı yorumlarda bize bildirin.