Panduan Feat Desain: 2. Data frdata frperusahaan

🖨️

Setiap formulir dan laporan di Feat terhubung dengan dua sumber data, yaitu frPerusahaan dan frData. Panduan ini menjelaskan isi keduanya, cara menghubungkan objek dengan data, dan variabel yang dikenal Feat.

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

ℹ️ Ini adalah Panduan 2 dari 7 seri Panduan Mendesain Formulir dan Laporan di Feat. Panduan ini memakai istilah standar FastReport karena itulah istilah yang tampil di layar designer.

← Membuka Designer dan Mengenal Layarnya Daftar Isi Tanda [ ] dan < >, Ekspresi, serta Rumus →

Setiap formulir dan laporan di Feat otomatis dihubungkan dengan dua dataset FastReport yang sudah tersedia saat designer dibuka. Keduanya tidak perlu (dan tidak boleh) dibuat sendiri.

Dataset	Isi	Jumlah baris	Berasal dari
frPerusahaan	Identitas perusahaan: nama, alamat, logo, telepon	Selalu 1 baris	Setup › Perusahaan
frData	Data dokumen (formulir) atau data laporan	Banyak baris	Kueri milik template, sesuai tipenya

Keduanya tampak pada Data Tree, tab Data. Kotak dialog Report › Data… juga menampilkan keduanya dalam keadaan tercentang.

🔒 Perhatian: jangan menghapus centang frPerusahaan atau frData pada Report › Data…. Jika terhapus, objek yang memakai data akan menampilkan pesan error.

frPerusahaan – Data Perusahaan

Field	Isi
`COMPANY NAME`	Nama perusahaan
`ADDRESS`	Alamat
`LOGO`	Logo (gambar)
`CITY`, `STATE`, `COUNTRY`	Kota, provinsi, negara
`TELEPHONE`, `FAX`, `WEBSITE`	Telepon, faks, situs web
`TAX ID`	Nomor pajak (NPWP) perusahaan
`NITKU`	Nomor Identitas Tempat Kegiatan Usaha

Contoh penulisan pada Text object:

[frPerusahaan."COMPANY NAME"]
[frPerusahaan."ADDRESS"] - [frPerusahaan."CITY"]
Telp. [frPerusahaan."TELEPHONE"]

Logo dipasang dengan Picture object yang properti DataSet-nya frPerusahaan dan DataField-nya LOGO. Untuk mengisi atau mengubah data perusahaan, gunakan Setup › Perusahaan, bukan designer.

frData – Data Dokumen atau Laporan

Dataset ini berisi hasil kueri milik template. Karena kuerinya berbeda untuk setiap tipe, field yang tersedia juga berbeda-beda. Daftar sebenarnya selalu yang tampak pada Data Tree di template yang sedang dibuka.

Pada formulir, satu dokumen menghasilkan satu baris untuk setiap baris isi dokumen (misalnya setiap barang pada faktur), dan data kepala dokumen (nomor, tanggal, pelanggan, total) diulang di setiap baris. Akibatnya:

Objek di Page Header dan Page Footer menampilkan data kepala dokumen.
Objek di Master Data tercetak sekali untuk setiap baris isi (kode barang, jumlah, harga).

Contoh sebagian field pada tipe Faktur Penjualan:

Kelompok	Field
Kepala dokumen	`NO FAKTUR`, `TANGGAL FAKTUR`, `NO PO`, `KETERANGAN`
Pelanggan	`KODE REKAN`, `NAMA REKAN`, `ALAMAT`, `KOTA`, `TELEPON`, `NPWP`
Penjualan	`NAMA SALESMAN`, `NAMA TERMIN`, `JATUH TEMPO`, `KURS`
Total	`PENJUALAN`, `DISKON`, `NETTO`, `PAJAK`, `TOTAL TRANSAKSI`, `UANG MUKA`
Isi (per baris)	`SEQ`, `KODE BARANG`, `NAMA BARANG`, `SATUAN`, `JUMLAH`, `HARGA`, `JUMLAH HARGA`
Isian tambahan	`TEXT1`–`TEXT5`, `NUMERIC1`–`NUMERIC5`, `TANGGAL1`–`TANGGAL5`

