SAP ERP

Konektor SAP ERP memungkinkan Anda melakukan operasi penyisipan, penghapusan, pembaruan, dan pembacaan pada data SAP ERP.

Sebelum memulai

Sebelum menggunakan konektor SAP ERP, lakukan tugas berikut:

  • Di project Google Cloud Anda:
    • Berikan peran IAM roles/connectors.admin kepada pengguna yang mengonfigurasi konektor.
    • Berikan peran IAM berikut ke akun layanan yang ingin Anda gunakan untuk konektor:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
      • roles/storage.objectViewer

      Akun layanan adalah jenis Akun Google khusus yang dimaksudkan untuk mewakili pengguna non-manusia yang perlu melakukan autentikasi dan diberi otorisasi untuk mengakses data di Google API. Jika tidak memiliki akun layanan, Anda harus membuat akun layanan. Untuk mengetahui informasi selengkapnya, lihat Membuat akun layanan.

    • Aktifkan layanan berikut:
      • secretmanager.googleapis.com (Secret Manager API)
      • connectors.googleapis.com (Connectors API)

      Untuk memahami cara mengaktifkan layanan, lihat Mengaktifkan layanan.

    Jika layanan atau izin ini belum diaktifkan untuk project Anda sebelumnya, Anda akan diminta untuk mengaktifkannya saat mengonfigurasi konektor.

Mengonfigurasi konektor

Mengonfigurasi konektor mengharuskan Anda membuat koneksi ke sumber data (sistem backend). Koneksi bersifat khusus untuk sumber data. Artinya, jika memiliki banyak sumber data, Anda harus membuat koneksi terpisah untuk setiap sumber data. Untuk membuat koneksi, lakukan langkah-langkah berikut:

  1. Di Konsol Cloud, buka halaman Integration Connectors > Connections, lalu pilih atau buat project Google Cloud.

    Buka halaman Connections

  2. Klik + Create new untuk membuka halaman Create Connection.
  3. Di bagian Lokasi, pilih lokasi untuk koneksi.
    1. Region: Pilih lokasi dari menu drop-down.

      Untuk mengetahui daftar semua wilayah yang didukung, lihat Lokasi.

    2. Klik Next.
  4. Di bagian Connection Details, selesaikan tindakan berikut:
    1. Konektor: Pilih SAP ERP 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 Connection.

      Nama koneksi harus memenuhi kriteria berikut:

      • Nama koneksi dapat menggunakan huruf, angka, atau tanda hubung.
      • Huruf harus kecil.
      • Nama koneksi harus dimulai dengan huruf dan diakhiri dengan huruf atau angka.
      • Nama koneksi tidak boleh lebih dari 63 karakter.
    4. Secara opsional, masukkan Deskripsi untuk instance koneksi.
    5. Akun Layanan: Pilih akun layanan yang memiliki peran yang diperlukan.
    6. Klien: Klien yang mengautentikasi ke sistem SAP.
    7. ID Sistem: ID Sistem atau R3Name Sistem SAP adalah string dengan maksimal tiga karakter. Alat ini sering digunakan dalam koneksi load balancing.
    8. Nomor Sistem: Nomor yang digunakan untuk menentukan sistem target. Digunakan saat menyetel properti koneksi Host.
    9. Project ID: ID project Google Cloud tempat bucket GCS yang berisi SAP JCo jar berada.
    10. Bucket: Nama bucket yang berisi file sapjco3.jar dan libsapjco3.so.
    11. ID objek Jaco jar: ID Objek jar JCo.
    12. ID objek libsapjco3: ID Objek jar libsapjco3.
    13. Mode tabel: Pilih tabel SAP untuk ditampilkan sebagai tampilan.
    14. ID objek SNC_LIB: ID Objek library SNC.
    15. PSE name: Nama file Personal Security Environment (PSE) yang berlaku untuk bucket. File PSE menyimpan pasangan kunci publik dan pribadi serta sertifikat X.509 dalam struktur ASN.1.
    16. Group: Nama grup untuk login. Ini biasanya ditentukan ketika sistem SAP Anda menggunakan load balancer.
    17. Server pesan: Nama server pesan yang akan digunakan saat terhubung ke sistem SAP yang menggunakan load balancer.
    18. Fungsi baca tabel: Nama fungsi yang akan digunakan untuk membaca tabel. Untuk mengetahui informasi selengkapnya, lihat Menggunakan fungsi baca kustom untuk tabel.
    19. Connection scheme: Pilih skema koneksi yang akan digunakan untuk terhubung ke sistem SAP Anda.
    20. ID Sistem: ID sistem atau R3Name sistem SAP. Anda dapat memasukkan maksimum 3 karakter.
    21. Kode sandi SNC: Pilih rahasia Secret Manager dari kode sandi library SNC.
    22. Secret version: Pilih versi secret.
    23. SNC mode: Pilih opsi ini guna mengaktifkan SNC untuk autentikasi antara Integration Connectors dan sistem SAP.
    24. SNC name: Masukkan nama untuk koneksi SNC.
    25. SNC qop: Pilih tingkat perlindungan. Berikut adalah level yang didukung:
      • 1 - Hanya terapkan autentikasi.
      • 2 - Menerapkan perlindungan integritas. Perlindungan ini juga mencakup perlindungan autentikasi.
      • 3 - Menerapkan perlindungan privasi. Hal ini juga mencakup perlindungan integritas dan autentikasi.
      • 8 - Menerapkan perlindungan default.
      • 9 - Menerapkan perlindungan maksimum.
    26. SNC partner name: Masukkan nama SNC server aplikasi.
    27. Mode kueri: Pilih tabel SAP mana yang akan ditampilkan sebagai tampilan.
    28. Tampilan yang dapat dijelajahi: Masukkan daftar tampilan yang dipisahkan koma yang akan ditampilkan. Contoh, ViewA,ViewB,ViewC.
    29. Tingkat banyaknya pembacaan: Masukkan tingkat panjang untuk logging. Nilai yang didukung adalah dari 1 hingga 5. Nilai yang lebih tinggi berarti detail lebih lanjut akan tersedia di log.
    30. Secara opsional, konfigurasikan Setelan node koneksi:

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

      {i>Node<i} adalah unit (atau replika) koneksi yang memproses transaksi. Lebih banyak node diperlukan untuk memproses lebih banyak transaksi untuk sebuah koneksi dan sebaliknya, lebih sedikit node diperlukan untuk memproses transaksi yang lebih sedikit. Untuk memahami pengaruh node terhadap harga konektor Anda, lihat Harga untuk node koneksi. Jika Anda tidak memasukkan nilai apa pun, secara default node minimum akan ditetapkan ke 2 (untuk ketersediaan yang lebih baik) dan node maksimum ditetapkan ke 50.

    31. Secara opsional, klik + TAMBAHKAN LABEL untuk menambahkan label ke Koneksi dalam bentuk pasangan kunci/nilai.
    32. Klik Next.
  5. Di bagian Destinations, masukkan detail host jarak jauh (sistem backend) yang ingin Anda hubungkan.
    1. Jenis Tujuan: Pilih Jenis Tujuan.
      1. Di kolom Host address, tentukan nama host atau alamat IP tujuan.
        1. Jika ingin membuat koneksi pribadi ke sistem backend, ikuti langkah-langkah berikut:
          1. Buat lampiran layanan PSC.
          2. Buat lampiran endpoint, lalu masukkan detail lampiran endpoint di kolom Alamat host.
        2. Jika ingin membuat koneksi publik ke sistem backend dengan keamanan tambahan, Anda dapat mempertimbangkan untuk 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.
  6. Di bagian Authentication, masukkan detail autentikasi.
    1. Pilih Jenis autentikasi, lalu masukkan detail yang relevan.

      Jenis autentikasi berikut didukung oleh koneksi SAP ERP:

      • Nama pengguna dan sandi

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

    2. Klik Next.
  7. Tinjau: Tinjau detail koneksi dan autentikasi Anda.
  8. Klik Create.

Mengonfigurasi autentikasi

Masukkan detail berdasarkan autentikasi yang ingin Anda gunakan.

  • Nama pengguna dan sandi
    • Nama pengguna: Nama pengguna untuk konektor
    • Password: Secret Manager yang berisi sandi yang terkait dengan konektor.

Menggunakan fungsi baca kustom untuk tabel

RFC_READ_TABLE

Konektor menggunakan fungsi SAP RFC_READ_TABLE untuk mendapatkan data dari tabel SAP.

Namun, cara ini memiliki batasan tertentu. Sebagai contoh, pertimbangkan pengecualian DATA_BUFFER_EXCEEDED. SAP RFC_READ_TABLE memiliki ukuran tetap 512 byte. Fungsi ini dapat melakukan buffer untuk setiap baris data, dan oleh karena itu Anda tidak dapat memilih kolom lebih dari jumlah yang akan sesuai dalam buffer ini. Jika Anda memilih lebih dari 512 byte, akan terjadi pengecualian yang menunjukkan bahwa Anda telah melebihi ukuran buffer maksimum yang diizinkan per baris dan harus memilih lebih sedikit kolom.

RFC_READ_TABLE2

