Akıllı İşaretleyici Şablonları ile Excel Raporları Oluşturun – Aspose.Cells Cloud API Kılavuzu
Bu REST API, Akıllı İşaretleyici şablonunu kullanarak bir çalışma kitabı oluşturur.
Çalışma Kitabı Akıllı İşaretleyici (SmartMarker) API
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.
Akıllı İşaretleyici Nedir?
Akıllı İşaretleyici, XML (veya JSON) dosyasındaki veri alanlarını bir Excel şablonundaki hücrelere eşleyen yer tutucu sözdizimidir. Çalışma zamanında Aspose.Cells, bu işaretleyicileri ilgili verilerle değiştirerek programatik olarak tamamen doldurulmuş raporlar oluşturmanızı sağlar.
Sorgu Parametreleri
| Parametre Adı | Tür | Açıklama |
|---|---|---|
| outPath | string | Oluşturulan çalışma kitabının kaydedileceği hedef yol. |
| folder | string | Orijinal çalışma kitabının bulunduğu klasör. |
| storageName | string | Kullanılacak depolama hizmetinin adı. |
İstek Gövdesi Parametresi
| Parametre Adı | Tür | Açıklama |
|---|---|---|
| xmlFile | file | İsteğe eklenen Akıllı İşaretleyici XML veri dosyası. |
Yanıt
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Notlar / Sınırlamalar:
- API, boyutu 50 MB‘a kadar olan Excel dosyalarını destekler.
- Kabul edilen formatlar yalnızca .xlsx, .xlsm ve .xlsb formatlarıdır.
- Hesap başına saniyede 20 istek hız sınırı uygulanır.
HTTP Durum Kodları
| Kod | Anlamı | Açıklama |
|---|---|---|
| 200 | OK (Tamam) | Filtre başarıyla uygulandı; yanıt işlem ayrıntılarını içerir. |
| 400 | Bad Request (Hatalı İstek) | Eksik veya geçersiz parametreler (örneğin, desteklenmeyen dosya türü). |
| 401 | Unauthorized (Yetkisiz) | Geçersiz veya eksik JWT belirteci. |
| 413 | Payload Too Large (Çok Büyük Yük) | Yüklenen dosya boyut sınırını aşıyor. |
| 500 | Internal Server Error (İç Sunucu Hatası) | Beklenmeyen sunucu tarafı hatası. |
Çalışma Kitabı Akıllı İşaretleyici API Nasıl Kullanılır?
Çalışma Kitabı Akıllı İşaretleyici API Spesifikasyonu
OpenAPI Spesifikasyonu, herkese açık bir programlama arayüzü tanımlar ve REST etkileşimlerini doğrudan bir web tarayıcısından gerçekleştirmenize olanak tanır.
Aspose.Cells Cloud SDK’larını Kullanın
Aspose.Cells web hizmetlerine kolayca erişmek için cURL komut satırı aracını kullanabilirsiniz. Aşağıdaki örnek, cURL ile Cloud API’ye nasıl istek yapıldığını göstermektedir.
Hızlı tek satırlık örnek
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
Hata Yönetimi
| HTTP Durumu | Açıklama | Tipik Neden |
|---|---|---|
| 400 | Bad Request (Hatalı İstek) | Eksik şablon, hatalı XML veya geçersiz parametreler. |
| 401 | Unauthorized (Yetkisiz) | Geçersiz veya eksik kimlik doğrulama belirteci. |
| 404 | Not Found (Bulunamadı) | Belirtilen çalışma kitabına veya depolama konumuna ulaşılamadı. |
| 500 | Internal Server Error (İç Sunucu Hatası) | Beklenmeyen sunucu tarafı hatası. |
Hata yanıtına örnek (400)
{
"Code": 400,
"Message": "XML veri dosyası eksik veya hatalı."
}
Bulut SDK Ailesi
SDK kullanmak, geliştirme sürecini hızlandırmanın en iyi yoldur. Bir SDK, düşük seviye detayları ele alır ve böylece projenizin görevlerine odaklanabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub deposuna göz atın.
Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanılarak Aspose.Cells web hizmetlerinin nasıl çağrılacağını göstermektedir: