Ekspresi Ekspor

Ekspresi ekspor adalah placeholder, fallback, dan sintaks kondisional yang digunakan NAHPU untuk mengubah field catatan menjadi keluaran. Ekspresi yang sama menggerakkan elemen teks pada templat dokumen dan prasetel ekspor tabel, sehingga nilai yang ditulis sebagai [taxonomy::genus] [taxonomy::specificEpithet] diuraikan dengan cara yang sama pada label cetak maupun pada kolom ekspor. Untuk alur kerja yang menggunakannya, lihat Ekspor Dokumen dan Ekspor Catatan.

Ekspresi umum

Salin ekspresi berikut ke elemen teks pada templat dokumen, atau ke Advanced > Raw source expression pada pemetaan ekspor tabel. Key yang dipakai adalah untuk catatan spesimen; bagian-bagian di bawah menjelaskan cara kerja setiap bagian.

Nama spesies

[taxonomy::genus] [taxonomy::specificEpithet]

Ekspresi ini mencetak Rattus rattus. Bila sebagian spesimen hanya teridentifikasi sampai genus, beri epitet fallback agar namanya menjadi Rattus sp.:

[taxonomy::genus] [taxonomy::specificEpithet??sp.]

Untuk nama lengkap, termasuk epitet subspesies, gunakan [specimen::scientificName]. Pada prasetel tabel, gunakan pemetaan Custom field.

Lokalitas lengkap

Ekspresi ini menggabungkan field geografi menjadi satu nilai dan melewati field yang kosong, sehingga county yang tidak tercatat tidak meninggalkan koma ganda.

[geography::country]|[geography::islandGroup]|[geography::stateProvince]|[geography::county]|[geography::municipality]|[geography::locality]

Tanda | menandai akhir setiap bagian; pemisah keluaran berasal dari pengaturan daftar:

Templat dokumen: atur Text type ke List Values lalu pilih format koma.
Prasetel ekspor tabel: atur Mapping type ke List field, List output ke One column, dan Separator ke Comma (A, B). Tempel ekspresi ke Raw source expression dan isi Column name (optional); format header Darwin Core dan namespace NAHPU mewajibkannya.

Satu catatan mencetak Indonesia, West Java, Bogor, Cibodas; catatan tanpa county mencetak Indonesia, West Java, Cibodas. Hapus, ubah urutan, atau tambahkan bagian sesuai kebutuhan.

Ukuran testis

Ekspresi ini mencetak panjang x lebar hanya bila testis skrotal dan kedua ukuran tercatat. Catatan lain tidak mencetak apa pun.

[[if][mammalAttribute::testisPosition=="0"&&mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisLength] x [mammalAttribute::testisWidth]"]]

Gunakan pada elemen teks di templat dokumen, atau pada pemetaan Custom field di prasetel tabel.

Catatan	Keluaran
Skrotal, 10 mm kali 6,5 mm	`10 x 6.5`
Skrotal, lebar tidak tercatat	Kosong
Abdominal	Kosong
Betina	Kosong

Kondisinya mensyaratkan posisi tersimpan 0, yaitu Scrotal, serta kedua ukuran; baru setelah itu teks ditulis dengan field-nya terisi. Lihat Teks kondisional.

Tambahkan mm di dalam tanda kutip untuk satuan, atau |"bukan skrotal" sebelum ]] penutup untuk menulis sesuatu pada catatan lain.

Label field berkode

[mammalAttribute::testisPosition#label]

Ekspresi ini mencetak Scrotal, bukan kode tersimpan 0, pada jenis teks apa pun, termasuk pemetaan Custom field. Lihat Menerjemahkan field berkode.

Simbol placeholder

Semua yang dapat ditulis oleh sebuah templat berasal dari salah satu bentuk berikut. Semuanya diketik ke dalam elemen teks, dan semuanya dapat dicampur dengan teks biasa.

Simbol	Arti	Contoh
`[ ]`	Placeholder field.	`[fieldNumber]`
`::`	Memisahkan tabel dari field pada key lengkap.	`[specimen::fieldNumber]`
`??`	Fallback yang dicetak ketika field kosong.	`[specimen::preparator??N/A]`
`#label`	Mencetak label field berkode, bukan kode tersimpannya.	`[mammalAttribute::testisPosition#label]`
`-img`	Menampilkan field `.sex` sebagai ikon, bukan teks.	`[mammal.sex]-img`
`[[ ]]`	Ekspresi kondisional.	`[[specimen::condition][…]]`
`[[if]` … `]]`	Teks kondisional, ditulis sesuai kondisinya.	`[[if][…]=>" mm"]]`

Key field

Sebuah placeholder memuat key lengkap Table::Field atau nama field singkat:

Nomor lapangan: [specimen::fieldNumber]
Nama ilmiah: [taxonomy::scientificName]
Lokasi: [site::specificLocality]

Bentuk singkat seperti [fieldNumber] juga dikenali, tetapi key lengkap lebih aman setiap kali lebih dari satu tabel memiliki field dengan nama tersebut. Masukkan key dari pemilih field alih-alih mengetiknya; pemilih hanya menawarkan field yang benar-benar dapat disediakan oleh tipe catatan templat itu.

Fallback nilai kosong

?? memberi placeholder sesuatu untuk dicetak ketika catatan tidak memiliki nilai. Kontrol No Content Placeholder menuliskannya untuk Anda, dengan lima pilihan:

Pilihan	Ditulis sebagai	Keluaran saat field kosong
`Blank`	`[specimen::preparator]`	Tidak ada
`table::field`	`[specimen::preparator??specimen::preparator]`	Key field itu sendiri, sebagai pengingat yang terlihat
`N/A`	`[specimen::preparator??N/A]`	`N/A`
`None`	`[specimen::preparator??None]`	`None`
Kustom	`[specimen::preparator??tidak dicatat]`	Apa pun yang Anda ketik

Teks setelah ?? bersifat literal. Placeholder yang diakhiri -img tidak pernah menerima fallback.

Placeholder ikon sex dan gambar

Dua placeholder berperilaku berbeda dari yang lain karena menampilkan gambar, bukan string. Keduanya harus menjadi satu-satunya isi elemen teksnya:

[mammal.sex]-img menggambar sex sebagai ikon yang dapat diubah ukurannya. Key-nya harus diakhiri .sex; atur kotak ikon dengan field lebar dan tinggi.
[media::media], dengan jenis teks disetel ke Picture, menggambar gambar yang terlampir pada catatan dalam grid yang ukurannya menyesuaikan jumlah gambar.

Field kustom

Field kustom adalah ekspresi yang mencampur field dengan teks literal, atau hanya berisi teks literal. Pada templat dokumen, setiap elemen teks sudah merupakan field kustom: sisipkan field dengan Insert Field lalu ketik teks di sekitarnya. Pada prasetel ekspor tabel, buat field kustom dengan Add custom field di Edit Fields, atau pilih Custom field sebagai Mapping type pada pemetaan yang sudah ada.

Editor field kustom menuliskan ekspresinya untuk Anda:

Kontrol	Fungsinya
`Add field`	Menambahkan placeholder field yang dipilih dari pemilih field.
`Add text`	Menambahkan segmen teks atau pemisah.
`Add conditional text`	Menambahkan teks kondisional yang disusun dari kondisi, teks yang ditulis, dan teks lain yang opsional.
`Show label`	Pada field berkode, menambahkan `#label` agar kolom menampilkan label, bukan kode tersimpan.
`Edit conditional text`	Membuka kembali segmen teks kondisional.
`Move segment up` / `Move segment down`	Mengubah urutan segmen. Keluaran ditulis dari kiri ke kanan.
`Remove segment`	Menghapus segmen.
`Expression:`	Menampilkan ekspresi yang akan disimpan.
`Column name`	Memberi nama kolom keluaran.

Field kustom tidak wajib memuat field. Setiap baris berikut adalah ekspresi yang lengkap dan valid:

[personnel::initial]-[specimen::fieldNumber]
[taxonomy::genus] [taxonomy::specificEpithet]
NAHPU

Contoh terakhir menulis NAHPU pada setiap baris, yang cocok untuk kolom konstan seperti kode institusi yang diharapkan basis data penerima.

Setel Column name untuk setiap field kustom. Nama kolom wajib diisi bila Generated header format adalah Darwin Core atau namespace NAHPU. Dengan table::fieldName atau fieldName, field kustom tanpa nama mengambil tajuknya dari field pertama dalam ekspresi, atau dari teks itu sendiri bila tidak ada field.

Field kustom pada prasetel tabel memakai jenis Normal Text. Keluaran kondisional, jenis teks berformat, dan kolom daftar berindeks memerlukan pemetaan dengan tepat satu field; gunakan Single field atau List field untuk keperluan tersebut.

Keluaran kondisional

Ekspresi kondisional menentukan, saat pencetakan, apakah sebuah nilai ditandai atau digantikan. Bangun ekspresi dengan Conditional output di bilah alat teks, yang akan menuliskan sintaks di bawah ini ke dalam teks; dialog yang sama akan terbuka kembali dan mengedit ekspresi yang sudah ada.

Prasetel ekspor tabel menyediakan jenis kondisional yang sama pada pemetaan Single field; sasarannya adalah field pemetaan itu sendiri.

Kumpulan simbol lengkap

Simbol	Nama	Fungsinya
`[[` … `]]`	Pembatas ekspresi	Membuka dan menutup sebuah ekspresi kondisional.
`][`	Pemisah sasaran	Mengakhiri field sasaran dan memulai daftar kondisi.
`==`	Sama dengan	Cocok bila nilainya tepat sama dengan nilai pembanding.
`!=`	Tidak sama dengan	Cocok bila nilainya berbeda dari nilai pembanding.
`~=`	Memuat	Cocok bila nilai pembanding muncul di bagian mana pun dari nilainya.
`!=""`	Tidak kosong	Cocok bila field memuat nilai apa pun.
`==""`	Kosong	Cocok bila field kosong atau tidak ada.
`&&`	Semua	Setiap kondisi harus cocok.
`\|\|`	Salah satu	Setidaknya satu kondisi harus cocok.
`"` … `"`	Tanda kutip nilai	Mengapit setiap nilai pembanding. Wajib, dan dibiarkan kosong untuk kedua operator kekosongan.
`\"` `\\`	Escape	Tanda kutip atau garis miring terbalik di dalam nilai pembanding.
`]=>`	Penanda penggantian	Mengakhiri kondisi dan memulai teks pengganti atau teks kondisional.
`if`	Kata kunci teks kondisional	Menggantikan posisi sasaran, sehingga ekspresi menulis teks alih-alih mengubah field.
`\|`	Pemisah selain itu	Setelah teks, memulai teks yang ditulis bila kondisinya tidak cocok.

Tiga bentuk

Apit nilai sasaran dengan tanda kurung siku bila kondisinya cocok:

[[sasaran][kondisi]]

Ganti nilai sasaran dengan teks literal bila kondisinya cocok:

[[sasaran][kondisi]=>"pengganti"]]

Tulis teks yang dipilih berdasarkan kondisinya, tanpa field sasaran:

[[if][kondisi]=>"teks"]]
[[if][kondisi]=>"teks"|"selain itu"]]

Perhatikan penutupnya: bentuk dengan penggantian dan bentuk teks tetap diakhiri ]], dan penanda ]=> berada di dalam ekspresi.

Teks kondisional (if dan else)

Teks kondisional menulis salah satu dari dua teks sesuai kondisinya, alih-alih mengubah nilai sebuah field. Gunakan untuk teks yang menyertai sebuah field tetapi hanya boleh muncul bersamanya, seperti satuan:

[mammalAttribute::testisWidth][[if][mammalAttribute::testisWidth!=""]=>" mm"]]

Lebar 6.5 mencetak 6.5 mm; lebar yang tidak ada tidak mencetak apa pun, bukan mm yang menggantung. Tambahkan teks kedua setelah | untuk menulis sesuatu bila kondisinya tidak cocok:

[[if][mammalAttribute::testisPosition=="0"]=>"skrotal"|"bukan skrotal"]]

Sebuah teks dapat memuat placeholder field, termasuk fallback dan #label, yang diisi ketika teks itu ditulis:

[[if][mammalAttribute::testisLength!=""&&mammalAttribute::testisWidth!=""]=>"[mammalAttribute::testisPosition#label], [mammalAttribute::testisLength] x [mammalAttribute::testisWidth] mm"]]

Kondisinya memakai operator yang sama dengan kondisional lain dan membandingkan kode tersimpan.
Apit setiap teks dengan tanda kutip, dan tulis tanda kutip di dalamnya sebagai \". Tanda | di dalam tanda kutip adalah teks biasa.
Tanpa teks kedua, tidak ada yang ditulis bila kondisinya tidak cocok.
Ekspresi kondisional lain di dalam teks tidak dievaluasi.
if ditulis dengan huruf kecil. Jenis Conditional text pada dialog menuliskan bentuk ini untuk Anda.

