Bimbingan

Teknis SPLP
SISTEM PENGHUBUNG LAYANAN
PEMERINTAH
Desain Arsitektur
Aplikasi SPLP
Core Components:
1. Integration / ESB
Backend & Service Bus dari proses
integrasi layanan pemerintah yang
belum memiliki API.
2. API Management
Pusat pengelolaan API untuk berbagi
pakai layanan dan data pemerintah
(Katalog API).
3. Konsolidasi
Layanan pengakomodir pengguna
dalam melakukan migrasi data antar
aplikasi sejenis ke aplikas umum atau
ke versi lain.
Materi Selanjutnya
ESB - Pembuatan Data Services
a. Generate Data Services
1. Konfigurasi Data Sources
2. Generate Data Services
3. Konfigurasi Resources (select, insert, update, delete)
b. Percobaan Menggunakan Postman
c. Create Data Service
1. Konfigurasi Data Services
2. Konfigurasi Data Sources
3. Konfigurasi Queries (select, insert, update, delete)
4. Konfigurasi Resources (select, insert, update, delete)
d. Percobaan Menggunakan Postman
Log in
Pergi ke halaman https://esb-splpdev.layanan.go.id/ untuk melakukan log in.
Konfigurasi Data Sources
Klik Datasources pada bagian Manage
Klik Add Datasource untuk menambahkan sumber data yang akan digenerate menjadi Data Service
 Contoh:
wilayah_ichwan

Dukungan DB Engine:

Lengkapi form New Data Source mulai dari Datasource Type hingga Password
URL: jdbc:mysql://10.31.3.174:3306/wilayah
Username: splpdemouser | Password: splpdemopassword
Pastikan datasource sesuai dengan cara klik Test Connections, kemudian klik Save
 Generate Data Services

Klik Generate Data Service pada bagian Data Services

Pilih Carbon Datasource(s)
Lengkapi Database Name
Klik Next sehingga tampil halaman Customize
Service Generation

Centang bagian Select Tabel sesuai dengan

kebutuhan
Klik Next sehingg tampil halaman Service
Generation
Pilih Service Generation Mode
Lengkapi Data Service Namespace dan Data
Service Name jika memilih Single Service
Lengkapi Data Service Namespace saja jika
memilih Multiple Services
Klik Next
Single Service: membuat satu data service untuk setiap tabel
yang dipilih, dalam satu data service akan tersedia data selutuh
tabel yang sebelumnya dipilih.
Contoh:
Multiple Services: membuat beberapa data service berdasarkan dswilayah_ichwan
tabel-tabel yang sebelumnya sudah dipilih

Klik Finish sehingga tampil Deployed Services

Tampil halaman Deployed Service, pastikan data service yang terlah dibuat tersedia pada tabel Services.
Halaman ini dapat diakses pada menu Service bagian Manage.
Konfigurasi Resources
1. Resources
2. Endpoint
Klik nama services pada kolom services yang ada di halaman Deployed Services.
Klik Edit Data Service (Wizard)
di bagian Specific Configuration
halaman Services Dashboard
Centang Enable Streaming pada bagian
Advanced Configuration
Centang bagian https (atau juga https) pada
bagian Transport Setting

Pergi ke halaman REST Resource dengan

cara mengklik Next di halaman Edit Data
Service (Wizard) sehingga tampil halaman
Data Sources

Klik Next pada halaman Data Sources

sehingga tampil halaman Queries
Klik Add New Resource sehingga tampil halaman
Add Resouces

Lengkapi Resource Path (eg: getprov)

Lengkapi Description
Pilih GET pada Resource Method
Pilih Query ID (eg: select_all_provinces_query)
Centang Enable Streaming
Klik Save
Tambahkan resources lainnya berdasarkan operasi yang diinginkan seperti
addprov, editprov, delprov sebagai contoh

Disini Resources Method POST digunakan untuk melakukan hapus data

Jika semua resources sudah selesai dikonfigurasi, klik Finish

Pergi kembali ke halaman ini dan klik Edit Resources untuk mengaktifkan
Return Request Status pada resources addprov, editprov, delprov

Jangan lupa klik kembali Save dan Finish agar perubahan tersimpan
Periksa halaman Services Dashboard pada service yang sudah dibuat, dan pastikan Endpoints tersedia.
Catatan:
Hilangkan bagian 'gw' pada endpoint saat akan menggunakan enspoint tersebut
https://esbgw-splpdev.layanan.go.id/services/t/arn.go.id/dswilayah > https://esb-splpdev.layanan.go.id/services/t/arn.go.id/dswilayah
Percobaan Select Data melalui
Postman
Request:
1. Get data
2. Add data
3. Update data
4. Delete data
Pilih New
Pilih HTTP Request
Pilih Method GET
Masukan URL Endpoint + /getprov
Klik Send
Percobaan Insert Data Melalui
Postman
Pilih New
Pilih HTTP Request
Pilih Method POST
Lengkapi URL Endpoint + /addprov
Pilih Body > raw (JSON) untuk parameter
Lengkapi Parameter id dan name

