Pemicu SAP Gateway

Pemicu SAP Gateway adalah pemicu Peristiwa Konektor. Konektor SAP Gateway memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data SAP Gateway.

Sebelum memulai

Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu SAP Gateway, pastikan Anda memiliki peran IAM berikut di project:
- Connector Admin (roles/connectors.admin)
Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu SAP Gateway:
- Pemanggil Integrasi Aplikasi (roles/integrations.integrationInvoker)

Tambahkan pemicu SAP Gateway

Untuk menambahkan pemicu SAP Gateway ke integrasi Anda, lakukan langkah-langkah berikut:

Di konsol Google Cloud , buka halaman Application Integration.
Buka Integrasi Aplikasi
Di menu navigasi, klik Integrasi.
Halaman Integrations List akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.
Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
1. Masukkan nama dan deskripsi di panel Buat Integrasi.
2. Pilih region untuk integrasi.
  Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, Klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk mengetahui informasi selengkapnya.
3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
  Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
4. Klik Buat.
Integrasi yang baru dibuat akan terbuka di editor integrasi.
Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
Klik dan tempatkan elemen pemicu SAP Gateway di editor integrasi.

Untuk mengonfigurasi pemicu SAP Gateway, Anda dapat menggunakan koneksi SAP Gateway yang ada dan tersedia di Integration Connectors, atau membuat koneksi SAP Gateway baru menggunakan opsi pembuatan koneksi inline.

Mengonfigurasi pemicu SAP Gateway menggunakan koneksi yang ada

Pemicu SAP Gateway adalah pemicu Peristiwa Konektor, sehingga Anda hanya dapat menggunakan koneksi SAP Gateway dengan langganan peristiwa yang diaktifkan untuk mengonfigurasi pemicu.

Untuk mengetahui informasi tentang cara mengonfigurasi pemicu SAP Gateway menggunakan koneksi SAP Gateway baru, lihat Mengonfigurasi pemicu SAP Gateway menggunakan koneksi baru

Untuk mengonfigurasi pemicu SAP Gateway menggunakan koneksi SAP Gateway yang ada, lakukan langkah-langkah berikut:

Klik elemen pemicu SAP Gateway di editor integrasi untuk membuka panel konfigurasi pemicu.
Klik Konfigurasi pemicu.
Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
1. Region: Pilih region koneksi SAP Gateway Anda.
2. Koneksi: Pilih koneksi SAP Gateway yang ingin Anda gunakan.
  Integrasi Aplikasi hanya menampilkan koneksi SAP Gateway yang aktif dan telah mengaktifkan langganan peristiwa.
3. Masukkan nama kolom jenis peristiwa. Kolom ini mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa masuk.
```
{
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
```
4. Akun Layanan: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu SAP Gateway.
Klik Selesai untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

Mengonfigurasi pemicu SAP Gateway menggunakan koneksi baru

Klik elemen pemicu SAP Gateway di editor integrasi untuk membuka panel konfigurasi pemicu.
Klik Konfigurasi pemicu.
Lewati kolom Region.
Klik Connection dan pilih opsi Create Connection dari menu drop-down.
Di bagian Connection Details, selesaikan langkah-langkah berikut:
1. Konektor: Pilih SAP Gateway dari menu drop-down Konektor yang tersedia.
2. Versi konektor: Pilih versi Konektor dari daftar drop-down versi yang tersedia.
3. Di kolom Connection Name, masukkan nama untuk instance Koneksi.
  Nama koneksi harus memenuhi kriteria berikut:
  - Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
  - Huruf harus berupa huruf kecil.
  - Nama koneksi harus diawali dengan huruf dan diakhiri dengan huruf atau angka.
  - Nama koneksi tidak boleh melebihi 49 karakter.
  - Untuk konektor yang mendukung langganan peristiwa, nama koneksi tidak boleh diawali dengan awalan "goog".
4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
6. Untuk menggunakan koneksi untuk langganan acara, pilih Aktifkan langganan acara. Jika Anda memilih opsi ini, opsi berikut akan ditampilkan:
  - Aktifkan langganan peristiwa dengan entitas dan tindakan: Pilih opsi ini untuk menggunakan koneksi untuk operasi langganan peristiwa dan konektor (entitas dan tindakan).
  - Aktifkan hanya langganan peristiwa: Pilih opsi ini untuk menggunakan koneksi hanya untuk langganan peristiwa. Jika Anda memilih opsi ini, klik Berikutnya, lalu konfigurasi langganan peristiwa.
