Di Toko Nusantara, sebelum bisa membuat iFlow pertama, saya butuh "sistem"-nya dulu. Di dunia ABAP, biasanya sistem sudah ada: tim Basis yang menyiapkan, saya tinggal minta user dan role. Di BTP trial, saya harus menyiapkan semuanya sendiri, dari akun sampai hak akses.
Prosesnya tidak sulit, tapi beberapa titik sempat membuat saya bingung: Integration Suite yang tidak muncul di Service Marketplace, tombol Add Capabilities yang tidak muncul, halaman "not authorized" padahal role sudah diberikan, dan tenant yang suatu hari hilang begitu saja. Artikel ini merangkum jalur yang akhirnya berhasil, sekaligus menyiapkan runtime supaya iFlow kita nanti bisa dipanggil dari luar.
Kenapa penting
Semua artikel seri ini berjalan di tenant trial pribadi yang gratis dan bebas dirusak. Kalau tahap ini beres, sisa seri tinggal fokus ke integrasinya.
Konsep: dari global account sampai service instance
Sebelum mengklik apa pun, ada beberapa istilah BTP yang perlu dipahami dulu:
Istilah BTP | Artinya | Padanan kasar di dunia ABAP |
|---|---|---|
Global account | "Wadah" paling luar milik kita | Satu landscape |
Subaccount | Tempat layanan diaktifkan, terikat ke satu region | Satu sistem (misalnya DEV) |
Entitlement | Izin memakai service dan plan tertentu di subaccount | Lisensi komponen |
Subscription | Aplikasi SaaS yang diaktifkan, di sini Integration Suite | Komponen yang terpasang di sistem |
Service instance + service key | Akses teknis ke sebuah service, lengkap dengan client ID dan secret | User komunikasi (tipe System) untuk RFC |
Role collection | Kumpulan role yang diberikan ke user | Composite role di PFCG, di-assign lewat SU01 |
Akun trial otomatis membuat satu global account dan satu subaccount bernama trial. Sisanya kita tambahkan sendiri: entitlement, subscription, environment Cloud Foundry, dan satu service instance.
Kenapa Cloud Foundry ikut terlibat? Integration Suite sendiri adalah subscription dan tidak butuh Cloud Foundry. Tapi untuk memanggil iFlow dari luar (dari Postman, atau nanti dari sistem lain), kita butuh service instance Process Integration Runtime, dan service instance seperti ini dibuat di dalam space Cloud Foundry. Di akun trial saya, Cloud Foundry ternyata belum aktif, jadi perlu diaktifkan dulu.
Langkah
1. Buat akun SAP BTP trial
Daftar di halaman SAP BTP trial dengan SAP Universal ID. Saat diminta, pilih region. Setelah proses selesai, klik Go To Your Trial Account untuk masuk ke BTP cockpit.
Region menentukan lokasi data dan layanan apa saja yang tersedia. Saya memakai Singapore - Azure, yang terdekat dari Indonesia dan menyediakan plan trial Integration Suite.
2. Cek entitlement
Masuk ke subaccount trial, buka Entitlements. Pastikan dua service ini sudah ada:
Service | Plan | Untuk apa |
|---|---|---|
Integration Suite | trial | Subscription aplikasi Integration Suite |
SAP Process Integration Runtime | integration-flow | Service instance untuk memanggil iFlow dari luar |
Kalau belum ada, pilih Edit → Add Service Plans, cari kedua service di atas, centang plan-nya, lalu Save. Tanpa entitlement, service tidak akan muncul di Service Marketplace maupun di dialog Create.
3. Subscribe ke Integration Suite
Buka Services > Instances and Subscriptions dan pilih Create. Di dialog New Instance or Subscription, pilih service Integration Suite dengan plan trial, lalu Create. Tunggu hingga Subscribed.
4. Beri diri sendiri role Integration_Provisioner
Buka Security > Users, pilih user kita, lalu di bagian Role Collections pilih Assign Role Collection dan centang Integration_Provisioner. Role ini hanya untuk mengaktifkan capability. Tanpa Integration_Provisioner, tombol Add Capabilities di langkah 5 tidak muncul.
Setelah itu, log out lalu login lagi (atau buka Integration Suite di jendela private). Role baru tidak terbaca oleh sesi yang sedang berjalan.
5. Aktifkan capability Cloud Integration
Buka aplikasi Integration Suite dari Instances and Subscriptions. Di halaman awalnya, pilih Add Capabilities, centang Build Integration Scenarios (nama capability untuk Cloud Integration atau CPI), lalu Activate. Aktivasinya butuh beberapa menit.
6. Beri role untuk bekerja di Cloud Integration
Setelah capability aktif, kembali ke Security > Users dan assign:
PI_Administrator: mengelola tenant, misalnya security material dan setting.
PI_Integration_Developer: mendesain dan men-deploy iFlow.
PI_Business_Expert: melihat isi pesan saat monitoring.
Role PI_Read_Only yang juga muncul di daftar tidak perlu; ketiga role di atas sudah mencakup hak lihatnya. Di tenant trial, kita memegang semuanya. Seperti di langkah 4, log out dan login lagi sebelum membuka Integration Suite.
7. Aktifkan Cloud Foundry dan buat space
Di halaman Overview subaccount, bagian Cloud Foundry Environment mungkin masih bertuliskan "You are currently not using Cloud Foundry capabilities". Pilih Enable Cloud Foundry, biarkan plan dan nama org sesuai usulan, lalu Create. Setelah org jadi, pilih Create Space dan beri nama dev. User kita otomatis mendapat role Space Manager dan Space Developer.
Kita tidak men-deploy aplikasi ke Cloud Foundry. Space ini hanya menjadi "rumah" untuk service instance di langkah berikutnya.
8. Buat runtime: service instance dan service key
Kembali ke Instances and Subscriptions → Create:
Service: SAP Process Integration Runtime, plan integration-flow
Runtime environment: Cloud Foundry, space dev
Nama instance:
tkn-runtime Di parameter, pilih role ESBMessaging.send dan grant type Client Credentials
Setelah instance jadi, buat service key di instance itu, misalnya tkn-. Isinya clientid, clientsecret, url, dan tokenurl, yang akan dipakai Postman di artikel keenam, Memanggil iFlow dari Postman dengan OAuth. Perlakukan service key seperti password: jangan sampai masuk screenshot atau Git.
9. Buat package demo
Di Integration Suite, menu Design dan Monitor sekarang tersedia. Di Design > Integrations and APIs, pilih Create dan buat package TKN Retail - Online Store Integration (ID TKNRetail). Semua iFlow seri ini disimpan di sini; alasan penamaannya dibahas di artikel kedelapan, Naming Convention supaya iFlow Mudah Dibaca.
Jebakan yang saya temui
Integration Suite tidak muncul di Service Marketplace. Penyebabnya entitlement belum ditambahkan ke subaccount. Cek langkah 2 dulu sebelum mencurigai region atau browser.
Tombol Add Capabilities tidak muncul, atau halaman "not authorized" padahal role PI_* sudah diberikan. Sesi lama masih memakai hak akses sebelum role ditambahkan. Mirip di ABAP: role baru dari PFCG baru terasa setelah user login ulang. Log out, tutup tab, masuk lagi.
Cloud Foundry belum aktif. Tanpa org dan space, service instance runtime tidak punya tempat. Kalau Overview subaccount masih bertuliskan "not using Cloud Foundry capabilities", kerjakan langkah 7 dulu.
Process Integration Runtime tidak ada di dialog Create. Biasanya entitlement plan integration-flow belum ditambahkan, atau capability Cloud Integration belum selesai aktif.
Trial tidak selamanya. Akun trial berlaku 90 hari. Kalau tidak login selama 30 hari, akun bisa di-suspend lalu dihapus. Di SAP Community juga ada laporan subscription Integration Suite di trial hilang lebih cepat dari itu. Anggap tenant trial bisa lenyap kapan saja: simpan hasil export iFlow secara berkala (kita otomatiskan di Backup iFlow ke Git dengan Skrip Kecil, artikel terakhir Series 5).
Ringkasan
Urutannya: entitlement → subscribe Integration Suite → Integration_Provisioner → Add Capabilities → role PI_* → Cloud Foundry + space
dev→ service instance Process Integration Runtime + service key.Integration Suite tidak butuh Cloud Foundry, tapi service instance runtime dibuat di space Cloud Foundry, yang mungkin perlu diaktifkan dulu.
Setiap kali role baru diberikan, log out dan login lagi.
Service key adalah rahasia; tenant trial bersifat sementara, jadi biasakan menyimpan export iFlow.
Berikutnya: sebelum membuat iFlow pertama, kita pahami dulu konsep yang paling penting di CPI: pesan itu seperti amplop, dengan body, header, dan property.