Buku_KRISA_MAMPU_12-03-2019 MAMPU

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

viii. Sumber Rujukan
Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

364 | D 03 S pe si f i k asi K e pe r l u an Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. PENGENALAN

1.1 Tujuan Sistem
Seksyen ini adalah ruangan untuk menerangkan tujuan, objektif dan matlamat
sistem aplikasi ini dibangunkan selaras dengan objektif bisnes yang ingin
dicapai.

1.2 Skop Sistem
Seksyen ini adalah ruangan untuk menjelaskan penentuan skop sistem aplikasi
yang ingin dibangunkan. Sila rujuk kepada langkah 1b di dalam Penyediaan
Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan penjelasan lanjut
berkenaan cara-cara untuk melengkapkan seksyen ini.

1.3 Senarai Aktor Sistem
Seksyen ini adalah ruangan untuk menyenaraikan aktor-aktor sistem yang
terlibat serta keterangan fungsinya di dalam sistem aplikasi yang akan
dibangunkan. Sila rujuk kepada langkah 1c di dalam Penyediaan Spesifikasi
Keperluan Sistem [F2.6] untuk mendapatkan penjelasan lanjut berkenaan
cara-cara untuk melengkapkan seksyen ini.

2. PEMODELAN FUNGSI SISTEM

2.1 Penggunaan Notasi
Seksyen ini adalah ruangan untuk menyenaraikan notasi-notasi yang akan
digunakan untuk menyediakan Model Fungsi Sistem. Sila rujuk kepada
ruangan notasi di Pemodelan Fungsi Sistem [F2.2] dan langkah 2a di dalam
Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

2.2 Rajah Hierarki Fungsian Sistem
Seksyen ini adalah ruangan untuk menyediakan Rajah Hierarki Fungsian
Sistem yang merangkumi komponen-komponen seperti sistem, subsistem,
fungsi, modul, submodul dan transaksi. Sila rujuk kepada langkah-langkah
dalam Pemodelan Fungsi Sistem [F2.2] dan langkah 2b di dalam
Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

2.3 Jadual Pemadanan Aktor Dengan Fungsi Sistem

Seksyen ini adalah ruangan untuk menyediakan Jadual Pemadanan. Sila rujuk
kepada langkah-langkah dalam Pemodelan Fungsi Sistem [F2.2] dan
langkah 2c di dalam Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

365 | D 03 S pe si f i k asi K e pe r l u an Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

3. PEMODELAN USE CASE

3.1 Penggunaan Notasi
Seksyen ini adalah ruangan untuk menyenaraikan notasi-notasi yang akan
digunakan untuk menyediakan Model Use Case. Sila rujuk kepada
Pemodelan Use Case [F2.1] dan langkah 2a - perkara i di dalam
Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

3.2 Model Use Case
Seksyen ini adalah ruangan untuk menyedia Model Use Case yang terdiri
daripada Rajah Use Case serta keterangan bagi use case yang terlibat. Sila
rujuk kepada langkah-langkah di bawah Pemodelan Use Case [F2.1] dan
langkah 2a - perkara ii di dalam Penyediaan Spesifikasi Keperluan Sistem
[F2.6] untuk mendapatkan penjelasan lanjut berkenaan cara-cara untuk
melengkapkan seksyen ini.

4. PEMODELAN MAKLUMAT

4.1 Penggunaan Notasi
Seksyen ini adalah ruangan untuk menyenaraikan notasi-notasi yang akan
digunakan untuk menyediakan Model Maklumat. Sila rujuk kepada
Pemodelan Keperluan Data [F2.3] dan langkah 3a - perkara i di dalam
Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

4.2 Model Maklumat
Seksyen ini adalah ruangan untuk menyediakan Model Maklumat yang terdiri
daripada Rajah Hubungan Entiti. Sila rujuk kepada langkah 1 sehingga langkah
3 di bawah Pemodelan Keperluan Data [F2.3] dan langkah 3a - perkara ii
di dalam Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

4.3 Definisi Kamus Data
Seksyen ini adalah ruangan untuk menyedia dan melengkapkan Definisi
Kamus Data bagi setiap entiti dan atribut yang telah disediakan di dalam Rajah
Hubungan Entiti. Sila rujuk kepada langkah 4 di bawah Pemodelan Keperluan
Data [F2.3] dan langkah 3a - perkara iii di dalam Penyediaan Spesifikasi
Keperluan Sistem [F2.6] untuk mendapatkan penjelasan lanjut berkenaan
cara-cara untuk melengkapkan seksyen ini. Sila rujuk juga kepada contoh
format templat di Apendiks 3 - Templat Definisi Kamus Data.

366 | D 03 S pe si f i k asi K e pe r l u an Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

5. PEMODELAN PROSES SISTEM

5.1 Penggunaan Notasi
Seksyen ini adalah ruangan untuk menyenaraikan notasi-notasi yang akan
digunakan untuk menyediakan Model Proses Sistem. Sila rujuk kepada
Pemodelan Proses Sistem [F2.4] dan langkah 4a - perkara i di dalam
Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

5.2 Model Proses Sistem
Seksyen ini adalah ruangan untuk menyedia Model Maklumat yang terdiri
daripada Rajah Konteks dan Rajah Aliran Data. Sila rujuk kepada langkah 1
sehingga 3 di bawah Pemodelan Proses Sistem [F2.4] dan langkah 4a -
perkara ii di dalam Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

5.3 Definisi Aliran Data

Seksyen ini adalah ruangan untuk menyedia dan melengkapkan Definisi Aliran
Data. Sila rujuk kepada langkah 4 di bawah Pemodelan Proses Sistem [F2.4]
dan langkah 4a – perkara iii di dalam Penyediaan Spesifikasi Keperluan
Sistem [F2.6] untuk mendapatkan penjelasan lanjut berkenaan cara-cara
untuk melengkapkan seksyen ini. Sila rujuk juga kepada contoh format templat
bagi penyediaan Definisi Aliran Data di Apendiks 5.

6. PENENTUAN KEPERLUAN BUKAN FUNGSIAN

6.1 Jadual Ciri-ciri Kualiti Sistem
Seksyen ini adalah ruangan untuk menyedia dan melengkapkan jadual
keperluan bukan fungsian yang merangkumi tiga aspek utama iaitu aspek
sistem, aspek dalaman dan aspek luaran. Sila rujuk kepada langkah-langkah
di bawah Penentuan Keperluan Bukan Fungsian [F2.5] dan langkah 6 di
dalam Penyediaan Spesifikasi Keperluan Sistem [F2.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

7. PENENTUAN SAIZ SISTEM APLIKASI

Seksyen ini adalah ruangan untuk menyediakan Pengiraan Saiz Sistem Aplikasi
dengan menggunakan kaedah Function Points Analysis. Sila rujuk kepada bab 8 di
dalam Langkah-langkah Pengiraan Saiz Fungsian Sistem Aplikasi di Fasa
Analisis bagi mendapatkan penjelasan lanjut berkenaan cara-cara untuk
melengkapkan seksyen ini.

8. LAMPIRAN
Seksyen ini merupakan ruangan untuk menyertakan dokumen-dokumen sokongan
yang perlu dirujuk seperti format borang fizikal, format laporan dan pelbagai lagi
dokumen-dokumen lain yang berkaitan.

367 | D 03 S pe si f i k asi K e pe r l u an Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D04 DOKUMEN SPESIFIKASI
REKABENTUK SISTEM (SDS)

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

368 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan.

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai-pegawai yang bertanggungjawab untuk
melakukan semakan dan pengesahan kepada maklumat-maklumat yang terkandung
di dalam dokumen ini. Sila sertakan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan. Contoh jadual semakan dan pengesahan adalah
seperti berikut :

SEMAKAN DOKUMEN Jawatan Tandatangan Tarikh
Disemak Oleh Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

iii. Kawalan Dokumen
Seksyen ini adalah ruangan untuk mencatatkan maklumat-maklumat penyediaan
dokumen termasuk maklumat pindaan yang telah dilakukan ke atas dokumen ini. Sila
masukkan nombor versi, tarikh, ringkasan pindaan dan nama penyedia di dalam jadual
seperti di bawah :

369 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat perubahan angka selepas titik
perpuluhan sahaja, contohnya, perubahan dari nombor versi 1.2 kepada 1.3. Sekiranya
pindaan yang dilakukan adalah besar dan melibatkan perubahan kepada kandungan
dokumen, gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2
kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

370 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh jadual bagi senarai akronim adalah seperti
berikut :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh jadual bagi senarai definisi
adalah seperti berikut :

Terma/Istilah Definisi

viii. Sumber Rujukan
Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

371 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. PENGENALAN

1.1 Tujuan Rekabentuk
Seksyen ini adalah ruangan untuk menerangkan tujuan, objektif dan matlamat
yang ingin dicapai di dalam rekabentuk sistem aplikasi selaras dengan objektif
bisnes dan keperluan sistem yang ingin dipenuhi.

1.2 Skop Rekabentuk
Seksyen ini adalah ruangan untuk menjelaskan penentuan skop rekabentuk
bagi sistem aplikasi yang ingin dibangunkan. Sila rujuk kepada Langkah 1b di
dalam Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

2. REKABENTUK ARKITEKTUR

2.1 Arkitektur Keseluruhan Sistem Aplikasi
Seksyen ini adalah ruangan untuk menyediakan Arkitektur Keseluruhan Sistem
Aplikasi yang merangkumi komponen-komponen antaramuka sistem, aplikasi
dan pangkalan data. Sila rujuk kepada Langkah 4 di dalam Rekabentuk
Arkitektur [F3.1] dan Langkah 2a – Perkara i di dalam 4.9 Penyediaan
Spesifikasi Rekabentuk Sistem untuk mendapatkan penjelasan lanjut
berkenaan cara-cara untuk melengkapkan seksyen ini.

2.2 Arkitektur Aplikasi
Seksyen ini adalah ruangan untuk menyediakan Arkitektur Keseluruhan Sistem
Aplikasi yang merangkumi komponen-komponen antaramuka sistem, aplikasi
dan pangkalan data. Sila rujuk kepada Langkah 4 di dalam Rekabentuk
Arkitektur [F3.1] dan Langkah 2a – Perkara i di dalam 4.9 Penyediaan
Spesifikasi Rekabentuk Sistem [F3.6] untuk mendapatkan penjelasan lanjut
berkenaan cara-cara untuk melengkapkan seksyen ini.

3. PEMODELAN FUNGSI SISTEM

3.1 Penggunaan Notasi
Seksyen ini adalah ruangan untuk menyenaraikan notasi-notasi yang akan
digunakan untuk menyediakan Model Fungsi Sistem. Sila rujuk kepada ruangan
notasi di Pemodelan Fungsi Sistem [F2.2] dan langkah 3a di dalam
Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk mendapatkan
penjelasan lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

372 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

3.2 Rajah Hierarki Fungsian Sistem
Seksyen ini adalah ruangan untuk menyediakan Rajah Hierarki Fungsian
Sistem yang merangkumi komponen-komponen Fungsi Sistem pada tahap
sistem, subsistem, fungsi, modul, submodul dan transaksi. Sila rujuk kepada
langkah-langkah dalam Pemodelan Fungsi Sistem [F2.2] dan langkah 3b di
dalam Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

3.3 Jadual Pemadanan Aktor Dengan Fungsi Sistem
Seksyen ini adalah ruangan untuk menyediakan Jadual Pemadanan. Sila rujuk
kepada langkah-langkah dalam Pemodelan Fungsi Sistem [F2.2] dan langkah
3c di dalam Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

4. REKABENTUK FUNGSIAN

4.1 Rekabentuk Antaramuka Pegguna dan Pemetaan Data
Seksyen ini adalah ruangan untuk menyertakan imej-imej antaramuka
pengguna dan menyediakan jadual pemetaan data. Sila rujuk kepada langkah-
langkah di dalam Rekabentuk Antaramuka Pengguna [F3.5] dan Langkah 3d
di dalam Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk
mendapatkan penjelasan lanjut berkenaan cara-cara untuk melengkapkan
seksyen ini.

4.2 Rekabentuk Transaksi Sistem
Seksyen ini adalah ruangan untuk menyediakan jadual-jadual senario use case.
Sila rujuk kepada langkah-langkah di dalam Rekabentuk Transaksi Sistem
[F3.3] dan Langkah 3c di dalam Penyediaan Spesifikasi Rekabentuk Sistem
[F3.6] untuk mendapatkan penjelasan lanjut berkenaan cara-cara untuk
melengkapkan seksyen ini.

5. REKABENTUK PANGKALAN DATA

5.1 Rekabentuk Pangkalan Data
Seksyen ini adalah ruangan untuk menyertakan Rajah Hubungan Entiti (ERD)
Logikal yang telah dibangunkan. Sila rujuk kepada langkah-langkah di dalam
Rekabentuk Pangkalan Data [F3.3] dan Langkah 4a di dalam Penyediaan
Spesifikasi Rekabentuk Sistem [F3.6] untuk mendapatkan penjelasan lanjut
berkenaan cara-cara untuk melengkapkan seksyen ini.

373 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

5.2 Skema Logikal Pangkalan Data
Seksyen ini adalah ruangan untuk menyediakan Skema Logikal Pangkalan
Data. Sila rujuk kepada langkah-langkah di dalam Rekabentuk Pangkalan
Data [F3.3] dan Langkah 4b di dalam Penyediaan Spesifikasi Rekabentuk
Sistem [F3.6] untuk mendapatkan penjelasan lanjut berkenaan cara-cara untuk
melengkapkan seksyen ini.

6. REKABENTUK MIGRASI DATA
Seksyen ini adalah ruangan untuk menerangkan secara ringkas berkenaan dengan
Rekabentuk Migrasi Data serta rujukan kepada dokumen lain yang terlibat. Sila rujuk
kepada langkah-langkah di dalam Rekabentuk Migrasi Data [F3.8], dokumen D05 -
Pelan Migrasi Data, D06 - Spesifikasi Migrasi Data dan Langkah 5a di dalam
Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk mendapatkan penjelasan
lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

7. REKABENTUK INTEGRASI DATA
Seksyen ini adalah ruangan untuk menerangkan secara ringkas berkenaan dengan
Rekabentuk Integrasi Data serta rujukan kepada dokumen lain yang terlibat. Sila rujuk
kepada langkah-langkah di dalam Rekabentuk Integrasi Data [F3.10], dokumen D06
- Pelan Integrasi Data, D07 - Spesifikasi Integrasi Data dan Langkah 5b di dalam
Penyediaan Spesifikasi Rekabentuk Sistem [F3.6] untuk mendapatkan penjelasan
lanjut berkenaan cara-cara untuk melengkapkan seksyen ini.

8. LAMPIRAN
Seksyen ini merupakan ruangan untuk mengepilkan dokumen-dokumen sokongan
yang berkaitan dengan rekabentuk-rekabentuk sistem aplikasi.

374 | D 04 S pe si f i k a si R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D05 DOKUMEN PELAN MIGRASI
DATA

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

375 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan dengan merujuk kepada piawaian antarabangsa yang
berkaitan.

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai yang terlibat untuk menurunkan tandatangan
sebagai semakan dan pengesahan kepada maklumat-maklumat yang terkandung di
dalam dokumen. Sila masukkan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan.

Contoh ruangan semakan dan pengesahan adalah seperti berikut :

SEMAKAN DOKUMEN Jawatan Tandatangan Tarikh
Disemak Oleh Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

376 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii. Kawalan Dokumen

Seksyen ini adalah ruangan untuk mencatatkan maklumat pindaan yang telah
dilakukan kepada dokumen. Sila masukkan nombor versi, tarikh, ringkasan pindaan
dan nama penyedia di dalam jadual seperti di bawah :

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat angka selepas titik perpuluhan
sahaja, contohnya, dari nombor versi 1.2 kepada 1.3. Sekiranya pindaan yang
dilakukan adalah besar dan melibatkan perubahan kepada kandungan dokumen,
gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2 kepada 2.0.

iv. Kandungan
Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah
Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual
Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

377 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen.

Terma/Istilah Definisi

viii. Sumber Rujukan

Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

378 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. TUJUAN
Perenggan ini menerangkan tujuan dokumen ini dihasilkan.

2. LATAR BELAKANG
Perenggan ini menerangkan secara ringkas latar belakang sistem yang terlibat untuk
migrasi data.

3. OBJEKTIF MIGRASI
Perenggan ini menerangkan objektif migrasi data dilaksanakan.

4. SKOP MIGRASI
Perenggan ini menerangkan skop data yang akan dimigrasi.

5. PENDEKATAN MIGRASI
Perenggan ini menerangkan pendekatan pelaksanaan migrasi dan kaedah yang dipilih
untuk memindahkan data.

6. PASUKAN PROJEK
Perenggan ini menerangkan struktur pasukan projek dan nama-nama pegawai yang
terlibat. Contoh adalah seperti di bawah:

KETUA PASUKAN

PASUKAN PERUNDING ICT

PASUKAN TEKNIKAL SUBJECT MATTER EXPERT

Ahli:- Ahli:-

Contoh Fungsi:- Contoh Fungsi :-
• Data Mapping • Migration Rules
• Develop Process • Data Cleansing
• Scripting /Verification
• Extraction
• Transformation
• Load

379 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

7. JADUAL PELAKSANAAN
Perenggan ini menerangkan jadual pelaksanaan migrasi data yang menunjukkan
semua proses migrasi bermula daripada analisis keperluan sehingga penyediaan
laporan.

8. PENUTUP
Perenggan ini menerangkan tentang Faktor Kritikal Kejayaan (Critical Success Factor)
yang perlu dikenal pasti untuk menjamin kejayaan pelaksanaan migrasi data dan lain-
lain perkara yang ingin dimasukkan sebagai penutup dokumen.

9. LAMPIRAN
Seksyen ini merupakan ruangan untuk menyertakan dokumen-dokumen sokongan
yang perlu dirujuk seperti pekeliling, minit mesyuarat, borang-borang fizikal, surat-surat
dan sebagainya.

380 | D 05 S pe si f i k asi R e k abe n tu k Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D06 DOKUMEN SPESIFIKASI
MIGRASI DATA

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

381 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan dengan merujuk kepada piawaian antarabangsa yang
berkaitan. Contoh keterangan dokumen adalah seperti di bawah :

“Dokumen ini menyatakan Spesifikasi Migrasi Data yang akan dirujuk semasa
fasa pembangunan. Ia bertujuan untuk menerangkan secara terperinci tujuan,
maklumat sistem yang terlibat, maklumat data serta rangkaian sistem legasi,
pemetaan data, pemetaan kod rujukan dan peraturan bisnes . “

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai-pegawai yang bertanggungjawab untuk
melakukan semakan dan pengesahan kepada maklumat-maklumat yang terkandung
di dalam dokumen ini. Sila sertakan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan. Contoh ruangan semakan dan pengesahan adalah
seperti berikut :

SEMAKAN DOKUMEN Jawatan Tarikh
Disemak Oleh Tandatangan Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

iii. Kawalan Dokumen
Seksyen ini adalah ruangan untuk mencatatkan maklumat-maklumat penyediaan
dokumen termasuk maklumat pindaan yang telah dilakukan ke atas dokumen ini. Sila
masukkan nombor versi, tarikh, ringkasan pindaan dan nama penyedia di dalam jadual
seperti di bawah :

382 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat perubahan angka selepas titik
perpuluhan sahaja, contohnya, perubahan dari nombor versi 1.2 kepada 1.3. Sekiranya
pindaan yang dilakukan adalah besar dan melibatkan perubahan kepada kandungan
dokumen, gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2
kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

383 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh pengisian di ruangan definisi
adalah seperti jadual di bawah :

Terma/Istilah Definisi

viii. Sumber Rujukan
Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

384 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. TUJUAN DOKUMEN
Perenggan ini menerangkan tujuan dokumen ini dihasilkan.

2. MAKLUMAT SISTEM YANG TERLIBAT

Perenggan ini menerangkan maklumat sistem dan pangkalan data yang terlibat bagi
tujuan migrasi data. Contoh adalah seperti di bawah:

Nama Sistem Legasi:

a) Maklumat Sistem Legasi