7. Namespace: Tentukan namespace layanan yang datanya ingin Anda ambil. Parameter ini wajib diisi jika layanan tidak ditentukan di URL.
8. Layanan: Tentukan layanan yang datanya ingin Anda ambil. Parameter ini wajib diisi jika layanan tidak ditentukan di URL.
9. CustomUrlParams: Tentukan parameter string kueri kustom yang disertakan dengan permintaan HTTP. Parameter harus dienkode sebagai string kueri dalam format berikut: field1=value1&field2=value2. Nilai dalam string kueri harus dienkode URL.
10. Format Data: Format data untuk mengambil data. Pilih XML atau JSON.
11. Gunakan Nama Tampilan: Nilai boolean yang menentukan apakah akan menggunakan label SAP atau tidak.
12. Jika perlu, konfigurasikan Setelan node koneksi:
  - Jumlah minimum node: Masukkan jumlah minimum node koneksi.
  - Jumlah node maksimum: Masukkan jumlah maksimum node koneksi.
  Node adalah unit (atau replika) koneksi yang memproses transaksi. Jumlah node yang diperlukan untuk memproses lebih banyak transaksi untuk suatu koneksi akan bertambah dan sebaliknya, jumlah node yang diperlukan untuk memproses lebih sedikit transaksi akan berkurang. Untuk memahami pengaruh node terhadap harga konektor, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.
13. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
14. Klik NEXT.
Di bagian Destinations, tetapkan URL lingkungan SAP Gateway Anda atau URL lengkap layanan OData. Misalnya, format ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ dan contoh URL-nya adalah https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Tambahkan properti tambahan menggunakan properti CustomUrlParams.
1. Jenis Tujuan: Pilih Jenis Tujuan.
  - Untuk menentukan nama host atau alamat IP tujuan, pilih Alamat host dan masukkan alamat di kolom Host 1.
  - Untuk membuat koneksi pribadi, pilih Endpoint attachment dan pilih lampiran yang diperlukan dari daftar Endpoint Attachment.
    Catatan: Untuk memahami cara membuat lampiran endpoint, lihat Lampiran layanan PSC dan lampiran endpoint. Setelah Anda membuat lampiran endpoint, lampiran tersebut akan terlihat dalam daftar Lampiran Endpoint.
  Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan mengonfigurasi alamat IP keluar statis untuk koneksi Anda, lalu mengonfigurasi aturan firewall untuk hanya mengizinkan alamat IP statis tertentu.
  
  Untuk memasukkan tujuan tambahan, klik +TAMBAHKAN TUJUAN.
2. Klik NEXT.
Di bagian Authentication, masukkan detail autentikasi.
1. Pilih Jenis autentikasi dan masukkan detail yang relevan.
  Jenis autentikasi berikut didukung oleh koneksi SAP Gateway:
  - Nama pengguna dan sandi
  - Anonim
  - SAP BTP (OAuth 2.0 - kredensial klien)
2. Klik NEXT.
Tinjau: Tinjau detail koneksi dan autentikasi Anda.
Klik Buat.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

Nama pengguna dan sandi
- Nama pengguna: Nama pengguna untuk konektor
- Sandi: Secret Manager Secret yang berisi sandi yang terkait dengan konektor.

Anonim
Jika Anda ingin menggunakan login anonim, pilih Tidak Tersedia.
- Kunci API: Kunci API pengguna yang saat ini diautentikasi.

SAP BTP (OAuth 2.0 - kredensial klien)
- Client ID: Masukkan client ID yang diperoleh dari halaman klien API.
- Rahasia Klien: Masukkan rahasia klien yang diperoleh dari halaman klien API.
- Versi secret: Masukkan versi secret untuk secret yang dipilih di atas.
- OAuthAccessTokenURL: Masukkan URL token akses OAuth.
- Destination Name: Masukkan nama tujuan SAP BTP.
- URL Tujuan: Masukkan URL tujuan SAP BTP.
- Aktifkan Penggantian Autentikasi: Pilih opsi ini untuk mengaktifkan koneksi agar menerima autentikasi yang berbeda secara dinamis selama runtime.

Mengonfigurasi langganan acara

Jika Anda telah mengaktifkan langganan acara, masukkan nilai berikut di bagian Detail Langganan Acara:

