Excel'den Karakterleri Kaldır – Aspose.Cells Cloud API (POST /cells/removecharacters)

Excel Web API’sinden Karakterleri Kaldır

Seçili hücrelerdeki metin içeriğini temizlemek için kapsamlı bir araç seti. API, belirli karakterleri, önceden tanımlanmış karakter kümelerini veya alt dizeleri kaldırır ve çalışma sayfası metninin standart hale getirilmesini ve istenmeyen sembollerden arındırılmasını sağlar.

Ön Gereksinimler

  • Aktif bir Aspose Cloud hesabı.
  • Doğrulama kılavuzunda açıklanan şekilde alınmış geçerli bir JWT erişim belirteci.
  • Bu uç noktayı çağırmadan önce Excel dosyasının depoya yüklenmiş olması gerekir.
  • Desteklenen dosya formatları şunları içerir: .xlsx, .xls, .xlsm ve diğer yaygın Excel türleri.
POST https://api.aspose.cloud/v3.0/cells/removecharacters

Güvenlik ve Doğrulama

Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı doğrulama gerektirir.

Fonksiyon Açıklaması

  • Özel karakterleri kaldır – Silmek istediğiniz karakterleri belirtin. Her bir karakteri Özel karakterleri kaldır alanına girin; API, seçilen hücrelerdeki bu karakterlerin tüm örneklerini siler.
  • Karakter kümelerini kaldır – Önceden tanımlanmış kümelerden birini seçin:
    • Yazdırılmayan karakterler – Satır sonlarını ve ilk 32 yazdırılmayan ASCII karakterini (0‑31) ile ek kodları (127, 129, 141, 143, 144, 157) siler.
    • Metin karakterleri – Tüm harfleri kaldırır.
    • Sayısal karakterler – Tüm rakamları siler.
    • Semboller – Matematiksel, geometrik, teknik, para birimi sembollerini ve “?”, “1”, “™” gibi harf benzeri sembolleri kaldırır.
    • Noktalama işaretleri – Tüm noktalama işaretlerini kaldırır.
  • Alt dizgiyi kaldır – Seçilen hücrelerden belirtilen alt dizgiyi (örneğin bir kelimeyi) siler.

İstek Parametreleri

Parametre Adı Tür Konum Açıklama
removeCharactersOptions Sınıf Gövde Hangi karakterlerin, karakter kümelerinin veya alt dizgilerin kaldırılacağını tanımlayan seçenekler.

removeCharactersOptions Şeması

Özellik Tür Zorunlu Açıklama
Range string Evet İşlenecek hücreleri belirten A‑1 gösterimi veya adlandırılmış aralık (örneğin "A1:C10").
CustomCharacters string Hayır Silinecek her bir özel karakteri içeren dize (örneğin "@#$").
CharacterSet string Hayır Önceden tanımlanmış bir küme belirten numaralandırma değeri ("NonPrinting", "Text", "Numeric", "Symbols", "Punctuation").
Substring string Hayır Kaldırılacak tam alt dizgi (örneğin "USD").
IgnoreCase boolean Hayır true ise, karakter kaldırma işlemi büyük/küçük harf duyarlılığından bağımsız çalışır.

Örnek JSON istek gövdesi

{
  "Range": "A1:B20",
  "CustomCharacters": "@#$",
  "CharacterSet": "NonPrinting",
  "Substring": "USD",
  "IgnoreCase": true
}

Örnek cURL isteği

curl -X POST "https://api.aspose.cloud/v3.0/cells/removecharacters" \
     -H "Authorization: Bearer {access_token}" \
     -H "Content-Type: application/json" \
     -d '{
           "Range": "A1:B20",
           "CustomCharacters": "@#$",
           "CharacterSet": "NonPrinting",
           "Substring": "USD",
           "IgnoreCase": true
         }'

Yanıt

{
    "Status" : "OK",
    "Code" : 200,
    "Filename" : "[birleştirilmiş dosya adı]",
    "Filesize" : [dosya boyutu],
    "FileContent" : "[Base64Dizesi]"
}

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 (Yük Çok Büyük) Yüklenen dosya boyut sınırını aşıyor.
500 Internal Server Error (İç Sunucu Hatası) Beklenmeyen sunucu hatası.

SDK’larla PostRemoveCharacters API’sini Nasıl Kullanılır

PostRemoveCharacters API Spesifikasyonu

PostRemoveCharacters uç noktası için tam 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ştirmenizi sağlar.

Aspose.Cells Cloud SDK’larını Kullanma

SDK kullanmak, geliştirme sürecini hızlandırmak için en iyi yoldur. Bir SDK, düşük seviye ayrıntıları yönetir ve proje görevlerinize odaklanmanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub Deposu’na göz atın.

Aşağıdaki kod örnekleri, farklı SDK’ları kullanarak Aspose.Cells web hizmetlerine nasıl istek gönderileceğini göstermektedir: