Alanlara Genel Bakış

Genellikle bir alan Microsoft Word’e eklendiğinde zaten güncel bir değer içerir. Örneğin alan bir formül veya sayfa numarasıysa, belgenin verilen sürümü için doğru hesaplanmış değeri içerecektir. Ancak alanları olan bir belge oluşturan veya değiştiren bir uygulamanız varsa (örneğin, iki belgeyi birleştiren veya verilerle dolduran), o zaman belgenin kullanışlı olması için ideal olarak tüm alanların güncellenmesi gerekir.

Bir alan şunlardan oluşur:

fields-aspose-words

  • Alan başlangıcı ve ayırıcı düğümler, alan kodunu oluşturan içeriği kapsamak için kullanılır (normalde düz metin olarak)
  • Alan ayırıcı ve alan ucu, saha sonucunu kapsar. Bu, metin dizilerinden paragraflara ve tablolara kadar çeşitli içerik türlerinden oluşabilir.
  • Bazı alanlarda ayırıcı bulunmayabilir; bu, içeriğin tamamının alan kodunu oluşturduğu anlamına gelir.
  • Alan kodu, alanın davranışını tanımlar ve alan tanımlayıcısından ve genellikle alan adı ve anahtarlar gibi diğer parametrelerden oluşur.
  • Saha sonucu sahanın en güncel değerlendirmesini içerir. Bu değer alan sonucunda saklanır ve kullanıcıya gösterilir. Bazı alanlarda herhangi bir alan sonucu bulunmayabilir, dolayısıyla belgede hiçbir şey görüntülenmez. Aynı şekilde bazı alanlar henüz güncellenmemiş olabilir, bu nedenle alan sonucu da olmayabilir.

Burada, Github‘de bulunabilen “DocumentExplorer” örneğini kullanarak bir alanın Aspose.Words’te nasıl saklandığına dair bir görünüm bulunmaktadır.

document-explorer-aspose-words

Aspose.Words, Microsoft Word belgelerinin sunucu tarafında işlenmesi için tasarlanmış bir sınıf kitaplığıdır ve alanları aşağıdaki şekillerde destekler:

  • Bir belgedeki tüm alanlar açma/kaydetme ve dönüştürmeler sırasında korunur.
  • En popüler alanlardan bazılarının sonuçlarını güncellemek mümkündür.

Microsoft Word’teki alanlar

Microsoft Word belgelerindeki alanlar karmaşıktır. 50’den fazla alan türü (her biri kendi sonuç hesaplama prosedürüne ihtiyaç duyar), formüller ve ifadeler, yer imleri ve referanslar, işlevler ve çeşitli anahtarlar vardır. Alanlar aynı zamanda iç içe de yerleştirilebilir. Normalde bir belge açıldığında, belgedeki tüm alanlar için alan sonucu (alan değeri) gösterilir. ALT+F9 tuşuna basarak tüm alanlar için Microsoft Word’teki alan sonucu veya alan kodlarının görüntülenmesini değiştirebilirsiniz.

Alan Kodu Alan Sonucu
field-code-result-aspose-words todo:image_alt_text

Microsoft Word’e Alan Ekleme

Microsoft Word’e alan eklemek için:

  1. Insert menüsüne tıklayın.
  2. Quick Parts açılır menüsüne tıklayın
  3. Field‘i seçin
  4. Alanın detaylarını girmenizi sağlayan bir ekran karşınıza çıkar. Sol tarafta size olası alanların bir listesi verilir ve sağ tarafta alanın özelliklerini görsel olarak düzenlemek için bir ekran bulunur.
    field-edit-aspose-words
  5. Ayrıca doğrudan alan kodunu yazmanıza olanak tanıyan Field Codes düğmesine de basabilirsiniz.
    field-properties-aspose-words
  6. Anahtarlar Options düğmesi kullanılarak da eklenebilir
    field-options-aspose-words
  7. Her iki yöntemden birini kullanarak istenen alanları uygun bilgilerle doldurun ve ardından Ok‘e basın.
  8. Alan belgeye geçerli imleç konumuna eklenir.
    insert-field-aspose-words

Microsoft Word’teki Alanları Güncelleme

Microsoft Word’te tek bir alanı güncellemek için:

  1. İmleci güncellemek istediğiniz alana taşıyın.
  2. Alanı güncellemek için F9 tuşuna basın.

Microsoft Word’teki tüm alanları güncellemek için:

  1. Belgedeki tüm içeriği seçmek için Ctrl+A tuşuna basın.
  2. Seçimde bulunan tüm alanları güncellemek için F9 tuşuna basın.

Alan Kodu Görüntülemesi ile Alan Sonucu Arasında Geçiş Yapma

Microsoft Word’te tek bir alanın alan kodlarını değiştirmek için:

  1. İmleci istediğiniz alana taşıyın.
  2. Yalnızca bu alana ait alan kodunu değiştirmek için ÜSTKRKT+F9 tuşuna basın.