Dua contoh terurai

Mengapit bobot yang merupakan perkiraan. Pengukuran mamalia memiliki penanda akurasi yang menyebutkan field mana yang tidak diukur secara presisi. Apit bobotnya bila bobot termasuk salah satunya:

[[mammalAttribute::weight][mammalAttribute::accuracy~="weight"]]

Spesimen yang bobotnya ditandai mencetak [82.5]; yang diukur presisi mencetak 82.5. Inilah kasus khusus ~=: pada mammalAttribute::accuracy, pembandingannya menanyakan apakah pengukuran yang disebut itu ditandai, bukan apakah teksnya memuat kata tersebut.

Menandai nama yang identifikasinya tidak pasti. Keyakinan identifikasi disimpan sebagai 0 untuk Low, 1 untuk Medium, dan 2 untuk High, sehingga "bukan High" adalah !="2". Tempatkan genus dan epitet pada satu elemen teks, lalu jadikan epitetnya kondisional:

[taxonomy::genus] [[taxonomy::specificEpithet][specimen::iDConfidence!="2"]=>"?"]]

Identifikasi berkeyakinan tinggi mencetak Rattus rattus; tingkat di bawahnya mencetak Rattus ?.

Ada dua hal pada contoh ini yang perlu dipahami sebelum Anda mengandalkannya.

Kondisi membandingkan nilai yang tersimpan, bukan yang ditampilkan. Encoded Text mengubah 2 menjadi High di jalur menuju halaman, tetapi kondisi melihat 2, sehingga specimen::iDConfidence!="High" akan cocok dengan setiap catatan. Baca kodenya dari nilai yang benar-benar dimuat catatan itu.

Penggantian menyubstitusi nilainya; ia tidak menambahkan pada nilai itu. Itulah sebabnya contoh di atas mencetak Rattus ? dan bukan Rattus rattus?. Untuk mempertahankan sebuah nilai lalu menambahkan akhiran secara kondisional, tulis nilainya lalu ikuti dengan teks kondisional.

Perbandingan tidak kosong seperti !="2" tidak cocok dengan keyakinan yang belum dicatat. Untuk memasukkan kasus itu, gunakan Is empty sebagai kondisi OR tambahan:

[[taxonomy::specificEpithet][specimen::iDConfidence=="0"||specimen::iDConfidence=="1"||specimen::iDConfidence==""]=>"?"]]

Jenis kondisional pada dialog

Conditional type memilih susunan mana dari keempatnya yang dituliskan dialog:

Jenis	Keluaran	Kondisinya menguji
`Conditional brackets`	Mengapit nilai sasaran dengan `[ ]`	Field lain mana pun
`Conditional field`	Menulis `Replacement text`	Field lain mana pun
`Conditional value`	Menulis `Replacement text`	Nilai field sasaran itu sendiri
`Conditional text`	Menulis `Text when matched` atau `Text otherwise (optional)`	Field mana pun; tidak ada sasaran

Conditional text tidak memiliki Target field. Dialog menambahkan ekspresinya di akhir teks elemen.

Biarkan Replacement text kosong untuk menyembunyikan nilainya ketika kondisinya cocok.

Conditional value adalah pilihan untuk "bila field ini bernilai X, cetak Y". Ia menyetel field sumber setiap kondisi ke sasaran untuk Anda, dan itulah sebabnya pemilih field sumber menghilang saat Anda memilihnya.

Match logic menyetel penghubungnya: Any condition (OR) menulis || dan All conditions (AND) menulis &&.

Menyembunyikan nilai yang bergantung pada field lain

Is not empty dan Is empty adalah operator untuk "cetak ini hanya bila itu tercatat". Keduanya tidak memerlukan nilai pembanding, dan dialog menyembunyikan kotak nilai ketika Anda memilih salah satunya.

Pasangkan keduanya dengan Replacement text kosong untuk menyembunyikan nilai. Ekspresi ini mencetak panjang testis hanya bila posisi testis tercatat:

[[mammalAttribute::testisLength][mammalAttribute::testisPosition==""]=>""]]

Kondisional hanya menyembunyikan sasarannya. Teks literal di sebelahnya, seperti satuan atau x di antara dua ukuran, tetap tercetak. Beri teks itu kondisi tersendiri dengan teks kondisional:

[[mammalAttribute::testisLength][mammalAttribute::testisPosition==""]=>""]][[if][mammalAttribute::testisPosition!=""&&mammalAttribute::testisLength!=""]=>" mm"]]

Ukuran testis menunjukkan pola lengkap.

Bagaimana kondisi dievaluasi

Perbandingan memangkas spasi di tepi dan membedakan huruf besar-kecil. Nilai yang dibaca adalah nilai tersimpan: bandingkan "2", bukan "High", untuk keyakinan identifikasi. Gunakan Is empty (=="") atau Is not empty (!="") untuk menguji keberadaan nilai kolom sumber. Perbandingan lain tidak cocok dengan sumber kosong. Jangan campur && dan || dalam satu ekspresi.

Target kosong menggunakan No Content Placeholder, bukan penggantian kondisional. ~="" tidak valid. Ekspresi yang salah format dapat tercetak secara literal; pratinjau catatan yang cocok dan tidak cocok. Penggantian menukar seluruh nilai; pengganti kosong menyembunyikan target berisi ketika kondisinya cocok.

Untuk mammalAttribute::accuracy, ~= menguji apakah pengukuran yang disebut ditandai tidak akurat, misalnya mammalAttribute::accuracy~="totalLength". Pada kolom ini, operator tersebut bukan pencarian potongan teks biasa.

Jenis teks dan formatnya

Prasetel ekspor tabel memakai jenis teks yang sama untuk format pemetaan Single field.

Jenis teks	Opsi format
`Normal Text`	`Normal`, `Uppercase`, `Lowercase`, `Capitalize`
`Picture`	Diatur dengan lebar dan tinggi, bukan dengan format
`Markdown`	`Normal`; menampilkan teks kaya seperti narasi
`Coordinates`	`Decimal`, `Cardinal Dec`, `DMS`, `DDM`
`List Values`	Garis tegak, koma, titik koma, garis miring, baris baru, butir, pemisah kustom
`Nested List`	`Table` atau `Card list`; tabel menambahkan kontrol `Header Case`
`Dates`	`YYYY-MM-DD`, `DD-MM-YYYY`, `MM-DD-YYYY`, `DD/MM/YYYY`, `MM/DD/YYYY`, `Month DD, YYYY`, `DD Month YYYY`, `DD Mon YYYY`
`Date and Time`	Tujuh belas kombinasi format tanggal di atas dengan keluaran 24 jam, 12 jam, ISO, dan hanya waktu
`Time`	`24h`, `24h seconds`, `12h`, `12h padded`
`Sex`	`Presentation` dan `Missing`, dijelaskan di bawah
`Number`	`Original`, atau 0, 1, 2, atau 3 angka desimal
`Encoded Text`	`Default mapping` atau `Custom mapping...`

Nested List digunakan untuk catatan terkait — bagian spesimen, personel, nilai upaya — dan merupakan jenis teks yang paling sering memerlukan ukuran dinamis.

`Encoded Text`: apa yang diterjemahkan

Encoded Text mengubah kode numerik tersimpan menjadi labelnya. Default mapping menggunakan tabel di bawah, dicocokkan pada akhir key field, sehingga mammalAttribute::testisPosition maupun testisPosition yang singkat sama-sama diterjemahkan.

Key field diakhiri	Kode 0	1	2	3	4	5	6
`::sex`	Male	Female	Unknown	Gynandromorph	Hermaphrodite	Female?	Male?
`::iDConfidence`	Low	Medium	High
`mammalAttribute::age`	Adult	Subadult	Juvenile	Unknown
`herpAttribute::age`	Adult	Juvenile	Neonate	Metamorph	Unknown
`::testisPosition`	Scrotal	Abdominal
`::epididymisAppearance`	Tubular	Partial	Not Tubular
`::vaginaOpening`	Imperforate	Perforate
`::pubicSymphysis`	Close	Small Open	Open
`::reproductiveStage`	Nulliparous	Primiparous	Multiparous
`::mammaeCondition`	Small	Large	Lactating
`::echolocation`	FM	CF	QCF	None
`::ovaryAppearance`	Smooth	Ova minute	At least one ovum ≥ 1 mm dia.
`::oviductAppearance`	Straight	Convoluted
`::fat`	None	Trace	Light	Moderate	Heavy	Extremely Heavy
`::bodyMolt`	None	Trace	Light	Moderate	Heavy

