Uzak Excel Çalışma Kitaplarında Metin Arama – Belirli Verileri Bulma
Uzak Çalışma Kitabında İçerik Arama API’si
Aspose.Cells Cloud API’sini kullanarak herhangi bir Excel çalışma kitabında programlı olarak belirli metinleri arayın. Bulut depolama alanında saklanan dosyalarda metin, sayı veya formülleri bulun. Bu RESTful API, otomatik veri keşfi, içerik analizi ve çalışma kitabları denetim süreçlerini mümkün kılar.
Web API’si
PUT https://api.aspose.cloud/v4.0/cells/{name}/search/content
Güvenlik ve Kimlik Doğrulama
Aspose.Cells Cloud API’leri güvenlidir ve JWT belirteci tabanlı kimlik doğrulama gerektirir.
-H "Authorization: Bearer {access_token}"
İstek Parametreleri:
| Parametre Adı | Tür | Yol/Sorgu Dizesi/HTTP Gövdesi | Açıklama |
|---|---|---|---|
| name | String | Yol | Zorunlu. Metin aramasının yapılacağı Excel çalışma kitabının dosya adı (uzantısı dahil), örneğin sales_data.xlsx. |
| searchText | String | Sorgu | Zorunlu. Çalışma kitabının tamamında veya çalışma sayfasında(sayfalarında) bulunacak olan tam dize, sayı veya kısmi içerik. |
| ignoringCase | Boolean | Sorgu | İsteğe bağlı. Büyük/küçük harf duyarlılığını belirler. Büyük/küçük harf duyarsız eşleştirme için true olarak ayarlayın (örneğin “Rapor”, “RAPOR” ile eşleşir); varsayılan değer false‘dır. |
| folder | String | Sorgu | İsteğe bağlı. Hedef çalışma kitabını içeren bulut depolama alanındaki dizin yolu. Atlanırsa kök klasör varsayılır. |
| storageName | String | Sorgu | İsteğe bağlı. Özelleştirilmiş yapılandırılmış bir bulut depolama hizmeti için ad tanımlayıcısı. Belirtilmezse API, hesapla ilişkili varsayılan depoyu kullanır. |
| region | String | Sorgu | İsteğe bağlı. Arama sırasında uygulanacak yerel ayar (örneğin tr-TR); bu ayar metin normalleştirme veya karşılaştırma kurallarını etkileyebilir. |
| password | String | Sorgu | İsteğe bağlı. Şifreli bir Excel dosyasına erişmek için gereken şifre çözme şifresi. Dosya şifrelenmemişse bu parametreyi atlayın. |
Sözlük
- searchText – Bulunacak tam dize; kısmi eşleşme de olabilir.
- ignoringCase –
truearamayı büyük/küçük harf duyarsız yapar;falsebüyük/küçük harf duyarlılığını zorunlu kılar. - folder – Çalışma kitabını içeren dizinin yolu.
- storageName – Özelleştirilmiş depo yapılandırmasının tanımlayıcısı.
- region – Metin karşılaştırma kurallarını etkileyen yerel kod.
- password – Korumalı çalışma kitapları için şifre çözme şifresi.
Yanıt
{
"Code": 200,
"Status": "OK",
"TextItems": [
{
"Filename": "string",
"Worksheet": "string",
"Position": "string",
"Content": "string"
}
]
}
Yanıt, aranan metnin bulunduğu hücrelerin listesini (CellName) ve çalışma sayfası adını ile eşleşen metni içerir. Eşleşme bulunamazsa TextItems dizisi boş döner ancak istek yine de HTTP 200 OK döndürülür.
Hata Kodları
- 400 Bad Request – Geçersiz Aspose.Cells Cloud API URI’si.
{"code":400,"message":"Invalid request URI"} - 401 Unauthorized – Geçersiz erişim belirteci, istemci kimliği veya istemci gizli anahtarı.
{"code":401,"message":"Invalid access token"} - 404 Not Found – Çalışma kitab dosyasına ulaşılamıyor.
{"code":404,"message":"File not found"} - 500 Server Error – API’nin isteği tamamlamasını engelleyen beklenmeyen bir durum oluştu.
{"code":500,"message":"Internal server error"}
Çalışma Kitabında İçerik Arama API’si Nerede Kullanılmalı?
- Kapsamlı çalışma kitabı uygunluk denetimi – Kurumsal veri güvenliği ve uygunluk kontrolü için tüm Excel dosyasını hızlıca tarayın ve tüm hassas terimleri (örneğin “Gizli Madde”, “İç Veri”) bulun.
- Çoklu sayfa verisi ilişkilendirme sorgusu – Proje bilgileri birden fazla çalışma sayfasına dağıtılmışsa, belirli bir proje numarasını veya müşteri adını arayın ve ilgili tüm verileri anında bulun.
- Toplu şablon içerik doğrulama – Otomatik rapor oluşturma işleminden sonra, tüm önceden tanımlı yer tutucuların (
{{Date}}gibi) doğru şekilde değiştirildiğini doğrulamak için birden fazla Excel dosyasını toplu olarak tarayın; böylece raporların eksiksiz ve doğru olmasını sağlayın. - Tarihsel veri arşivleme ve madencilik – Eski dosyaları analiz edin, belirli olay kodlarını veya iş terimlerini arayın ve veri arkeolojisi amacıyla tarihsel iş mantığını hızlıca anlayın.
Çalışma Kitabında İçerik Arama API’si Neden Kullanılmalı?
- Geliştirici dostu – Aspose.Cells Cloud, birden fazla dilde SDK kütüphaneleri sunar ve kapsamlı belgelerle hızlı geliştirme sağlar. Özel çözümler geliştirmeye kıyasla geliştirme çabasını büyük ölçüde azaltır.
- Düşük iş gücü maliyeti – Tekrarlayan arama görevlerini otomatikleştirir, geliştiricileri manuel veri çıkarma işlerinden serbest bırakır.
- Kullanım başına ödeme – Önceden ödeme gerektirmez; sadece kullandığınız API çağrıları için ödeme yaparsınız.
- Bakım gerektirmez – Aspose sunucuları, güncellemeleri ve uyumluluğu yönetir; böylece uygulama mantığına odaklanabilirsiniz.
- Karmaşık Excel formatlarını korur – Sonuçlar orijinal stillendirme korunarak evrensel olarak erişilebilir PDF formatına aktarılabilir.
Çalışma Kitabında Bozuk Bağlantıları Arama Nasıl Yapılır? – SDK’larla
OpenAPI 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ı Kullanma
SDK kullanmak, geliştirme hızını en çok artıracak yoldur. SDK, arka plandaki ayrıntıları yöneterek, hücrelerdeki çalışma kitaplarında içerik arama işlevselliğini en az kodla uygulamanızı sağlar. Aspose.Cells Cloud SDK’larının tam listesi için lütfen GitHub Deposu‘na bakın.
Aşağıdaki kod örnekleri, farklı SDK’lar kullanılarak Aspose.Cells web hizmetlerinin nasıl çağrılacağını göstermektedir: