manual pengguna sistem cimms - cimms.kkr.gov.mycimms.kkr.gov.my/help/manual_jalan_konsesi.pdf ·...

MANUAL PENGGUNA

SISTEM CIMMS

Modul Maklumat Penyenggaraan Jalan Persekutuan

(Khusus Untuk Pengguna Syarikat Konsesi)

Manual Penggunaan Sistem CIMMS

2

KANDUNGAN

1.0 Pengenalan ............................................................................. 5

2.0 Applikasi Berasakan Web ...................................................... 6

2.1 Portal ............................................................................................................... 6 2.1.1 Laman Utama .............................................................................................. 6

2.1.2 Log Pengguna .............................................................................................. 7 2.1.2.1 Log Masuk ............................................................................................... 7 2.1.2.2 Lupa Kata Laluan ..................................................................................... 7 2.1.2.3 Tukar Kata Laluan ................................................................................... 8 2.1.2.4 Log Keluar ............................................................................................... 8

2.2 Kemasukan Data ............................................................................................. 9 2.2.1 Maklumat Asas Jalan ................................................................................... 9 2.2.1.1 Butiran Am: Menambah Jalan Baru ...................................................... 11

2.2.1.2 Butiran Am: Mengemaskini Butiran Am Jalan ..................................... 11 2.2.1.3 Butiran Am: Menghapuskan Jalan ......................................................... 11 2.2.1.4 Segmen Jalan: Menambah Segmen Baru ............................................... 12 2.2.1.5 Segmen Jalan: Mengemaskini Maklumat Segmen ................................ 12

2.2.1.6 Segmen Jalan: Menghapuskan Segmen ................................................. 12 2.2.1.7 Inventori Jalan: Menambah Inventori Baru ........................................... 13

2.2.1.8 Inventori Jalan: Mengemaskini Maklumat Inventori ............................. 13 2.2.1.9 Inventori Jalan: Menghapuskan Inventori ............................................. 13 2.2.1.10 Sejarah Jalan: Menambah Sejarah Baru ................................................ 14

2.2.1.11 Sejarah Jalan: Mengemaskini Maklumat Sejarah .................................. 14 2.2.1.12 Sejarah Jalan: Menghapuskan Sejarah ................................................... 14

2.2.2 Maklumat Syarikat Konsesi Jalan ............................................................. 15 2.2.2.1 Butiran Am: Menambah Syarikat Konsesi Baru ................................... 17

2.2.2.2 Butiran Am: Mengemaskini Butiran Am Syarikat Konsesi .................. 17 2.2.2.3 Butiran Am: Menghapuskan Syarikat Konsesi ...................................... 17

2.2.2.4 Keupayaan: Menambah Keupayaan Baru .............................................. 18 2.2.2.5 Keupayaan: Mengemaskini Maklumat Keupayaan ............................... 18

2.2.2.6 Keupayaan: Menghapuskan Keupayaan ................................................ 18 2.2.2.7 Dokumen: Menambah Dokumen Baru .................................................. 19 2.2.2.8 Dokumen: Mengemaskini Maklumat Dokumen .................................... 19

2.2.2.9 Dokumen: Menghapuskan Dokumen .................................................... 19 2.2.2.10 Senarai Jalan: Menambah Segmen Jalan Baru ...................................... 20

2.2.2.11 Senarai Jalan: Mengemaskini Maklumat Segmen Jalan ........................ 20 2.2.2.12 Segmen Jalan: Menghapuskan Segmen Jalan ........................................ 20 2.2.2.13 Sub-Kontraktor: Menambah Sub-Kontraktor Baru ............................... 21 2.2.2.14 Sub-Kontraktor: Mengemaskini Maklumat Sub-Kontraktor ................. 21 2.2.2.15 Sub-Kontraktor: Menghapuskan Sub-Kontraktor .................................. 21

2.2.2.16 Kadar Bayaran: Menambah Kadar Bayaran Baru ................................. 22 2.2.2.17 Kadar Bayaran: Mengemaskini Kadar Bayaran .................................... 22

2.2.2.18 Kadar Bayaran: Menghapuskan Kadar Bayaran .................................... 22 2.2.3 Maklumat Penyenggaraan Rutin ............................................................... 23 2.2.3.1 Butiran Am: Menambah Jadual & Perlaksanaan Baru .......................... 24 2.2.3.2 Butiran Am: Mengemaskini Jadual & Perlaksanaan ............................. 24 2.2.3.3 Butiran Am: Menghapuskan Jadual & Perlaksanaan ............................. 24 2.2.3.4 Tuntutan Bayaran: Menambah Rekod Bayaran Baru ............................ 25 2.2.3.5 Tuntutan Bayaran: Mengemaskini Rekod Bayaran ............................... 25


3

2.2.3.6 Tuntutan Bayaran: Menghapuskan Rekod Bayaran .............................. 25

2.2.4 Maklumat Penyenggaraan Berkala ............................................................ 26 2.2.4.1 Butiran Am: Menambah Arahan Kerja Baru ......................................... 27 2.2.4.2 Butiran Am: Mengemaskini Butiran Am Arahan Kerja ........................ 27

2.2.4.3 Butiran Am: Menghapuskan Arahan Kerja ........................................... 27 2.2.4.4 Laporan Progres: Menambah Laporan Baru .......................................... 28 2.2.4.5 Laporan Progres: Mengemaskini Maklumat Laporan ........................... 28 2.2.4.6 Laporan Progres: Menghapuskan Laporan ............................................ 28 2.2.4.7 Sejarah Bayaran: Menambah Bayaran Baru .......................................... 29

2.2.4.8 Sejarah Bayaran: Mengemaskini Maklumat Bayaran............................ 29 2.2.4.9 Sejarah Bayaran: Menghapuskan Bayaran ............................................ 29 2.2.5 Maklumat Kerja Kecemasan ..................................................................... 30 2.2.5.1 Butiran Am: Menambah Arahan Kerja Baru ......................................... 31 2.2.5.2 Butiran Am: Mengemaskini Butiran Am Arahan Kerja ........................ 31

2.2.5.3 Butiran Am: Menghapuskan Arahan Kerja ........................................... 31

2.2.5.4 Laporan Progres: Menambah Laporan Baru .......................................... 32 2.2.5.5 Laporan Progres: Mengemaskini Maklumat Laporan ........................... 32

2.2.5.6 Laporan Progres: Menghapuskan Laporan ............................................ 32 2.2.5.7 Sejarah Bayaran: Menambah Bayaran Baru .......................................... 33 2.2.5.8 Sejarah Bayaran: Mengemaskini Maklumat Bayaran............................ 33

2.2.5.9 Sejarah Bayaran: Menghapuskan Bayaran ............................................ 33 2.2.6 Maklumat Aduan ....................................................................................... 34 2.2.6.1 Butiran Am: Menambah AduanBaru ..................................................... 36

2.2.6.2 Butiran Am: Mengemaskini Butiran Am Aduan ................................... 36 2.2.6.3 Butiran Am: Menghapuskan Aduan ...................................................... 36

2.2.6.4 Laporan Progres: Menambah Laporan Baru .......................................... 37 2.2.6.5 Laporan Progres: Mengemaskini Maklumat Laporan ........................... 37 2.2.6.6 Laporan Progres: Menghapuskan Laporan ............................................ 37

2.3 Senarai Kod ................................................................................................... 38

2.3.1.1 Menambah Kod Baru ............................................................................. 39 2.3.1.2 Mengemaskini Kod ................................................................................ 39 2.3.1.3 Menghapuskan Kod ............................................................................... 39

3.0 Import Dan Eksport Data ..................................................... 40

3.1 Fungsi: Eksport Data .................................................................................... 40 3.2 Fungsi: Import Data ...................................................................................... 41

3.2.1 Penyediaan data ......................................................................................... 41 3.2.1.1 Menambah Rekod .................................................................................. 42

3.2.1.2 Mengemaskini Rekod ............................................................................ 42 3.2.1.3 Menghapuskan Rekod ............................................................................ 42 3.2.2 Muat-naik Data .......................................................................................... 43

3.3 Butir-butir Medan Fail XML......................................................................... 45

3.3.1 Maklumat Asas Jalan ................................................................................. 45

3.3.2 Maklumat Syarikat Konsesi ....................................................................... 47 3.3.3 Maklumat Penyenggaraan Rutin ............................................................... 49

3.3.4 Maklumat Penyenggaraan Berkala ............................................................ 50 3.3.5 Maklumat Kerja Kecemasan ..................................................................... 52 3.3.6 Maklumat Aduan ....................................................................................... 53

4.0 Web Service .......................................................................... 54

4.1 Pengambungan Ke CIMMS Web Service ..................................................... 54 4.2 Mengintegrasi Sistem CRMIS Kepada Sistem CIMMS ............................... 56


4

4.2.1 PHP ............................................................................................................ 56

4.2.2 VB.Net ....................................................................................................... 57 4.3 Senarai Fail dan Fungsi dalam CIMMS Web Service .................................. 59 4.3.1 Collect/RList_WS.php ............................................................................... 59

4.3.2 Collect/RCompany_WS.php ..................................................................... 66 4.3.3 Collect/RRoutine_WS.php ........................................................................ 83 4.3.4 Collect/RPeriodic_WS.php........................................................................ 90 4.3.5 Collect/REWork_WS.php ......................................................................... 98 4.3.6 Collect/RCmpnt_WS.php ........................................................................ 106

4.3.7 Collect/CodeList_WS.php ....................................................................... 112 4.3.8 Collect/RUploadDoc_WS.php ................................................................ 114


5

1.0 Pengenalan

CIMMS dibangunkan adalah untuk membantu pegawai-pegawai Bahagian Kawalselia dan Senggaraan di Kementerian Kerjaraya dalam mengurus dan memantau kerja-kerja penyelenggaraan Bangunan Gunasama Persekutuan dan Jalan Persekutuan. Syarikat-syarikat konsesi dipertunggungjawabkan untuk menyediakan data-data yang diperlukan oleh sistem CIMMS. Terdapat 3 kaedah penyediaan data yang boleh digunakan oleh Syarikat konsesi iaitu:- i. Antaramuka Web Kaedah ini membolehkan penguna di syarikat konsesi memasukkan data terus ke sistem CIMMS menggunakan skrin kemasukan data yang disediakan dalam halaman web. ii. Import / Ekport Data Kaedah ini membolehkan penguna di syarikat konsesi menyediakan data secara offline (menggunakan aplikasi seperti MS Excel atau yang seumpamanya), kemudian menghantarnya menggunakan fungsi muat-naik fail yang disediakan di halaman web CIMMS. iii. 'Web Service' Kaeadah ini memboleh integasi sepenuhnya, dimana sistem CIMMS dan CRMIS boleh berhubung secara otomatik tanpa memerlukan sebarang operator. Dengan menggunakan protokol TCP/SOAP, aplikasi CRMIS boleh menghantar data dan juga meng'query' data daripada sistem CIMMS secara terus.