Field berikut diterjemahkan menjadi Yes untuk 1 dan No untuk 0:

::broodPatch, ::hasBursa, ::wingIsMolt, ::tailIsMolt, ::showBatFields, ::showEchoFields.

Selain itu dibiarkan apa adanya. Field yang tidak ada di tabel di atas, nilai yang bukan bilangan bulat, dan kode di luar daftarnya semuanya dicetak tanpa perubahan — dan itulah biasanya arti angka polos pada label cetak. Custom mapping... adalah cara memberi label pada field yang tidak dicakup pemetaan bawaan.

Dua di antaranya memiliki alternatif yang lebih ramah. Jenis teks Sex memformat sex sebagai simbol atau huruf dan menangani ketidakpastian, dan […sex]-img menggambarnya sebagai ikon; gunakan Encoded Text pada field sex hanya bila Anda menginginkan katanya secara polos.

Menerjemahkan field berkode

Field berkode menyimpan angka, seperti 0 atau 1, dan ekspresinya tidak berubah: tulis placeholder field seperti biasa. Yang mengubah kode menjadi labelnya adalah jenis teks, bukan placeholder-nya.

Pada templat dokumen. Letakkan placeholder di elemen teks lalu setel Text type ke Encoded Text:

Testis: [mammalAttribute::testisPosition]

Dengan Default mapping, spesimen yang menyimpan 0 mencetak Testis: Scrotal. Setiap placeholder dalam elemen diterjemahkan berdasarkan field-nya sendiri, sehingga satu elemen dapat memuat beberapa field berkode:

[mammalAttribute::age], [mammalAttribute::testisPosition]

Pada prasetel ekspor tabel. Gunakan pemetaan Single field untuk field berkode lalu setel Value format ke Encoded text. Pemetaan Custom field selalu memakai Normal Text, jadi tambahkan #label pada field berkode di dalamnya atau pilih Show label pada segmennya:

