Aspose.Cells Cloud API Kullanılarak Excel Dosyalarında Metin Arama ve Değiştirme

Metin işlemleri, Excel dosyaları için karmaşık işlemlerdir. Bu karmaşıklığa birçok faktör katkı sağlar ve işleme sırasında dikkate alınmalıdır. Aspose.Cells Cloud, çeşitli elektronik tablo formatlarında metin arama ve değiştirme konusunda güvenilir bir çözüm sunar.

Excel çalışma kitaplarında metinle çalışmak, genellikle belirli dizeleri bulup bunları birden fazla sayfada güncellemeyi gerektirir. Aspose.Cells Cloud API, bu görevi basitleştirerek desteklenen tüm elektronik tablo formatlarında çalışan tek bir arama ve değiştirme işlemi sağlar.

Genel Bakış

Arama ve değiştirme işlemi, bir çalışma kitabında veya belirli bir çalışma sayfasında belirli dizeleri bulup bunları yeni değerlerle değiştirme imkanı sunar. İşlem, Aspose.Cells Cloud tarafından desteklenen XLS, XLSX, XLSM, XLSB, ODS, CSV ve diğer tüm formatlarla çalışır. Arama ve değiştirme özelliği sayesinde verileri hızlı bir şekilde temizleyebilir, tekrarlanan yazım hatalarını düzeltebilir veya tüm çalışma kitabında toplu adlandırma kurallarını uygulayabilirsiniz.

Ön Gereksinimler

  • Geçerli bir Client‑Id ve Client‑Secret içeren aktif bir Aspose.Cloud hesabı.
  • OAuth 2.0 kimlik doğrulama akışı ile elde edilen erişim belirteci (access token).
  • Hedef çalışma kitabının Aspose Cloud depolama alanına kaydedilmiş ya da herkese açık bir URL üzerinden erişilebilir olması.
  • Gerekli SDK’nın yüklü olması (örneğin, .NET, Java veya Python için Aspose.Cells‑Cloud).

API Referansı

Yöntem: POST
Uç Nokta

POST https://api.aspose.cloud/v3.0/cells/{fileName}/searchreplace
Parametre Tür Gerekli Açıklama
fileName string Evet Çalışma kitabının adı (uzantısı dahil).
folder string Hayır Bulut depolama klasör yolu.
storage string Hayır Varsayılan olmayan bir depo adı.
sheetName string Hayır Belirli bir çalışma sayfası adı; atlanırsa işlem tüm çalışma kitabına uygulanır.
searchString string Evet Aranacak metin.
replaceString string Evet Bulunan ögelerin değiştirileceği metin.
ignoreCase boolean Hayır Büyük/küçük harf duyarsız arama yapmak için true olarak ayarlayın.
matchWholeCell boolean Hayır Sadece tüm hücre eşleşmelerini değiştirmek için true olarak ayarlayın.

Başlıklar

  • Authorization: Bearer {access_token}
  • Content-Type: application/json

İstek Gövdesi (JSON)

{
  "searchString": "EskiDeger",
  "replaceString": "YeniDeger",
  "ignoreCase": false,
  "matchWholeCell": false,
  "sheetName": "Sayfa1"
}

Başarılı Yanıt (JSON)

{
  "status": "OK",
  "replacedCount": 3,
  "updatedFileUrl": "https://api.aspose.cloud/v3.0/storage/file/updatedWorkbook.xlsx"
}

Desteklenen Formatlar

Format Uzantı
Excel Çalışma Kitabı .xls, .xlsx, .xlsm, .xlsb
OpenDocument Elektronik Tablosu .ods
CSV .csv
Diğerleri (Aspose.Cells tarafından desteklenenler) —

Kod Örnekleri

Aşağıda, üç popüler SDK için minimum örnekler verilmiştir. {clientId}, {clientSecret} ve diğer yer tutucuları gerçek değerlerinizle değiştirin. Bu örnekler, arama ve değiştirme işlemini programatik olarak nasıl gerçekleştireceğinizi gösterir.

Hata İşleme ve Kenar Durumları

HTTP Kodu Anlamı Önerilen Eylem
400 Hatalı İstek – eksik veya geçersiz parametreler Gerekli alanları ve veri türlerini kontrol edin.
401 Yetkisiz – geçersiz veya süresi dolmuş belirteç Erişim belirtecini yenileyin.
404 Bulunamadı – çalışma kitabı veya çalışma sayfası yok Dosya adını, klasör yolunu ve sheetName değerini kontrol edin.
415 Desteklenmeyen Medya Türü – geçersiz dosya formatı Yüklenecek dosyanın desteklenen Excel veya CSV formatında olduğundan emin olun.
202 Kabul Edildi – işlem işlenmek üzere kabul edildi Eşzamansız işlem kullanılıyorsa işlemin durumunu periyodik olarak kontrol edin.
204 İçerik Yok – işlem gövdesiz başarıyla tamamlandı Değiştirme uygulandı; ek veri döndürülmedi.
500 İç Sunucu Hatası – beklenmeyen hata Kısa bir gecikmeden sonra yeniden deneyin; sorun devam ederse Aspose desteğiyle iletişime geçin.

Notlar:

  • Büyük çalışma kitapları istek boyutu sınırlarını aşabilir; bu nedenle dosyayı önce bulut depolama alanına yüklemeyi düşünün.
  • ignoreCase değeri true olarak ayarlandığında, yerel ayara özel büyük/küçük harf eşleştirmeleri sonuçları etkileyebilir.
  • Formüllerde matchWholeCell kullanmak, formül metni içindeki kısmi eşleşmelerin değiştirilmesine izin vermez.

Excel dosyalarında arama ve değiştirme

Excel Dosyalarını Birleştir ve Bölümlere Ayır Veriyi Excel Dosyalarına İçe Aktarın ve Excel Dosyalarından Veri Dışa Aktarın