Sub kategori Dataset merupakan pengelompokan terhadap respond dari sebuah service atau method yang merupakan format dataset atau data tabel.
Biasanya untuk sub kategori ini, respond yang diterima ditandai dengan tipe data yang mengandung kata result. Sehingga dengan demikian, apabila anda menjumpai sebuah method dari web service kemudian respond yang anda terima itu dikembalikan dengan tipe data mengandung kata result, maka anda harus siap-siap untuk menyimpan data dari respond yang diterima kedalam file xml. Setelah anda selesai membuat file XML, maka langkah selanjutnya yang harus anda lakukan adalah membuat file transformasi dengan extention .xtr
Ketika anda hendak membuat file transformasi, maka anda harus memperhatikan beberapa hal penting yang jangan sampai terlupakan. Hal penting tersebut antara lain adalah seperti disebutkan berikut ini :
- Tipe data field.
- Ukuran dari masing-masing field
- Tag ‘soap: Envelope‘, tag ‘soap: Body‘ dan tag lain-lainnya yang diikuti dengan tanda titik dua
- Data View
Sekarang kita akan bahas satu per satu permasalahan diatas.
| Tipe data field | |
| Ketika data ditransfer dari sisi Server ke cllient dengan menggunakan XML, data-data tersebut dikirim dengan tipe data string. Sehingga semua field yang ada didalam tabel tanpa terkecuali akan di konversi kedalam tipe data string. Oleh karena itulah, para delphier harus berhati-hati akan status ini. Jangan sampai anda tertipe karena ketidaktahuan akan aturan seperti ini. Dengan demikian, setiap kali anda hendak membuat file transformasi, maka ketika anda mengenerate field yang anda pilih, anda selalu perhatikan tipe-tipe datanya. Apabila tipe data dari field yang anda pilih pada tabelnya menunjukk kan tipe data DateTime, maka anda harus ubah tipe datanya dengan DateTimejuga. Secara default, tipe data dari masing-masing field yang anda pilih adalah String atau text dengan ukuran sesuai dengan jumlah karakter dari data yang sampel atau contoh. Untuk lebih jelasnya mengenai ukuran akan dibahas pada bagian Ukuran dari masing-masing field. Jika suatu ketika anda lupa tidak menentukan tipe data dari field yang anda pilih, maka sudah barang tentu program aplikasi yang anda buat akan mengalami permasalahan seperti ketidak-sinkron-nya data yang anda olah dengan data yang ada didalam database. Mengingat kesalahan yang begitu fatal, maka diharapkan bagi anda para Delphier untuk selalu berhati-hati sehingga hal-hal yang tidak diinginkan bisa dihindarkan dan program aplikasi anda akan menjadi stabil. | |
| Ukuran dari masing-masing field | |
| Ukuran field atau size dari sebuah field merupakan faktor yang sangat dominan untuk menentukan keabsahan data yang akan diolah. Kenapa sampai saya katakan faktor dominan karena ketika anda tidak tepat menentukan ukuran atau size dari field bisa menjadi bumerang ketika data yang ditransfer itu tidak sama dengan data yang ditangkap. Sebenarnya data yang dibawa oleh XML dari server sudahlah tepat sesuai dengan data yang dikirim. Kesalahan biasanya terjadi ketika saat proses transformasi disisi aplikasi client atau end user. Ketika kita menggunakan aplikasi atau tools XML Mapper, saat kita mengklik salah satu element pada bagian dokomen XML-nya, maka program tersebut akan mengenerate data tersebut dengan ukuran file sebesar jumlah karakter dari data yang ditangkap. Seandainya data yang ditangkap adalah Eko Indriyawan, maka ukuran dari field tersebut secara default akan sama dengan jumlah dari karakter data tersebut. Sehingga kalau kita hitung jumlah karakter dari data Eko Indriyawan adalah 14. Anggap pada itu merupakan data dari field Nama. Dan kita anggap pula ukuran atau size dari field Nama didalam tabel XXXX tersebut adalah 50. Jika ketika kita mengenerate field tersebut tanpa mencocokkan dengan ukuran dari field yang ada didalam tabel, maka ketika suatu saat nanti method atau service tersebut direquest oleh client dan memberikan respond data dengan hasil Franscisca Aure Liasie akan didapatkan ketidakcocokan data yang dikirim dengan data yang ditampilkan atau diolah. Dari ilustrasi tersebut terlihat dengan jelas bahwa data yang dikirim adalah Francisca Aure Liasie dan yang ditampilkan atau diolah akan menjadi Francisca Aure sedangkan untuk data ‘ Liasie‘ akan hilang. Hal ini terjadi karena mengacu pada data Eko Indriyawan dengan jumlah karakter 14. Jika data yang dikirim kurang dari 14 tidaklah bermasalah, yang akan bermasalah ketika data yang diterima itu melebihi dari jumlah 14 karakter. Karena ini sangat vital sekali, maka jangan sampai anda lalai dalam menentukan ukuran atau size dari field yang anda generate untuk menghasilkan file transformasi. | |
| Tag ‘soap: Envelope‘, tag ‘soap: Bodylain-lainnya yang diikuti dengan tanda titik dua | |
| Pada tools program aplikasi XML Mapper yang sudah disertakan dari team borland atau codegear pada compiler Delphi dan teman-temannya ada beberapa bug yang salah satu diantaranya adalah ketidakmampuannya membaca dengan baik dokumen XML yang dihasilkan dari .NET. Sampai saat ini saya tidak tahu penyebabnya apa dan yang jelas ini merupakan salah satu bug yang harus kita akali agar aplikasi XML Mapper bisa berjalan sebagaimana mestinya. Ada hal yang unik dalam kondisi ini, Saya memerlukan waktu kurang lebih satu tahun hingga bisa punya pemikiran seperti ini. Sebelumnya, agar XML Mapper bisa membaca dengan baik dokumen XML hasil respond dari request ke web service yang dibuat oleh .NET dengan tipe data Dataset, saya selalu mengakali kondisi ini dengan menghapus beberapa tag-tag dan elemen-elemen dari dokumen XML agar bisa digenerate oleh XML Mapper untuk menghasilkan file transformasi. Beberapa bulan yang lalu saya sedikit mendapatkan pencerahan namun tidak bisa berjalan dengan lancar untuk semua kondisi. Pencerahan tersebut datang dari artikel yang saya ambil dari situs www.agnisoft.com tepatnya pada artikel ini. Namun setelah saya coba, ternyata hal ini masih belum berhasil alias gagal. Terlihat sepitas dari contoh screenshot yang diberikan bisa berjalan dengan lancar, tapi waktu saya mencoba untuk mengimplementasikan dengan salah satu web service XXX ternyata tidak bisa berjalan dengan baik atau bisa dikatakan masih gagal. Sejak saat itu, akhirnya proses penelitian akan bug dari XML Mapper ini saya hentikan karena proyek yang saya kerjakan tidak bisa diajak bersahabat alias sudah mendekati waktu deadline. Bulan demi bulan berlalu hingga terus bertanya dalam hati, “Apakah aplikasi desktop tidak bisa mengakses web service yang dicreate atau dibangun dengan .NET. Dan apakah saya harus menggunakan aplikasi .NET untuk mengakses web service kemudian saya gabungkan dengan aplikasi desktop dengan database sebagai media penghubungnya.”. Pertanyaan itu selalu menghantui saya dari hari ke hari tanpa henti. Suatu ketika akhirnya kurang lebih 4 hari yang lalu atau tepatnya tanggal 16 Februari 2008 merupakan hari yang bersejarah karena saya telah mampu menyelesaikan polemik yang ada dipikiran saya tentang aplikasi web service yang dibangun dengan menggunakan .NET. Akhirnya tanpa basa-basipun saya langsung buat contoh program aplikasi desktop Latihan 1 yang mengakses web service dengan dibagi menjadi 5 bagian penting agar para Delphier bisa ikut memahami dengan baik. Mungkin setelah saya buatkan studi kasus dengan petunjuk langkah demi langkah para delphier bisa mempelajari ini dengan cepat, berbeda dengan saya yang harus butuh waktu tahunan agar bisa menemukan konsep ini. Sebernarnya solusi dari permasalahan pada bug aplikasi XML Mapper itu adalah sangat sepele sekali. Dimana XML Mapper tidak mampu mengenerate sebuah file dokumen XML yang didalam tag-nya diikuti tanda titik dua. Untuk meyakinkan konsep atau pernyataan saya ini saya mencoba beberapa web service dengan respond yang berbeda-beda dan ternyata hasilnya menakjubkan. Semua web service bisa saya akses dengan baik. Syukur alhamdulillah, bahwa Allah swt telah memberikan sebuah pencerahan yang menurut saya sungguh sangat luar biasa. Semoga artikel yang saya tulis ini bisa bener-bener bermanfaat buat teman-temen delphier di seluruh indonesia pada khususnya dan diseluruh dunia pada umumnya. Dengan artikel ini pula, diharapkan dapat membuka gerbang baru bahwa program-program aplikasi delphi nantinya bisa semakin marak meramaikan pasar IT di Indonesia. Amin… | |
| Data View | |
| Didalam aplikasi XML Mapper, option Data View berada diatas tab Document Viewdalam kondisi tab aktif. Mungkin ada beberapa dari rekan-rekan Delphier penasaran kenapa option ini perlu mendapatkan perhatian yang lebih. Suatu ketika, bisa jadi dokumen XML yang dibaca oleh XML Mapper tidak bisa menunjukkan field dari tag dataset. Sebagai contoh adalah dokumen XML hasil respond ketika kita request untuk method Login pada web service ICodeCentralWSSoap. Pada umumnya tanpa memberikan status ter-check atau tercentang pada bagian option Data View, XML Mapper mampu membaca dokumen secara baik. Namun pada kondisi lain, kadang XML Mapper ada keterbatasan lagi tidak bisa membaca dengan baik dokumen XML dengan kondisi yang tidak standard. Oleh karena itu, apabila anda suatu ketika menjalankan program aplikasi XML Mapper tidak bisa membaca elemen field yang akan digenerate, maka silahkan anda berikan status option Data View dalam kondisi ter-check. | |
Dari penjelasan diatas untuk sementara waktu dapat kita dapatkan point penting mengenai bug dari tools program aplikasi XML Mapper. Bug tersebut diantaranya adalah :
- Tag yang di-ikuti dengan tanda titik dua
- Dan yang kedua adalah Option Data Viewyang tidak bisa membaca berbagai macam kondisi dari dokumen XML.
