Lihat konektor yang didukung untuk Application Integration.

Pemicu Gateway SAP

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

Sebelum memulai

  • Jika Anda berencana membuat atau mengonfigurasi koneksi baru untuk pemicu Gateway SAP, pastikan Anda memiliki peran IAM berikut pada project:
    • Admin Konektor (roles/connectors.admin)

      • Untuk mengetahui informasi tentang cara memberikan peran, lihat Mengelola akses.

  • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk pemicu Gateway SAP:
    • Invoker Integrasi Aplikasi (roles/integrations.integrationInvoker)

      • Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

    • Menambahkan pemicu Gateway SAP

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

    1. Di konsol Google Cloud, buka halaman Application Integration.

      Buka Application Integration

    2. Di menu navigasi, klik Integrations

      Halaman Integrations List akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.

    3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

      Jika Anda membuat integrasi baru:

      1. Masukkan nama dan deskripsi di panel Create Integration.
      2. Pilih region untuk integrasi.
      3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan dari integrasi kapan saja dari panel Integration Summary di toolbar integrasi.
      4. Klik Create.

      Tindakan ini akan membuka integrasi di editor integrasi.

    4. Di menu navigasi editor integrasi, klik Pemicu untuk melihat daftar pemicu yang tersedia.
    5. Klik dan tempatkan elemen Pemicu Gateway SAP di editor integrasi.

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

    Mengonfigurasi pemicu Gateway SAP menggunakan koneksi yang ada

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

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

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

    1. Klik elemen SAP Gateway trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
    2. Klik Konfigurasi pemicu.
    3. Berikan detail konfigurasi berikut di halaman Editor Pemicu Peristiwa Konektor:
      1. Region: Pilih region koneksi Gateway SAP Anda.
      2. Connection: Pilih koneksi Gateway SAP yang ingin Anda gunakan.

        Application Integration hanya menampilkan koneksi Gateway SAP yang aktif dan mengaktifkan langganan peristiwa.

      3. Masukkan nama kolom jenis peristiwa. Kolom ini mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa yang masuk. 
        {
    "event_type": "user.created",
    ...
    // other request fields
    ...
    }
      4. Service Account: Pilih akun layanan dengan peran IAM yang diperlukan untuk pemicu Gateway SAP.
    4. Klik Done untuk menyelesaikan konfigurasi pemicu dan menutup halaman.

    Mengonfigurasi pemicu Gateway SAP menggunakan koneksi baru

    1. Klik elemen SAP Gateway trigger di editor integrasi untuk membuka panel konfigurasi pemicu.
    2. Klik Konfigurasi pemicu.
    3. Lewati kolom Region.
    4. Klik Connection, lalu pilih opsi Create Connection dari menu drop-down.
    5. Di bagian Connection Details, selesaikan langkah-langkah berikut:
      1. Konektor: Pilih Gateway SAP dari menu drop-down Konektor yang tersedia.
      2. Versi konektor: Pilih versi Konektor dari menu 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 huruf kecil.
        • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
        • Nama koneksi tidak boleh lebih dari 63 karakter.
      4. Jika perlu, masukkan Description untuk instance koneksi.
      5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
      6. Agar dapat menggunakan koneksi untuk langganan acara, pilih Aktifkan langganan acara. Memilih ini, menampilkan opsi berikut:
        • Aktifkan langganan acara dengan entitas dan tindakan: Pilih opsi ini untuk menggunakan koneksi untuk operasi konektor dan langganan peristiwa (entity dan tindakan).
        • Aktifkan langganan acara saja: Pilih opsi ini untuk menggunakan koneksi hanya untuk langganan acara. Jika Anda memilih opsi ini, klik Berikutnya, lalu konfigurasi langganan peristiwa.
      7. Namespace: Tentukan namespace layanan yang datanya ingin Anda ambil. Hal ini diperlukan jika layanan tidak ditentukan dalam URL.
      8. Layanan: Tentukan layanan yang datanya ingin Anda ambil. Hal ini diperlukan jika layanan tidak ditentukan dalam 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 ke URL.
      10. Format Data: Format data tempat data diambil. Pilih XML atau JSON.
      11. Gunakan Nama Tampilan: Boolean yang menentukan apakah label SAP akan digunakan atau tidak.
      12. Anda juga dapat mengonfigurasi Setelan node koneksi:

        • Jumlah minimum node: Masukkan jumlah minimum node koneksi.
        • Jumlah maksimum node: Masukkan jumlah maksimum node koneksi.

        Simpul adalah unit (atau replika) koneksi yang memproses transaksi. Diperlukan lebih banyak {i>node<i} untuk memproses lebih banyak transaksi untuk koneksi dan sebaliknya, lebih sedikit node yang diperlukan untuk memproses lebih sedikit transaksi. Untuk memahami pengaruh node terhadap harga konektor Anda, 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. Anda juga dapat mengklik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
      14. Klik NEXT.
    6. Di bagian Destinations, tetapkan URL lingkungan Gateway SAP Anda atau URL lengkap layanan OData. Misalnya format; ${ENVIRONMENT_URL}/sap/opu/odata/${NAMESPACE}/${SERVICE}/ dan contoh URL adalah https://sapes5.sapdevcenter.com/sap/opu/odata/IWBEP/GWSAMPLE_BASIC/. Tambahkan properti tambahan menggunakan properti CustomUrlParams.
      1. Jenis Tujuan: Pilih Jenis Tujuan.
        • Pilih Host address dari daftar untuk menentukan nama host atau alamat IP tujuan.
        • Jika Anda ingin membuat koneksi pribadi ke sistem backend Anda, pilih Endpoint attachment dari daftar, lalu pilih lampiran endpoint yang diperlukan dari daftar Endpoint Lampiran.

        Jika Anda ingin membuat koneksi publik ke sistem {i> backend<i} dengan keamanan tambahan, Anda dapat pertimbangkan untuk mengonfigurasi jaringan keluar statis alamat IP untuk koneksi Anda, lalu konfigurasikan aturan firewall untuk hanya mengizinkan alamat IP statis tertentu ke daftar yang diizinkan.

        Untuk memasukkan tujuan lain, klik +TAMBAHKAN TUJUAN.

      2. Klik NEXT.
    7. Di bagian Authentication, masukkan detail autentikasi.
      1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.

        Jenis autentikasi berikut didukung oleh koneksi Gateway SAP:

        • Nama pengguna dan {i>password<i}
        • Anonim

        2. Untuk memahami cara mengonfigurasi jenis autentikasi ini, lihat Mengonfigurasi autentikasi.

      2. Klik NEXT.
    8. Peninjauan: Tinjau detail koneksi dan autentikasi Anda.
    9. Klik Create.

    Mengonfigurasi autentikasi

    Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

    • Nama pengguna dan sandi
      • Nama pengguna: Nama pengguna untuk konektor
      • Sandi: Rahasia Secret Manager yang berisi sandi yang terkait dengan konektor.
    • Anonim

      Jika Anda ingin menggunakan login anonim, pilih Tidak Tersedia.

      • Kunci API: Kunci API dari pengguna yang saat ini diautentikasi.

    Konfigurasi langganan peristiwa

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

    1. Pilih salah satu jenis autentikasi berikut untuk pemroses peristiwa.
    2. Masukkan nama kolom jenis peristiwa. Kolom ini mengidentifikasi jenis peristiwa yang terkait dengan permintaan peristiwa yang masuk. 
      {
"event_type": "user.created",
...
// other request fields
...
}
    3. Pilih Aktifkan konektivitas pribadi untuk konektivitas yang aman antara aplikasi backend Anda dan koneksi Anda. Jika memilih opsi ini, Anda harus melakukan langkah konfigurasi tambahan setelah membuat koneksi. Untuk mengetahui informasi selengkapnya, lihat Konektivitas pribadi untuk langganan acara.
    4. Masukkan konfigurasi yang dihentikan pengirimannya. Jika Anda mengonfigurasi huruf mati, koneksi akan menulis peristiwa yang belum diproses ke Pub/Sub topic yang ditentukan. Masukkan detail berikut:
      1. ID project yang dihentikan pengirimannya: ID project Google Cloud tempat Anda mengonfigurasi topik Pub/Sub yang dihentikan pengirimannya.
      2. Topik yang dihentikan pengirimannya: Topik Pub/Sub tempat Anda ingin menulis detail peristiwa yang belum diproses.

    Mengonfigurasi autentikasi di SAP

    Konfigurasikan autentikasi di SAP dengan mengikuti petunjuk di panduan Ringkasan autentikasi untuk ABAP SDK lokal atau edisi cloud apa pun untuk Google 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 selanjutnya