Excel için Toplu Metin Ekleme – Önek, Sonek ve Özel Metinleri Hücrelere Ekleme – Adım Adım Rehber
Birden fazla Excel hücresine tek bir işlemde metin ekleyin. Aspose.Cells API kullanarak hücrelerin başlangıcına, sonuna veya içindeki belirli bir metinden önce/sonra önekler, sonekler, etiketler veya özel karakterler ekleyin.
Genel Bakış
Hedef aralıktaki her hücreye tek bir çağrıyla önek, sonek veya sabitlenmiş dizeleri ekleyin—formül veya yardımcı sütun gerekmez.
- Her hücre içinde herhangi bir konumda özel metin ekleme
| Değer | Açıklama |
|---|---|
None |
Orijinal içeriği değiştir |
AtTheBeginning |
Başlangıca ekle (ön ek) |
AtTheEnd |
Sonuna ekle (son ek) |
BeforeText |
selectText’in ilk oluşumundan önce ekle; bulunamazsa atla |
AfterText |
selectText’in ilk oluşumundan sonra ekle; bulunamazsa atla |
-
Dört konum modu: önek, sonek, alt metinden önce/sonra.
-
Gereksiz doluluğu önlemek için boş hücreleri atla.
-
API yalnızca metin türü değerleriyle çalışır; sayılar, boolean’lar ve formüller önce metne dönüştürülür.
-
Boş hücreler
skipEmptyCells = true→ boş hücreler atlanır.skipEmptyCells = false→ boş hücrelere metin eklenir (hücre metin türü olur).
-
Bağlayıcı metin bulunamadı:
position = BeforeText | AfterTextveselectTextyoksa, hücre değeri değişmeden kalır.
Web API
PUT https://api.aspose.cloud/v4.0/cells/content/add/text
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}"
AddText API’sinin istek parametreleri şunlardır:
| Parametre Adı | Tür | Yol/Sorgu Dizisi/HTTP Gövdesi | Açıklama | Gerekli |
|---|---|---|---|---|
| Spreadsheet | Dosya | FormData | İşlenecek spreadsheet dosyası. Desteklenen formatlar: XLSX, XLS, ODS, CSV vb. | Evet |
| text | Dize | Sorgu | Spreadsheet’te belirtilen hücrelere eklenecek metin içeriği. | Evet |
| position | Dize | Sorgu | Mevcut hücre içeriğine göre metnin nereye ekleneceğini belirtir. Seçenekler: AtTheBeginning, AtTheEnd, BeforeText, AfterText, None. |
Evet |
| selectText | Dize | Sorgu | (İsteğe bağlı) Sağlanırsa, metin yalnızca bu tam alt dizesini içeren hücrelere eklenir. position parametresiyle birlikte kullanılır. |
Hayır |
| skipEmptyCells | Boolean | Sorgu | true ise boş hücreler atlanır; false ise boş hücrelere metin eklenir. |
Hayır |
| worksheet | Dize | Sorgu | (İsteğe bağlı) Metin eklenecek çalışma sayfasının adı. Atlanırsa, işlem varsayılan olarak ilk çalışma sayfasına uygulanır. | Hayır |
| range | Dize | Sorgu | (İsteğe bağlı) Metin eklenecek hücre aralığı (örn. "A1:C10"). Atlanırsa, işlem belirtilen çalışma sayfasındaki tüm kullanılan hücrelere uygulanır. |
Hayır |
| outPath | Dize | Sorgu | (İsteğe bağlı) İşlenmiş defterin kaydedileceği bulut depolama klasör yolu. Atlanırsa, dosya kaynak klasörde kaydedilir. | Hayır |
| outStorageName | Dize | Sorgu | Çıktı dosyasının saklanacağı bulut depolamanın adı. | Hayır |
| region | Dize | Sorgu | (İsteğe bağlı) Çıktı dosyasında sayıları, tarihleri ve parabirimlerini Biçimlendirmek için yerel ayar (örn. "en-US", "zh-CN", "de-DE"). |
Hayır |
| password | Dize | Sorgu | (İsteğe bağlı) Yüklenen spreadsheet şifreliyse, dosyayı açmak ve işlemek için şifreyi sağlayın. | Hayır |
cURL Örneği
curl -X PUT "https://api.aspose.cloud/v4.0/cells/content/add/text?text=Rapor&position=AtTheBeginning&skipEmptyCells=true" \
-H "Authorization: Bearer {access_token}" \
-F "Spreadsheet=@/path/to/workbook.xlsx" \
-F "outPath=output/workbook_modified.xlsx"
Yanıt
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Hata Kodları
| Kod | Açıklama |
|---|---|
| 400 Bad Request | Geçersiz Aspose.Cells Cloud API URI’si veya eksik gerekli parametreler. |
| 401 Unauthorized | Geçersiz erişim belirteci veya geçersiz istemci kimliği ve gizli anahtarı. |
| 404 Not Found | Spreadsheet dosyasına erişilemiyor. |
| 500 Server Error | Spreadsheet, hesaplama verilerini alırken bir anomaliyle karşılaştı. |
Add Text for Spreadsheet API’i nerede kullanmalıyız?
- Dinamik Rapor Etiketleme: Otomatik olarak oluşturulan finansal raporlar ve satış raporlarına dinamik başlıklar, tarih etiketleri veya notlar ekleyin.
- Toplu Dosya Filigranlama: Excel dosyalarının bir kümesine şirket logoları, gizlilik filigranları veya sürüm bilgileri ekleyin.
- Şablon Veri Doldurma: Sözleşme veya fatura şablonlarında önceden tanımlanmış konumlara müşteri adlarını, tutarları ve diğer metinleri otomatik doldurun.
- Veri Sınıflandırma Etiketleme: Analiz sonuçlarına dayanarak veri satırlarına sınıflandırma etiketleri veya durum etiketleri (örn. “İnceleniyor”, “Onaylandı”) ekleyin.
- Veri Kalitesi Açıklaması: Veri temizleme sırasında sorunlu veriler için notlar ekleyin.
- Toplu Metin Biçimlendirme: Ürün adlarını veya müşteri adlarını tek bir formatta önek veya sonek ekleyerek standartlaştırın.
Neden Add Text for Spreadsheet API’i kullanmalısınız?
- Toplu Metin Ekleme: Elle çalışmaktan %95’e kadar zaman kazandırarak, yüzlerce hücreye veya dosyaya aynı anda metin ekleyin.
- Kesin Konum Kontrolü: Başlangıç, bitiş veya hücre içinde belirli metinden önce/sonra gibi altı konumda metin eklemeyi destekler.
- Akıllı Koşullu İşleme: Boş bir hücrede veya belirli metni içeren bir hücrede metin ekleme kararını verin.
- Çok Konumlu Strateji Desteği:
AtTheBeginning: Tüm seçili hücrelerin içeriğinden önce aynı metni ekleyin.AtTheEnd: Tüm seçili hücrelerin içeriğinden sonra metin ekleyin.BeforeText/AfterText: Belirli metni içeren hücrelerin başına veya sonuna metin ekleyin.None: Orijinal içeriği değiştirin.
- Kesin Aralık Kontrolü: İşlem için belirli çalışma sayfalarını veya hücre aralıklarını belirlemeyi sağlar.
- Koşullu Atlama Seçeneği: Gereksiz metin eklemesini önlemek için boş hücreleri atlamayı destekler.
- Geliştirici Dostu: Aspose.Cells Cloud, birden fazla dilde SDK kütüphaneleri sunar; hızlı geliştirme sağlar ve kapsamlı dokümantasyonla birlikte gelir. Özel grafik oluşturma çözümleri oluşturmaya göre geliştirme yükünü önemli ölçüde azaltır.
- Maliyet Etkin: Öncelikle defteri yüklemeye gerek kalmadan hücreye metin ekleyebilirsiniz; bu, depolama alanını tasarruf eder ve maliyetleri düşürür.
OpenAPI Specification
OpenAPI Specification, herkese açık bir programlama arayüzü tanımlar ve web tarayıcınızdan doğrudan REST etkileşimlerini gerçekleştirmenize olanak tanır.
Aspose.Cells Cloud SDK’larını Kullanın
SDK kullanmak, geliştirmeyi hızlandırmanın en iyi yoludur. SDK, altta yatan ayrıntıları yönetir, böylece hücrelere Add Text için minimum kodla uygulama yapabilirsiniz. Aspose.Cells Cloud SDK’larının tam listesi için GitHub deposuna göz atın.
Aşağıdaki kod örnekleri, çeşitli SDK’lar kullanılarak Aspose.Cells web servislerine nasıl çağrı yapılacağını göstermektedir: