Ikhtisar Bidang

Aspose.Words adalah perpustakaan kelas yang dirancang untuk pemrosesan dokumen Microsoft Word di sisi server dan mendukung bidang dengan cara berikut:

  • semua bidang dalam dokumen dipertahankan selama pembukaan/penyimpanan dan konversi
  • dimungkinkan untuk memperbarui hasil dari sebagian besar bidang

Dalam artikel ini, kita akan mempelajari lebih lanjut tentang struktur bidang, bidang yang didukung di Aspose.Words, dan detail cara bekerja dengan bidang tersebut.

Struktur Lapangan

Sebuah bidang terdiri dari:

  • Node awal dan pemisah bidang digunakan untuk mencakup konten yang membentuk kode bidang (biasanya dalam bentuk teks biasa).
  • Pemisah bidang dan ujung bidang mencakup hasil lapangan. Ini dapat terdiri dari berbagai jenis konten mulai dari teks, paragraf, hingga tabel.
  • Beberapa kolom mungkin tidak memiliki pemisah yang berarti seluruh konten membentuk kode kolom.
  • Kode bidang mendefinisikan perilaku bidang dan terdiri dari pengidentifikasi bidang dan sering kali parameter lain seperti nama bidang dan sakelar.
  • Hasil lapangan berisi evaluasi lapangan terkini. Nilai ini disimpan dalam hasil bidang dan ditampilkan kepada pengguna. Beberapa bidang mungkin tidak memiliki hasil bidang apa pun sehingga tidak akan menampilkan apa pun di dokumen. Demikian pula, beberapa bidang mungkin belum diperbarui sehingga tidak ada hasil bidangnya.

fields-aspose-words

Konten yang membentuk kode bidang disimpan sebagai node Run antara FieldStart dan FieldSeparator. Hasil bidang disimpan antara node FieldSeparator dan FieldEnd dan dapat terdiri dari berbagai jenis konten. Biasanya hasil bidang hanya berisi teks yang terdiri dari node Run, namun ada kemungkinan node FieldEnd ditempatkan di paragraf yang sama sekali berbeda, sehingga membuat hasil bidang terdiri dari Tingkat Logis Node dalam Dokumen seperti Table dan Paragraph node juga.

Berikut adalah tampilan bagaimana suatu bidang disimpan di Aspose.Words dengan menggunakan contoh “DocumentExplorer” yang dapat ditemukan di Github.

document-explorer-aspose-words

Bidang di Aspose.Words Document Object Model (DOM)