Konektor juga mendukung fungsi pembacaan tabel RFC_READ_TABLE2. Anda dapat mengalihkan fungsi pembacaan tabel yang aktif ke RFC_READ_TABLE2 dengan menetapkan ReadTableFunction ke /SAPDS/RFC_READ_TABLE2.

Fungsi Tabel Baca Kustom

Menginstal RFC Tabel Baca Kustom

Konektor mencakup kode untuk Z_CUSTOM_READ_TABLE, RFC tabel baca kustom yang mirip dengan SAP RFC_READ_TABLE, tetapi dengan buffer yang lebih besar untuk mengatasi masalah DATA_BUFFER_EXCEEDED serta mengabaikan batasan RFC_READ_TABLE lainnya.

Langkah berikut menunjukkan cara menggunakan RFC tabel baca kustom yang disertakan untuk mengabaikan batasan dengan RFC_READ_TABLE default.

  1. Gunakan fungsi RFC_READ_TABLE sebagai template untuk fungsi baru: Pilih kode transaksi SE37 dan Grup Fungsi SDTX, lalu salin RFC_READ_TABLE ke grup fungsi baru atau grup fungsi kerja Anda. Dalam contoh ini, RFC_READ_TABLE disalin ke Z_CUSTOM_READ_TABLE.
  2. Pada tab Attributes di layar SAP, pilih Remote Enabled Module.
  3. Di tab Tables, tetapkan parameter DATA ke CHAR8000 (Anda mungkin perlu mengklik kanan lalu klik Display -> Change)
  4. Pada tab Source Code, tempel contoh kode sumber untuk modul fungsi RFC_READ_TABLE pengganti yang terletak di subfolder db dalam direktori penginstalan. Kode ini berada di Z_CUSTOM_READ_TABLE.txt, meskipun Z_CUSTOM_READ_TABLE_752.txt lebih disukai jika instance SAP ERP Anda menjalankan ABAP versi 7.52 atau yang lebih baru (lihat bagian di bawah). Klik Simpan.
  5. Tentukan impor, tabel, dan pengecualian seperti yang didokumentasikan dalam tabel baca kustom yang disediakan.
  6. Aktifkan modul fungsi dan di string koneksi Anda, setel ReadTableFunction ke Z_CUSTOM_READ_TABLE, atau nama modul fungsi Anda.

Tabel Baca Kustom ABAP 7.52

Bersama dengan Z_CUSTOM_READ_TABLE.txt, ada juga file Z_CUSTOM_READ_TABLE_752.txt, yang dirancang untuk ABAP versi 7.52 dan yang lebih baru. Sebagian besar fungsi ini sama dengan Z_CUSTOM_READ_TABLE, tetapi menggunakan kata kunci yang baru tersedia di ABAP 7.52 untuk melakukan paging dalam database, bukan di skrip ABAP itu sendiri. Ini membuat {i>paging<i} efisien saat bekerja dengan tabel besar.

Sebaiknya gunakan RFC Z_CUSTOM_READ_TABLE_752 jika memungkinkan.

Entitas, operasi, dan tindakan

Semua Integration Connectors menyediakan lapisan abstraksi untuk objek aplikasi yang terhubung. Anda hanya dapat mengakses objek aplikasi melalui abstraksi ini. Abstraksi ditampilkan kepada Anda sebagai entity, operasi, dan tindakan.

  • Entity: Entity dapat dianggap sebagai objek, atau kumpulan properti, dalam aplikasi atau layanan yang terhubung. Definisi entity berbeda dari konektor ke konektor. Misalnya, pada konektor database, tabel adalah entity, pada konektor server file, folder adalah entity, dan di konektor sistem pesan, antrean adalah entity.

    Namun, mungkin saja konektor tidak mendukung atau memiliki entitas, dalam hal ini daftar Entities akan kosong.

  • Operasi: Operasi adalah aktivitas yang dapat Anda lakukan pada entity. Anda dapat melakukan salah satu operasi berikut pada entitas:

    Memilih entity dari daftar yang tersedia akan menghasilkan daftar operasi yang tersedia untuk entity tersebut. Untuk deskripsi operasi secara mendetail, lihat operasi entity tugas Konektor. Namun, jika konektor tidak mendukung salah satu operasi entity, operasi yang tidak didukung tersebut tidak akan dicantumkan dalam daftar Operations.

  • Tindakan: Tindakan adalah fungsi kelas pertama yang tersedia untuk integrasi melalui antarmuka konektor. Tindakan memungkinkan Anda membuat perubahan pada satu atau beberapa entitas, dan bervariasi dari satu konektor ke konektor lainnya. Namun, mungkin saja konektor tidak mendukung tindakan apa pun, dalam hal ini daftar Actions akan kosong.

Keterbatasan sistem

Konektor ERP SAP dapat memproses 7 transaksi per detik, per node, dan membatasi transaksi apa pun di luar batas ini. Secara default, Integration Connectors mengalokasikan 2 node (untuk ketersediaan yang lebih baik) untuk satu koneksi.

Untuk informasi tentang batas yang berlaku untuk Konektor Integrasi, lihat Batas.

Contoh konfigurasi koneksi

Bagian ini mencantumkan nilai contoh untuk berbagai kolom yang akan Anda konfigurasi saat membuat koneksi.

Jenis koneksi ApplicationServer

Tabel berikut mencantumkan contoh nilai konfigurasi untuk jenis koneksi ApplicationServer. Lihat antarmuka pembuatan koneksi di konsol untuk mengetahui kolom wajib dan opsional.

Nama kolom Nilai sampel
Region us-central1
Konektor SAP ERP
Versi Konektor 1
Nama Konektor saperp-applicationserver-conn
Deskripsi NA
Akun Layanan xxxxxxxxx-compute@developer.gserviceaccount.com
Klien 800
Nomor Sistem 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
ID objek Jco Jar sapjco3.jar
ID objek libsapjco3 libsapjco3.so
Mode Tabel TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Baca Fungsi Tabel Z_CUSTOM_READ_TABLE
Skema Koneksi ApplicationServer
ID Sistem SA1
Mode Kueri NA
Tampilan yang Dapat Dijelajahi NA
Tingkat {i>Verbosity<i} 5
Jumlah minimum node 2
Jumlah node maksimum 50
Alamat Host 10.30.X.XX atau String Router dari sistem SAP eksternal.
Authentication Sandi Pengguna
Nama pengguna 12345
Sandi dst@12.345
versions 1

Jenis koneksi GroupServer

Tabel berikut mencantumkan contoh nilai konfigurasi untuk jenis koneksi GroupServer. Lihat antarmuka pembuatan koneksi di konsol untuk mengetahui kolom wajib dan opsional.

Nama kolom Nilai sampel
Region us-central1
Konektor SAP ERP
Versi Konektor 1
Nama Konektor saperp-GroupServer-conn
Deskripsi NA
Akun Layanan xxxxxxxxx-compute@developer.gserviceaccount.com
Klien 800
Nomor Sistem 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
ID objek Jco Jar sapjco3.jar
ID objek libsapjco3 libsapjco3.so
Mode Tabel TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
Grup PUBLIK
Server Pesan 10,30.X.XX
Baca Fungsi Tabel Z_CUSTOM_READ_TABLE
Skema Koneksi GroupServer
ID Sistem SA1
Mode Kueri NA
Tampilan yang Dapat Dijelajahi NA
Tingkat {i>Verbosity<i} 5
Jumlah minimum node 2
Jumlah node maksimum 50
Alamat Host 10.30.X.XX atau String Router dari Sistem SAP Eksternal.
Authentication Sandi Pengguna
Nama pengguna 12345
Sandi dst@12.345
versions 1

Jenis koneksi sertifikat X509

Tabel berikut mencantumkan contoh nilai konfigurasi untuk jenis koneksi X509 certificate. Lihat antarmuka pembuatan koneksi di konsol untuk mengetahui kolom wajib dan opsional.

Nama kolom Nilai sampel
Region us-central1
Konektor SAP ERP
Versi Konektor 1
Nama Konektor saperp-X509Certificate-conn
Deskripsi NA
Akun Layanan xxxxxxxxx-compute@developer.gserviceaccount.com
Klien 800
Nomor Sistem 00
Project ID xxxx-gcp-project
Bucket sap-erp-bucket
ID objek Jco Jar sapjco3.jar
ID objek libsapjco3 libsapjco3.so
Mode Tabel TransparentApplication/TransparentCustomer/TransparentSystem/Pooled/Cluster/None
ID objek SNC_LIB libsapcrypto.so
Nama PSE untuk membuat file cred_v2 EHP8_GCP_SA1.pse
Baca Fungsi Tabel Z_CUSTOM_READ_TABLE
Skema Koneksi ApplicationServer
ID Sistem SA1
Kode sandi SNC xyz@gcp
Mode SNC Boolean yang menentukan apakah Anda menggunakan SNC. Setel ke true untuk menggunakan SNC.
Nama SNC p:CN=EHP8_GCP_SA1, OU=IT, O=CSW, C=DE
Qop SNC 3
NamaPartner SNC p:CN=SA1, OU=I0020070395, OU=SAP Web AS, O=SAP Trust Community, C=DE
Mode Kueri NA
Tampilan yang Dapat Dijelajahi NA
Tingkat {i>Verbosity<i} 5
Jumlah minimum node 2
Jumlah node maksimum 50
Alamat Host 10.30.X.XX atau String Router dari Sistem SAP Eksternal.
Authentication Autentikasi Berbasis Sertifikat X509
X509Certificate Sertifikat X509 dapat ditentukan menggunakan jalur file yang mengarah ke file yang berisi sertifikat X509 dalam format PEM, blob PEM yang dimulai dengan header "-----BEGIN ...", atau blob PEM tanpa header "-----BEGIN ...".
versions 1