Bab

1


6

2.0 Applikasi Berasakan Web

Applikasi ini membolehkan pengguna memasukkan data ke dalam sistem CIMMS secara atas talian.

2.1 Portal

2.1.1 Laman Utama

Laman utama untuk aplikasi ini adalah seperti berikut.

Rajah 1.1a.Laman Utama

Menu navigasi Menu navigasi (atau menu bar) membolehkan pengguna membuka modul-modul yang terdapat dalam sistem cimms.

.

Bab

2


7

2.1.2 Log Pengguna

Sistem CIMMS mengandungi maklumat yang sensitif, setiap pengguna perlu membuat pendaftaran masuk (log Masuk) sebelum dibenarkan membuka sistem. Pengguna juga dinasihatkan untuk daftar keluar (log keluar) apabila tidak lagi menggunakan sistem

2.1.2.1 Log Masuk

Klik Log Masuk pada menubar

Masukkan Nama Pengguna

Masukkan Kata Laluan

Klik butang Log Masuk

2.1.2.2 Lupa Kata Laluan

Jika terlupa kata laluan, Pengguna boleh meminta kata laluan baru.

Klik hiper-rangkai Lupa Kata Laluan. Skrin berikut akan dipaparkan:-

Masukkan email pengguna.

Periksa dan tunggu email daripada sistem CIMMS.

Klik hiper-rangkai yang disediakan dalam email diterima.


8

Kata Laluan baru akan dipaparkan.

2.1.2.3 Tukar Kata Laluan

Klik Log Masuk atau Log Keluar pada menubar.

Klik hiper-rangkai Tukar Kata Laluan

Masukkan medan-medan yang disediakan

Klik butang Tukar Kata Laluan.

2.1.2.4 Log Keluar

Untuk Keselamatan, pengguna juga dinasihatkan untuk daftar keluar (log keluar) apabila tidak lagi menggunakan sistem.

Klik Log Keluar pada menubar


9

2.2 Kemasukan Data

2.2.1 Maklumat Asas Jalan

Skrin ini menyediakan kemudahan carian dan paparan maklumat asas jalan

Klik Jalan>Kemasukan Data>Maklumat Asas Jalan pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.1.a

Rajah 3.1.1.a: Maklumat Asas Jalan

Pilih zon untuk mendapatkan senarai jalan mengikut zon.

Klik jalan dalam senarai untuk memaparkan maklumat lengkap mengenai jalan tersebut, seperti rajah 3.1.1.b. o Klik tab Butiran Am: Maklumat Am jalan akan dipaparkan. o Klik tab Segmen Jalan: Senarai segmen jalan akan dipaparkan. o Klik tab Inventori: Senarai inventori jalan akan dipaparkan. o Klik tab Sejarah: Sejarah jalan akan dipaparkan. o Klik tab Inventori: Senarai inventori jalan akan dipaparkan.

Rajah 3.1.1.b: Maklumat Terperinci Jalan


10

Klik butang carian untuk membuat carian data. o Medan-medan carian akan dipaparkan seperti dalam rajah 3.1.1.c. o Masukan kata kunci carian pada medan-medan yang disediakan.

o Klik butang cari atau tekan <Enter> untuk memulakan proses carian.

Rajah 3.1.1.c: Medan-medan Carian

Klik nombor halaman untuk memaparkan senarai jalan seterusnya.


11

2.2.1.1 Butiran Am: Menambah Jalan Baru

Klik tab Butiran Am seperti dalam rajah 3.1.1 c.

Klik butang Tambah untuk menambah jalan yang baru.


klik butang Simpan untuk menyimpan maklumat jalan yang baru.

2.2.1.2 Butiran Am: Mengemaskini Butiran Am Jalan


Klik Jalan yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini butiran am jalan.

Masukkan/betulkan medan-medan yang disediakan.

Klik butang Simpan untuk menyimpan butiran am jalan yang dikemaskini.

2.2.1.3 Butiran Am: Menghapuskan Jalan



Klik butang Hapus untuk menghapus jalan.

Klik butang "OK" untuk kepastian.

Rajah 3.1.1 c: Butiran Am Jalan


12

2.2.1.4 Segmen Jalan: Menambah Segmen Baru

Klik tab Segmen Jalan seperti dalam rajah 3.1.1 d.

Klik butang Tambah untuk menambah segmen yang baru.

Masukkan medan-medan yang disediakan.

klik butang Simpan untuk menyimpan maklumat segmen yang baru.

2.2.1.5 Segmen Jalan: Mengemaskini Maklumat Segmen


Klik segmen yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat segmen.


Klik butang Simpan untuk menyimpan maklumat segmen yang dikemaskini.

2.2.1.6 Segmen Jalan: Menghapuskan Segmen



Klik butang Hapus untuk menghapus segmen.


Rajah 3.1.1 d: Segmen Jalan


13

2.2.1.7 Inventori Jalan: Menambah Inventori Baru

Klik tab Inventori Jalan seperti dalam rajah 3.1.1 e.

Klik butang Tambah untuk menambah Inventori yang baru.


klik butang Simpan untuk menyimpan maklumat Inventori yang baru.

2.2.1.8 Inventori Jalan: Mengemaskini Maklumat Inventori


Klik Inventori yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat Inventori.


Klik butang Simpan untuk menyimpan maklumat Inventori yang dikemaskini.

2.2.1.9 Inventori Jalan: Menghapuskan Inventori


Klik Inventori yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus Inventori.


Rajah 3.1.1 e: Inventori Jalan


14

2.2.1.10 Sejarah Jalan: Menambah Sejarah Baru

Klik tab Sejarah Jalan seperti dalam rajah 3.1.1 f.

Klik butang Tambah untuk menambah Sejarah yang baru.


klik butang Simpan untuk menyimpan maklumat Sejarah yang baru.

2.2.1.11 Sejarah Jalan: Mengemaskini Maklumat Sejarah


Klik Sejarah yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat Sejarah.


Klik butang Simpan untuk menyimpan maklumat Sejarah yang dikemaskini.

2.2.1.12 Sejarah Jalan: Menghapuskan Sejarah


Klik Sejarah yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus Sejarah.


Rajah 3.1.1 f: Sejarah Jalan


15

2.2.2 Maklumat Syarikat Konsesi Jalan

Skrin ini menyediakan kemudahan carian dan paparan maklumat Syarikat Konsesi jalan.

Klik Jalan>Kemasukan Data>Maklumat Syarikat Konsesi Jalan pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.2.a

Rajah 3.1.2.a: Maklumat Syarikat Konsesi Jalan

Klik nama syarikat dalam senarai untuk memaparkan maklumat lengkap mengenai syarikat tersebut, seperti rajah 3.1.2.b. o Klik tab Butiran Am: Maklumat am syarikat akan dipaparkan. o Klik tab Keupayaan: Senarai keupayaan syarikat akan dipaparkan. o Klik tab Dokumen: Senarai dokumen berkaitan dengan syarikat

akan dipaparkan. o Klik tab Jalan: Senarai jalan yang diselenggara oleh syarikat akan

dipaparkan. o Klik tab Sub-Kontraktor : Senarai sub-kontraktor kepada syarikat

akan dipaparkan. o Klik tab Kadar Bayaran: Maklumat Kadar Bayaran Penyenggaraan

akan dipaparkan.


16

Rajah 3.1.2.b: Maklumat Terperinci Syarikat Konsesi




Klik nombor halaman untuk memaparkan senarai syarikat seterusnya.


17

2.2.2.1 Butiran Am: Menambah Syarikat Konsesi Baru

Klik tab Butiran Am seperti dalam rajah 3.1.2.d.

Klik butang Tambah untuk menambah syarikat yang baru.


klik butang Simpan untuk menyimpan maklumat syarikat yang baru.

2.2.2.2 Butiran Am: Mengemaskini Butiran Am Syarikat Konsesi

Klik tab Butiran Am seperti dalam rajah 3.1.2.d


Klik butang Kemaskini untuk mengemaskini butiran am syarikat.


Klik butang Simpan untuk menyimpan butiran am syarikat yang dikemaskini.

2.2.2.3 Butiran Am: Menghapuskan Syarikat Konsesi

Klik tab Butiran Am seperti dalam rajah 3.1.2.d.


Klik butang Hapus untuk menghapus syarikat.


Rajah 3.1.2.d: Butiran Am Syarikat Konsesi


18

2.2.2.4 Keupayaan: Menambah Keupayaan Baru

Klik tab Keupayaan seperti dalam rajah 3.1.2.e.

Klik butang Tambah untuk menambah keupayaan yang baru.


klik butang Simpan untuk menyimpan maklumat keupayaan yang baru.

2.2.2.5 Keupayaan: Mengemaskini Maklumat Keupayaan

Klik tab keupayaan seperti dalam rajah 3.1.2.e.

Klik keupayaan yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat keupayaan.


Klik butang Simpan untuk menyimpan maklumat keupayaan yang dikemaskini.

2.2.2.6 Keupayaan: Menghapuskan Keupayaan

Klik tab keupayaan seperti dalam rajah 3.1.2.e.

Klik keupayaan yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus keupayaan.


Rajah 3.1.2.e: Keupayaan Syarikat Konsesi


19

2.2.2.7 Dokumen: Menambah Dokumen Baru

Klik tab Dokumen seperti dalam rajah 3.1.2.f.

Klik butang Tambah untuk menambah dokumen yang baru.


klik butang Simpan untuk menyimpan maklumat dokumen yang baru.

2.2.2.8 Dokumen: Mengemaskini Maklumat Dokumen


Klik dokumen yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat dokumen.


Klik butang Simpan untuk menyimpan maklumat dokumen yang dikemaskini.

2.2.2.9 Dokumen: Menghapuskan Dokumen


Klik dokumen yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus dokumen.


Rajah 3.1.2.f: Dokumen


20

2.2.2.10 Senarai Jalan: Menambah Segmen Jalan Baru