Microsoft Word’teki tüm alanların alan kodlarını değiştirmek için:

  1. ALT+F9‘e basın

Microsoft Word’te Alanları Statik Metne Dönüştürme

Microsoft Word’te dinamik bir alanı statik metne dönüştürmek için:

  1. İmleci dönüştürmek istediğiniz alana taşıyın.
  2. Alanları statik metne dönüştürmek için Ctrl+Üst Karakter+F9 tuşuna basın.

Microsoft Word’te Bir Alanı Kaldırma

Microsoft Word’te bir alanı kaldırmak için:

  1. Alanı oluşturan içeriğin tamamını seçin. Alan kodları görüntüleniyorsa açılış ve bitiş parantezlerinin de seçilmesi gerekir.
  2. Alanın tamamını kaldırmak için Delete tuşuna basın.

Aspose.Words’teki alanlar

Bir belge Aspose.Words’e yüklendiğinde, belgenin alanları bir dizi ayrı bileşen (düğüm) olarak Aspose.Words Document Object Model’ye yüklenir. Tek bir alan, FieldStart, FieldSeparator ve FieldEnd düğümlerinin bir koleksiyonu olarak ve bu düğümler arasındaki içerikle birlikte yüklenir. Bir alanın alan sonucu yoksa FieldSeparator düğümü olmayacaktır. Bu düğümlerin tümü her zaman satır içi olarak bulunur (Paragraph veya SmartTag‘nin çocukları olarak).

Alan kodunu oluşturan içerik, FieldStart ile FieldSeparator arasında Run düğümleri olarak depolanır. Alan sonucu FieldSeparator ve FieldEnd düğümleri arasında depolanır ve çeşitli içerik türlerinden oluşabilir. Normalde alan sonucu yalnızca Run düğümlerinden oluşan metni içerir, ancak FieldEnd düğümünün tamamen farklı bir paragrafta konumlandırılması ve dolayısıyla alan sonucunun Table ve Paragraph düğümleri gibi blok düzeyinde düğümlerden oluşması da mümkündür.

Aspose.Words’te FieldXXX düğümlerinin her biri FieldChar‘den türetilir. Bu sınıf, belirtilen düğüm tarafından temsil edilen alan türünü FieldChar.field_type özelliği aracılığıyla kontrol etmek için bir özellik sağlar. Örneğin FieldType.FIELD_MERGE_FIELD, belgedeki bir birleştirme alanını temsil eder.

Güncelleme Sırasında Desteklenen Alanlar

Aşağıdaki alanların hesaplanması Aspose.Words’in güncel sürümünde desteklenmektedir:

  • = (formül alanı)
  • ADDRESSBLOCK
  • AUTHOR
  • COMPARE
  • CREATEDATE
  • DATE
  • DOCPROPERTY
  • DOCVARIABLE
  • GREETINGLINE
  • IF
  • INCLUDETEXT
  • MERGEFIELD
  • MERGEREC
  • MERGESEQ
  • NEXT
  • NEXTIF
  • NUMPAGES
  • PAGE
  • PAGEREF
  • REF
  • SECTION
  • SECTIONPAGES
  • SEQ
  • SET
  • STYLEREF
  • TIME
  • TITLE
  • TOA
  • TOC (TOT ve TOF dahil)
  • TC

Gelişmiş Ayrıştırma

Aspose.Words, Microsoft Word’nin alanları işleme biçimini takip eder ve sonuç olarak şunları doğru şekilde işler:

  • İç içe alanlar : IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
  • Alan bağımsız değişkeni iç içe geçmiş bir alanın sonucu olabilir.
  • Alanlar, alan sonucunun yanı sıra alan kodu içinde de iç içe yerleştirilebilir.
  • Boşluk/boşluk yok, tırnak işaretleri/tırnak işaretleri yok, alanlardaki kaçış karakterleri vb.: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
  • Birden fazla paragrafa yayılan alanlar.

Formül Alanları

Aspose.Words, formül motorunun çok ciddi bir uygulamasını sağlar ve aşağıdakileri destekler:

  • Aritmetik ve mantıksal operatörler: =(54+4*(6-77)-(5))+(-6-5)/4/5
  • Fonksiyonlar: =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
  • Yer imlerine referanslar: =IF(C>4, 5,ABS(A)*.76) +3.85
  • Sayı biçimlendirme anahtarları: =00000000 \\\# "$#,##0.00;($#,##0.00)"

İfadelerde şu işlevler desteklenir: ABS, AND, AVERAGE, COUNT, DEFINED, FALSE, IF, INT, MAX, MIN, MOD, NOT, OR, PRODUCT, ROUND, SIGN, SUM, TRUE.

IF ve COMPARE Alanları

Aspose.Words’nin kolayca hesaplayabildiği IF ifadelerinden sadece birkaçı size bu özelliğin ne kadar güçlü olduğu hakkında bir fikir vermelidir:

  • IF 3 > 5.7^4+MAX(4,3) True False
  • IF "abcd" > "abc" True False
  • IF "?ab*" = "1abdsg" True False
  • IF 4 = "2*2" True False
  • COMPARE 3+5/34 < 4.6/3/2