Tindakan

Bagian ini mencantumkan tindakan yang didukung oleh konektor. Untuk memahami cara mengonfigurasi tindakan, lihat Contoh tindakan.

Tindakan BAPI_MATERIAL_SAVEDATA

Tindakan ini memungkinkan Anda melakukan tugas tertentu. Misalnya, Anda dapat menggunakannya untuk membuat atau mengubah data master material di SAP ERP.

Parameter input tindakan BAPI_MATERIAL_SAVEDATA

Nama Parameter Jenis Data Diperlukan Deskripsi
DATA {i>headdata<i} String Ya Parameter input HEADDATA.
DATA KLIEN String Ya Parameter input CLIENTDATA.
KLIENDATA String Ya Parameter input CLIENTDATAX.
DESKRIPSI MATERI String Ya Tabel MATERIALDESCRIPTION.

Parameter output dari tindakan BAPI_MATERIAL_SAVEDATA

Tindakan ini akan menampilkan status 200 (OK) jika tindakan tersebut berhasil.

Untuk mengetahui contoh cara mengonfigurasi tindakan BAPI_MATERIAL_SAVEDATA, lihat Contoh tindakan.

Tindakan ZFM_GCP_MULTIDATA_TAB

Tindakan ini memungkinkan pengguna melakukan tugas tertentu. Misalnya, Anda dapat membuat data multitipe data di SAP ERP.

Input parameter tindakan ZFM_GCP_MULTIDATA_TAB

Nama Parameter Jenis Data Diperlukan Deskripsi
ReturnTables String Ya Daftar yang dipisahkan koma yang menentukan tabel mana dalam modul fungsi yang akan menjadi output. Jika tidak ditentukan, semua tabel yang ditampilkan akan berupa output.
T_TABLE String Ya Tabel T_TABLE.
IM_INPUT_1 String Ya Parameter input IM_INPUT_1.
IM_INPUT_2 String Ya Parameter input IM_INPUT_2.

Parameter output tindakan ZFM_GCP_MULTIDATA_TAB

Tindakan ini akan menampilkan status 200 (OK) jika tindakan tersebut berhasil.

Untuk mengetahui contoh cara mengonfigurasi tindakan ZFM_GCP_MULTIDATA_TAB, lihat Contoh tindakan.

Tindakan PushIDoc

Tindakan ini memungkinkan Anda melakukan tugas tertentu. Misalnya, Anda dapat mentransfer data dari SAP ke sistem eksternal.

Parameter input tindakan PushIDoc

Nama Parameter Jenis Data Diperlukan Deskripsi
FileType String Ya Jenis file.Nilai yang diizinkan adalah XML, IDoc.
Mode String Ya Mode transfer.Nilai yang diizinkan adalah Sync, ASync.
Konten String Ya Konten file.

Parameter output tindakan PushIDoc

Tindakan ini akan menampilkan status 200 (OK) jika tindakan tersebut berhasil.

Untuk mengetahui contoh cara mengonfigurasi tindakan PushIDoc, lihat Contoh tindakan.

Tindakan ExecuteCustomQuery

Tindakan ini memungkinkan Anda menjalankan kueri kustom.

Untuk membuat kueri kustom, ikuti langkah-langkah berikut:

  1. Ikuti petunjuk mendetail untuk menambahkan tugas konektor.
  2. Saat Anda mengonfigurasi tugas konektor, pada jenis tindakan yang ingin dilakukan, pilih Tindakan.
  3. Dalam daftar Action, pilih Execute custom query, lalu klik Done.
  4. Luaskan bagian Task input, lalu lakukan tindakan berikut:
    1. Di kolom Timeout after, masukkan jumlah detik untuk menunggu hingga kueri dieksekusi.

      Nilai default: 180 detik.

    2. Di kolom Maximum number of rows, masukkan jumlah maksimum baris yang akan ditampilkan dari database.

      Nilai default: 25.

    3. Untuk memperbarui kueri kustom, klik Edit Kueri Kustom. Dialog Editor skrip akan terbuka.
    4. Dalam dialog Editor skrip, masukkan kueri SQL, lalu klik Simpan.

      Anda dapat menggunakan tanda tanya (?) dalam pernyataan SQL untuk mewakili satu parameter yang harus ditentukan dalam daftar parameter kueri. Misalnya, kueri SQL berikut memilih semua baris dari tabel Employees yang cocok dengan nilai yang ditentukan untuk kolom LastName: 

      SELECT * FROM Employees where LastName=?

    5. Jika telah menggunakan tanda tanya dalam kueri SQL, Anda harus menambahkan parameter dengan mengklik + Tambahkan Nama Parameter untuk setiap tanda tanya. Saat menjalankan integrasi, parameter ini menggantikan tanda tanya (?) dalam kueri SQL secara berurutan. Misalnya, jika Anda telah menambahkan tiga tanda tanya (?), Anda harus menambahkan tiga parameter secara berurutan. Untuk menambahkan parameter kueri, lakukan tindakan berikut:
      1. Dari daftar Jenis, pilih jenis data parameter.
      2. Di kolom Nilai, masukkan nilai parameter.
      3. Untuk menambahkan beberapa parameter, klik + Tambahkan Parameter Kueri.