Bil Modul Data Fungsi Dalam Pembangunan Maklumat Sistem & Server Maklumat Server
terlibat yang Sistem Penyelenggaraan
terlibat

Y T Language SA/ Inhouse/ Nama OS IP Zone
CS/ Outsource
WB (intranet/

DMZ/dll)

Nota:
SA: Stand Alone
CS: Client-Server
WB: Web based

b) Maklumat Pangkalan Data dan Rangkaian Sistem Legasi

Maklumat Pangkalan Data Rangkaian

Arkitektur Kepatuhan Jenis Catatan
Hybrid/ Centralised/ DDSA
Nama DBMS Volume Data 1Gov*Net Lain-lain
Decentralised (Nyatakan)

Nota:
DBMS: Database Management System
DDSA: Data Dictionary Sektor Awam

385 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

Nama Sistem Baharu:

a) Maklumat Sistem Baharu

Bil Modul Data Fungsi Maklumat Sistem & Server
terlibat yang Sistem
terlibat Dalam Pembangunan Penyelenggaraan Maklumat Server

Y T Language SA/ Inhouse/ Nama OS IP Zone
CS/ Outsource
WB (intranet/

DMZ/dll)

Nota:
SA: Stand Alone
CS: Client-Server
WB: Web based

a) Maklumat Pangkalan Data dan Rangkaian Sistem Baharu