DATE ve TIME Alanları

Aspose.Words, Microsoft Word’de bulunan tüm tarih ve saat biçimlendirme anahtarlarını destekler; bazı örnekler şunlardır:

  • DATE @ "d-MMM-yy"
  • DATE @ "d/MM/yyyy h:mm am/pm

Mail Merge Alanları

Aspose.Words, belgelerinizdeki Mail Merge alanlarının karmaşıklığına herhangi bir sınırlama getirmez ve iç içe IF ve formül alanlarını destekler ve hatta bir formül kullanarak birleştirme alanının adını hesaplayabilir.

Aspose.Words’nin desteklediği Mail Merge alanlarına bazı örnekler:

  • Mail merge alan anahtarları: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
  • Bir formülde iç içe geçmiş birleştirme alanları: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
  • Çalışma zamanında birleştirme alanının adını hesaplayın: MERGEFIELD { IF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
  • Veri kaynağındaki bir sonraki kayda koşullu geçiş: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

Format Anahtarları

Belgedeki bir alan, elde edilen değerin nasıl biçimlendirilmesi gerektiğini belirten biçimlendirme anahtarlarına sahip olabilir. Aspose.Words aşağıdaki format anahtarlarını destekler:

  • @ - tarih ve saat biçimlendirmesi
  • \# - sayı biçimlendirmesi
  • \\\\* Büyük harfler
  • \\\\* İlk Başlık
  • \\\\* Daha düşük
  • \\\\* Üst
  • \\\\* CHARFORMAT – sonucu alan kodunun ilk karakterine göre biçimlendir.
  • \\\\* MERGEFORMAT – sonucu, eski sonucun nasıl biçimlendirildiğine göre biçimlendirin.

Alanlarda Date ve Sayı Biçimlendirmesi

Aspose.Words bir alan sonucunu hesapladığında, genellikle bir dizeyi bir sayı veya tarih değerine ayrıştırması ve ayrıca onu tekrar bir dizeye biçimlendirmesi gerekir. Aspose.Words, alan güncellemesi sırasında alan değerlerini hesaplarken varsayılan olarak ayrıştırma ve biçimlendirmeyi gerçekleştirmek için geçerli iş parçacığı kültürünü kullanır. ve mail merge. Alan güncellemesi sırasında hangi kültürün kullanıldığı üzerinde daha fazla kontrole olanak tanıyan FieldOptions sınıfı biçiminde sağlanan seçenekler de vardır.

Geçerli Konunun Kültürünü Kullanarak Biçimlendirme

Alan hesaplaması sırasında kullanılan kültürü kontrol etmek için, alan hesaplamasını başlatmadan önce yerel ayar.setlocale yöntemini kullanarak istediğiniz kültürü ayarlayın. Aşağıdaki örnekte, güncelleme sırasında biçimlendirme alanlarında kullanılan kültürün nasıl değiştirileceği gösterilmektedir.

Alanları biçimlendirmek için mevcut kültürün kullanılması, sistemin alan güncellemesi sırasında belgedeki tüm alanların nasıl biçimlendirileceğini kolay ve tutarlı bir şekilde kontrol etmesine olanak tanır.

Belgedeki Kültürü Kullanarak Biçimlendirme

Öte yandan Microsoft Word, her bir alanı, alanda bulunan metnin diline (özellikle alan kodundaki çalıştırmalara) göre biçimlendirir. Bazen alan güncellemesi sırasında bu istenen davranış olabilir; örneğin, birçok farklı dilden oluşan içerik içeren küreselleştirilmiş belgeleriniz varsa ve her alanın metinde kullanılan yerel ayarı dikkate almasını istiyorsanız. Aspose.Words de bu işlevselliği destekler.

Document sınıfı, alanların belge içinde nasıl güncellendiğini kontrol etmek için kullanılabilecek üyeleri içeren bir field_options özelliği sağlar. Aşağıdaki örnekte, alan güncellemesi sırasında tarih biçimlendirmesi için kullanılan kültürün ve mail merge’in seçildiği yerin nasıl belirleneceği gösterilmektedir.

Alan Kodunu ve Alan Sonucunu Bulma

DocumentBuilder.insert_field kullanılarak eklenen alan bir Field nesnesi döndürür. Bu, bir alanın bu tür özelliklerini hızlı bir şekilde bulmak için kullanışlı yöntemler sağlayan bir cephe sınıfıdır. Belgede yalnızca birleştirme alanlarının adlarını arıyorsanız, bunun yerine yerleşik MailMerge.get_field_names yöntemini kullanabileceğinizi unutmayın. Aşağıdaki örnek, bir belgedeki tüm birleştirme alanlarının adlarının nasıl alınacağını gösterir.

Birleştirme Alanlarını Yeniden Adlandırma

Aşağıdaki örnek, bir Word belgesindeki birleştirme alanlarının nasıl yeniden adlandırılacağını gösterir.