Setelah berhasil dieksekusi, tindakan ini akan menampilkan status 200 (OK) dengan isi respons yang memiliki hasil kueri.

Contoh tindakan

Contoh - Membuat data

Contoh ini membuat kumpulan data metrial dengan menggunakan tindakan BAPI_MATERIAL_SAVEDATA.

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan BAPI_MATERIAL_SAVEDATA, lalu klik Done.
  3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009001\",\"IND_SECTOR\":\"M\",\"MATL_TYPE\":\"HALB\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA" : "{\"MATL_GROUP\":\"00107\",\"BASE_UOM\":\"KG\"}",
"CLIENTDATAX" : "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
"MATERIALDESCRIPTION" : "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Google\"}"
}

    4. Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas BAPI_MATERIAL_SAVEDATA akan memiliki nilai yang mirip dengan berikut ini:

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9001 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9001",
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Contoh - Memperbarui data

Contoh ini memperbarui kumpulan data metrial dengan menggunakan tindakan BAPI_MATERIAL_SAVEDATA.

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan BAPI_MATERIAL_SAVEDATA, lalu klik Done.
  3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"IND_SECTOR\":\"A\",\"MATL_TYPE\":\"FHMI\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA": "{\"MATL_GROUP\":\"013\",\"BASE_UOM\":\"ST\"}",
"CLIENTDATAX": "{\"MATL_GROUP\":\"X\",\"BASE_UOM\":\"X\"}",
"MATERIALDESCRIPTION": "{\"LANGU\":\"E\",\"MATL_DESC\":\"Classification Googlecloud\"}"
}

    4. Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas BAPI_MATERIAL_SAVEDATA akan memiliki nilai yang mirip dengan yang berikut:

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_MESSAGE": "The material 9000 has been created or extended",
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Contoh - Menghapus data

Contoh ini menghapus data metrial dengan menggunakan tindakan BAPI_MATERIAL_SAVEDATA.

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan BAPI_MATERIAL_SAVEDATA, lalu klik Done.
  3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
"HEADDATA": "{\"MATERIAL\":\"000000000000009000\",\"BASIC_VIEW\":\"X\"}",
"CLIENTDATA": "{\"DEL_FLAG\":\"X\"}",
"CLIENTDATAX": "{\"DEL_FLAG\":\"X\"}"
}

    4. Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas BAPI_MATERIAL_SAVEDATA akan memiliki nilai yang mirip dengan yang berikut:

    [{
"RETURN_TYPE": "S",
"RETURN_ID": "MM",
"RETURN_NUMBER": 356,
"RETURN_LOG_NO": "",
"RETURN_LOG_MSG_NO": 0,
"RETURN_MESSAGE_V1": "9000",
"RETURN_PARAMETER": "",
"RETURN_ROW": 0,
"RETURN_FIELD": "",
"RETURN_SYSTEM": "T90CLNT090",
"RESULT_TABLE": null
}]

Contoh - Membuat data jenis multidata

Contoh ini membuat data jenis multidata menggunakan tindakan ZFM_GCP_MULTIDATA_TAB.

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan ZFM_GCP_MULTIDATA_TAB, lalu klik Done.
  3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