Maklumat Pangkalan Data Rangkaian

Arkitektur Kepatuhan Jenis Catatan
DDSA
Nama DBMS Volume Data Hybrid/ Centralised/ Lain-lain
Decentralised (Nyatakan)
1Gov*Net

Nota:
DBMS: Database Management System
DDSA: Data Dictionary Sektor Awam

3. PEMETAAN JADUAL

Perenggan ini memaparkan rajah pemetaan jadual bagi sistem yang terlibat.
Pendekatan pemetaan adalah merujuk kepada Bab 4.10.2 Langkah 1.
4. PERATURAN BISNES

Perenggan ini menerangkan peraturan bisnes yang perlu dipatuhi dalam proses migrasi
data.
5. PEMETAAN DATA

Perenggan ini memuatkan jadual yang mengandungi perincian data yang perlu
dipindahkan. Pendekatan pemetaan adalah merujuk kepada Bab 4.10.2 Langkah 2.

386 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

6. PEMETAAN KOD
Perenggan ini memuatkan jadual pemetaan kod yang disediakan untuk menyesuai dan
menyelaraskan kod bagi atribut daripada sumber data dengan destinasi baharu data.
Pendekatan pemetaan adalah merujuk kepada Bab 4.10.2 Langkah 3.

7. PEMETAAN REKOD (DATA)
Perenggan ini memuatkan jadual pemetaan rekod (data) yang disediakan untuk
menyesuai dan menyelaraskan rekod data berdasarkan kod data baharu. Pendekatan
pemetaan adalah merujuk kepada Bab 4.10.2 Langkah 4.