Klik Send

Lakukan kembali Request /getprov untuk

memeriksa data yang telah ditambahkan
Percobaan Update Data melalui
Postman
Pilih New
Pilih HTTP Request
Pilih Method PUT
Lengkapi URL Endpoint + /editprov
Pilih Body > raw (JSON) untuk parameter
Lengkapi Parameter id dan name

Klik Send

Lakukan kembali Request /getprov untuk

memeriksa data yang telah diubah
Percobaan Delete Data melalui
Postman
Pilih New
Pilih HTTP Request
Pilih Method PUT
Lengkapi URL Endpoint + /delprov
Pilih Body > raw (JSON) untuk parameter
Lengkapi Parameter id dan name

Klik Send

Lakukan kembali Request /getprov untuk

memeriksa data yang telah dihapus
Materi Selanjutnya
ESB - Pembuatan Data Services
a. Generate Data Services
1. Konfigurasi Data Sources
2. Generate Data Services
3. Konfigurasi Resources (select, insert, update, delete)
b. Percobaan Menggunakan Postman
c. Create Data Service
1. Create Data Services
2. Konfigurasi Data Sources
3. Konfigurasi Queries (select, insert, update, delete)
4. Konfigurasi Resources (select, insert, update, delete)
d. Percobaan Menggunakan Postman
Create Data Services

klik Create pada bagian Data Services

 Lengkapi Data Service Name & Service Namespace
Centang bagian https (atau bisa juga http) pada bagian
Contoh:
dswilayah2_ichwan
Transport Setting, kemudia klik Next

Kemudian lakukan Tambah / Konfigurasi Datasource

Klik Add New Datasource
Lengkapi Datasource Id hingga Password

Konfigurasi Datasource
URL : jdbc:mysql://10.31.3.174:3306/wilayah
Username : splpdemouser | Password : splpdemopassword
Pastikan datasource sesuai dengan cara klik Test Connections, kemudian klik Save
Klik Finish untuk memeriksa ketersedian Data
Service yang telah dibuat.

Namun bisa juga klik Next untuk melanjutkan

Konfigurasi Queries.

Service yang dibuat dengan metode Create

telah tersedia di halaman Deployed Service,
namun masih harus dikonfigurasi terutama
bagian Query dan Resources.
 Konfigurasi Queries
Untuk dapat mengkonfigurasi
query, pergi terlebih dahulu ke
halaman Queries.

Klik nama services pada kolom

Services halaman Deployed
Services.
Klik Edit Data Service (Wizard)
pada bagian Specific Config.
halaman Service Dashboard
sehingg akan tampil halaman
Edit Data Service.
Pada halaman Edit Data Service klik Next hingga tampil halaman
Datasource yang sebelumnya sudah pernah dilakukan
konfigurasi.

Pada halaman Datasources diatas, klik Next sehingga tampil

halaman Queries. Klik Add New Query untuk mengkonfigurasi
query.
Select Query
Lengkapi Query ID

Pilih Data Source

Isi SQL dengan SQL Syntax select:

SELECT id, name FROM

provinces

Lalu klik Generate Response

Jika semua sudah sesuai klik Save

Insert Query
Lengkapi Query ID

Pilih Data Source

Isi SQL dengan SQL Syntax update:

INSERT INTO provinces(id,name)

VALUES(?,?)

Lalu klik Generate Input Mapping

Ubah Mapping Name param0 & param1

menjadi name & id

Centang Return Update Row Count

Jika semua sudah sesuai klik Save

Update Query
Lengkapi Query ID

Pilih Data Source

Isi SQL dengan SQL Syntax update:

UPDATE provinces SET name=?

WHERE id=?

Lalu klik Generate Input Mapping

Ubah Mapping Name param0 & param1

menjadi name & id

Centang Return Update Row Count

Jika semua sudah sesuai klik Save

Delete Query
Lengkapi Query ID

Pilih Data Source

Isi SQL dengan SQL Syntax delete:

DELETE FROM provinces WHERE id=?

Lalu klik Generate Input Mapping

Ubah Mapping Name param0 menjadi id

Centang Return Update Row Count

Jika semua sudah sesuai klik Save

Konfigurasi
Resources
Pada halaman Queries, klik Next
sehingga tampil halaman Operations

Pada halaman Operations, klik Next

kembali sehingga tampil halaman
Resources.

Klik Add New Resource untuk melakukan

konfigurasi Resources.
Lakukan konfigurasi Resources
seperti pada gambar-gambar
berikut.

Jika konfigurasi Resources telah

selesai klik Finish.
Percobaan Select, Insert, Update,
Delete Data melalui Postman