"T_TABLE": "{\"ZACCP\":\"111\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
"IM_INPUT_1": "{\"ZACCP\":\"222\",\"ZCHAR\":\"CHARACTER1\",\"ZCLNT\":\"100\",\"ZCUKY\":\"INR\",\"ZCURR\": 200,\"ZDATS\": \"20231213\",\"ZINT1\": 45,\"ZINT2\":54,\"ZDEC\": 0.12,\"ZFLTP\": 1234,\"ZLANG\":\"E\",\"ZNUMC\":\"110\",\"ZPREC\": 3,\"ZQUAN\": 188.0,\"ZRAW\":\"01010008010101050401\",\"ZTIMS\": \"103056\",\"ZUNIT\":\"11\",\"ZINT4P\": 45,\"ZINT4\": 54,\"ZLRAW\":\"0101000801010105040100030101010300040000\"}",
"IM_INPUT_2": "{\"ZSTRING\": \"HI Google\",\"ZSSTRING\": \"HI Google How are you\"}"
}

    4. Jika tindakan tersebut berhasil, parameter respons connectorOutputPayload tugas ZFM_GCP_MULTIDATA_TAB akan memiliki nilai yang mirip dengan yang berikut:

    [{
"EX_OUTPUT_1_ZACCP": 222,
"EX_OUTPUT_1_ZCHAR": "CHARACTER1",
"EX_OUTPUT_1_ZCLNT": "100",
"EX_OUTPUT_1_ZCUKY": "INR",
"EX_OUTPUT_1_ZCURR": 200,
"EX_OUTPUT_1_ZDATS": "2023-12-13",
"EX_OUTPUT_1_ZRAW": "01010008010101050401",
"EX_OUTPUT_1_ZTIMS": "10:30:56",
"EX_OUTPUT_1_ZUNIT": "11",
"EX_OUTPUT_1_ZINT4P": 45,
"EX_OUTPUT_1_ZINT4": 54,
"EX_OUTPUT_1_ZLRAW": "0101000801010105040100030101010300040000\u0000",
"EX_OUTPUT_2_ZSTRING": null,
"EX_OUTPUT_2_ZSSTRING": null,
"RESULT_TABLE": null,
"T_TABLE_ZACCP": null,
"T_TABLE_ZCHAR": null,
"T_TABLE_ZCLNT": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZRAW": null,
"T_TABLE_ZLANG": null,
"T_TABLE_ZNUMC": null,
"T_TABLE_ZPREC": null,
"T_TABLE_ZQUAN": null,
"T_TABLE_ZRAW": null,
"T_TABLE_ZTIMS": null,
"T_TABLE_ZUNIT": null
},{
"EX_OUTPUT_1_ZACCP": null,
"EX_OUTPUT_1_ZCHAR": null,
"EX_OUTPUT_1_ZCLNT": null,
"EX_OUTPUT_1_ZCUKY": null,
"EX_OUTPUT_1_ZCURR": null,
"EX_OUTPUT_1_ZDATS": null,
"EX_OUTPUT_1_ZDEC": null,
"EX_OUTPUT_1_ZQUAN": null,
"T_TABLE_ZNUMC": 110,
"T_TABLE_ZPREC": 3,
"T_TABLE_ZQUAN": 188,
"T_TABLE_ZRAW": "01010008010101050401",
"T_TABLE_ZTIMS": "10:30:56",
"T_TABLE_ZUNIT": "11"
}]

Contoh - Mengirim IDoc

Contoh ini mendorong IDoc ke SAP ERP.

  1. Dalam dialog Configure connector task, klik Actions.
  2. Pilih tindakan PushIDoc, lalu klik Done.
  3. Di bagian Task Input pada tugas Connectors, klik connectorInputPayload, lalu masukkan nilai yang mirip dengan berikut di kolom Default Value: 
    {
"Content": "\n\n\n EDI_DC40\n 800\n 0000000008604824\n 740\n 53\n 2\n \n MATMAS05\n MATMAS\n ZLS_QA23\n LS\n ZLS_QA23\n SAPSA1\n LS\n SA1CLNT800\n 20230218\n 232556\n\n\n 005\n 000000000000000012\n 20170328\n 42039\n 20170727\n 42039\n KLVC\n FERT\n M\n 02\n BG\n 000\n 002\n 0.000\n 0.000\n KGM\n 0.000\n 0001\n 0.000\n 0.000\n 0.000\n 0.000\n 0.000\n",
"FileType": "XML",
"Mode": "ASync"
}

    4. . Jika tindakan berhasil, parameter respons connectorOutputPayload tugas PushIDoc akan memiliki nilai yang mirip dengan berikut ini:

    [{
"Result": "Success",
"Message": "Push IDoc success"
}]

Contoh operasi entitas

Bagian ini menunjukkan cara melakukan beberapa operasi entity di konektor ini.

Contoh - Menampilkan daftar semua catatan