8. LAMPIRAN
Seksyen ini merupakan ruangan untuk menyertakan dokumen-dokumen sokongan yang
perlu dirujuk seperti format borang fizikal, format laporan dan pelbagai lagi dokumen-
dokumen lain yang berkaitan.

387 | D 06 S pe si f i k asi M i gr asi D a t a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D07 DOKUMEN PELAN INTEGRASI
SISTEM

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

388 | D 07 Pe l an I n te gr asi Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan dengan merujuk kepada piawaian antarabangsa yang
berkaitan. Contoh keterangan dokumen adalah seperti di bawah :

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai yang terlibat untuk menurunkan tandatangan
sebagai semakan dan pengesahan kepada maklumat-maklumat yang terkandung di
dalam dokumen. Sila masukkan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan.

Contoh ruangan semakan dan pengesahan adalah seperti berikut :

SEMAKAN DOKUMEN Jawatan Tandatangan Tarikh
Disemak Oleh Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

389 | D 07 Pe l an I n te gr asi Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii. Kawalan Dokumen

Seksyen ini adalah ruangan untuk mencatatkan maklumat pindaan yang telah
dilakukan kepada dokumen. Sila masukkan nombor versi, tarikh, ringkasan pindaan
dan nama penyedia di dalam jadual seperti di bawah :

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat angka selepas titik perpuluhan
sahaja, contohnya, dari nombor versi 1.2 kepada 1.3. Sekiranya pindaan yang
dilakukan adalah besar dan melibatkan perubahan kepada kandungan dokumen,
gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2 kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

390 | D 07 Pe l an I n te gr asi Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh pengisian di ruangan definisi
adalah seperti jadual di bawah :

Terma/Istilah Definisi

vii. Sumber Rujukan

Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

391 | D 07 Pe l an I n te gr asi Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. TUJUAN DOKUMEN
Perenggan ini menerangkan tujuan dokumen ini dihasilkan.

2. OBJEKTIF
Seksyen ini menerangkan objektif pengintegrasian sistem.

3. SKOP KERJA INTEGRASI
Seksyen ini menerangkan skop kerja integrasi yang terlibat

4. PENDEKATAN DAN STRATEGI
Seksyen ini menerangkan kaedah dan strategi yang dilakukan untuk mengenalpasti
integrase yang diperlukan dan pelaksanaan integrasi tersebut

5. KAEDAH INTEGRASI, TOOLS DAN PERSEKITARAN
Seksyen ini menerangkan kaedah dan strategi yang dilakukan untuk mengenalpasti
integrasi yang diperlukan dan pelaksanaan integrasi tersebut.

6. TUGAS DAN TANGGUNGJAWAB
Seksyen ini menerangkan tugas dan tanggungjawab pasukan integrasi dan pihak
berkepentingan

7. JADUAL PELAKSANAAN
Seksyen ini menyatakan tempoh masa yang diperlukan untuk setiap aktiviti yang
dirancang.

8. ANDAIAN DAN RISIKO
Seksyen menerangkan andaian yang dibuat sepanjang pelaksanaan integrasi dan
potensi halangan yang akan memberi impak kepada pelaksanaan integrasi tersebut.

9. PENUTUP
Perenggan ini menerangkan tentang Faktor Kritikal Kejayaan (Critical Success Factor)
yang perlu dikenal pasti untuk menjamin kejayaan pelaksanaan Integrasi data dan lain-
lain perkara yang ingin dimasukkan sebagai penutup dokumen.

