Oluşturma, Yönetme, Bakım: Aspose.Cells Cloud Management API’ye Pratik Bir Rehber

Boş bir çalışma kitabı oluşturmak, bir sayfanın adını değiştirmek, şişirilmiş bir dosyayı sıkıştırmak veya bozuk bir dosyayı onarmak — bunlar, doğru araca sahip olmadığınızda hâlâ geliştiricilerin zamanını yiyen küçük, günlük görevlerdir. ManagementController bunları tek satırlara dönüştürür.

E-tablolarla çalışan her uygulama sonunda aynı sıkıcı görevlerle karşılaşır:

• Oluşturma yeni, boş bir çalışma kitabını anında — bazen markalı bir şablondan.
• Çalışma sayfalarını yeniden düzenleme — ekleme, yeniden adlandırma, silme, yeniden sıralama — çünkü verinin şekli dün beri değişti.
• Dosya boyutunu kontrol etme — 40 MB’lik bir XLSX’i e-posta göndermeden önce 8 MB’a sıkıştırma.
• Bozuk bir dosyayı kurtarma — kullanıcının yanlış kaydettiği veya bir aracın hatalı dışa aktardığı dosya.
• Yapıyı inceleme — bir çalışma kitabının içinde hangi sayfaların, tabloların, grafiklerin ve birleştirilmiş hücre bölgelerinin bulunduğunu açmadan öğrenme.

ManagementController, Aspose.Cells Cloud mikro hizmetinde (kaynak: src/Aspose.Cells.Cloud.MicroService/Controllers/ManagementController.cs) tüm bu işlemleri temiz bir REST yüzeyi arkasında yönetir. Bu gönderi, bugün pipeline’ınıza yapıştırabileceğiniz çalıştırılabilir cURL örnekleriyle birlikte 15 uç noktasını tanıtıyor.

1. ManagementController ne yapar?

ManagementController çalışma kitabı yaşam döngüsü ve bakım için adanmış denetleyicidir. ConversionController (format dönüşümü), DataProcessingController (toplu birleştirme/ayırma/ithalat) veya CellsController (hücre düzeyinde okuma/yazma) gibi değil, bu denetleyici çalışma kitabının şekli, sağlığı ve meta verileri ile ilgilidir.

Her uç nokta, bir çalışma kitabını çok parçalı giriş (yerel) olarak alır veya bulut depolamada zaten mevcut olan bir çalışma kitabına (uzak) referans verir ve ya değiştirilmiş bir çalışma kitabı akışı, bir JSON yükü veya basit bir OK döndürür.

2. On beş uç nokta bir bakışta

Yollar, ana bilgisayarın https://api.aspose.cloud olduğunu varsayar. Canlı çağrılar https://api.aspose.cloud/v4.0/cells/... gibi görünür.

3. Başlamadan önce: iki ön koşul

1. Kimlik bilgilerini alın. Aspose Cloud Dashboard’da kaydolun, bir Uygulama oluşturun, Client ID ve Client Secret alın. SDK’lar JWT değişimini sizin için halleder; cURL ile bunları manuel olarak bir taşıyıcı token ile değiştirirsiniz.
2. Bir SDK kurun — ya da sadece cURL kullanın. Her şey düz REST’tir.

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

4. Hızlı başlangıç: yeni bir çalışma kitabı oluşturun

PUT /v4.0/cells/spreadsheet/create denetleyicinin yaptığı en basit şeydir — ve en faydalı olanlardan biridir. Yeni bir çalışma kitabı dosyası döndürür.

cURL

# 1) Get a bearer token
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) Create an empty XLSX
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output new_workbook.xlsx

Şablon kullanma

Markalı bir şablonunuz varsa — başlıkta logo, temada marka renkleri, önceden biçimlendirilmiş “Invoice” tablosu — bunu bir kez bulut depolamaya yükleyin, ardından yolunu template olarak geçirin.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/create?format=xlsx&template=templates/invoice_branded.xlsx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  --output invoice_2026_09_001.xlsx

Artık uygulamanız, stil mantığını gömmeden, zaten doğru görünen yeni faturalar oluşturabilir.