Contoh ini mencantumkan semua data dalam entity T001.

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih T001 dari daftar Entity.
  3. Pilih operasi List, lalu klik Done.
  4. Secara opsional, di bagian Task Input pada tugas Connectors, Anda dapat memfilter kumpulan hasil dengan menentukan klausa filter. Tentukan nilai klausa filter selalu dalam tanda kutip tunggal (').

Contoh - Mendapatkan kumpulan data dari entity

Contoh ini mendapatkan data dengan ID yang ditentukan dari entity T001.

  1. Dalam dialog Configure connector task, klik Entities.
  2. Pilih T001 dari daftar Entity.
  3. Pilih operasi Get, lalu klik Done.
  4. Di bagian Task Input pada tugas Connectors, klik EntityId lalu masukkan 0001 di kolom Default Value.

    Di sini, 0001 adalah ID data unik dalam entity T001.

Gunakan terraform untuk membuat koneksi

Anda dapat menggunakan resource Terraform untuk membuat koneksi baru.

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform.

Untuk melihat contoh template terraform untuk pembuatan koneksi, lihat contoh template.

Saat membuat koneksi ini menggunakan Terraform, Anda harus menetapkan variabel berikut dalam file konfigurasi Terraform:

Nama parameter Jenis data Diperlukan Deskripsi
klien STRING Benar Klien yang mengotentikasi ke sistem SAP.
grup STRING Salah Grup {i>Logon<i} sedang digunakan. Atribut ini biasanya hanya perlu ditetapkan saat menghubungkan ke sistem SAP yang menggunakan load balancing.
message_server STRING Salah Server pesan harus ditentukan saat terhubung ke sistem SAP yang menggunakan load balancing.
read_table_function STRING Salah Fungsi yang digunakan untuk membaca data tabel.
connection_scheme ENUM Salah Menentukan apakah Anda terhubung ke sistem SAP dengan server pesan (GroupServer) atau tanpa server (ApplicationServer). Nilai yang didukung adalah: ApplicationServer, GroupServer
system_id STRING Salah {i>System ID<i} atau R3Name Sistem SAP adalah {i>string<i} dengan maksimal tiga karakter. Alat ini sering digunakan dalam koneksi load balancing.
system_number STRING Benar Angka yang digunakan untuk menentukan sistem target. Digunakan saat menyetel properti koneksi Host.
project_id STRING Benar ID project Google Cloud tempat bucket Cloud Storage yang berisi jar SAP JCo berada.
ember STRING Benar Nama bucket yang berisi file sapjco3.jar dan libsapjco3.so
sapjco3_jar STRING Benar ID objek untuk sapjco3.jar
libsapjco3_so STRING Benar ID objek untuk libsapjco3.so
snc_lib STRING Salah ID objek untuk library SNC
snc_mode BOOLEAN Salah Boolean yang menentukan apakah Anda menggunakan SNC. Setel ke true untuk menggunakan SNC.
snc_name STRING Salah Input opsional dengan nama koneksi SNC Anda.
snc_qop ENUM Salah Kualitas perlindungan untuk koneksi SNC Anda.Nilai yang valid adalah 1, 2, 3, 8, atau 9, yang sesuai dengan tingkat perlindungan berikut: 1 Hanya terapkan otentikasi. 2 Terapkan perlindungan integritas (autentikasi). 3 Menerapkan perlindungan privasi (integritas dan autentikasi). 8 Terapkan perlindungan default. 9 Menerapkan perlindungan maksimum. Nilai yang didukung adalah: 1, 2, 3, 8, 9
snc_partner_name STRING Salah Nama SNC server aplikasi. Ini adalah input yang diperlukan saat menggunakan SNC.
query_mode ENUM Salah Menentukan tabel SAP mana yang akan ditampilkan sebagai tampilan, jika ada. Nilai yang didukung adalah: Global, Local, All, None
table_mode ENUM Salah Menentukan tabel SAP mana yang akan ditampilkan sebagai tampilan, jika ada. Nilai yang didukung adalah: TransparentApplication, TransparentCustomer, TransparentSystem, Pooled, Cluster, All, None
panjang STRING Salah Tingkat panjang untuk koneksi, bervariasi dari 1-5. Tingkat panjang yang lebih tinggi akan mencatat semua detail komunikasi (sertifikat permintaan,respons & SSL).

Menggunakan koneksi ERP SAP dalam integrasi

Setelah Anda membuat koneksi, koneksi tersebut akan tersedia di Apigee Integration dan Application Integration. Anda dapat menggunakan koneksi dalam integrasi melalui tugas Konektor.

  • Untuk memahami cara membuat dan menggunakan tugas Konektor di Integrasi Apigee, lihat Tugas konektor.
  • Untuk memahami cara membuat dan menggunakan tugas Konektor dalam Application Integration, lihat tugas konektor.

Dapatkan bantuan dari komunitas Google Cloud

Anda dapat memposting pertanyaan dan mendiskusikan konektor ini di komunitas Google Cloud di Cloud Forums.

Langkah selanjutnya