392 | D 07 Pe l an I n te gr asi Si s te m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D08 DOKUMEN SPESIFIKASI
INTEGRASI DATA

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

393 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan dengan merujuk kepada piawaian antarabangsa yang
berkaitan. Contoh keterangan dokumen adalah seperti di bawah :

“Dokumen ini menyatakan spesifikasi integrasi sistem yang akan dirujuk
semasa fasa pembangunan sistem. Ia bertujuan untuk menerangkan secara
terperinci tujuan, skop, gambaran keseluruhan, analisis-analisis keperluan
sistem, maklumat dan proses bagi perisian yang akan dibangunkan.

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai yang terlibat untuk menurunkan tandatangan
sebagai semakan dan pengesahan kepada maklumat-maklumat yang terkandung di
dalam dokumen. Sila masukkan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan.

Contoh ruangan semakan dan pengesahan adalah seperti berikut :

SEMAKAN DOKUMEN Jawatan Tarikh
Disemak Oleh Tandatangan Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

394 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii. Kawalan Dokumen

Seksyen ini adalah ruangan untuk mencatatkan maklumat pindaan yang telah
dilakukan kepada dokumen. Sila masukkan nombor versi, tarikh, ringkasan pindaan
dan nama penyedia di dalam jadual seperti di bawah :

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat angka selepas titik perpuluhan
sahaja, contohnya, dari nombor versi 1.2 kepada 1.3. Sekiranya pindaan yang
dilakukan adalah besar dan melibatkan perubahan kepada kandungan dokumen,
gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2 kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

395 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh pengisian di ruangan definisi
adalah seperti jadual di bawah :

Terma/Istilah Definisi

viii. Sumber Rujukan

Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

396 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. TUJUAN DOKUMEN
Perenggan ini menerangkan tujuan dokumen ini dihasilkan.Senaraikan kumpulan
sasar dokumen ini. Nyatakan andaian, batasan dan kekangan dalam pembangunan
integrasi.

2. KEPERLUAN INTEGRASI
Terangkan integasi yang diperlukan oleh sistem. Kenalpasti servis yang diperlukan.

Bil Rujukan Rujukan Nama Pemilik Keterangan Tujuan
Fungsi Aktiviti Sistem Maklumat Maklumat Penggunaan
Sumber
yang Maklumat
dihantar

1

2

3. KAEDAH INTEGRASI DATA

Penerangan setiap servis integrasi yang dibangunkan.
Nama Servis
Keterangan
Kaedah
Integrasi
URL Web
Service

Request

Respond

Nama Jenis Saiz Nullable Rules

Data yang
terlibat

397 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

4. PEMETAAN DATA

Lakukan pemetaan data antara sistem yang memohon data dengan data yang
diterima.

Sistem yang memohon (request) Data yang diterima

Nama Jenis Saiz Keterangan Nama Jenis Saiz Keterangan
Medan Medan

5. PROSES PERTUKARAN DATA

Terangkan aliran proses semasa pertukaran data tersebut. Nyatakan juga sebarang
peraturan yang meyebabkan pertukaran data berlaku.

6. REKA BENTUK SENIBINA INTEGRASI

Perincikan reka bentuk senibina integrasi yang terlibat. Ia juga menggambarkan
keperluan infrastruktur seperti rangkaian untuk persekitaran pembangunan dan
pemngimplementasian serta komponen perisian yang digunakan untuk mewujudkan
proses integrasi.

398 | D 08 Sp e si f i k asi I n te gr a si D a ta

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D09 DOKUMENTASI PANGKALAN
DATA

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

399 | D 09 D ok u me n t asi Pan gk al an D at a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan dengan merujuk kepada piawaian antarabangsa yang
berkaitan.

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai-pegawai yang bertanggungjawab untuk
melakukan semakan dan pengesahan kepada maklumat-maklumat yang terkandung
di dalam dokumen ini. Sila sertakan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan. Contoh ruangan semakan dan pengesahan adalah
seperti berikut :

SEMAKAN DOKUMEN Jawatan Tandatangan Tarikh
Disemak Oleh Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh
Semakan

400 | D 09 D ok u me n t asi Pan gk al an D at a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii. Kawalan Dokumen

Seksyen ini adalah ruangan untuk mencatatkan maklumat-maklumat penyediaan
dokumen termasuk maklumat pindaan yang telah dilakukan ke atas dokumen ini. Sila
masukkan nombor versi, tarikh, ringkasan pindaan dan nama penyedia di dalam jadual
seperti di bawah :

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat perubahan angka selepas titik
perpuluhan sahaja, contohnya, perubahan dari nombor versi 1.2 kepada 1.3. Sekiranya
pindaan yang dilakukan adalah besar dan melibatkan perubahan kepada kandungan
dokumen, gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2
kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

401 | D 09 D ok u me n t asi Pan gk al an D at a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh pengisian di ruangan definisi
adalah seperti jadual di bawah :

Terma/Istilah Definisi

viii. Sumber Rujukan

Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

402 | D 09 D ok u me n t asi Pan gk al an D at a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. PENGENALAN
Seksyen ini menerangkan pangkalan data bagi sistem yang dibangunkan. Terangkan
secara ringkas latar belakang sistem dan kandungan yang terdapat dalam dokumen
ini.