Saat dokumen dimuat ke Aspose.Words, bidang dokumen dimuat ke Aspose.Words Document Object Model (DOM) sebagai kumpulan komponen terpisah (node). Satu bidang dimuat sebagai kumpulan node FieldStart, FieldSeparator, dan FieldEnd beserta konten di antara node tersebut. Jika suatu field tidak memiliki hasil field maka tidak akan ada node FieldSeparator. Semua node ini selalu ditemukan inline (sebagai turunan dari Paragraph atau SmartTag.

Di Aspose.Words, setiap node FieldXXX berasal dari FieldChar. Kelas ini menyediakan properti untuk memeriksa jenis bidang yang diwakili oleh node tertentu melalui properti FieldType. Misalnya FieldType.FieldMergeField mewakili bidang gabungan dalam dokumen.

Bidang yang Didukung

Perhitungan bidang berikut ini didukung dalam versi Aspose.Words saat ini:

  • = (rumus)
  • ADDRESSBLOCK
  • ASK
  • AUTHOR
  • AUTONUM
  • AUTONUMLGL
  • AUTONUMOUT
  • AUTOTEXT
  • BARCODE
  • COMMENTS
  • COMPARE
  • CREATEDATE
  • DATABASE
  • DATE
  • DISPLAYBARCODE
  • DOCPROPERTY
  • DOCVARIABLE
  • EDITTIME
  • EQ
  • FILENAME
  • FILESIZE
  • FILLIN
  • FORMCHECKBOX
  • FORMDROPDOWN
  • FORMTEXT
  • GLOSSARY
  • GOTOBUTTON
  • GREETINGLINE
  • HYPERLINK
  • IF
  • IMPORT
  • INCLUDE
  • INCLUDEPICTURE
  • INCLUDETEXT
  • INDEX
  • INFO
  • KEYWORDS
  • LASTSAVEDBY
  • LISTNUM
  • MACROBUTTON
  • MERGEBARCODE
  • MERGEFIELD
  • MERGEREC
  • MERGESEQ
  • NEXT
  • NEXTIF
  • NOTEREF
  • NUMCHARS
  • NUMPAGES
  • NUMWORDS
  • PAGE
  • PAGEREF
  • PRINTDATE
  • QUOTE
  • REF
  • REVNUM
  • SAVEDATE
  • SECTION
  • SECTIONPAGES
  • SEQ
  • SET
  • SHAPE
  • SKIPIF
  • STYLEREF
  • SUBJECT
  • SYMBOL
  • TEMPLATE
  • TIME
  • TITLE
  • TOA
  • TOC
  • USERADDRESS
  • USERINITIALS
  • USERNAME

Parsing Lapangan yang Canggih

Aspose.Words mengikuti cara Microsoft Word memproses kolom dan sebagai hasilnya ia menangani dengan benar:

  • bidang bersarang: IF { =OR({ COMPARE { =2.5 +PRODUCT(3,5 ,8.4) } > 4}, { =2/2 }) } = 1 "Credit not acceptable" "Credit acceptable"
  • argumen bidang dapat berupa hasil bidang bersarang
  • bidang dapat disarangkan dalam kode bidang serta dalam hasil bidang
  • spasi/tanpa spasi, tanda kutip/tanpa tanda kutip, karakter escape di kolom, dll.: MERGEFIELD \f"Text after""Field \n\ame with \" and \\\ and \\\*"\bTextBefor\e
  • bidang yang mencakup beberapa paragraf

Bidang Rumus

Aspose.Words menyediakan implementasi mesin formula yang sangat serius dan mendukung hal-hal berikut:

  • operator aritmatika dan logika: =(54+4*(6-77)-(5))+(-6-5)/4/5
  • fungsi: =ABS(-01.4)+2.645/(5.6^3.5)+776457 \\\# "#,##0"
  • referensi ke bookmark: =IF(C>4, 5,ABS(A)*.76) +3.85
  • saklar pemformatan angka: =00000000 \\\# "$#,##0.00;($#,##0.00)"

Fungsi ekspresi berikut ini didukung: ABS, AND, AVERAGE, COUNT, DEFINED, FALSE, IF, INT, MAX, MIN, MOD, NOT, OR, PRODUCT, ROUND, SIGN, MIN, TRUE.

Bidang IF dan COMPARE

Beberapa ekspresi IF yang dapat dihitung dengan mudah oleh Aspose.Words akan memberi Anda gambaran betapa hebatnya fitur ini:

  • 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

Bidang DATE dan TIME

Aspose.Words mendukung semua sakelar pemformatan tanggal dan waktu yang tersedia di Microsoft Word, beberapa contohnya adalah:

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

Bidang Mail Merge

Aspose.Words tidak memberikan batasan pada kompleksitas bidang mail merge di dokumen Anda dan mendukung IF bertingkat dan bidang rumus dan bahkan dapat menghitung nama bidang gabungan menggunakan rumus.

Beberapa contoh kolom mail merge yang didukung Aspose.Words:

  • Sakelar bidang Mail merge: MERGEFIELD FirstName \\\\\\\\* FirstCap \b "Mr. "
  • bidang gabungan bersarang dalam rumus: IF { MERGEFIELDValue1 } >= {MERGEFIELD Value2 } True False
  • hitung nama bidang gabungan saat runtime: MERGEFIELD { IF{MERGEFIELDValue1 } >= {MERGEFIELD Value2 } FirstName"LastName" }
  • perpindahan bersyarat ke rekaman berikutnya di sumber data: NEXTIF { MERGEFIELDValue1 } <= { =IF(-2.45 >= 6*{MERGEFIELD Value2 }, 2, -.45) }

Peralihan Format

Bidang dalam dokumen dapat memiliki tombol pemformatan yang menentukan bagaimana nilai yang dihasilkan harus diformat. Aspose.Words mendukung sakelar format berikut:

  • \@ – format tanggal dan waktu
  • \# – pemformatan angka
  • \* Batasan
  • \* FirstCap
  • \* Lebih rendah
  • \* Atas
  • \* CHARFORMAT – memformat hasil sesuai dengan karakter pertama kode field
  • \* MERGEFORMAT – memformat hasil sesuai dengan format hasil lama

Date dan Pemformatan Angka di Bidang

Saat Aspose.Words menghitung hasil bidang, sering kali Aspose.Words perlu menguraikan string menjadi nilai angka atau tanggal dan juga memformatnya kembali menjadi string. Secara default, Aspose.Words menggunakan budaya thread saat ini untuk melakukan penguraian dan pemformatan saat menghitung nilai bidang selama pembaruan bidang dan mail merge. Ada juga opsi yang disediakan dalam bentuk kelas FieldOptions yang memungkinkan kontrol lebih lanjut terhadap budaya mana yang digunakan selama pembaruan lapangan.

  • secara default properti FieldUpdateCultureSource diatur ke CurrentThread yang memformat bidang menggunakan budaya thread saat ini
  • properti ini dapat disetel ke FieldCode sehingga bahasa yang disetel dari kode bidang digunakan untuk pemformatan

Memformat menggunakan Budaya Thread Saat Ini

Untuk mengontrol budaya yang digunakan selama perhitungan lapangan, cukup atur properti Thread.CurrentThread.CurrentCulture ke budaya pilihan Anda sebelum menjalankan perhitungan lapangan.

Contoh kode berikut menunjukkan cara mengubah budaya yang digunakan dalam bidang pemformatan selama pembaruan:

Menggunakan budaya saat ini untuk memformat bidang memungkinkan sistem mengontrol dengan mudah dan konsisten bagaimana semua bidang dalam dokumen diformat selama pembaruan bidang.

Memformat menggunakan Budaya dalam Dokumen

Di sisi lain, Microsoft Word memformat setiap bidang berdasarkan bahasa teks yang ditemukan di bidang tersebut (khususnya, proses dari kode bidang). Terkadang selama pembaruan bidang, hal ini mungkin merupakan perilaku yang diinginkan, misalnya jika Anda memiliki dokumen global yang berisi konten yang terdiri dari berbagai bahasa dan ingin setiap bidang mengikuti lokal yang digunakan dari teks. Aspose.Words juga mendukung fungsi ini.

Kelas Document menyediakan properti FieldOptions yang berisi anggota yang dapat digunakan untuk mengontrol bagaimana bidang diperbarui dalam dokumen.

Contoh kode berikut menunjukkan cara menentukan dari mana budaya yang digunakan untuk pemformatan tanggal selama pembaruan bidang dan mail merge dipilih:

Sisipkan Bidang di C#