Dokumentasi Uji dalam Pengujian Perangkat Lunak (Contoh)

Apa itu Dokumentasi Tes?

Dokumentasi pengujian adalah dokumentasi artefak yang dibuat sebelum atau selama pengujian perangkat lunak. Dokumen ini membantu tim pengujian memperkirakan upaya yang diperlukan, melacak sumber daya dan kemajuan, serta memastikan cakupan pengujian yang memadai. Catatan dan laporan pengujian merupakan rangkaian dokumen lengkap yang memungkinkan Anda mendeskripsikan dan mendokumentasikan perencanaan pengujian, desain pengujian, pelaksanaan pengujian, dan hasil pengujian yang diperoleh dari aktivitas pengujian.

👉 Daftar untuk Proyek Pengujian Perangkat Lunak Langsung Gratis

Mengapa Perlunya Formalitas Tes?

Bagi pemula, mudah berasumsi bahwa pengujian adalah mengeksekusi berbagai bagian kode secara ad-hoc dan memverifikasi hasilnya. Namun, dalam dunia nyata, pengujian merupakan aktivitas yang sangat formal dan didokumentasikan secara detail. Dokumentasi pengujian memudahkan perencanaan, peninjauan, dan pelaksanaan pengujian sekaligus terverifikasi.

Derajat formalitas ujian bergantung pada:

• Jenis Aplikasi yang Diuji (AUT).
• Standar yang diikuti oleh organisasi Anda.
• Kematangan proses pembangunan.

Kegiatan pengujian biasanya memakan waktu antara 30% dan 50% dari total upaya pengembangan perangkat lunak. Dokumentasi membantu mengidentifikasi peningkatan proses pengujian yang dapat diterapkan pada proyek-proyek mendatang.

Apa Saja Jenis Dokumentasi Pengujian?

Berikut ini adalah jenis-jenis dokumentasi pengujian yang penting:

“Dalam praktiknya, dokumen-dokumen ini dibuat pada berbagai tahap — mulai dari perencanaan awal (kebijakan pengujian, strategi) hingga pelaksanaan dan penutupan (laporan cacat dan ringkasan).”

Jenis Dokumen Pengujian	Uraian Teknis
Kebijakan pengujian	Ini adalah dokumen tingkat tinggi yang menjelaskan prinsip, metode, dan semua tujuan pengujian penting organisasi.
Strategi pengujian	Dokumen tingkat tinggi yang mengidentifikasi tingkat pengujian (jenis) yang akan dijalankan untuk proyek.
Rencana uji	Rencana pengujian adalah dokumen perencanaan lengkap yang berisi ruang lingkup, pendekatan, sumber daya, jadwal, dll. dari aktivitas pengujian.
Persyaratan Matriks Ketertelusuran	Ini adalah dokumen yang menghubungkan persyaratan dengan kasus uji.
Skenario Uji	Skenario Uji adalah item atau peristiwa sistem perangkat lunak yang dapat diverifikasi oleh satu atau lebih kasus Uji.
Uji Kasus	Ini adalah sekumpulan nilai input, prasyarat eksekusi, pascakondisi eksekusi yang diharapkan, dan hasil. Ini dikembangkan untuk Skenario Uji.
Data Uji	Data uji adalah data yang sudah ada sebelum pengujian dijalankan. Data ini digunakan untuk menjalankan kasus uji.
Laporan Cacat	Laporan cacat adalah laporan terdokumentasi tentang setiap cacat pada sistem perangkat lunak yang gagal menjalankan fungsi yang diharapkan.
Laporan ringkasan tes	Laporan ringkasan pengujian adalah dokumen tingkat tinggi yang merangkum aktivitas pengujian yang dilakukan serta hasil pengujian.

Apa Praktik Terbaik untuk Mencapai Dokumentasi Pengujian?

Di bagian ini, kita akan mempelajari praktik terbaik yang membantu mencapai dokumentasi pengujian dengan contoh untuk membantu Anda memahaminya dengan lebih baik:

• Libatkan QA di Awal Proyek: Libatkan tim QA sejak awal proyek sehingga dokumentasi pengujian berkembang seiring dengan desain dan persyaratan produk.
  Contoh: QA berkolaborasi selama perencanaan sprint untuk menyusun kasus uji awal berdasarkan kisah pengguna.
• Jaga Dokumen Tetap Terkini: Jangan hanya membuat dokumen pengujian dan melupakannya — perbarui setiap kali persyaratan atau fitur berubah.
  Contoh: Bila API login berubah, segera perbarui kasus uji dan hasil terkait.
• Gunakan Kontrol Versi: Kelola dan lacak semua perubahan pada dokumen pengujian melalui sistem kontrol versi untuk menghindari kebingungan dan kehilangan data.
  Contoh: Simpan rencana pengujian di GitHub untuk menjaga riwayat versi dan opsi pengembalian yang jelas.
• Dokumen untuk Kejelasan dan Tujuan: Catat hanya apa yang membantu Anda dan pemangku kepentingan Anda memahami kemajuan dan hasil pengujian.
  Contoh: Sertakan laporan ringkasan pengujian yang menyoroti kasus pengujian yang lulus, gagal, dan terblokir untuk tinjauan manajemen.
• Gunakan Template Standar: Ikuti format yang konsisten — seperti templat Excel atau Word — untuk membuat dokumentasi lebih mudah dibuat dan ditinjau.
  Contoh: Gunakan “Templat Kasus Uji” standar dengan kolom untuk ID, deskripsi, prasyarat, dan hasil yang diharapkan.