Klik tab Senarai Jalan seperti dalam rajah 3.1.2.g.

Klik butang Tambah untuk menambah segmen jalan yang baru.


klik butang Simpan untuk menyimpan maklumat segmen jalan yang baru.

2.2.2.11 Senarai Jalan: Mengemaskini Maklumat Segmen Jalan



Klik butang Kemaskini untuk mengemaskini maklumat segmen jalan.


Klik butang Simpan untuk menyimpan maklumat segmen jalan yang dikemaskini.

2.2.2.12 Segmen Jalan: Menghapuskan Segmen Jalan



Klik butang Hapus untuk menghapus segmen jalan.


Rajah 3.1.2.g: Segmen Jalan


21

2.2.2.13 Sub-Kontraktor: Menambah Sub-Kontraktor Baru

Klik tab Sub-Kontraktor seperti dalam rajah 3.1.2.h.

Klik butang Tambah untuk menambah sub-kontraktor yang baru.


klik butang Simpan untuk menyimpan maklumat sub-kontraktor yang baru.

2.2.2.14 Sub-Kontraktor: Mengemaskini Maklumat Sub-Kontraktor


Klik sub-kontraktor yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat sub-kontraktor.


Klik butang Simpan untuk menyimpan maklumat sub-kontraktor yang dikemaskini.

2.2.2.15 Sub-Kontraktor: Menghapuskan Sub-Kontraktor


Klik sub-kontraktor yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus sub-kontraktor.


Rajah 3.1.2.h: Sub-Kontraktor


22

2.2.2.16 Kadar Bayaran: Menambah Kadar Bayaran Baru

Rujuk Bab 3.3 (Senarai Kod Skop Kerja Penyenggaraan Rutin).

2.2.2.17 Kadar Bayaran: Mengemaskini Kadar Bayaran

Klik tab Kadar Bayaran seperti dalam rajah 3.1.2.i.

Klik kadar bayaran yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat kadar bayaran.


Klik butang Simpan untuk menyimpan maklumat kadar bayaran yang dikemaskini.

2.2.2.18 Kadar Bayaran: Menghapuskan Kadar Bayaran

Rujuk Bab 3.3 (Senarai Kod Skop Kerja Penyenggaraan Rutin).

Rajah 3.1.2.i: Kadar Bayaran


23

2.2.3 Maklumat Penyenggaraan Rutin

Skrin ini menyediakan kemudahan untuk memantau kerja-kerja penyenggaraan rutin.

Klik Jalan>Kemasukan Data>Maklumat Penyenggaraan Rutin pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.3.a

Rajah 3.1.3.a: Maklumat Penyenggaraan Rutin

Pilih nama syarikat, Skop Kerja dan Tahun.

Klik No Jalan atau kotak jadual dan perlaksanaan dalam senarai untuk memaparkan maklumat lengkap mengenai kerja rutin, seperti rajah 3.1.3.b. o Klik tab Butiran Am: Maklumat jadual dan perlaksanaan kerja rutin

akan dipaparkan. o Klik tab Tuntutan Bayaran: Maklumat Tuntutan Bayaran akan

dipaparkan.

Rajah 3.1.3.b: Maklumat Terperinci Penyenggaraan Rutin


24





2.2.3.1 Butiran Am: Menambah Jadual & Perlaksanaan Baru

Klik tab Butiran Am seperti dalam rajah 3.1.3.f.

Klik butang Tambah untuk menambah Jadual yang baru.


klik butang Simpan untuk menyimpan maklumat jadual yang baru.

2.2.3.2 Butiran Am: Mengemaskini Jadual & Perlaksanaan


Klik jadual yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini butiran am jadual.


Klik butang Simpan untuk menyimpan butiran am jadual yang dikemaskini.

2.2.3.3 Butiran Am: Menghapuskan Jadual & Perlaksanaan


Klik Jadual yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus jadual.



25

Rajah 3.1.3.f: Butiran Am Jadual & Perlaksanaan

2.2.3.4 Tuntutan Bayaran: Menambah Rekod Bayaran Baru

Klik tab Tuntutan Bayaran seperti dalam rajah 3.1.3.g.

Klik butang Tambah untuk menambah rekod bayaran yang baru.


klik butang Simpan untuk menyimpan rekod bayaran yang baru.

2.2.3.5 Tuntutan Bayaran: Mengemaskini Rekod Bayaran


Klik rekod bayaran yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini rekod bayaran.


Klik butang Simpan untuk menyimpan rekod bayaran yang dikemaskini.

2.2.3.6 Tuntutan Bayaran: Menghapuskan Rekod Bayaran



Klik butang Hapus untuk menghapus rekod bayaran.


Rajah 3.1.3.g: Tuntutan Bayaran


26

2.2.4 Maklumat Penyenggaraan Berkala

Skrin ini menyediakan kemudahan untuk memantau kerja-kerja penyenggaraan Berkala.

Klik Jalan>Kemasukan Data>Maklumat Penyenggaraan Berkala pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.4.a

Rajah 3.1.4.a: Maklumat Penyenggaraan Berkala

Klik No AK (Arahan Kerja) dalam senarai untuk memaparkan maklumat lengkap mengenai projek tersebut, seperti rajah 3.1.4.b. o Klik tab Butiran Am: Maklumat am Arahan Kerja akan dipaparkan. o Klik tab Laporan Progress: Senarai laporan kemajuan kerja akan

dipaparkan. o Klik tab Sejarah Bayaran: Senarai Pembayaran akan dipaparkan.

Rajah 3.1.4.b: Maklumat Terperinci Arahan Kerja


27





2.2.4.1 Butiran Am: Menambah Arahan Kerja Baru


Klik butang Tambah untuk menambah AK yang baru.


klik butang Simpan untuk menyimpan maklumat AK yang baru.

2.2.4.2 Butiran Am: Mengemaskini Butiran Am Arahan Kerja


Klik AK yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini butiran am AK.


Klik butang Simpan untuk menyimpan butiran am AK yang dikemaskini.

2.2.4.3 Butiran Am: Menghapuskan Arahan Kerja



Klik butang Hapus untuk menghapus AK.



28

Rajah 3.1.4.f: Butiran Am Arahan Kerja

2.2.4.4 Laporan Progres: Menambah Laporan Baru

Klik tab Laporan Progres seperti dalam rajah 3.1.4.g.

Klik butang Tambah untuk menambah laporan yang baru.


klik butang Simpan untuk menyimpan maklumat laporan yang baru.

2.2.4.5 Laporan Progres: Mengemaskini Maklumat Laporan


Klik laporan yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat laporan.


Klik butang Simpan untuk menyimpan maklumat laporan yang dikemaskini.

2.2.4.6 Laporan Progres: Menghapuskan Laporan



Klik butang Hapus untuk menghapus laporan.


29


Rajah 3.1.4.g: Laporan Progres Arahan Kerja

2.2.4.7 Sejarah Bayaran: Menambah Bayaran Baru

Klik tab Sejarah Bayaran seperti dalam rajah 3.1.4.h.




2.2.4.8 Sejarah Bayaran: Mengemaskini Maklumat Bayaran






2.2.4.9 Sejarah Bayaran: Menghapuskan Bayaran





Rajah 3.1.4.h: Sejarah Bayaran Arahan Kerja


30

2.2.5 Maklumat Kerja Kecemasan

Skrin ini menyediakan kemudahan untuk memantau kerja-kerja penyenggaraan Kecemasan.

Klik Jalan>Kemasukan Data>Maklumat Kerja Kecemasan pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.5.a

Rajah 3.1.5.a: Maklumat Kerja Kecemasan

Klik No Kerja (Arahan Kerja) dalam senarai untuk memaparkan maklumat lengkap mengenai projek tersebut, seperti rajah 3.1.5.b. o Klik tab Butiran Am: Maklumat am Arahan Kerja akan dipaparkan. o Klik tab Laporan Progress: Senarai laporan kemajuan kerja akan

dipaparkan. o Klik tab Sejarah Bayaran: Senarai Pembayaran akan dipaparkan.

Rajah 3.1.5.b: Maklumat Terperinci Arahan Kerja


31





2.2.5.1 Butiran Am: Menambah Arahan Kerja Baru


Klik butang Tambah untuk menambah AK yang baru.


klik butang Simpan untuk menyimpan maklumat AK yang baru.

2.2.5.2 Butiran Am: Mengemaskini Butiran Am Arahan Kerja



Klik butang Kemaskini untuk mengemaskini butiran am AK.


Klik butang Simpan untuk menyimpan butiran am AK yang dikemaskini.

2.2.5.3 Butiran Am: Menghapuskan Arahan Kerja



Klik butang Hapus untuk menghapus AK.



32

Rajah 3.1.5.f: Butiran Am Arahan Kerja


















33

Rajah 3.1.5.g: Laporan Progres Arahan Kerja

2.2.5.7 Sejarah Bayaran: Menambah Bayaran Baru





2.2.5.8 Sejarah Bayaran: Mengemaskini Maklumat Bayaran






2.2.5.9 Sejarah Bayaran: Menghapuskan Bayaran





Rajah 3.1.5.h: Sejarah Bayaran Arahan Kerja


34

2.2.6 Maklumat Aduan

Skrin ini menyediakan kemudahan untuk memantau Aduan.

Klik Jalan>Kemasukan Data>Maklumat Aduan pada bar menu untuk memaparkan skrin senarai jalan seperti rajah 3.1.6.a

Rajah 3.1.6.a: Maklumat Aduan

Klik No Aduan dalam senarai untuk memaparkan maklumat lengkap mengenai aduan tersebut, seperti rajah 3.1.6.b. o Klik tab Butiran Am: Maklumat am Aduanakan dipaparkan. o Klik tab Laporan Progress: Senarai laporan kemajuan kerja akan

dipaparkan.

Rajah 3.1.6.b: Maklumat Terperinci Aduan





35



36

2.2.6.1 Butiran Am: Menambah AduanBaru


Klik butang Tambah untuk menambah Aduan yang baru.


klik butang Simpan untuk menyimpan maklumat Aduan yang baru.

2.2.6.2 Butiran Am: Mengemaskini Butiran Am Aduan


Klik Aduan yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini butiran am Aduan.


Klik butang Simpan untuk menyimpan butiran am Aduan yang dikemaskini.

2.2.6.3 Butiran Am: Menghapuskan Aduan


Klik Aduan yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus Aduan.


Rajah 3.1.6.f: Butiran Am Aduan


37

















Rajah 3.1.6.g: Laporan Progres Aduan


38

2.3 Senarai Kod

Modul ini digunakan untuk menyenggara kod-kod yang digunakan dalam sistem CIMMS.

Antara Kod-kod tersebut adalah:-

o Senarai Kawasan o Senarai Kelas Jalan o Senarai Status Aduan o Senarai Jenis Aduan o Senarai Kategori Keupayaan o Senarai Jenis Dokumen o Senarai Kategori Sejarah Jalan o Senarai Kategori Inventori o Senarai Skop Kerja Penyenggaraan Berkala o Senarai Status Arahan Kerja o Senarai Skop Kerja Kecemasan o Senarai Status Kerja Kecemasan o Senarai Skop Kerja Penyenggaraan Rutin o Senarai Jenis Laporan (muat-naik) o Senarai Zon o Senarai Jenis Jalan o Senarai Daerah o Senarai Parlimen o Senarai Kategori Jalan o Senarai Butiran Peruntukan

Untuk Membuka laporan klik Jalan>Senarai Kod>nama kod pada bar menu. Contoh ditunjukan dalam rajah 3.3.a

Rajah 3.3.a: Senarai Kod

Klik kod dalam senarai untuk memaparkan maklumat lengkap mengenai kod tersebut, seperti rajah 3.3.b


39

Rajah 3.1.6.b: Maklumat Terperinci Kod



Rajah 3.3.c: Medan-medan Carian

Klik nombor halaman untuk memaparkan senarai seterusnya.

2.3.1.1 Menambah Kod Baru

Klik butang Tambah untuk menambah kod yang baru.


klik butang Simpan untuk menyimpan maklumat kod yang baru.

2.3.1.2 Mengemaskini Kod

Klik kod yang dikehendaki dari dalam senarai.

Klik butang Kemaskini untuk mengemaskini maklumat kod.


Klik butang Simpan untuk menyimpan maklumat kod yang dikemaskini.

2.3.1.3 Menghapuskan Kod

Klik kod yang dikehendaki dari dalam senarai.

Klik butang Hapus untuk menghapus kod.



40

3.0 Import Dan Eksport Data

Fungsi ini membolehkan penguna di syarikat konsesi menyediakan data secara offline (menggunakan aplikasi seperti MS Excel atau yang seumpamanya), kemudian menghantarnya menggunakan fungsi muat-naik fail yang disediakan di halaman web.

3.1 Fungsi: Eksport Data

Sebelum melaksanakan proses penghantaran (import) data ke Sistem CIMMS, pengguna perlu terlebih dahulu memuat turun data (atau sekurang-kurang stuktur data) daripada sistem CIMMS.

Klik Jalan>Kemasukan Data> pada menubar.

Pada Menu pilih skrin berdasarkan data yang dikehendaki.

Rajah 3 a: Menu

Pada Skrin yang dipilih,Klik butang Import/Eksport untuk membuat mengeksport data. o Klik tab muat-turun data. o Klik hiper-rangkai arahan sediakan data (Klik disini).

Rajah 3 b: Muat Turun Data

Bab

3


41

o Klik-kanan pada ikon muat turun yang disediakan.

o Pilih 'save link as' / 'save as' o Tentukan lokasi fail dan tekan butang save o Buka fail tersebut dibuka menggunakan Ms Excel atau applikasi

lain yang boleh membaca format fail xml.

3.2 Fungsi: Import Data

Proses mengimport data ke Sistem CIMMS perlu sekurang-kurangnya melalui 2 proses iaitu penyediaan data dan muat-naik data.

3.2.1 Penyediaan data

Untuk memulakan proses ini, buka aplikasi MS Excel.

Buka fail xml yang telah di muat-turun menggunakan fungsi eksport

sebelum ini.

Apabila diberi pilihan, pilih "Open XML - as an XML table".

skrin seperti berikut akan dipaparkan.


42

Rajah 3 c: Contoh fail xml

Baris 1: Adalah nama medan. Tidak boleh diubah.

Baris 2: Mengandungai Keterangan tentang kegunaan setiap kolum.

Baris 3: Biarkan Kosong.

Baris 4 & 5 (bagi contoh ini sahaja) : Adalah data yang di ekport dari sistem CIMMS. Data ini boleh diubah.

Baris seterusnya: boleh digunakan untuk menambah data. Nota : i. Setiap satu rekod hanya boleh diwakili oleh satu baris sahaja. ii. Kolum yang mempunyai nama bermula dengan PKey_ tidak boleh diubah.

3.2.1.1 Menambah Rekod

Klik pada baris kosong selepas rekod terakhir (baris 6 bagi contoh dalam rajah 3 c).

Pada Kolum Command, Masukkan Huruf 'T' untuk tambah rekod.

Masukkan data pada setiap kolum yang disediakan. Keterangan lanjut mengenai setiap kolum boleh dirujuk pada bab 3.3.

3.2.1.2 Mengemaskini Rekod

Klik pada baris data yang dikehendaki.

Pada Kolum Command, Masukkan Huruf 'U' untuk ubah/kemaskini rekod.

Masukkan/betulkan data pada setiap kolum yang dikehendaki. Keterangan lanjut mengenai setiap kolum boleh dirujuk pada bab 3.3.

3.2.1.3 Menghapuskan Rekod

Klik pada baris data yang dikehendaki.

Pada Kolum Command, Masukkan Huruf 'H' untuk hapuskan rekod.


43

3.2.2 Muat-naik Data

Setelah proses penyediaan data selesai, pengguna boleh memulakn prose muat-naik data.

Klik pada baris 1 kolum Command.

Klik-kanan pada tetikus. menu berikut akan dipaparkan.

Rajah 3.d : Export ke fail xml

Pilih XML>Export. Klik.

Tentukan nama dan lokasi fail.

Klik butang Export.

Klik Jalan>Kemasukan Data> pada menubar.


44

Pada Menu pilih skrin berdasarkan data yang dikehendaki.

Rajah 3 e: Menu

Pada Skrin yang dipilih,Klik butang Import/Eksport untuk membuat mengimport data.

Klik tab muat naik data (Import).

Rajah 3 f: Import Data

Jika Ada, Hapuskan fail yang lama dan telah diproses terlebih dahulu.

klik butang hapus .

Klik tambah . skrin berikut akan dipaparkan.

Rajah 3 g: Muat naik fail

Masukkan Nota.

Klik butang browse dan pilih fail xml yang hendak dimuat-naik.

Klik butang muat-naik dan tunggu mesej "fail telah dimuat naik".


45

Klik butang Simpan .

klik arahan proses untuk memulakan proses fail.

3.3 Butir-butir Medan Fail XML

3.3.1 Maklumat Asas Jalan

Nama Jadual / Keterangan

Input Parameter

1.a tb_Road Keterangan: Senarai jalan

RoadNo: string(10) No. Jalan

Section: string(5) Seksyen Jalan

RoadName: string(100) Nama Jalan

Category: string(5) Rujuk CodeList/RCategory_WS.php

RoadLen: decimal Panjang Jalan

Chainage: string(45) Rantaian Jalan

Area: string(10) Kawasan dilalui

ComnNo: string(45) No. Warta

ComnDate: date Tarikh Warta

Concession: string(10) No. Pendaftaran Syarikat Konsesi

1.b tb_RoadSegment Keterangan: Senarai Segment Jalan


SegID: string(10) No. Segment

District: string(45) Daerah

BSection: decimal Sekyen Mula

ESection: decimal Sekyen Tamat

SegLen: decimal Panjang Segment

SegSize: decimal Saiz Segment

SCategory: string(5) Kategori Jalan. Rujuk GetRoadCategoryRecord

SType: string(5) Jenis Jalan. Rujuk GetRoadTypeRecord

ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetCoRecord

Zone: string(5) Zon dilalui. Rujuk GetRoadZoneRecord

1.c tb_RoadInv Keterangan: Senarai Inventori

UserName: string(20) Nama Pengguna/Login

Password: string(20) Kata Laluan Pengguna


Num: integer No baris/turutan (1,2..)


46

Jalan Code: string(5) Kod Inventori. Rujuk GetRoadInvCat.

Description: string(45) Keterangan

Qty: string Kuantiti Inventori

1.d tb_RoadHis Keterangan: Sejarah Jalan




EventID: integer No baris/turutan (1,2,3,...)

EventDate: date Tarikh Sejarah

Description: string (45) Keterangan

EventType: string (5) Ketegori Sejarah. Rujuk GetRoadHistoryType

AKNo: string (45) No. Arahan Kerja

ComsNo: string (45) No. Warta

ComsDate: date Tarikh Warta

Cost: decimal Kos terlibat


47

3.3.2 Maklumat Syarikat Konsesi


Input Parameter

2.a tb_RoadCo Keterangan: Senarai Syarikat Konsesi Jalan

RegNo: string(10) No. Pendaftaran Syarikat

ConName: string(45) Nama Syarikat

Address: string(255) Alamat

Contact: string(45) Pegawai Dihubungi

Telephone: string(45) No. Telefon

Fax: string(45) No. Fax

DateSignAggr: date Tarikh Perjanjian

DateEffective: date Tarikh Mula Kontrak

DateExp: date Tarikh Tamat Kontrak

ExtraInfo: string(1000) Maklumat Lain-lain

2.b tb_RoadCoAbility Keterangan: Keupayaan Syarikat Konsesi Jalan

Concession: string(10)

No. Pendaftaran Syarikat Konsesi. Rujuk GetRoadCoRecord

Num: integer No baris/turutan (1,2,3,...)

AbilityType: string(10) Kod Keupayaan. Rujuk Tb_RoadCoAbilityType

Have: integer Ada(1)/Tiada(0)

Qty: string (45) Kuantiti

Comment: string (100) Komen/Nota

2.c tb_RoadCoSub Keterangan: Sub-kontraktor kepada Syarikat Konsesi Jalan


No. Pendaftaran Syarikat Konsesi. Rujuk Tb_RoadCoRecord

RegNo: string(10) No. Pendaftaran Syarikat Sub-kontraktor

SubcName: string(45) Nama Sub-kontraktor



Phone: string(45) No. Telefon


ContSDate: date Tarikh Mula Kontrak

ContEDate: date Tarikh Tamat Kontak

JobScope: string(1000) Skop Kerja

2.d tb_RoadCoRateItem Keterangan: ekod kadar harga per skop kerja

ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk Tb_RoadCoRecord

Zone: string(5) Zon. Rujuk Tb_RoadZone

JobScope: string(5) Skop Kerja. Rujuk


48

penyenggaraan rutin Jalan

Tb_RoadRoutineJob

RateType: string(5) Jenis Kadar Tb_RoadRoutineRateType

JobItem: string(5) Item Skop Kerja. Rujuk Tb_RoadRoutineJobItem

Rate: decimal Kadar Harga

2.e tb_RoadCoRoadRate Keterangan: Rekod kadar harga Jalan

ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk Tb_RoadCoRecord

JobScope: string(5) Skop Kerja. Rujuk Tb_RoadRoutineJob

RateType: string Jenis Kadar Tb_RoadRoutineRateType

RoadNo: string No. Jalan

RoadLen: decimal Panjang Jalan untuk kadar ini


49

3.3.3 Maklumat Penyenggaraan Rutin


Input Parameter

3.a tb_RoadRoutine Keterangan: Digunakan untuk tambah rekod Jadual & Perlaksanaan Penyenggaraan Rutin Jalan



ConID: string(10) No. Pendaftaran Syarikat. Rujuk Tb_RoadCoRecord


Tb_RoadRoutineJob

RYear: string(4) Tahun(yyyy)


TaskID: string(20) No. Kerja / No Pusingan

SDateBegin: date Tarikh Jangka Mula

SDateEnd: date Tarikh Jangka Selesai

WDateBegin: date Tarikh Mula Kerja

WDateEnd: date Tarikh Selesai Kerja

VerifiedBy: smallint Disahkan(1:ya; 0:tidak)

Note: string(255) Nota

Location: string(45) Lokasi Kerja

AreaSize: decimal Saiz kawasan kerja (untuk skop kerja turapan sahaja)

3.b tb_RoadRoutinePaid Keterangan: Digunakan untuk tambah rekod Pembayaran Penyenggaraan Rutin Jalan



ConID: string(10) No. Pendaftaran Syarikat. Rujuk Tb_RoadCoRecord



JobScope: string(5) Skop Kerja. Rujuk Tb_RoadRoutineJob


RMonth: string(2) Bulan(MM)


RoadLen: decimal Panjang Jalan yang dibayar

Amount: decimal Amaun bayaran.


50

3.3.4 Maklumat Penyenggaraan Berkala


Input Parameter

4.a tb_RoadPeriodic Keterangan: Senarai Arahan Kerja



Concession:string(10) No. Pendaftaran Syarikat. Rujuk Tb_RoadCoRecord

ProjectNo: string(45) No. AK

ProjectName:string(255) Nama Projek


Tb_RoadPeriodicJob

ProjectDetail: string(45) Butir-butir projek

JKROfficer: string(45) Nama Pegawai JKR


Location: string(45) Lokasi Projek

Lon: string(45) Kordinat Longitut

Lat: string(45) Kordinat Latitut

DateStart: date Tarikh Mula Projek

DateEnd: date Tarikh Selesai Projek

DateDLP: date Tarikh DLP

Status: string(5) Status. Rujuk Tb_RoadPeriodicStatus

Value: numeric Nilai Projek

Paid: numeric Jumlah Telah Dibayar

4.b tb_RoadPeriodicRpt Keterangan: Laporan Arahan Kerja




ProjectNo: string(45) No. AK. Rujuk Tb_RoadPeriodicRecord

Num: integer No baris/turutan (1,2,3,..)

PDate: date Tarikh Laporan

Description: string(255) Laporan

Progress: string(45) Progres %

4.c tb_RoadPeriodicPaid Keterangan: Pembayaran Arahan Kerja




No. Pendaftaran Syarikat. Rujuk Tb_RoadCoRecord

ProjectNo: string(45) No. AK. Rujuk Tb_RoadPeriodicRecord


PayDate: date Tarikh Bayar


51


Amount: decimal Amaun dibayar


52

3.3.5 Maklumat Kerja Kecemasan


Input Parameter

5.a tb_RoadEWork Keterangan: Senarai Kerja Kecemasan







Tb_RoadEWorkJob









Status: string(5) Status. Rujuk Tb_RoadEWorkStatus



5.b tb_RoadEWorkRpt Keterangan: Laporan Kerja Kecemasan




ProjectNo: string(45) No. AK. Rujuk Tb_RoadEWorkRecord





5.c tb_RoadEWorkPaid Keterangan: Pembayaran Kerja Kecemasan




No. Pendaftaran Syarikat. Rujuk Tb_RoadCoRecord

ProjectNo: string(45) No. AK. Rujuk Tb_RoadEWorkRecord





53


3.3.6 Maklumat Aduan


Input Parameter

6.a tb_RoadCmpnt Keterangan: Senarai Aduan




CmpntNo: string(45) No. Aduan

Title: string (45) Tajuk aduan

CmpntBy: string (45) Pengadu

CmpntType: string (5) Jenis Aduan. Rujuk Tb_RoadCmpntType

Detail: string (255) Butir-butir aduan

RoadNo: string (45) No. Jalan

Location: string (45) Lokasi

CmpntDate: date Tarikh Aduan

CloseDate: date Tarikh Tutup

Status: string (5) Status

6.b tb_RoadCmpntRpt Keterangan: Laporan Aduan




CmpntNo: string(45) No. Aduan. Rujuk Tb_RoadCmpntRecord

RptNo: integer No baris/turutan (1,2,3,..)

RptDate: date Tarikh Laporan




54

4.0 Web Service

Web Service memboleh integasi sepenuhnya, dimana sistem CIMMS dan CRMIS boleh berhubung secara otomatik tanpa memerlukan sebarang operator. Dengan menggunakan protokol SOAP, aplikasi CRMIS boleh menghantar data dan juga meng'query' data daripada sistem CIMMS secara terus.

4.1 Pengambungan Ke CIMMS Web Service

Sebelum menggunakan CIMMS Web Service perlu dipastikan bahawa server CRMIS boleh membuat penyambungan ke CIMMS Web Service. Pengujian ini boleh dilaksanakan dengan mengikuti langkah-langkah berikut:-

Buka Internet browser dan buka alamat http://cimms.kkr.gov.my/Collect/WSList.php. Senarai fail CIMMS Web Service akan dipaparkan

Rajah 4a: Senarai Fail CIMMS Web Serivce

Nota: Alamat adalah case-sensitive.

Klik mana-mana hiper-rangkai fail yang disenaraikan. Senarai Fungsi dalam fail akan dipaparkan seperti dalam Skrin berikut:-.

Bab

4


55

Rajah 4b: Senarai Fungsi dalam fail CIMMS Web Serivce

Klik hiper-rangkai "View the WDSL". Skrin berikut akan dipaparkan

Rajah 4c: Fail CIMMS Web Service dalam format XML


56

4.2 Mengintegrasi Sistem CRMIS Kepada Sistem CIMMS

CIMMS Web Service menggunakan XML untuk memformat data dan menggunakan SOAP sebagai protokol dalam penghantaran data. Senibina CIMMS Web Service ini adalah mengikut piawaian yang digunakan oleh kebanyakan bahasa pengaturcaraan. Dalam manual ini, akan ditunjukan kaedah pengintegrasian menggunakan 2 bahasa pengaturcaraan yang popular, iaitu php dan VB.Net

4.2.1 PHP

Untuk menggunakan web servcie dalam php, terlebih dahulu dapatkan library Web Service/SOAP. Antara Open Source Library yang popular hari ini adalah seperti PEAR, NUSOAP, AXIS dll. Contoh berikut adalah menggunakan NUSOAP. Library ini boleh dimuat turun dari alamat http://sourceforge.net/projects/nusoap/ <?php require_once 'nusoap.php'; $sclient = new nusoap_client('http://cimms.kkr.gov.my/Collect/ RList_WS.php?wsdl',true); $proxy = $sclient ->getProxy(); $result = $proxy->GetRoadRecord("a","a","RoadNo='L700'"); echo $result; ?> Keterangan:

$sclient Variable ini menyimpan Instant Soap Client yang telah dicipta untuk membuat penyambungan kepada server CIMMS.

Collect/RList_WS.php Path dan nama fail CIMMS Web Service

getProxy(); Membolehkan capaian terus kepada function dalam fail CIMMS Web Service.

GetRoadRecord Function yang digunakan.

Berikut contoh output yang dihasilkan.


57

Rajah 4d: source Out

4.2.2 VB.Net

Visual Studio.Net 2008/10 menyokong penggunaan web service tanpa memerlukan library atau component lain.

Klik Website> Add Web Reference untuk membuka skrin Web Reference.

Rajah 4e: Add Web Reference


58

Masukkan nama web reference.

Klik butang Add Web Reference. Fail yang ditambah akan dipaparkan pada solution explorer seperti berikut:-

Berikut adalah contoh penggunaan reference tersebut:-.

Dim VCWS As CWS.CIMMSWebService = New CWS.CIMMSWebService Dim StrData = VCWS.GetRoadRecord("a", "a", "RoadNo='L700'") Label1.Text = StrData

Keterangan: VCWS Variable ini menyimpan Instant web service

yang telah dicipta untuk membuat penyambungan kepada server CIMMS.

CIMMSWebService Name Space bagi CIMMS Web Service.

GetRoadRecord Function yang digunakan.

Output yang dihasilkan adalah dalam format xml sama seperti dalam rajah 4d.

4.3 Senarai Fail dan Fungsi dalam CIMMS Web Service

Senarai fail dan fungsi (function) adalah seperti berikut :-.

4.3.1 Collect/RList_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat asas jalan. Antara fungsi-fungsi tersebut adalah:-

Nama Fungsi / Keterangan Input Parameter Output

1.InsertRoadRecord Keterangan: Digunakan untk menambah rekod jalan






Category: string(5) Kelas Jalan. Rujuk GetCodeListRecord(54)






Concession: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetRoadCoRecord

return:string Makna Nilai return:- 0: berjaya 1: gagal

2.UpdateRoadRecord

Key_RoadNo: string(10) No. Jalan (Asal)

return:string


60

Keterangan: Digunakan untuk mengemaskini rekod jalan






Category: string(5) Kelas Jalan. Rujuk GetCodeList(54)






Concession: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetCoRecord

Makna Nilai return:- 0: berjaya 1: gagal

3.DeleteRoadRecord Keterangan: Digunakan untuk mengemaskini rekod jalan



Key_RoadNo: string(10) No. Jalan


4.GetRoadRecord Keterangan: Digunakan untuk meng'query' rekod jalan



Filter: string SQL condition statement

return: string return mengandungi rekod-rekod yang di'query' dalam format xml.

5.InsertRoadSegmentRecord return:string


61

Keterangan: Digunakan untuk Tambah Rekod Segment Jalan





District: string(45) Daerah. Rujuk GetDistrictRecord





SCategory: string(5) Kelas Jalan. Rujuk GetCodeListRecord (54)

SType: string(5) Jenis Jalan. Rujuk GetRoadCoRecord(64)


Zone: string(5) Zon dilalui. Rujuk GetCodeListRecord (66)


6.UpdateRoadSegmentRecord Keterangan: Digunakan untuk Kemaskini Rekod Segment Jalan



Key_RoadNo: string(10) No. Jalan (asal)

Key_SegID: string(10) No. Segment (asal)



District: string(45) Daerah. Rujuk GetDistrictRecord




62




SCategory: string(5) Kelas Jalan. Rujuk GetRoadCoRecord(54)

SType: string(5) Jenis Jalan. Rujuk GetCodeListRecord (64)


Zone: string(5) Zon dilalui. Rujuk GetCodeListRecord (66)

7.DeleteRoadSegmentRecord Keterangan: Digunakan untuk Hapus Rekod Segment Jalan




Key_SegID: string(10) No. Segment (asal)


8.GetRoadSegmentRecord Keterangan: Digunakan untuk meng'query' Rekod Segment Jalan



RoadFilter: string SQL condition statement untuk Senarai Jalan

SegFilter: string SQL condition statement untuk segment


9.InsertRoadInvRecord Keterangan:



return:string Makna Nilai


63

Digunakan untuk Tambah Rekod Inventori Jalan



Code: string(5) Kod Inventori. Rujuk GetCodeListRecord(60).


Qty: string Kuantiti Inventori

return:- 0: berjaya 1: gagal

10.UpdateRoadInvRecord Keterangan: Digunakan untuk Kemaskini Rekod Inventori Jalan



Key_RoadNo: string(10) No. Jalan (asal

Key_Num: integer No (asal)



Code: string (5) Kod Inventori. Rujuk GetCodeListRecord(60).


Qty: string(45) Kuantiti Inventori


11.DeleteRoadInvRecord Keterangan: Digunakan untuk Hapus Rekod Inventori Jalan



Key_RoadNo: string(10) No. Jalan (asal

Key_Num: integer No (asal)


12.GetRoadInvRecord

return: string


64

Keterangan: Digunakan untuk meng'query' Rekod Inventori Jalan




InvFilter: string SQL condition statement untuk inventori

return mengandungi rekod-rekod yang di'query' dalam format xml.

13.InsertRoadHisRecord Keterangan: Digunakan untuk Tambah Rekod Sejarah Jalan







EventType: string (5) Ketegori Sejarah. Rujuk GetCodeListRecord(59)






14.UpdateRoadHisRecord Keterangan: Digunakan untuk Kemaskini Rekod Sejarah Jalan




Key_EventID: integer No (asal)






65


EventType: string (5) Ketegori Sejarah. Rujuk GetCodeListRecord(59)





15.DeleteRoadHisRecord Keterangan: Digunakan untuk Hapus Rekod Sejarah Jalan




Key_EventID: integer No (asal)


16.GetRoadHisRecord Keterangan: Digunakan untuk meng'query' Rekod Sejarah Jalan




HisFilter: string SQL condition statement untuk sejarah



66

4.3.2 Collect/RCompany_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat syarikat konsesi jalan. Antara fungsi-fungsi tersebut adalah:-


17.InsertRoadCoRecord Keterangan: Digunakan untuk Tambah Rekod Syarikat Konsesi Jalan














18.UpdateRoadCoRecord Keterangan: Digunakan untuk Kemaskini Rekod Syarikat Konsesi Jalan



Key_RegNo: string(10) No. Pendaftaran (Asal)







67







19.DeleteRoadCoRecord Keterangan: Digunakan untuk Hapus Rekod Syarikat Konsesi Jalan



Key_RegNo: string(10) No. Pendaftaran (Asal)


20.GetRoadCoRecord Keterangan: Digunakan untuk meng'query' Rekod Syarikat Konsesi Jalan





21.InsertRoadCoAbilityRecord Keterangan: Digunakan untuk Tambah Rekod Keupayaan Syarikat Konsesi Jalan







68


AbilityType: string(10) Kod Keupayaan. Rujuk GetCodeListRecord(55)




22.UpdateRoadCoAbilityRecord Keterangan: Digunakan untuk Kemaskini Rekod Keupayaan Syarikat Konsesi Jalan



Key_Concession: string(10)

No. Pendaftaran (Asal)

Key_Num: integer No (Asal)








23.DeleteRoadCoAbilityRecord Keterangan: Digunakan untuk Hapus Rekod Keupayaan Syarikat Konsesi Jalan








69

24.GetRoadCoAbilityRecord Keterangan: Digunakan untuk meng'query' Rekod Keupayaan Syarikat Konsesi Jalan



CoFilter: string SQL condition statement untuk Senarai Syarikat Konsesi

AbFilter: string SQL condition statement untuk keupayaan


25.InsertRoadCoDocRecord Keterangan: Digunakan untuk Tambah Rekod Dokumen Syarikat Konsesi Jalan




DocType: string(5) Jenis Dokumen. Rujuk GetCodeListRecord(56)

Description:string(100) Keterangan

FileFormat:string(3) Format fail (jpg atau pdf sahaja)

FileContent:string Kandungan fail dalam base64_encode.

return:string Makna Nilai return:- 0: berjaya 1: gagal Nama fail

26.UpdateRoadCoDocRecord Keterangan:





70

Digunakan untuk Kemaskini Rekod Dokumen Syarikat Konsesi Jalan



Key_FileName: string(5)

Nama Fail




27.DeleteRoadCoDocRecord Keterangan: Digunakan untuk Menghapus Rekod Dokumen Syarikat Konsesi Jalan






Nama Fail


28. GetRoadCoDocRecord Keterangan: Digunakan untuk meng'query' Rekod Dokumen Syarikat Konsesi Jalan




DocFilter: string SQL condition statement untuk dokumen


29.InsertRoadCoSubRecord return:string


71

Keterangan: Digunakan untuk tambah Rekod Sub-kontraktor kepada Syarikat Konsesi Jalan















30.UpdateRoadCoSubRecord Keterangan: Digunakan untuk Kemaskini Rekod Sub-kontraktor kepada Syarikat Konsesi Jalan



Key_Concession:

string(10)

No. Pendaftaran Syarikat Konsesi (Asal)

Key_RegNo: string(10)

No. Pendaftaran Syarikat Sub-kontraktor (Asal)







72








31.DeleteRoadCoSubRecord Keterangan: Digunakan untuk Hapus Rekod Sub-kontraktor kepada Syarikat Konsesi Jalan



Key_Concession:

string(10)

No. Pendaftaran Syarikat Konsesi (Asal)

Key_RegNo: string(10)

No. Pendaftaran Syarikat Sub-kontraktor (Asal)


32.GetRoadCoSubRecord Keterangan: Digunakan untuk meng'query' Rekod Sub-kontraktor kepada Syarikat Konsesi Jalan



CoFilter: string SQL condition statement untuk senarai syarikat konsesi

SubFilter: string SQL condition statement untuk sub-kontraktor


33.InsertRoadCoSubAbilityRecord Keterangan:





73

Digunakan untuk Tambah Rekod Keupayaan Sub-Kontraktor



Company: string(10) No. Pendaftaran Sub-Kontraktor. Rujuk GetRoadCoSubRecord







22.UpdateRoadCoSubAbilityRecord Keterangan: Digunakan untuk Kemaskini Rekod Keupayaan Sub-Kontraktor





Key_Company: string(10)

No. Pendaftaran Sub-Kontraktor. Rujuk GetRoadCoSubRecord






74






23.DeleteRoadCoSubAbilityRecord Keterangan: Digunakan untuk Hapus Rekod Keupayaan Sub-Kontraktor









24.GetRoadCoSubAbilityRecord Keterangan: Digunakan untuk meng'query' Rekod Keupayaan Sub-Kontraktor




AbFilter: string SQL condition statement untuk keupayaan


25.InsertRoadCoSubDocRecord return:string


75

Keterangan: Digunakan untuk Tambah Rekod Dokumen Sub-Kontraktor









Makna Nilai return:- 0: berjaya 1: gagal Nama fail

26.UpdateRoadCoSubDocRecord Keterangan: Digunakan untuk Kemaskini Rekod Dokumen Sub-Kontraktor





Key_Company:

string(10)



Nama Fail




76


27.DeleteRoadCoSubDocRecord Keterangan: Digunakan untuk Menghapus Rekod Dokumen Sub-Kontraktor








Nama Fail


28. GetRoadCoSubDocRecord Keterangan: Digunakan untuk meng'query' Rekod Dokumen Sub-Kontraktor




DocFilter: string SQL condition statement untuk dokumen


29. InsertRoadRoutineJobGrpRecord Keterangan: Digunakan untuk tambah rekod



ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk

return:string Makna Nilai return:- 0: berjaya


77

Perjanjian kadar harga per skop kerja penyenggaraan rutin Jalan

GetRoadCoRecord

Zone: string(5) Zon. Rujuk GetCodeListRecord(66)

RateType: string(5) Jenis Kadar GetCodeListRecord(63)

FYear: string(4) Tahun Mula

LYear: string(4) Tahun Tamat


1: gagal

30. UpdateRoadRoutineJobGrpRecord Keterangan: Digunakan untuk kemaskini rekod Perjanjian kadar harga per skop kerja penyenggaraan rutin Jalan



Key_ConID: string(10) No. Pendaftaran Syarikat Konsesi. (Asal)

Key_Zone: string(5) Zon. (Asal)

Key_RateType: string(5)

Jenis Kadar (Asal)

Key_FYear: string(4) Tahun Mula

ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetRoadCoRecord



FYear: string(4) Tahun Mula

LYear: string(4) Tahun Tamat




78

31. DeleteRoadRoutineJobGrpRecord Keterangan: Digunakan untuk menghapus rekod Perjanjian kadar harga per skop kerja penyenggaraan rutin Jalan




Key_Zone: string(5) Zon. (Asal)


Jenis Kadar (Asal)

Key_FYear: string(4) Tahun Mula


32. GetRoadRoutineJobGrpRecord Keterangan: Digunakan untuk meng'query' rekod Perjanjian kadar harga per skop kerja penyenggaraan rutin Jalan




RateGrpFilter: string SQL condition statement untuk perjanjian kadar harga


33.InsertRoadCoRateItemRecord Keterangan: Digunakan untuk tambah rekod kadar harga per skop kerja penyenggaraan rutin Jalan





JobScope: string(5) Skop Kerja. Rujuk GetRoadRoutineJob

RateType: string(5) Jenis Kadar



79

GetCodeListRecord(63)

JobItem: string(5) Item Skop Kerja.


34.UpdateRoadCoRateItemRecord Keterangan: Digunakan untuk kemaskini rekod kadar harga per skop kerja penyenggaraan rutin Jalan



Key_ConID: string(10) No. Pendaftaran Syarikat Konsesi (Asal)

Key_Zone: string(5) Zon (Asal)

Key_JobScope: string(5)

Skop Kerja (Asal)


Jenis Kadar (Asal)

Key_JobItem: string(5) Item Skop Kerja. (Asal)





JobItem: string(5) Item Skop Kerja.



35.DeleteRoadCoRateItemRecord Keterangan:





80

Digunakan untuk Hapus rekod kadar harga per skop kerja penyenggaraan rutin Jalan

Key_ConID: string(10) No. Pendaftaran Syarikat Konsesi (Asal)

Key_Zone: string(5) Zon (Asal)


Skop Kerja (Asal)

Key_RateType: string(5) Jenis Kadar (Asal)

Key_JobItem: string(5) Item Skop Kerja. (Asal)


36.GetRoadCoRateItemRecord Keterangan: Digunakan untuk meng'query' rekod kadar harga per skop kerja penyenggaraan rutin Jalan




RateFilter: string SQL condition statement untuk kadar harga


37.InsertRoadCoRoadRateRecord Keterangan: Digunakan untuk tambah Rekod kadar harga Jalan





RateType: string Jenis Kadar GetCodeListRecord(63)




38.UpdateRoadCoRoadRateRecord return:string


81

Keterangan: Digunakan untuk Kemaskini Rekod kadar harga Jalan





Skop Kerja. (Asal)

Key_RateType: string Jenis Kadar (Asal)

Key_RoadNo: string No. Jalan (Asal)



RateType: string Jenis Kadar GetCodeListRecord(63)




39.DeleteRoadCoRoadRateRecord Keterangan: Digunakan untuk Hapus Rekod kadar harga Jalan





Skop Kerja. (Asal)

Key_RateType: string Jenis Kadar (Asal)

Key_RoadNo: string No. Jalan (Asal)


40.GetRoadCoRoadRateRecord return: string


82

Keterangan: Digunakan untuk meng'query' Rekod kadar harga Jalan




RoadFilter: string SQL condition statement untuk jalan.

return mengandungi rekod-rekod yang di'query' dalam format xml.


83

4.3.3 Collect/RRoutine_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat penyenggaraan rutin jalan. Antara fungsi-fungsi tersebut adalah:-


41.InsertRoadRoutineRecord Keterangan: Digunakan untuk tambah rekod Jadual & Perlaksanaan Penyenggaraan Rutin Jalan



ConID: string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord


GetRoadRoutineJob













42.UpdateRoadRoutineRecord return:string


84

Keterangan: Digunakan untuk kemaskini rekod Jadual & Perlaksanaan Penyenggaraan Rutin Jalan



Key_ConID: string(10) No. Pendaftaran Syarikat (asal)

Key_JobScope: string(5) Skop Kerja (asal)

Key_RYear: string(4) Tahun(asal)


Key_TaskID: string(2) No. Kerja/No Pusingan (asal)















43.DeleteRoadRoutineRecord Keterangan: Digunakan untuk hapus rekod Jadual



Key_ConID: string(10) No. Pendaftaran Syarikat

return:string Makna Nilai return:-


85

& Perlaksanaan Penyenggaraan Rutin Jalan

(asal)

Key_JobScope: string(5) Skop Kerja (asal)



Key_TaskID: string(2) No. Kerja/No Pusingan (asal)

0: berjaya 1: gagal

44.GetRoadRoutineRecord Keterangan: Digunakan untuk meng'query' rekod Jadual & Perlaksanaan Penyenggaraan Rutin Jalan





45. InsertRoadRoutineDocRecord Keterangan: Digunakan untuk Tambah Rekod Dokumen Perlaksanaan Penyenggaraan Rutin Jalan





RYear: string(5) Tahun





FileContent:string Kandungan fail dalam



86

base64_encode.

46. UpdateRoadRoutineDocRecord Keterangan: Digunakan untuk Kemaskini Rekod Dokumen Perlaksanaan Penyenggaraan Rutin Jalan



Key_ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetRoadCoRecord


Skop Kerja. Rujuk GetRoadRoutineJob

Key_RYear: string(5) Tahun

Key_RoadNo: string(45)

No. Jalan

Key_TaskID: string(2) No. Kerja / No Pusingan


Nama Fail



47. DeleteRoadRoutineDocRecord Keterangan: Digunakan untuk hapus Rekod Dokumen Perlaksanaan Penyenggaraan Rutin Jalan



Key_ConID: string(10) No. Pendaftaran Syarikat Konsesi. Rujuk GetRoadCoRecord


Skop Kerja. Rujuk GetRoadRoutineJob

Key_RYear: string(5) Tahun

Key_RoadNo: string(45)

No. Jalan



87

Key_TaskID: string(2) No. Kerja / No Pusingan


Nama Fail

48. GetRoadRoutineDocRecord Keterangan: Digunakan untuk meng'query' rekod Dokumen Perlaksanaan Penyenggaraan Rutin Jalan





49.InsertRoadRoutinePaidRecord Keterangan: Digunakan untuk tambah rekod Pembayaran Penyenggaraan Rutin Jalan













50.UpdateRoadRoutinePaidRecord


return:string


88

Keterangan: Digunakan untuk kemaskini rekod Pembayaran Penyenggaraan Rutin Jalan





Key_JobScope: string(5) Skop Kerja. (asal)

Key_Num: integer No baris/turutan (asal)











51.DeleteRoadRoutinePaidRecord Keterangan: Digunakan untuk hapus rekod Pembayaran Penyenggaraan Rutin Jalan






Key_JobScope: string(5) Skop Kerja. (asal)




89

52.GetRoadRoutinePaidRecord Keterangan: Digunakan untuk meng'query' rekod Pembayaran Penyenggaraan Rutin Jalan






90

4.3.4 Collect/RPeriodic_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat penyenggaraan berkala jalan. Antara fungsi-fungsi tersebut adalah:-


53.InsertRoadPeriodicRecord Keterangan: Digunakan untuk tambah rekod Arahan Kerja



Concession:string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord




GetRoadPeriodicJob










Status: string(5) Status. Rujuk GetRoadPeriodicStatus




91


54.UpdateRoadPeriodicRecord Keterangan: Digunakan untuk kemaskini rekod Arahan Kerja



Key_Concession:string(10) No. Pendaftaran Syarikat.(asal)

Key_ProjectNo: string(45) No. AK (asal)





GetRoadPeriodicJob










Status: string(5) Status. Rujuk GetRoadPeriodicStatus




55.DeleteRoadPeriodicRecord return:string


92

Keterangan: Digunakan untuk hapus rekod Arahan Kerja






56.GetRoadPeriodicRecord Keterangan: Digunakan untuk meng'query' rekod Arahan Kerja





57.InsertRoadPeriodicRptRecord Keterangan: Digunakan untuk tambah rekod Laporan Arahan Kerja




ProjectNo: string(45) No. AK. Rujuk GetRoadPeriodicRecord






58.UpdateRoadPeriodicRptRecord Keterangan:





93

Digunakan untuk kemaskini rekod Laporan Arahan Kerja


Key_ProjectNo: string(45) No. AK. (asal)









59.DeleteRoadPeriodicRptRecord Keterangan: Digunakan untuk hapus rekod Laporan Arahan Kerja







60.GetRoadPeriodicRptRecord Keterangan: Digunakan untuk meng'query' rekod Laporan Arahan Kerja



AKFilter: string SQL condition statement untuk AK.

RptFilter: string SQL condition statement untuk laporan



94

61. InsertRoadPeriodicRptDocRecord Keterangan: Digunakan untuk Tambah Rekod Dokumen Laporan Arahan Kerja





RptNum: integer No baris/turutan (1,2,3,..)

Caption:string(45) Keterangan




62. UpdateRoadPeriodicRptDocRecord Keterangan: Digunakan untuk Kemaskini Rekod Dokumen Laporan Arahan Kerja





Key_ProjectNo: string(45)

No. AK. Rujuk GetRoadPeriodicRecord

Key_RptNum: integer No baris/turutan (1,2,3,..)

Key_ FileName: string(45)

Nama Fail



63. return:string


95

DeleteRoadPeriodicRptDocRecord Keterangan: Digunakan untuk Hapus Rekod Dokumen Laporan Arahan Kerja






No. AK. Rujuk GetRoadPeriodicRecord



Nama Fail


64.GetRoadPeriodicRptDocRecord Keterangan: Digunakan untuk meng'query' rekod Dokumen Laporan Arahan Kerja




DocFilter: string SQL condition statement untuk laporan


65.InsertRoadPeriodicPaidRecord Keterangan: Digunakan untuk tambah rekod Pembayaran Arahan Kerja




No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord







96


66.UpdateRoadPeriodicPaidRecord Keterangan: Digunakan untuk kemaskini rekod Pembayaran Arahan Kerja



Key_Concession:string(10) No. Pendaftaran Syarikat (asal)


Key_Num: integer No baris/turutan(asal)

Concession: string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord







67.DeleteRoadPeriodicPaidRecord Keterangan: Digunakan untuk hapus rekod Pembayaran Arahan Kerja







68.GetRoadPeriodicPaidRecord Keterangan:



return: string return


97

Digunakan untuk meng'query' rekod Pembayaran Arahan Kerja


PaidFilter: string SQL condition statement untuk pembayaran

mengandungi rekod-rekod yang di'query' dalam format xml.


98

4.3.5 Collect/REWork_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat kerja kecemasan jalan. Antara fungsi-fungsi tersebut adalah:-


69.InsertRoadEWorkRecord Keterangan: Digunakan untuk tambah rekod Kerja Kecemasan







GetRoadEWorkJob









Status: string(5) Status. Rujuk GetRoadEWorkStatus





99

70.UpdateRoadEWorkRecord Keterangan: Digunakan untuk kemaskini rekod Kerja Kecemasan









GetRoadEWorkJob









Status: string(5) Status. Rujuk GetRoadEWorkStatus




71.DeleteRoadEWorkRecord Keterangan:





100

Digunakan untuk hapus rekod Kerja Kecemasan




72.GetRoadEWorkRecord Keterangan: Digunakan untuk meng'query' rekod Kerja Kecemasan





73.InsertRoadEWorkRptRecord Keterangan: Digunakan untuk tambah rekod Laporan Kerja Kecemasan




ProjectNo: string(45) No. AK. Rujuk GetRoadEWorkRecord






74.UpdateRoadEWorkRptRecord Keterangan: Digunakan untuk kemaskini rekod Laporan Kerja Kecemasan



Key_Concession:string(10)

No. Pendaftaran Syarikat.(asal)



101


No. AK. (asal)








1: gagal

75.DeleteRoadEWorkRptRecord Keterangan: Digunakan untuk hapus rekod Laporan Kerja Kecemasan







76.GetRoadEWorkRptRecord Keterangan: Digunakan untuk meng'query' rekod Laporan Kerja Kecemasan






77. return:string


102

InsertRoadEWorkRptDocRecord Keterangan: Digunakan untuk Tambah Rekod Dokumen Laporan Kecemasan









Makna Nilai return:- 0: berjaya 1: gagal Nama fail

78. UpdateRoadEWorkRptDocRecord Keterangan: Digunakan untuk Kemaskini Rekod Dokumen Laporan Kecemasan






No. AK. Rujuk GetRoadEWorkRecord



Nama Fail



79. DeleteRoadEWorkRptDocRecord


return:string


103

Keterangan: Digunakan untuk Hapus Rekod Dokumen Laporan Kecemasan





No. AK. Rujuk GetRoadEWorkRecord



Nama Fail


80.GetRoadEWorkRptDocRecord Keterangan: Digunakan untuk meng'query' rekod Dokumen Laporan Kecemasan






81.InsertRoadEWorkPaidRecord Keterangan: Digunakan untuk tambah rekod Pembayaran Kerja Kecemasan




No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord








104

82.UpdateRoadEWorkPaidRecord Keterangan: Digunakan untuk kemaskini rekod Pembayaran Kerja Kecemasan






Concession: string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord







83.DeleteRoadEWorkPaidRecord Keterangan: Digunakan untuk hapus rekod Pembayaran Kerja Kecemasan







84.GetRoadEWorkPaidRecord Keterangan: Digunakan untuk meng'query' rekod



AKFilter: string SQL condition statement

return: string return mengandungi


105

Pembayaran Kerja Kecemasan untuk AK.

PaidFilter: string SQL condition statement untuk pembayaran

rekod-rekod yang di'query' dalam format xml.


106

4.3.6 Collect/RCmpnt_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat aduan jalan. Antara fungsi-fungsi tersebut adalah:-


85.InsertRoadCmpntRecord Keterangan: Digunakan untuk tambah rekod Aduan







CmpntType: string (5) Jenis Aduan. Rujuk GetRoadCmpntType








86.UpdateRoadCmpntRecord Keterangan: Digunakan untuk kemaskini rekod Aduan




Key_ CmpntNo: string(45) No. Aduan (asal)



107





CmpntType: string (5) Jenis Aduan. Rujuk GetRoadCmpntType







87.DeleteRoadCmpntRecord Keterangan: Digunakan untuk hapus rekod Aduan






88.GetRoadCmpntRecord Keterangan: Digunakan untuk meng'query' rekod Aduan






108

89.InsertRoadCmpntRptRecord Keterangan: Digunakan untuk tambah rekod Laporan Aduan




CmpntNo: string(45) No. Aduan. Rujuk GetRoadCmpntRecord






90.UpdateRoadCmpntRptRecord Keterangan: Digunakan untuk kemaskini rekod Laporan Aduan





Key_RptNo: integer No baris/turutan (asal)









109

91.DeleteRoadCmpntRptRecord Keterangan: Digunakan untuk hapus rekod Laporan Aduan




Key_ CmpntNo: string(45) No. Aduan. (asal)

Key_ RptNo: integer No baris/turutan (asal)


92.GetRoadCmpntRptRecord Keterangan: Digunakan untuk meng'query' rekod Laporan Aduan



CmpntFilter: string SQL condition statement untuk Aduan.



93. InsertRoadCmpntRptDocRecord Keterangan: Digunakan untuk Tambah Rekod Dokumen Laporan Aduan








FileContent:string Kandungan fail dalam



110

base64_encode.

94. UpdateRoadCmpntRptDocRecord Keterangan: Digunakan untuk Kemaskini Rekod Dokumen Laporan Aduan





Key_CmpntNo: string(45)

No. Aduan. Rujuk GetRoadCmpntRecord


Key_ PicNo: string(45) Nama Fail



95. DeleteRoadCmpntRptDocRecord Keterangan: Digunakan untuk Hapus Rekod Dokumen Laporan Aduan





Key_CmpntNo: string(45)

No. Aduan. Rujuk GetRoadCmpntRecord


Key_ PicNo: string(45) Nama Fail


96.GetRoadCmpntRptDocRecord Keterangan: Digunakan untuk meng'query' rekod



CmpntFilter: string SQL condition statement



111

Dokumen Laporan Aduan untuk Aduan.




112

4.3.7 Collect/CodeList_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat kod-kod yang digunakan dalam sistem cimms. Antara kod-kod tersebut adalah:-

Jenis Kod Nama Kod

51 Senarai Status Aduan

52 Senarai Jenis Aduan

53 Senarai Butiran Peruntukan

54 Senarai Kelas Jalan

55 Senarai Kategori Keupayaan Syarikat Konsesi

56 Senarai Jenis Dokumen Syarikat Konsesi

57 Senarai Status Kerja Kecemasan

58 Senarai Skop Kerja Kecemasan

59 Senarai Kategori Sejarah Jalan

60 Senarai Kategori Inventori Jalan

61 Senarai Skop Kerja Penyenggaraan Berkala

62 Senarai Status Arahan Kerja

63 Senarai Jenis Kadar Harga Penyenggaraan Rutin

64 Senarai Jenis Jalan

65 Senarai Jenis Laporan (muat-naik)

66 Senarai Zon

67 Senarai Kategori Jalan


113

Antara fungsi-fungsi tersebut adalah:-


97.a InsertCodeListRecord Keterangan: Digunakan untk menambah rekod kod



CodeType: string(2) Jenis Kod. Rujuk jadual diatas.

Code: string(5) Kod Rujukan.

Descrption: string(45) Keterangan/Nama Kod

.


97.b UpdateCodeListRecord Keterangan: Digunakan untk mengemaskini rekod kod




Key_Code: string(5) Kod Rujukan Asal.

Code: string(5) Kod Rujukan.

Descrption: string(45) Keterangan/Nama Kod

.


97.c DeleteCodeListRecord Keterangan: Digunakan untk menghapuskan rekod kod




Key_Code: string(5) Kod Rujukan.


97.d GetCodeListRecord Keterangan:






114

Digunakan untuk meng'query' rekod kod



4.3.8 Collect/RUploadDoc_WS.php

Fail ini mengandungi fungsi-fungsi untuk memproses maklumat laporan/dokumen yang dimuat-naik. Antara fungsi-fungsi tersebut adalah:-


98. InsertRoadUploadDocRecord Keterangan: Digunakan untuk tambah rekod Laporan yang dimuat-naik



ConID:string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord

DocID: integer No. Laporan yang dimuat-naik

DocDate: date Tajuk Laporan yang dimuat-naik

DocType: string (5) Jenis Laporan yang dimuat-naik. Rujuk GetCodeList(65)

Description: string Keterangan/tajuk Laporan

return:string Makna Nilai return:- 0: berjaya 1: gagal [0/1]|Mesej|Nama fail


115

(255) yang dimuat-naik

99.UpdateRoadUploadDocRecord Keterangan: Digunakan untuk kemaskini rekod Laporan yang dimuat-naik



Key_ConID:string(10) No. Pendaftaran Syarikat (Asal)

Key_DocID: integer No. Laporan yang dimuat-naik (asal)



DocDate: date Tajuk Laporan yang dimuat-naik

DocType: string (5) Jenis Laporan yang dimuat-naik. Rujuk GetCodeList(65)

Description: string (255) Keterangan/tajuk Laporan yang dimuat-naik


100.DeleteRoadUploadDocRecord Keterangan: Digunakan untuk hapus rekod Laporan yang dimuat-naik



Key_ConID:string(10) No. Pendaftaran Syarikat (Asal)



116

Key_DocID: integer No. Laporan yang dimuat-naik (asal)

1: gagal

101.GetRoadUploadDocRecord Keterangan: Digunakan untuk meng'query' rekod Laporan yang dimuat-naik





102.InsertRoadUploadDocFileRecord Keterangan: Digunakan untuk tambah rekod fail Laporan yang dimuat-naik





Description: string(255)

Nama/tajuk fail yang dimuat-naik

FileFormat: string (3) jpg atau pdf

FileContent: string Kandungan fail dalam string.

return:string Makna Nilai return:- 0: berjaya 1: gagal [0/1]|Mesej|Nama fail

103.UpdateRoadUploadDocFileRecord Keterangan: Digunakan untuk kemaskini rekod fail Laporan yang dimuat-naik



Key_ConID:string(10) No. Pendaftaran Syarikat. Rujuk



117

GetRoadCoRecord

Key_DocID: integer No. Laporan yang dimuat-naik


Nama fail

Description: string(255) Nama/tajuk fail yang dimuat-naik

1: gagal

104.DeleteRoadUploadDocFileRecord Keterangan: Digunakan untuk hapus rekod fail Laporan yang dimuat-naik



Key_ConID:string(10) No. Pendaftaran Syarikat. Rujuk GetRoadCoRecord

Key_DocID: integer No. Laporan yang dimuat-naik

Key_FileName: string(45) Nama fail


105.GetRoadUploadDocFileRecord Keterangan: Digunakan untuk meng'query' rekod fail Laporan yang dimuat-naik



DocFilter: string SQL condition statement untuk Laporan.

FileFilter: string SQL condition statement untuk fail


manual pengguna sistem cimms - cimms.kkr.gov.mycimms.kkr.gov.my/help/manual_jalan_konsesi.pdf ·...

Documents