5. Kılavuz: bir çalışma kitabındaki sayfaları yönetme

Bu dört uç nokta, bir çalışma kitabının günlük şeklini yönetir. Gerçekçi bir senaryoyu inceleyelim: bir çalışma kitabı yüklediniz ve sayfalarını listelemeniz, yeni bir sayfa eklemeniz, mevcut bir sayfayı yeniden adlandırmanız ve üçüncü bir sayfayı silmeniz gerekiyor.

5a. Çalışma sayfalarını listele

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/worksheets" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@my_workbook.xlsx"

Response:

[
  { "WorksheetName": "Sheet1", "SheetType": "Worksheet" },
  { "WorksheetName": "Data", "SheetType": "Worksheet" },
  { "WorksheetName": "Chart1", "SheetType": "Chart" }
]

5b. Yeni bir çalışma sayfası ekleyin

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/add/worksheet?sheetType=Worksheet&position=1&sheetName=Summary" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5c. Bir çalışma sayfasının adını değiştir

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/rename/worksheet?sourceName=Sheet1&targetName=Overview" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5d. Çalışma sayfasını sil

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/delete/worksheet?sheetName=Chart1" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

5e. Çalışma sayfasını taşı

# Move "Data" to position 0 (front of the workbook)
curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/move/worksheet?worksheet=Data&position=0" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@my_workbook.xlsx" \
  --output updated.xlsx

Bu uç noktaların her biri aynı deseni izler: çok parçalı olarak çalışma kitabını yükleyin, değiştirilmiş çalışma kitabını geri alın. Bunları iş akışınızda zincirleyin veya bir UI’dan geçici olarak çağırın.

6. Uygulama: şişirilmiş bir çalışma kitabını sıkıştırma

Bir kullanıcı size %90’ı gereksiz XML içeren 40 MB’lık bir XLSX gönderdi. PUT /v4.0/cells/spreadsheet/compress bunu küçültür.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/compress?level=9" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@bloated.xlsx" \
  --output slim.xlsx

Tipik bir 40 MB çalışma kitabında 9 seviyesi genellikle 6–10 MB aralığına düşer. İçerik aynı kalır; sadece XLSX konteynerinin ZIP sıkıştırması sıkılaştırılır.

7. Adım adım: bozuk bir çalışma kitabını onarma

Bazen Excel’in açmayı reddettiği bir dosya alırsınız. PUT /v4.0/cells/spreadsheet/repair motorun kurtarma rutinini çalıştırır ve temiz bir sürüm döndürür.

curl -X PUT "https://api.aspose.cloud/v4.0/cells/spreadsheet/repair" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@broken.xlsx" \
  --output repaired.xlsx

Parametre yok. Denetleyici, bozuk bölümleri atarak ve yapısal olarak geçerli bir dosya yazarak, motor aracılığıyla çalışma kitabını yeniden serileştirir. Her bozulma kurtarılamaz, ancak bu yaygın durumları ele alır — kesilmiş ZIP girişleri, geçersiz hücre referansları, hatalı paylaşılan dizeler.

8. Ana faydaların özeti

• Yaşam döngüsü işlemleri için tek denetleyici. Oluşturun, yeniden yapılandırın, sıkıştırın, onarın, inceleyin — hepsi tek bir kimlik doğrulama modeli ve tek bir hata sözleşmesi altında.
• Şablona duyarlı oluşturma. Uygulamanızda stil oluşturmayı yeniden yapmayın; sunucunun her yeni çalışma kitabına bir şablon eklemesine izin verin.
• Yerel ve uzak varyantlar. Dosyalar kullanıcı tarayıcısında olsun ya da zaten bulut depolamada olsun aynı mantık.
• Yapı içgörüsü. structure uç noktası, sayfalar, tablolar, pivot tablolar, grafikler ve şekillerin tam bir JSON haritasını döndürür — bir UI’yi veya doğrulama hattını yönlendirmek için mükemmeldir.
• Sıfır altyapı. Excel kurulumu yok, COM yok, bakım gerektiren sunucu yok.