• Sentralisasi Penyimpanan Dokumen: Simpan semua dokumen terkait proyek di satu lokasi yang mudah diakses untuk memastikan anggota tim dapat merujuk atau memperbaruinya dengan mudah.
  Contoh: Simpan artefak pengujian di tempat yang sama Google Drive folder yang dapat diakses oleh seluruh tim QA dan pengembangan.
• Sertakan Detail yang Cukup: Hindari informasi yang tidak jelas atau tidak lengkap; dokumentasi yang terperinci meningkatkan pemahaman dan mengurangi kesalahan selama pelaksanaan pengujian.
  Contoh: Alih-alih “Periksa login,” tulis “Verifikasi login pengguna dengan kredensial yang valid mengarahkan ke dasbor dengan sukses.”

Kapan Anda Harus Membuat Dokumentasi Uji untuk Pengujian Perangkat Lunak?

Berikut adalah beberapa poin penting tentang kapan Anda harus membuat dokumentasi pengujian untuk pengujian perangkat lunak:

• Tahap Perencanaan: Sebelum pelaksanaan pengujian dimulai, tentukan cakupan, tujuan, dan strategi pengujian dengan jelas.
• Persiapan Ujian: Selama perencanaan pengujian, untuk menetapkan jadwal, sumber daya, dan persyaratan lingkungan secara efisien.
• Analisis Persyaratan: Setelah analisis kebutuhan, untuk memastikan cakupan lengkap spesifikasi fungsional dan non-fungsional.
• Standarisasi Desain: Sebelum merancang kasus uji, untuk menstandardisasi format dan menjaga keterlacakan di semua dokumen.
• Dokumentasi Skenario: Selama desain pengujian, untuk mendokumentasikan skenario, masukan, keluaran yang diharapkan, dan detail data pengujian.
• Kesiapan Eksekusi: Sebelum pelaksanaan pengujian, untuk memverifikasi kesiapan lingkungan pengujian, peralatan, dan keakuratan dokumentasi.
• Evaluasi Pasca: Setelah pengujian, untuk mencatat hasil, cacat, dan pelajaran yang dipetik untuk perbaikan proses.

Jenis Template Apa yang Diperlukan untuk Dokumentasi Pengujian?

Berikut adalah beberapa templat yang Anda perlukan untuk dokumentasi pengujian dalam pengujian perangkat lunak:

Nama Template	Tools
Templat Rencana Tes	Microsoft Word, Google Docs, atau Confluence untuk pengeditan kolaboratif dan kontrol versi
Templat Kasus Uji	TestRail, Zephyr (di JIRA), Xray, atau Excel/Google Sheets untuk manajemen pengujian terstruktur
Templat Skenario Uji	JIRA, TestLink, atau Google Sheets untuk mendokumentasikan kondisi pengujian tingkat tinggi
Templat Matriks Ketertelusuran Persyaratan (RTM)	Excel, Google Sheets, atau TestRail untuk memetakan persyaratan ke kasus pengujian
Templat Laporan Cacat	JIRA, Bugzilla, atau Azure DevOps untuk pencatatan dan pelacakan cacat
Templat Laporan Ringkasan Pengujian	Pertemuan, Google Docs, atau TestRail untuk mengkompilasi hasil pengujian dan analisis

Pro dan Kontra Dokumentasi Pengujian

Pro

• Alasan utama pembuatan dokumentasi pengujian adalah untuk mengurangi atau menghilangkan ketidakpastian terkait aktivitas pengujian. Hal ini membantu menghilangkan ambiguitas yang sering muncul dalam alokasi tugas.
• Dokumentasi tidak hanya menawarkan pendekatan sistematis pengujian perangkat lunak, tetapi juga berfungsi sebagai materi pelatihan bagi mereka yang baru pertama kali mencoba proses pengujian perangkat lunak.
• Ini berfungsi sebagai strategi pemasaran dan penjualan yang baik untuk memamerkan dokumentasi pengujian untuk memperlihatkan proses pengujian yang matang.
• Dokumentasi pengujian membantu Anda menawarkan produk berkualitas kepada klien dalam batas waktu tertentu.
• In Rekayasa Perangkat Lunak, dokumentasi pengujian juga membantu mengonfigurasi atau mengatur program melalui dokumen konfigurasi dan manual operator.
• Dokumentasi pengujian membantu Anda meningkatkan transparansi dengan klien.

Kekurangan

• Biaya dokumentasi mungkin melampaui nilainya karena sangat memakan waktu.
• Seringkali, tulisan tersebut ditulis oleh orang yang tidak bisa menulis dengan baik atau tidak menguasai materi.
• Melacak perubahan yang diminta oleh klien dan memperbarui dokumen terkait memang melelahkan.
• Dokumentasi yang buruk secara langsung mencerminkan kualitas produk, karena kesalahpahaman antara klien dan organisasi dapat terjadi.

Kesalahan Umum yang Harus Dihindari dalam Dokumentasi Pengujian

Berikut adalah kesalahan paling umum yang harus Anda hindari dalam dokumentasi pengujian:

1. Hindari penulisan deskripsi kasus uji yang tidak jelas atau ambigu.
2. Jangan lewatkan pendokumentasian prasyarat dan dependensi pengujian.
3. Jangan pernah lupa untuk menyertakan hasil yang diharapkan untuk setiap pengujian.
4. Hindari pemformatan yang tidak konsisten di berbagai dokumen pengujian.
5. Jangan menggunakan tujuan pengujian yang tidak jelas atau tidak terukur.
6. Jangan pernah mengabaikan kontrol versi untuk pembaruan dokumentasi pengujian.
7. Hindari duplikasi informasi di beberapa artefak pengujian.
8. Jangan abaikan peninjauan dokumentasi untuk memastikan keakuratan dan kelengkapannya.

Pertanyaan Umum (FAQ)