Executable Data Import Tool Remedy di UNIX

Kebetulan di project ada kebutuhan untuk custom development Remedy, customer saya memerlukan bulk data upload dari CSV yang harus diproses oleh AR Server secara real-time. Nah sebetulnya Remedy out of the box sudah memiliki data import melalui Pentaho Spoon. Cukup dengan membuat job dan dieksekusi melalui script atau dengan run manual di Pentaho itu sendiri. Nah alternatif lain adalah dengan menggunakan command line di Sistem Operasi lewat executable dataimport. Nah di project ini mengharuskan saya menggunakan executable dataimport agar dapat dieksekusi oleh filter secara otomatis ketika user sudah selesai upload file CSV.

Jika menggunakan Microsoft Windows maka dapat memanfaatkan file dataimport.bat yang berada di “[Folder Installasi ARSystem]\DataImportTools” Sedangkan jika menggunakan Sistem Operasi UNIX maka harus membuat file dataimport.sh secara manual. Lhah kok? Ya dikarenakan direktori DataImportTools tidak ada untuk instalasi ARSystem di UNIX dan saya mengikuti tutorial dari link berikut.

Nah langkah awal adalah :

  • buat sebuah shell script dengan nama dataimport.sh.
  • Yang perlu dipastikan adalah full path dari ARSystem API Library. Kebetulan di tempat saya pathnya “/arapp/remedy/ARSystem/api/lib” Dan pastikan di dalamnya sudah ada arapi[version]_build[xxx].jar, arapiext[version]_build[xxx].jar, dan log4j-[version].jar. Ketiga file ini wajib keberadaannya.
  • Setelah itu, cek JDK JAVA_HOME yang digunakan oleh Remedy. Kebetulan di tempat saya JDK yang digunakan oleh remedy berada di “/arapp/java/jdk1.7.0_50/”
  • Masukan code berikut di dataimport.sh berdasarkan parameter yang telah disesuaikan dengan environment masing-masing.
#!/bin/sh
APIDROP=/arapp/remedy/ARSystem/api/lib
export APIDROP
echo apidrop=$APIDROP
JAVA_HOME=/arapp/java/jdk1.7.0_50/
export JAVA_HOME
echo javahome=$JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH:$APIDROP
export PATH
echo path=$PATH
exec java -cp $APIDROP/arapi81_build001.jar:$APIDROP/log4j-1.2.14.jar:$APIDROP/arapiext81_build001.jar com.bmc.arsys.apiext.data.DataImport ${1+"$@"}
  • Pergi ke direktori di mana ARSystem terinstall, semisal punya saya “/arapp/remedy/ARSystem/” lalu buatlah folder dengan nama contohnya “DataImport” dan simpan dataimport.sh ke dalam folder ini. Set agar dapat dieksekusi oleh user OS. Misal chmod dengan akses 777.
  • Selesai

Yap cukup hanya dengan langkah yang singkat tersebut sudah dapat menggunakan Data Import Remedy di Sistem Operasi UNIX. Untuk mengeksekusi import data semisal kita memiliki file mapping di folder “/arapp/contoh/datamap.armx” dan data source dalam bentuk CSV di folder “/arapp/contoh/data.csv” adalah dengan menjalankan perintah seperti di bawah ini ya :

sh /arapp/remedy/ARSystem/DataImport/dataimport.sh -x "[alamat server]" -u "[username]" -p "[password user]" -a [nomor port] -M "/arapp/contoh/datamap.armx" -o "/arapp/contoh/data.csv"

Ketika eksekusi dataimport.sh biasakan untuk menggunakan full path agar file yang diperlukan dapat teresolve dengan benar. Oke sekian dari saya, semisal masih belum berhasil atau masih bingung silakan komentar yak. Dan saya sendiri sudah mencoba dan berhasil dengan Remedy versi 8.1. Harusnya sih untuk versi 7.6 ke atas sama saja. Untuk detail end-to-end development dari data mentah di file upload hingga diimport ke dalam Remedy dengan menggunakan proses attachment akan saya share di posting berikutnya ya! 😀

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s