2. RINGKASAN MAKLUMAT PANGKALAN DATA FIZIKAL YANG DIBANGUNKAN
Seksyen ini adalah ruang untuk menerangkan maklumat pangkalan data fizikal yang
dibangunkan seperti berikut.
a) Pangkalan data yang digunakan.
b) Peruntukan ruang jadual (tablespace/filegroup)
c) Nama pangkalan data
d) Bilangan table, view
e) Stored procedure
f) Maklumat jadual dan medan yang mengandungi INDEX
g) Senarai pengguna yang mempunyai kawalan akses ke atas pangkalan
data/jadual

3. SKRIP PANGKALAN DATA
Seksyen ini adalah ruangan untuk skrip pangkalan data yang digunakan untuk
membangunkan pangkalan data fizikal.

4. LAMPIRAN
Seksyen ini merupakan ruangan untuk menyertakan dokumen-dokumen sokongan
yang perlu dirujuk seperti pekeliling, minit mesyuarat, borang-borang fizikal, surat-surat
dan sebagainya.

403 | D 09 D ok u me n t asi Pan gk al an D at a

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D10 DOKUMENTASI KOD SUMBER

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

404 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan. Contoh keterangan dokumen adalah seperti di bawah :

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai-pegawai yang bertanggungjawab untuk
melakukan semakan dan pengesahan kepada maklumat-maklumat yang terkandung
di dalam dokumen ini. Sila sertakan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan. Contoh ruangan semakan dan pengesahan adalah
seperti berikut :

SEMAKAN DOKUMEN

Disemak Oleh Jawatan Tandatangan Tarikh
Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tarikh
Tandatangan Semakan

405 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii. Kawalan Dokumen

Seksyen ini adalah ruangan untuk mencatatkan maklumat-maklumat penyediaan
dokumen termasuk maklumat pindaan yang telah dilakukan ke atas dokumen ini. Sila
masukkan nombor versi, tarikh, ringkasan pindaan dan nama penyedia di dalam jadual
seperti di bawah :

KAWALAN DOKUMEN

No. Tarikh Ringkasan Pindaan Penyedia
Versi

Penentuan nombor versi adalah bergantung kepada saiz pindaan kepada dokumen
yang telah dilakukan. Sekiranya saiz pindaan yang dilakukan adalah kecil ataupun
sederhana, perubahan nombor versi hanya melibat perubahan angka selepas titik
perpuluhan sahaja, contohnya, perubahan dari nombor versi 1.2 kepada 1.3. Sekiranya
pindaan yang dilakukan adalah besar dan melibatkan perubahan kepada kandungan
dokumen, gunakan angka nombor yang seterusnya, contohnya, dari nombor 1.2
kepada 2.0.

iv. Kandungan

Seksyen ini merupakan ruangan untuk memasukkan maklumat kandungan dokumen
berserta nombor muka surat yang terlibat.

v. Senarai Gambarajah

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
gambarajah-gambarajah yang terkandung di dalam dokumen berserta nombor muka
surat yang terlibat.

vi. Senarai Jadual

Seksyen ini merupakan ruangan untuk memasukkan senarai nombor rujukan bagi
jadual-jadual yang terkandung di dalam dokumen berserta nombor muka surat yang
terlibat.

406 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

vii. Definisi dan Akronim

Akronim

Sub seksyen ini adalah ruangan untuk menerangkan akronim-akronim yang
digunakan di dalam dokumen. Contoh pengisian di ruangan akronim adalah
seperti jadual di bawah :

Akronim Keterangan

Definisi

Sub seksyen ini adalah ruangan untuk menerangkan definisi bagi terma atau
istilah yang digunakan di dalam dokumen. Contoh pengisian di ruangan definisi
adalah seperti jadual di bawah :

Terma/Istilah Definisi

viii. Sumber Rujukan

Seksyen ini adalah ruangan untuk menyenaraikan semua sumber-sumber rujukan
yang digunakan di dalam penyediaan dokumen ini, contohnya seperti surat pekeliling
perkhidmatan, manual prosedur kerja, garis-garis panduan, dokumen-dokumen
piawaian ISO/IEC/IEEE dan bahan rujukan lain yang berkaitan.

407 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. TUJUAN DOKUMEN

Perenggan ini menerangkan tujuan dokumen ini dihasilkan.Senaraikan kumpulan
sasar dokumen ini. Nyatakan andaian, batasan dan kekangan dalam menyediakan
dokumentasi kod sumber ini.

2. SKOP DOKUMEN

Perenggan ini menyatakan skop bagi penyediaan kod sumber. Berikut adalah contoh
maklumat yang boleh dinyatakan:
i) Nama sistem yang terlibat
ii) Nama modul yang terlibat
iii) Nama pasukan pembangunan sistem yang terlibat

3. PIAWAIAN KOD SUMBER

Nyatakan piawaian kod sumber (cara penulisan kod) yang digunakan semasa
membangunkan sistem. Pasukan pembangun sistem boleh menyenaraikan kod yang
bersesuaian mengikut keperluan. Berikut antara contoh kod sumber yang perlu
dipatuhi.

i) File Name
<Nyatakan nama fail yang terlibat>
Contoh:
.java, .php

ii) Class Headers and Declaration
<Isytiharkan Class Header yang mengandungi class name, inheritance,
attributes, methods, functionality, visibility, requirement number dan penyataan
yang mengisytiharkan Class tersebut>

Contoh:
/*******************************************************

* Class name:
* Inheritance:
* Attributes:
* Methods:
* Functionality:
* Visibility:
* From requirement number
*******************************************************/
public class ClassName