[mammalAttribute::testisPosition#label], [mammalAttribute::mammaeCondition#label]

Penanda #label. #label menerjemahkan satu placeholder dengan pemetaan bawaan pada jenis teks apa pun, sehingga satu elemen atau kolom dapat mencampur kode dan label. Tulis setelah key dan sebelum fallback, seperti [mammalAttribute::sex#label??Unknown]. Nilai tanpa label bawaan dicetak apa adanya.

Label kustom. Di editor templat, pilih Custom mapping... sebagai format, lalu Map encoded values untuk mengetik label bagi setiap kode. Dialog dimulai dari label bawaan. Pada prasetel tabel, tulis pemetaan yang sama di Advanced > Raw format option:

custom_map:0=Scrotal,1=Abdominal

Tulis setiap pasangan sebagai kode=label, dipisahkan koma. Label tidak boleh memuat koma atau tanda sama dengan, dan kode tanpa pasangan dicetak tanpa perubahan. Nilai Raw format option lainnya, seperti enum, memakai pemetaan bawaan. Pemetaan kustom berlaku untuk setiap placeholder dalam elemen, jadi beri field dengan pemetaan kustom elemen teksnya sendiri.

Kondisi tetap membaca kode. Penerjemahan hanya mengubah apa yang dicetak. Kondisi pada field berkode membandingkan kode tersimpan, jadi tulis mammalAttribute::testisPosition=="0", bukan =="Scrotal". Field kosong tidak diterjemahkan; field itu memakai fallback No Content Placeholder.

Pemformatan sex

Kontrol	Pilihan
`Format`	`Symbol (♂/♀)`, `Letter (M/F)`, `Text (Male/Female)`
`Missing`	`Unknown`, `N/A`, `None`

Penentuan yang tidak pasti mempertahankan akhirannya pada setiap penyajian: Female?, F?, ♀?, dan Male?, M?, ♂?.

Mengatasi masalah sintaks

Gejala	Yang perlu diperiksa
Kondisional tercetak apa adanya	Ekspresi yang salah bentuk dilewati. Periksa `]]` yang hilang, nilai tanpa tanda kutip, atau `&&` dan `\|\|` yang dicampur.
Fallback mencetak `[table::field]`	Pilihan fallback `table::field` sedang dipakai; ubah ke `Blank`, `N/A`, `None`, atau teks kustom.
Ikon sex tampil sebagai teks	Elemennya harus berisi `[…sex]-img` saja, dan key-nya harus diakhiri `.sex`.
Gambar catatan tidak muncul	Elemennya harus berisi `[media::media]` saja dan memakai jenis teks `Picture`.
Kolom field kustom memiliki tajuk yang tidak terduga	Setel `Column name`. Tanpanya, tajuk diambil dari field pertama atau dari teks literal.
Field berkode mencetak angka	Gunakan jenis teks `Encoded Text`, `Encoded text` pada pemetaan `Single field`, atau tambahkan `#label` pada placeholder. Pastikan kodenya ada di pemetaan bawaan.
Teks kondisional tidak mencetak apa pun	Tanpa teks kedua setelah `\|`, tidak ada yang ditulis bila kondisinya tidak cocok. Kondisi membandingkan kode tersimpan, dan `if` harus huruf kecil.

Opsi editor templat

Opsi berikut hanya berlaku untuk editor templat dokumen. Prasetel ekspor tabel tidak menggunakannya.

Ukuran pada kanvas dinyatakan dalam milimeter (mm). Ketebalan garis, ukuran fon, dan padding dinyatakan dalam poin PDF (pt, di mana 1 pt adalah 1/72 inci). Warna disimpan sebagai nilai 0xAARRGGBB, tetapi selalu dipilih melalui pemilih warna.

Bilah alat

Kontrol	Fungsinya
`Add text`	Menempatkan elemen teks baru pada kanvas.
`Add image`	Menempatkan gambar statis dari perangkat.
`Add line`	Menempatkan garis lurus.
`Add shape`	Menempatkan persegi panjang, elips, lingkaran, segitiga, atau poligon.
`Save template`	Menyimpan templat. Gunakan `Save as...` untuk membuat variasi.
`Undo` / `Redo`	Menelusuri riwayat pengeditan.
`Template border`	Membuka panel garis tepi untuk batas templat.
`Show grid` / `Hide grid`	Mengalihkan grid perataan.
`Enable snap` / `Disable snap`	Mengalihkan pengancingan ke grid dan ke elemen lain.
Kunci kanvas	Membekukan penggeseran agar tarikan tidak memindahkan kanvas.
`Select specimen for text preview`	Memilih catatan yang nilainya mengisi placeholder saat Anda merancang.
`Template settings`	Nama, deskripsi, jumlah sisi, dan ukuran templat.
`Preset template`	Memuat titik awal yang sudah disediakan.
`Zoom in` / `Zoom out`	Hanya mengubah skala tampilan kanvas; tidak ada yang berubah pada hasilnya.
`1 sided` / `Front` / `Back`	Mengalihkan mode sisi dan sisi yang sedang diedit.
Cermin	Mencerminkan satu sisi, untuk tag yang dilipat pada satu tepi.

Opsi elemen teks

Konten

Opsi	Nilai	Catatan
Teks	Teks apa pun, placeholder, kondisional	Isi elemen.
`Text type`	Lihat tabel di bawah	Menentukan bagaimana nilainya diformat.
`Format`	Bergantung pada jenis teks	Format spesifik di dalam jenis tersebut.
`No Content Placeholder`	Blank, `table::field`, `N/A`, `None`, kustom	Menuliskan fallback `??`.
`Conditional output`	Kurung, field, nilai	Menuliskan ekspresi `[[ … ]]`.
`Find and replace`	—	Mengedit teks elemen.
Replacement rule	Pola, pengganti, jenis kecocokan, kepekaan huruf	Menulis ulang nilai setelah pemformatan.
`Map encoded values`	Pemetaan bawaan atau kustom	Mengubah kode tersimpan menjadi label untuk `Encoded Text`.

Tipografi dan gaya

Opsi	Nilai
`Font`	Fon bawaan dan terpasang; fon yang tidak terpasang ditandai `(not installed)`
Ukuran fon	Poin, dengan tombol untuk menambah dan mengurangi
`Bold`, `Italic`, `Underline`, `Strikethrough`	Aktif atau tidak
Perataan	`Align left`, `Align center`, `Align right`
Huruf	`Normal`, `Uppercase`, `Lowercase`, `Capitalize`
Warna teks	Pemilih warna

Kotak dan penempatan

Opsi	Nilai	Catatan
Posisi	X dan Y dalam mm	Diukur dari sudut kiri atas templat.
Lebar maksimum	mm	Teks dilipat pada lebar ini. Bila tidak disetel, teks tidak dilipat.
Tinggi	mm	Membatasi tinggi kotak teks.
Padding	pt	Ruang di dalam kotak, di sekitar teks.
Rotasi	0–359 derajat	Derajat bulat.
Warna latar	Warna atau tidak ada	—
Warna, ketebalan, dan gaya garis tepi	Warna, pt, `solid` / `dashed` / `dotted` / `double`	—
Radius sudut	pt	Membulatkan sudut kotak.
Ukuran dinamis	Aktif atau tidak	Membiarkan kotak tumbuh mengikuti teks. Pasangkan dengan `Auto-fill page` pada blok tata letak.
Penumpukan	`Bring to front`, `Bring forward`, `Send backward`, `Send to back`	—
Kunci	Aktif atau tidak	Elemen yang terkunci tidak dapat ditarik atau diubah ukurannya.
Terlihat	Aktif atau tidak	Elemen yang disembunyikan tetap ada di templat, tetapi tidak dicetak.

Kode QR

Ubah elemen teks menjadi kode QR untuk membawa identifier yang dapat dibaca kembali oleh ponsel.

Opsi	Nilai
Kode QR	Aktif atau tidak
Ukuran	mm
Warna latar	Pemilih warna
Bentuk	`Square` atau `Circle`

Muatan QR menyimpan nilai terformat apa adanya, termasuk .0 di akhir yang akan dibuang oleh teks cetak, sehingga kode yang dipindai sama persis dengan nilai yang tersimpan.

Gambar

Opsi	Nilai
Lebar, tinggi	mm

Hanya elemen yang berisi [media::media] atau [media] saja yang diuraikan menjadi gambar catatan. Mencampur placeholder ini dengan teks lain memang tidak akan bekerja.

Opsi gambar, garis, dan bentuk

Gambar statis, garis, dan bentuk bersifat dekoratif. Ketiganya tidak membawa data catatan, sehingga tidak memiliki jenis teks, format, maupun opsi kondisional.

Elemen	Opsi
Gambar	Path gambar, posisi, lebar, tinggi, rotasi, penumpukan, kunci, visibilitas
Garis	Posisi, panjang, rotasi, ketebalan (pt), warna, gaya garis, penumpukan, kunci, visibilitas
Bentuk	Jenis bentuk, posisi, lebar, tinggi, rotasi, ketebalan garis, warna garis, gaya garis, warna isian atau `Clear fill`, penumpukan, kunci, visibilitas

Jenis bentuknya adalah rect, ellipse, circle, triangle, dan polygon; poligon juga memerlukan jumlah sisi. Gaya garis untuk garis dan bentuk adalah solid, dashed, dotted, dan double.

Elemen gambar menyimpan path, bukan gambarnya. Templat yang diekspor ke perangkat lain menyebutkan nama gambarnya dan memintanya kembali di sana.

Opsi templat

Opsi	Nilai	Catatan
`Template name`	Teks	Harus unik. Mengganti nama akan mengarahkan ulang setiap tata letak yang memakai nama lama.
`Description`	Teks, hingga 80 karakter	Opsional.
`Record type`	`Specimen`, `Specimen Part`, `Site`, `Collecting Event`, `Narrative`, `None`	Menentukan field dan catatan mana yang tersedia.
Jumlah sisi	`1 sided` atau `2 sided`	Templat satu sisi tetap menyimpan rancangan sisi belakangnya, tetapi tidak mencetaknya.
Lebar, tinggi	mm	Ukuran satu blok, bukan lembarnya.
`Template border`	Gaya, ketebalan (pt), warna	Gayanya adalah `solid`, `dashed`, `dotted`, dan `double line`.

Opsi cetak yang disimpan bersama templat mencakup duplex, pencerminan sisi depan dan belakang, ukuran halaman, baris dan kolom per halaman, padding halaman, serta padding dokumen. Preset tata letak cetak menimpa opsi ini untuk lembar yang dihasilkannya; lihat Ekspor Dokumen.