Skip to Content

BMC Remedy Data Import Tool di UNIX

Posted on by 3 mins read

Klien saya punya kebutuhan untuk custom development pada BMC Remedy untuk bulk upload dari CSV dan diproses oleh AR Server secara real-time. Di BMC Remedy secara out of the box memiliki fitur data import menggunakan Pentaho Spoon. Dengan membuat job dan dieksekusi melalui script atau run manual di Pentaho.

Sebagai alternatif lain adalah dengan menggunakan command line di Sistem Operasi lewat executable dataimport.

Sesuai kebutuhan mengharuskan untuk mengembangkan executable dataimport agar tereksekusi melalui filter event ketika user selesai upload file CSVnya. Jika menggunakan sistem operasi Microsoft Windows maka dapat memanfaatkan file dataimport.bat yang berada di [AR System directory]\DataImportTools.

Sedangkan untuk sistem operasi UNIX harus membuat Shellscript terlebih dahulu. Dikarenakan DataImportTools tidak tersedia di instalasi ARSystem UNIX. Saya mengikuti tutorial dari link berikut. Langkah-langkah yang dibutuhkan sebagai berikut:

  1. Di direktori instalasi AR System buat direktori baru dengan nama DataImport.
  2. Buat sebuah shellscript pada direktori baru tersebut dengan nama semisal dataimport.sh.
  3. Perlu diperhatikan juga hak akses eksekusi shellscriptnya, better diberikan akses “777” hanya untuk testing.
  4. Yang perlu dipastikan adalah full path dari ARSystem API Library. Kebetulan di lokal saya pathnya terdapat pada /arapp/remedy/ARSystem/api/lib.
  5. Pastikan di dalamnya sudah ada pustaka arapi[version]_build[xxx].jar, arapiext[version]_build[xxx].jar, dan log4j-[version].jar. Ketiga file ini wajib diketahui keberadaannya.
  6. Setelah itu cek juga JDK JAVA_HOME yang digunakan oleh BMC Remedy. Di lokal saya, JDK yang digunakan di /arapp/java/jdk1.7.0_50/

Pada Shellscript dataimport.sh, berdasarkan parameter yang telah disesuaikan dengan env variables maka konfigurasi perintah adalah sebagai berikut.

#!/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+"$@"}

Dengan langkah yang singkat di atas maka sudah dapat menggunakan Data Import Remedy di UNIX. Untuk melakukan testing apakah sudah ketika mengeksekusi import data maka dibutuhkan :

  1. File mapping .armx. File mapping untuk sample saya buat pada direktori /arapp/contoh/datamap.armx
  2. Data CSV saya letakkan pada direktori /arapp/contoh/data.csv

Untuk menjalankan test data import adalah dengan menjalankan perintah seperti di bawah ini pada terminal atau console:

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"

Parameter alamat server, username, dan password dapat disesuaikan dengan environment BMC Remedy yang telah terinstall.

Untuk eksekusi dataimport.sh sebaiknya menggunakan full path dibandingkan relative path agar shellscript dapat diresolve dengan pasti. Saya sudah berhasil mencobanya untuk BMC Remedy versi 8.1. Untuk versi 7.6 ke atas kurang lebih sama seharusnya.

Untuk end-to-end pengembangan upload CSV dan diimport otomatis ke dalam Remedy, dapat menggunakan proses attachment yang eventnya dibaca oleh filter. Result dari proses attachment dipassing sebagai argumen di shellscript.

  1. Buat filter yang membaca event pada sebuah form dan field attachment
  2. Result yang berupa file beserta full path pada attachment dimasukkan ke dalam variabel argumen
  3. Buat aksi untuk eksekusi shellscript sebagai berikut, argumen saya lambangkan dengan $namaVariabel$.
sh /arapp/remedy/ARSystem/DataImport/dataimport.sh \
    -x "$AREnvironmentIpAddress$" \
    -u "$ARCurrentUsername$" \
    -p "{ARCurrentCredential}" \
    -a $AREnvironmentPort$ \
    -M "/arapp/contoh/datamap.armx" \
    -o "$ResultFileFullPath$"

Variabel seperti sesi, informasi kredensial, AR IP Address, dan AR Port dapat dibaca pada dokumentasi produk BMC. Semoga bermanfaat, terimakasih.