408 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

iii) Method Headers and Declaration
<Isytiharkan Class Header yang mengandungi method name, inheritance,
attributes, precondition, postcondition, functionality, visibility, @param, @return
dan requirement numbers>

Contoh:
/*******************************************************

* Method name:
* Inheritance:
* Attributes:
* Precondition:
* Postcondition:
* Functionality:
* Visibility:
* @param:
* @return:
* From requirement number

*******************************************************/
iv) Indentation

<Nyatakan kaedah indentation yang digunakan>
Contoh:

Four spaces should be used as the unit of indentation

v) Inline Comments
<Nyatakan kaedah inline comment yang digunakan>
Contoh:
Inline comment should make up 20% of the total lines of code in a program,
excluding the header documentation blocks.

vi) Variable Names
<Nyatakan kaedah penulisan variable names yang digunakan>
Contoh:
Variable shall have mnemonic or meaningful names that convey to a casual
observer, the intent of its use. Variables shall be initialized prior to its firts use.
String tempWord;

vii) Use of Braces
<Nyatakan gaya penggunaan Braces>

Contoh:
Style 1:
for (int j = 0 ; j < max_iterations ; ++j)
{

/* Some work is done here. */
}

409 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

Style 2:
for ( int j = 0 ; j < max_iterations ; ++j )
{

/* Some work is done here. */
}

viii) Line Length
<Nyatakan line length yang digunakan>
Contoh:
Keep the lengths of source code lines at or below 80 characters.

ix) Spacing
<Nyatakan kaedah spacing yang digunakan>
Contoh:
i. A keyword followed by a parenthesis should be separated by a space.
ii. A blank space should appear afther each comma in an argument list.

cost = price + ( price * sales_tax );
fprintf (stdout, “The total cost is %5.2f\n”, cost) ;

x) Wrapping Lines
<Nyatakan kaedah wrapping lines yang digunakan>
Contoh:
i. Break after a comma
fprintf ( stdout , “\nThere are %d reasons to use standards\n”
num_reasons ) ;
ii. Break after an operator
long int total_apples = num_my_apples + num_his_apples
num_her_apples ;

xi) Program Statement
<Nyatakan kaedah penulisan program statement yang digunakan>
Contoh:
Program statement should be limited to one per line. Also nested statements
should be avoided when possible.
number_of_names = names.length ;
b = new JButton [ number_of_names ] ;

4. LAMPIRAN

Seksyen ini merupakan ruangan untuk menyertakan dokumen-dokumen sokongan
yang perlu dirujuk seperti format borang fizikal, format laporan dan pelbagai lagi
dokumen-dokumen lain yang berkaitan.

410 | D 10 D ok u me n t asi Ko d Su mbe r

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

RUJUKAN :

D11 DOKUMEN LAPORAN UJIAN
SISTEM

NAMA SISTEM

(Sertakan nama modul di bawah nama sistem sekiranya dokumen disediakan secara
berasingan bagi setiap modul di bawah sistem yang sama)

NAMA AGENSI :
NAMA AGENSI INDUK :
TARIKH DOKUMEN :
VERSI DOKUMEN :

411 | D 11 L ap or an Uj i an Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

i. Keterangan Dokumen

Seksyen ini adalah ruangan untuk menyatakan secara ringkas keterangan berkenaan
dokumen yang disediakan.

ii. Semakan dan Pengesahan Dokumen

Seksyen ini adalah ruangan bagi pegawai yang terlibat untuk menurunkan tandatangan
sebagai semakan dan pengesahan kepada maklumat-maklumat yang terkandung di
dalam dokumen. Sila masukkan maklumat seperti nama, jawatan, tandatangan dan
tarikh semakan atau kelulusan.

Contoh ruangan semakan dan pengesahan adalah seperti berikut :

Dengan ini adalah disahkan Ujian Sistem telah selesai dilaksanakan dengan
sempurna.

SEMAKAN DOKUMEN Jawatan Tandatangan Tarikh
Disemak Oleh
Semakan

PENGESAHAN DOKUMEN

Disahkan Oleh Jawatan Tandatangan Tarikh

Semakan

412 | D 11 L ap or an Uj i an Si ste m

Buku Panduan Kejuruteraan Sistem Aplikasi Sektor Awam (KRISA). © BPI MAMPU

1. PENGENALAN

1.1 Tujuan Laporan
Seksyen ini adalah ruangan untuk menerangkan tujuan laporan ini
dibangunkan.

1.2 Skop Laporan

Seksyen ini adalah ruangan untuk menyenaraikan modul dan sub modul yang
terlibat dalam Ujian sistem merujuk kepada Dokumen SRS.

2. AKTIVITI PENGUJIAN

2.1 Serahan
Seksyen ini adalah ruangan untuk menyenaraikan status laporan ujian sistem
yang telah dilaksanakan.

Bil Modul & Sub Modul Status Pengujian Keterangan
1. (Lulus/Gagal)

2.

2.2 Rumusan Serahan

Bil Modul Bil Lulus Bil Keterangan
Gagal

1.

2.

3.

4. Jumlah
Peratus Lulus/Gagal

3. DOKUMEN SOKONGAN

Seksyen ini menyenaraikan dokumen sokongan yang berkaitan dengan laporan ujian
yang telah dilaksanakan.

413 | D 11 L ap or an Uj i an Si ste m