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 | AfterText ve selectText yoksa, 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: