Penggunaan

OJK-BOX (O-Box) Agent

September 2019

Otoritas Jasa Keuangan

OBOX Agent
Persiapan Aplikasi
1. Registrasi Pengguna
Registrasi pengguna OBOX dilakukan melalui mekanisme Surat Resmi yang ditujukan kepada OJK cq. Departemen
Perizinan dan Informasi Perbankan, yang juga menyertakan email pengguna yang akan didaftarkan sebagai User ID
untuk masuk ke dalam aplikasi OBOX.

2. Aktivasi Pengguna
Setelah user didaftarkan, sistem akan menyampaikan email aktivasi yang digunakan untuk mengaktivasi user ID
ybs, serta melakukan download aplikasi OBOX Agent.
OBOX Agent
Persiapan Aplikasi
3. Download Paket Instalasi OBOX Agent Case user telah aktif:
Apabila link aktivasi dibuka, maka akan Apabila anda telah melakukan aktivasi sebelumnya,
menampilkan halaman aktivasi pengguna sebagai klik pada link **) untuk melakukan login aplikasi.
berikut:

Aktivasi pengguna baru *)

Link khusus pengguna lama

yang telah aktif dan memiliki
User ID dan Password **)
Lakukan input username dan password pada
Lakukan input password baru beserta konfirmasi textbox yang tersedia, lalu klik Login.
password baru pada textbox yang tersedia*) lalu
klik Submit, maka akan muncul pesan bahwa User
ID telah diaktifkan dan pengguna diminta untuk
melakukan login kembali.
OBOX Agent
Persiapan Aplikasi
Apabila user telah diaktifkan, masukkan kembali username beserta password pada halaman login, lalu klik Login
untuk melanjutkan, Apabila login berhasil, maka akan tampil halaman untuk mengunduh file paket instalasi OBOX
Agent.

Setelah proses unduh selesai, maka pengguna akan mendapatkan file paket instalasi OBOX Agent sebagai berikut:
OBOX Agent
Persiapan Aplikasi
4. Instalasi OBOX Agent
File paket instalasi berbentuk file terkompresi, lakukan dekompresi terlebih dahulu sebelum melakukan instalasi
aplikasi, gunakan tools kompresi yang anda miliki, yang akan menghasilkan 2 file sebagai berikut:

Jalankan program OboxAgent-*.exe untuk melanjutkan ke tahapan instalasi.

Apabila proses instalasi berhasil, maka akan muncul halaman utama login dari aplikasi OBOX Agent sebagai berikut:
Apabila saat melakukan instalasi terdapat kegagalan install, maka cara pengecekkannya bisa mengikuti langkah sebagai berikut:
OPSI A:
1. Klik kanan pada Drive C lalu pilih menu properties
2. Pilih Tab Security
3. Pastikan user yang digunakkan permissionnya sudah di allow (v) pada kolom Write
OPSI B:
1. Tidak perlu melakukan uninstall ‘OBOX Agent
2. Cek terlebih dahulu apakah ada folder berikut: C:\OboxAgent\app\resources
3. Apabila tidak ada untuk dapat membuat folder secara manual.
OBOX Agent
Konfigurasi dan Pemrosesan Data
1. Login Aplikasi
Apabila login berhasil, akan muncul halaman utama aplikasi
Masukkan user ID, Password, dan direktori sumber yang
sebagai berikut:
akan dibaca oleh aplikasi OBOX Agent, pada menu login
aplikasi OBOX Agent

*) Direktori Sumber adalah direktori tempat meletakkan file

input yang akan dibaca oleh OBOX Agent, alamat direktori ini
dapat diubah pada menu konfigurasi OBOX Agent.
OBOX Agent
Konfigurasi dan Pemrosesan Data
2. Test Koneksi Jaringan
Sebelum melakukan pemrosesan data, terlebih dulu lakukan pengujian koneksi jaringan via aplikasi OBOX Agent,
klik menu konfigurasi yang terdapat di pojok kanan atas aplikasi OBOX Agent.

Lakukan konfigurasi Proxy (apabila diperlukan), dan klik tombol Test Koneksi untuk menguji koneksi jaringan,
pastikan muncul pesan koneksi sukses.

Selain itu, terdapat juga informasi koneksi aplikasi (Tehubung/Tidak Terhubung) yang berada disebelah pojok kiri
bawah aplikasi OBOX Agent
OBOX Agent
Konfigurasi dan Pemrosesan Data
3. Pengaturan Aplikasi
Setelah dipastikan bahwa koneksi berhasil, selanjutnya lakukan penyesuaian konfigurasi sebagai berikut:

Direktori file laporan adalah direktori sumber lokasi file input yang akan
dibaca oleh OBOX Agent

Direktori file proses adalah direktori yang digunakan OBOX Agent

selama pemrosesan file berlangsung

Direktori file raw adalah direktori lokasi file input yang telah sukses
melalui tahapan validasi

Direktori file kirim adalah direktori lokasi file output OBOX Agent,
direktori ini merupakan lokasi yang disebut juga dengan Repository LJK.
Pastikan kapasitas Storage untuk direktori ini mencukupi untuk
menyimpan data output OBOX Agent.
*) dilarang untuk melakukan modifikasi/perubahan pada file/direktori yang terdapat di
dalam direktori ini
OBOX Agent
Konfigurasi dan Pemrosesan Data

Lakukan pengaturan Memori yang akan dioptimalkan oleh OBOX Agent

dalam memproses file input, isi dapat disesuaikan dengan kapasitas
memory Workstation/Server masing-masing LJK.

Pilih jenis koneksi yang digunakan (Internet/Ekstranet).

OBOX Agent
Konfigurasi dan Pemrosesan Data
4. Halaman utama OBOX Agent
Link ke direktori proses

Menu pencarian file di Repository Link ke direktori sumber

LJK
Jumlah antrian file yang akan
diproses
Progress Agent dalam melakukan
scan file di direktori sumber
Menu Pengaturan Konfigurasi Aplikasi
Keterangan waktu proses setiap
tahapan
Progress Agent dalam memproses
file (current)

Status hasil pemrosesan file di

OBOX Agent

Informasi koneksi jaringan

OBOX Agent
Pemrosesan Data dan Konfigurasi
5. Cara Memproses Data
Untuk memproses file baik structured maupun unstructured, pengguna dapat meletakkan file input pada direktori sumber,
kemudian membuat 1 file penanda dengan ketentuan sebagai berikut:
a) File penanda adalah file kosong dengan ekstensi .ready, untuk memberi info kepada OBOX Agent bahwa file input telah siap
untuk diproses.
b) File penanda diberi nama sama dengan nama file yang akan diproses, namun dengan ekstensi .ready
c) File penanda dibuat setelah file input yang akan disampaikan selesai di-copy seluruhnya ke folder sumber.

Berikut contoh file input beserta file penandanya:

OBOX Agent
Pemrosesan Data dan Konfigurasi
Apabila telah terdapat file penanda, maka OBOX Agent akan langsung memproses file input yang bersesuaian, melakukan proses
validasi, kompresi dan enkripsi, serta menampilkan hasil proses pada menu utama OBOX Agent

Status hasil pemrosesan file di OBOX Agent

 OBOX Agent
Pemrosesan Data dan Konfigurasi
Dalam hal terdapat ketidaksesuaian file input, maka OBOX Agent akan
memberikan output hasil validasi berupa file error yang dapat digunakan
untuk melakukan koreksi/perbaikan file input
File Error adalah file dengan ekstensi .valerr (validation
error), untuk membukanya dapat menggunakan text editor
(semacam Notepad++)

Contoh isi File Error

Klik untuk menuju folder
error untuk data input ybs

Dalam hal terdapat beberapa record yang ditolak karena

adanya ketidaksesuaian, maka cara mengkoreksinya adalah
dengan menyampaikan ulang seluruh record termasuk
record yang telah dikoreksi (tidak hanya record yang error
saja)
OBOX Agent
Pemrosesan Data dan Konfigurasi
6. Pencarian Data pada Repository LJK
Untuk melakukan pencarian data yang telah tersimpan pada Repository LJK, pengguna dapat menggunakan menu
Repository

Filter dengan tanggal penyampaian file

Filter dengan nama file

OBOX Agent
Koreksi Data
Koreksi Data Structured dan Unstructured
Untuk melakukan koreksi atas data yang telah diproses, dapat dilakukan dengan memproses ulang data untuk kode
data dan periode yang sama.
Contoh:
Kode Data CR001-A, untuk periode data 20190104 telah disampaikan sebelumnya dengan jumlah record 3, nama
file untuk data ini adalah: 0101.008.CR001-A.20190104.txt
H|0101|008|A|20190104|3
D|ARMAN|REK0012|CIF001|.....dst
D|ARDO|REK0013|CIF002|.....dst
D|KINO|REK0014|CIF003|.....dst

Apabila akan dilakukan koreksi atas data dimaksud (misalkan: terdapat penambahan record, perubahan isi kolom,
dsb), maka file sebelumnya yang telah diproses akan di-replace dengan file baru yang dikirimkan (nama file sama
yaitu: 0101.008.CR001-A.20190104.txt)
H|0101|008|A|20190104|5
D|ARMAN|REK0012|CIF001|.....dst
D|ARDO|REK0013|CIF002|.....dst
D|KINO|REK0014|CIF003|.....dst
D|FANI|REK0017|CIF009|.....dst
D|LULU|REK0018|CIF007|.....dst

Perlakuan koreksi untuk data unstructured(zip) sama seperti koreksi pada data structured (txt)
OBOX Agent
Housekeeping Aplikasi
Pembersihan Hasil Validasi Data Error (Housekeeping direktori file proses)
Untuk membersihkan file data yang gagal validasi, dapat dilakukan dengan langkah berikut:
a) Logout/Close OBOX Agent dan pastikan tidak ada process OBOX Agent yang running
b) Buka direktori file proses (atau direktori sesuai konfigurasi pada aplikasi OBOX Agent)
c) Lakukan penghapusan seluruh direktori/file yang ada di dalam direktori file proses

Bisa dihapus

d) Untuk direktori lainnya (selesai, selesai-raw, sumber), tidak boleh dilakukan house keeping.
TERIMA KASIH