Pilih salah satu jenis autentikasi berikut untuk pemroses peristiwa.
Catatan: Sebelum mengonfigurasi autentikasi, pastikan Anda memiliki endpoint pemroses peristiwa, yang tersedia untuk Anda setelah Anda membuat koneksi. Untuk melihat endpoint, buka halaman Semua koneksi, lalu klik koneksi yang ingin Anda lihat. Endpoint ditampilkan di bagian Detail Koneksi.
- Autentikasi Google. Jika Anda mengaktifkan opsi ini, ikuti langkah-langkah di Mengautentikasi menggunakan Token Web JSON untuk mengonfigurasi autentikasi untuk ABAP SDK. Selain itu, pastikan akun layanan memiliki peran roles/connectors.listener yang token aksesnya digunakan untuk autentikasi.
- Autentikasi Kunci API. Jika memilih opsi ini, Anda harus membuat kunci API, lalu menyimpan kunci tersebut sebagai secret Secret Manager. Untuk informasi selengkapnya, lihat Membuat kunci API.
Masukkan nama kolom jenis peristiwa. Kolom ini mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa masuk.
```
{
"event_type": "user.created",
...
// other request fields
...
}
```
Pilih Aktifkan konektivitas pribadi untuk konektivitas yang aman antara aplikasi backend dan koneksi Anda. Jika memilih opsi ini, Anda harus melakukan langkah-langkah konfigurasi tambahan setelah membuat koneksi. Untuk mengetahui informasi selengkapnya, lihat Konektivitas pribadi untuk langganan peristiwa.
Masukkan konfigurasi pesan yang dihentikan pengirimannya. Jika Anda mengonfigurasi pesan yang dihentikan pengirimannya, koneksi akan menulis peristiwa yang belum diproses ke topik Pub/Sub yang ditentukan. Masukkan detail berikut:
1. Project ID pesan yang tidak terkirim: Project ID Google Cloud tempat Anda mengonfigurasi topik Pub/Sub pesan yang tidak terkirim.
2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang belum diproses.

Mengonfigurasi autentikasi di SAP

Konfigurasi autentikasi di SAP dengan mengikuti petunjuk dalam panduan Ringkasan autentikasi untuk ABAP SDK untuk Google Cloud edisi on-premise atau cloud.

Memvalidasi pemicu

Untuk memvalidasi pemicu, Anda dapat membuat program ABAP. Berikut adalah contoh program ABAP yang dapat Anda gunakan sebagai referensi. Kolom ls_event_payload berubah berdasarkan persyaratan Anda:

*&---------------------------------------------------------------------*
*& Report ZR_TEST_INT_CONNECTOR
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT zr_test_int_connector.
PARAMETERS: p_auth TYPE char1 RADIOBUTTON GROUP rbg1 USER-COMMAND uc DEFAULT 'X',
 p_apik TYPE char1 RADIOBUTTON GROUP rbg1.
DATA:
 lv_p_projects_id TYPE string,
 lv_p_locations_id TYPE string,
 lv_p_connections_id TYPE string,
 ls_input TYPE /goog/cl_connectors_v1=>ty_103.
TYPES: BEGIN OF event_payload,
 event_type TYPE string,
 event_id TYPE string,
 name TYPE string,
 org_id TYPE string,
 END OF event_payload.
DATA: ls_event_payload TYPE event_payload.
ls_event_payload = VALUE #(
 event_type = 'create-entity'
 event_id = '1'
 name = 'demo-org'
 org_id = 'SAP'
 ).
TRY.
 IF p_Auth = abap_true.
 DATA(lv_client_key) = 'IC_DEMO_GOOGLE_AUTH'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway'.
 ELSE.
 lv_client_key = 'IC_DEMO_GOOGLE_APIK'.
 lv_p_connections_id = 'conn-event-triggers-from-sap-gateway-apik'.
 ENDIF.
* Open HTTP Connection
 DATA(lo_client) = NEW /goog/cl_connectors_v1( iv_key_name = CONV #( lv_client_key ) ).
* Populate relevant parameters
 lv_p_projects_id = lo_client->gv_project_id.
 lv_p_locations_id = 'us-central1'.
 GET REFERENCE OF ls_event_payload INTO ls_input-payload .
* Call API method: connectors.projects.locations.connections.listenEvent
 CALL METHOD lo_client->listen_event_connections
 EXPORTING


iv_p_projects_id = lv_p_projects_id
 iv_p_locations_id = lv_p_locations_id
 iv_p_connections_id = lv_p_connections_id
 is_input = ls_input
 IMPORTING
* es_raw =
 es_output = DATA(ls_output)
 ev_ret_code = DATA(lv_ret_code)
 ev_err_text = DATA(lv_err_text)
 es_err_resp = DATA(ls_err_resp).
 IF lo_client->is_success( lv_ret_code ).
 MESSAGE 'Success' TYPE 'S'.
 ELSE.
 MESSAGE lv_err_text TYPE 'E'.
 ENDIF.
* Close HTTP Connection
 lo_client->close( ).
 CATCH /goog/cx_sdk INTO DATA(lo_exception).
 MESSAGE lo_exception->get_text( ) TYPE 'E'.
ENDTRY.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya

Pelajari semua tugas dan pemicu.
Pelajari cara menguji dan memublikasikan integrasi .

Pelajari penanganan error.
Pelajari log eksekusi integrasi.