Panduan Feat Desain: 3. Rumus dan Tanda Kurung

🖨️

Panduan ini menjelaskan perbedaan tanda [ ] dan < >, cara menulis rumus, fungsi yang tersedia, fungsi agregat, serta cara mengatasi pesan error.

⭐ Feat Desktop   ⭐ Feat Professional   ⭐ Feat Enterprise   ⭐ Feat ERP

Tanda [ ] sebagai Batas Ekspresi

Tanda < > untuk Mengambil Nilai Field di Dalam Rumus

Di dalam [ ] terdapat dua bentuk penulisan:

• Bentuk A (hanya menampilkan field): tulis nama field tanpa < >, misalnya [frData."JUMLAH HARGA"].
• Bentuk B (ada rumus, fungsi, atau perbandingan): setiap field wajib dibungkus < >.

[<frData."JUMLAH HARGA"> * 2]
[iif(<frData."JUMLAH"> > 10, 'Banyak', 'Sedikit')]
[<frData."KODE BARANG"> + ' - ' + <frData."NAMA BARANG">]

Mengapa demikian? Isi rumus dibaca sebagai script PascalScript. Tanda < > mengubah nama field menjadi nilainya. Tanpa tanda tersebut, FastReport mengira seluruh isi [ ] adalah satu nama field dan mencarinya.

Perbandingan Hasil Nyata

Contoh berikut diuji pada faktur dengan JUMLAH HARGA = 2.500.000.

Aturan Penulisan Nama Field

• Bentuknya NamaDataset."NAMA FIELD", misalnya frData."JUMLAH HARGA".
• Tanda petik ganda wajib bila nama field mengandung spasi. Nama field di Feat umumnya huruf besar semua dan sering memakai spasi.
• Nama field dan nama dataset tidak membedakan huruf besar dan kecil, tetapi sebaiknya ditulis sama seperti yang tampak di Data Tree.
• Teks (string) di dalam rumus memakai tanda petik tunggal: 'Besar'.
• Angka desimal di dalam rumus memakai titik: 0.11, bukan 0,11.

Di Mana Memakai [ ], Di Mana Tidak?

Operator

Fungsi yang Sering Dipakai

Seluruh daftar fungsi ada pada Data Tree › tab Functions. Klik dua kali nama fungsi atau tarik ke dalam teks untuk memasukkannya.

Kategori Feat functions adalah fungsi tambahan khusus dari Feat. Contoh penggunaan yang sudah diuji:

Fungsi Agregat (Total, Hitung, Rata-rata)

SUM(<frData."JUMLAH HARGA">, MasterData1)

• SUM = jumlah, MIN = terkecil, MAX = terbesar, AVG = rata-rata, COUNT = banyak baris.
• Argumen kedua adalah nama band data yang dihitung (lihat nama band pada Report Tree).
• Argumen ketiga bersifat pilihan: 1 = hitung juga band yang disembunyikan, 2 = total berjalan (running total), 3 = keduanya.

Cara mudah dengan dialog Insert Aggregate:

1. Klik dua kali Text object di band total (misalnya Group Footer).
2. Pada tab Text, klik tombol Σ (Insert Aggregate).
3. Pilih Function, Data band, DataSet, dan DataField.
4. Klik OK. Teks [SUM(<frData."JUMLAH HARGA">,MasterData1)] masuk ke objek.

Hasil agregat bergantung pada letak band tempat teks berada:

Terbilang dan Script

Cetakan faktur Feat memuat baris seperti “Terbilang: tujuh juta lima ratus ribu rupiah”. Cara termudah adalah memakai fungsi Terbilang:

Terbilang: [Terbilang(<frData."TOTAL TRANSAKSI">)] rupiah

Kata “rupiah” ditulis di luar [ ] karena fungsi hanya menghasilkan kata bilangannya. Untuk huruf awal kapital, bungkus dengan NameCase.

Untuk kebutuhan yang tidak tercakup rumus, tersedia tab Code berisi script PascalScript. Pada script, field diambil dengan < > tanpa [ ]:

procedure Memo1OnBeforePrint(Sender: TfrxComponent);
begin
  if <frData."TOTAL TRANSAKSI"> = 0 then
    TfrxMemoView(Sender).Text := 'nol rupiah';
end;

Pertanyaan Umum

❓ Apa perbedaan tanda kurung siku dan kurung sudut pada rumus Feat?

Kurung siku menandai bagian teks yang harus dihitung. Kurung sudut dipakai di dalam rumus untuk mengambil nilai field. Pada kolom yang sudah pasti berupa rumus, seperti kondisi Highlight, kurung siku tidak dipakai.

❓ Mengapa muncul pesan Field not found saat Preview?

Penyebab umumnya field di dalam rumus tidak dibungkus kurung sudut, misalnya ditulis frData."JUMLAH HARGA" * 2. Tulis sebagai [<frData."JUMLAH HARGA"> * 2] dan periksa ejaan nama field pada Data Tree.

❓ Mengapa hasil rumus tampil 0 pada Preview di dalam designer?

Preview di dalam designer tidak berisi data. Periksa hasil sebenarnya lewat Preview pada transaksi untuk formulir, atau lewat Daftar, Semua Laporan untuk laporan.