Pada laporan, setiap baris frData adalah satu baris hasil laporan, sesuai tanggal awal, tanggal akhir, dan filter yang dipilih pengguna.

💡 Mencari field: ketik sebagian nama field pada kotak cari di pojok kanan atas Data Tree. Daftar akan menyempit mengikuti ketikan.

Bila field yang dibutuhkan tidak ada: designer tidak dapat menambah field karena field ditentukan oleh kueri template. Lakukan hal berikut:

Periksa apakah template bertipe lain menyediakan field tersebut, lalu buat template baru dari tipe itu.
Periksa isian tambahan TEXT1–TEXT5, NUMERIC1–NUMERIC5, dan TANGGAL1–TANGGAL5.
Hubungi pengembang Feat untuk penambahan field pada kueri.

Tiga Cara Menghubungkan Objek dengan Data

Tarik dari Data Tree: buka tab Data, klik nama field, lalu tarik ke dalam band. Designer membuat Text object berisi [frData."SATUAN"].
Ketik di Text object: klik dua kali objek, lalu ketik ekspresi lengkap dengan tanda [ ] dan tanda petik ganda.
Lewat Object Inspector: isi properti DataSet dengan frData dan DataField dengan nama field. Cara ini dipakai Feat pada logo perusahaan.

Band Master Data harus terhubung ke frData agar tercetak berulang untuk setiap baris data. Pada template bawaan sudah demikian, ditandai tulisan frData di ujung kanan band.

Variabel yang Dikenal Feat

Variabel ditulis tanpa tanda petik, misalnya [Judul]. Daftarnya terlihat pada Data Tree › tab Variables.

Variabel	Dipakai di	Menampilkan
`[Date]`, `[Time]`	Formulir dan laporan	Tanggal dan jam saat ini
`[Page#]`, `[TotalPages#]`	Formulir dan laporan	Nomor halaman dan jumlah seluruh halaman
`[Line#]`	Formulir dan laporan	Nomor urut baris data (terus bertambah walaupun data dikelompokkan)
`[Version]`	Formulir dan laporan	Nama dan nomor versi Feat
`[UserName]`	Formulir dan laporan	Nama pengguna yang sedang mencetak
`[Judul]`	Laporan	Nama laporan sesuai kolom Nama pada daftar template
`[StartDate]`, `[FinishDate]`	Laporan	Tanggal awal dan tanggal akhir yang dipilih pengguna
`[AsOfDate]`	Laporan tertentu	Tanggal “per tanggal”, hanya pada laporan yang memiliki filter tersebut

ℹ️ Variabel milik Feat (Judul, StartDate, dan sebagainya) tidak perlu didaftarkan pada Report › Variables…. Feat mengisinya secara otomatis. Cukup ketik [Judul] pada Text object.

Ingin menampilkan	Tulis di Text object
Nama perusahaan	`[frPerusahaan."COMPANY NAME"]`
Nomor faktur	`[frData."NO FAKTUR"]`
Judul laporan	`[Judul]`
Periode laporan	`[StartDate] - [FinishDate]`
Nomor halaman	`Halaman [Page#] dari [TotalPages#]`

Pertanyaan Umum

❓ Apakah field baru dapat ditambahkan lewat designer?

Tidak. Field ditentukan oleh kueri milik template. Periksa template bertipe lain, gunakan isian tambahan TEXT1 sampai TEXT5, NUMERIC1 sampai NUMERIC5, atau TANGGAL1 sampai TANGGAL5, atau hubungi pengembang Feat.

❓ Di mana data perusahaan pada cetakan diubah?

Ubah di Setup, Perusahaan, bukan di designer. Isi cetakan akan mengikuti data tersebut.