Membuat Laporan Crystal Report | Kemampuan aplikasi untuk membuat sebuah laporan yang bisa dicetak ke printer adalah hal umum yang harus bisa dilakukan sebuah aplikasi desktop. Untuk itu skill ini amat sangat diperlukan oleh seorang programmer pengembang aplikasi desktop. Tutorial ini mencoba memberikan arahan langkah demi langkah cara menggunakan vb.net untuk membuat sebuah laporan crystal report sederhana namun professional menggunakan Push Method, artinya proses pengambilan data dari database dilakukan di luar Crystal Report , namun menggunakan DataSet, dan setelah data siap, Data Set bersangkutan di-Push ke Crystal Report. Studi kasus berupa Laporan Purchase Order. Aplikasi ini dibuat menggunakan C# karena dengan menguasai C# kita lebih mudah untuk migrasi ke bahasa lain seperti Java. Namun jika kita ingin membuatnya dalam bahasa lain, seperti VB.net, itu adalah hal yang sangat mudah karena coding dalam aplikasi ini hanya beberapa baris saja.
Beberapa hal lain yang perlu diperhatikan antara lain, tutorial ini tidak membahas cara menjalankan Visual Studio, cara membuat Project baru, cara menambah Form atau DataSet baru, cara membuka Server Explorer dan sebangsanya. Ane berasumsi agan semua sudah mengetahui cara-caranya. Tutorial ini juga tidak membahas cara menyimpan data master detail ke dalam database, karena concern kita saat ini hanyalah manmpilkan data yang sudah ada dalam database menggunakan crystal report. Database yang digunakan adalah SQL Server Compact Database. Tutorial ini juga tidak membahas cara membuat database baru, cara koneksi database di .NET, cara design database yang baik dan lain sebagainya. Ane berasumsi agan semua sudah mengetahui cara-caranya.
Membuat Project dan DataSet
Buat project baru dan Siapkan database, untuk tutorial ini ane pakai Local Database (dbSample.sdf). Note: cara membuat project baru dan design database atau menggunakan database lain tidak dibahas di sini.
[collapsed title=Desain Database] 
[/collapse]
Tambahkan DataSet baru, beri nama dsSample.xsd, setelah itu buka Database menggunakan Server Explorer. Lakukanlah drag dan drop table yang ada di Database Explorer ke atas dataset designer dsSample.xsd menjadi seperti yang ada di gambar.
[collapsed title=Desain Datasat Setelah Proses Drag-Drop] [/collapse]
Buat custom query untuk mengambil data Companies berdasarkan CompanyID, beri nama method Fill dengan FillByCustomerID dan method Return DataTable dengan GetDataByCompanyID. Note: Perhatikan step pembuatannya di gambar.
[collapsed title=Custom query untuk table Companies]
[collapsed title=Langkah ke-1]
[/collapse]
[collapsed title=Langkah ke-2]
[/collapse]
[collapsed title=Langkah ke-3]
[/collapse]
[collapsed title=Langkah ke-4]
[/collapse]
[collapsed title=Langkah ke-5]
[/collapse]
[collapsed title=Langkah ke-6]
[/collapse]
[/collapse]
Buat custom query untuk mengambil data Orders berdasarkan OrderID, beri nama method Fill dengan FillByOrderID dan method Return DataTable dengan GetDataByOrderID. Note: Perhatikan step pembuatannya di gambar.
[collapsed title=Custom query untuk table Orders]
[collapsed title=Langkah ke-1]
[/collapse]
[collapsed title=Langkah ke-2]
[/collapse]
[collapsed title=Langkah ke-3]
[/collapse]
[collapsed title=Langkah ke-4]
[/collapse]
[collapsed title=Langkah ke-5]
[/collapse]
[collapsed title=Langkah ke-6]
[/collapse]
[/collapse]
Buat custom query untuk mengambil data OrderDetails berdasarkan OrderID, beri nama method Fill dengan FillByOrderID dan method Return DataTable dengan GetDataByOrderID. Note: Perhatikan step pembuatannya di gambar.
[collapsed title=Custom query untuk table OrderDetails]
[collapsed title=Langkah ke-1]
[/collapse]
[collapsed title=Langkah ke-2]
[/collapse]
[collapsed title=Langkah ke-3]
[/collapse]
[collapsed title=Langkah ke-4]
[/collapse]
[collapsed title=Langkah ke-5]
[/collapse]
[collapsed title=Langkah ke-6]
[/collapse]
[/collapse]
Buat custom query untuk mengambil data Items berdasarkan OrderID, beri nama method Fill dengan FillByOrderID dan method Return DataTable dengan GetDataByOrderID. Note: Perhatikan step pembuatannya di gambar.
[collapsed title=Custom query untuk table Orders]
[collapsed title=Langkah ke-1]
[/collapse]
[collapsed title=Langkah ke-2]
[/collapse]
[collapsed title=Langkah ke-3]
[/collapse]
[collapsed title=Langkah ke-4]
[/collapse]
[collapsed title=Langkah ke-5]
[/collapse]
[collapsed title=Langkah ke-6]
[/collapse]
[/collapse]
Buat custom query untuk mengambil list Orders yang terdenormalisasi, beri nama method Fill dengan FillList dan method Return DataTable dengan GetDataList. Note: Perhatikan step pembuatannya di gambar.
[collapsed title=Custom query untuk List Orders]
[collapsed title=Langkah ke-1]
[/collapse]
[collapsed title=Langkah ke-2]
[/collapse]
[collapsed title=Langkah ke-3]
[/collapse]
[collapsed title=Langkah ke-4]
[/collapse]
[collapsed title=Langkah ke-5]
[/collapse]
[collapsed title=Langkah ke-6]
[/collapse]
[/collapse]
Compile aplikasi (Ctrl-F5). Langkah ini penting agar dapat maju ke langkah berikutnya. Jika tidak dilakukan kompilasi, maka Crystal Report tidak bisa menggunakan DataSet – yang kita siapkan pada langkah sebelumnya – sebagai definisi report.
Sekarang DataSet sudah siap kita gunakan
[collapsed title=Hasil Akhir DataSet]
[/collapse]
Membuat Report Definition
Tambahkan Crystal Report ke project untuk laporan List Order, pilih “Using the Report Wizard” untuk membuat definisi report, kemudian pilih Create New Connection > ADO.NET (XML) sebagai data source dan arahkan File Path ke DataSet dsSample.xsd yang kita buat pada langkah sebelumnya.
[collapsed title=Koneksi report ke data source]
[collapsed title=Using the Report Wizard]
[/collapsed]
[collapsed title=Create New Connection]
[/collapsed]
[collapsed title=Arahkan File Path]
[/collapsed]
[collapsed title=Data source terkoneksi]
[/collapsed]
[/collapsed]
Tambahkan ke Selected Tables: Companies, Orders, OrderDetails, dan Items ke list “Selected Tables”, kemudian klik next untuk melihat relasi antar tabel
[collapsed title=Selected Tables]
[collapsed title=Selected Tables]
[/collapsed]
[collapsed title=Relationship antar Tabel]
[/collapsed]
[/collapsed]
Tambahkan field-field yang yang akan ditampilkan ke list “Fields to Display”, kemudian tambahkan juga report grouping, summary, dan filtering jika diperlukan, akhiri dengan memilih template yang diinginkan.
[collapsed title=Fields to Display]
[collapsed title=Fields to Display]
[/collapsed]
[collapsed title=Grouping Fields]
[/collapsed]
[collapsed title=Summary Fields]
[/collapsed]
[collapsed title=Filtering Fields]
[/collapsed]
[collapsed title=Pilih Templete]
[/collapsed]
[/collapsed]
Tampilan standar dari wizard, Silakan ubah layoutnya sesuai keinginan agan, misalkan menjadi seperti ini,
[collapsed title=Hasil report wizardwizard]
[collapsed title=Tampilan standar dari wizard]
[/collapsed]
[collapsed title=ubah layoutnya]
[/collapsed]
[/collapsed]
Tambahkan formula field untuk menghitung nilai order dengan cara klik kanan pada item “Formula Field” di window “Field Explorer”. Beri nama formula tersebut “ItemAmount” dan isikan rumusnya seperti pada gambar, kemudian klik tombol “Save and Close” di pojok kanan. Note: agar tidak perlu ketik ulang nama field di formula editor, bisa dengan cara klik ganda pada field yang ada di Field Tree.
[collapsed title=Formula Field]
[collapsed title=Tambah Formula Field]
[/collapsed]
[collapsed title=Tentukan Rumusnya]
[/collapsed]
[collapsed title=Masukkan formula field ke report]
[/collapsed]
[/collapsed]
Tambahkan Subtotal untuk field ItemAmount, dengan cara klik kanan mouse pada field Item Amount, kemudian pilih menu “Insert” -> “Summary”, kemudian ubah “Summary Location” menjadi “Group 1” Hasilnya akan muncul field summary persis di bawah field “ItemAmount”.
[collapsed title=Subtotal ]
[collapsed title=Buat field summary]
[/collapsed]
[collapsed title=Field summary tampil di report]
[/collapsed]
[/collapsed]
Rapikan layout report kita, misalnya menjadi seperti ini. Note: Jika “GroupFooterSection2” tidak ada pada report, silahkan klik kanan mouse pada “GroupFooterSection” kemudian pilih menu “Insert Section Below”
[collapsed title=Finishing]
[/collapsed]
Buat Form untuk Menampilkan Report
buat form baru kemudian beri nama frmReportViewer, setelah itu drag dan drop komponen CrystalReportViewer dari toolbox, hasilnya akan tampak seperti gambar di bawah ini.
[collapsed title=desain form report viewer]
[/collapsed]
Kemudian buka code editor dan tambahkan coding seperti di bawah ini. Metoda yang kita pakai adalah dengan memanfaatkan constructor form untuk menerima argumen berupa report yang akan di tampilkan.
[collapsed title=coding form report viewer]
using CrystalDecisions.CrystalReports.Engine;
public frmReportViewer(ReportClass rpt)
{
InitializeComponent();
InitializeReport(rpt);
}
private void InitializeReport(ReportClass rpt)
{
this.crystalReportViewer1.ReportSource = rpt;
this.crystalReportViewer1.Zoom(0);
}
[/collapsed]
Buat Form untuk List Order
Buka desain Form1, ubah namanya menjadi “frmMain” kemudian tambahkan 1 buah button dan 1 buah DataGridView seperti yang tampak dalam gambar. Selanjutnya menggunakan property window, ubah nama button1 menjadi btnPrintForm, dan dataGridView1 menjadi grid1.
[collapsed title=Desain Awal]
[/collapsed]
Kemudian drag dan drop ke form dari toolbox grup “CrystalReports1 Components”, dsSample dan OrdersTableAdapter, sehingga desain form akan tampak sepert gambar di bawah ini. Selanjutnya ubah property berikut ini untuk grid1,
- DataSource = dsSample1
- DataMember = Orders
- ReadOnly = True
- AllowUserToAddRows = False
- AllowUserToDeleteRows = False
- AutoSizeColumnMode = Fill
Jika sudah maka tampilan form akan berubah menjadi seperti gambar di bawah ini
[collapsed title=Setelah Set Property untuk grid]
[/collapsed]
Sekarang saatnya menambahkan coding untuk mengambil data dari database dan ditampilkan ke grid. Silakan buka Code Editor dan tambahkan code seperti di bawah ini
[collapsed title=code untuk retrieve list order]
public frmMain()
{
InitializeComponent();
InitializeDatabase();
}
private void InitializeDatabase()
{
ordersTableAdapter1.FillList(dsSample1.Orders);
}
[/collapsed]
Coding untuk Menampilkan Report adalah sebagai berikut, Buka desain frmMain kemudian klik ganda pada button btnPrintForm untuk membuka code editor, kemudian tambahkanlah code seperti di bawah ini
[collapsed title=Coding Tampilkan report]
private void btnPrintForm_Click(object sender, EventArgs e)
{
// ganti cursor
Cursor = Cursors.WaitCursor;
// ambil OrderID
int col = 0; // nomor index field OrderID
int row = grid1.SelectedCells[0].RowIndex; // nomor index row yang dipilih
int id = (int)grid1[col, row].Value; // order id yang terpilih
// siapkan pengambilan data yng ingin ditampilkan di report
dsSample ds = new dsSample();
OrdersTableAdapter orders = new OrdersTableAdapter();
OrderDetailsTableAdapter details = new OrderDetailsTableAdapter();
ItemsTableAdapter items = new ItemsTableAdapter();
CompaniesTableAdapter comp = new CompaniesTableAdapter();
// ambil data dari databse sesuai OrderID
comp.FillByCompanyID(ds.Companies, id);
items.FillByOrderID(ds.Items, id);
orders.FillByOrderID(ds.Orders, id);
details.FillByOrderID(ds.OrderDetails, id);
// siapkan report
ReportClass rpt = new rptOrderForm();
rpt.SetDataSource(ds);
// siapkan report viewer
Form f1 = new frmReportViewer(rpt);
f1.ShowDialog();
// ganti cursor
Cursor = Cursors.Default;
}
[/collapsed]
Hasilnya gan….
Hasil akhir tampilan form aplikasi seperti ini
[collapsed title=List Order]
[/collapsed]
Hasil akhir tampilan report yang dihasilkan seperti ini
[collapsed title=Tampilan Report]
[/collapsed]
Download Source Code di sini gan!
Semoga berguna
.
