Menginstal dan mengonfigurasi ABAP SDK untuk Google Cloud edisi cloud atau lokal

Dokumen ini menunjukkan cara menginstal dan mengonfigurasi ABAP SDK untuk Google Cloud edisi lokal atau cloud di sistem host SAP Anda pada instance VM Compute Engine, secara lokal, di penyedia cloud lain, atau di lingkungan lain di luar Google Cloud.

Dokumen ini ditujukan untuk administrator SAP, administrator Google Cloud, serta profesional keamanan SAP dan Google Cloud lainnya.

Ringkasan

ABAP SDK untuk Google Cloud menyediakan library klien bagi developer untuk menggunakan ABAP guna mengakses Google Cloud API secara terprogram. Dengan mengenkapsulasi fungsi penting sebagai komponen yang dapat digunakan kembali, library klien ini mengurangi jumlah kode yang perlu ditulis oleh developer. Untuk mengetahui daftar lengkap library klien yang disediakan ABAP SDK untuk Google Cloud, lihat Library klien ABAP SDK untuk Google Cloud.

Sebagai developer ABAP, Anda dapat mem-build dan men-deploy solusi berbasis ML dan AI menggunakan berbagai layanan Google Cloud seperti Vertex AI, Document AI Warehouse, BigQuery, Dataproc, Pub/Sub, Google Workspace API, dan Google Maps Platform.

Mulai versi 1.8, ABAP SDK untuk Google Cloud edisi cloud atau on-premise menawarkan alat khusus, Vertex AI SDK untuk ABAP, untuk interaksi yang lancar dengan platform Vertex AI Google Cloud. Untuk mengetahui informasi tentang Vertex AI SDK untuk ABAP, lihat Ringkasan Vertex AI SDK untuk ABAP.

Untuk komunikasi antara SAP dan Google Cloud API, ABAP SDK untuk Google Cloud menggunakan protokol HTTPS dengan SSL.

Sebelum memulai

Sebelum menginstal ABAP SDK untuk Google Cloud, lakukan hal berikut:

  1. Jika Anda baru menggunakan Google Cloud, buat akun di https://cloud.google.com.

  2. Jika Anda belum memiliki project Google Cloud, buat project:

    Buka pemilih project

  3. Pastikan penagihan diaktifkan untuk project Anda. Untuk informasi selengkapnya, lihat Memverifikasi status penagihan project.

  4. Pastikan versi software SAP yang Anda gunakan didukung oleh ABAP SDK untuk Google Cloud. Untuk informasi selengkapnya, lihat Persyaratan versi software SAP.

Persyaratan versi software SAP

ABAP SDK untuk Google Cloud menggunakan Add-On Antarmuka Pengguna (UI) SAP untuk membuat serialisasi data ABAP ke dalam format JSON. Pastikan koreksi terbaru diterapkan untuk class /UI2/CL_JSON.

Tabel berikut menjelaskan versi minimum komponen yang diperlukan untuk menginstal SDK:

SAP SAP Netweaver Add-On UI SAP
SAP ERP 6.0 (ECC) SAP_BASIS 702 atau yang lebih baru

/UI2/CL_JSON: PL12 atau yang lebih baru.

Untuk mengetahui informasi selengkapnya, lihat Catatan SAP 22798102 - /UI2/CL_JSON corrections - PL12

Add-On UI SAP harus kompatibel dengan versi SAP Netweaver Anda. Untuk mengetahui informasi tentang kompatibilitas Add-On UI SAP, lihat:
S/4HANA 1909 atau yang lebih baru SAP_BASIS 752 atau yang lebih baru

Membuat koneksi jaringan ke Google Cloud

Jika workload SAP Anda tidak dijalankan di Google Cloud, Anda atau administrator jaringan harus membuat koneksi yang aman, memiliki bandwidth tinggi, dan berlatensi rendah ke Google Cloud.

Anda dapat mengakses Google Cloud API melalui internet publik. Untuk mengetahui informasi selengkapnya, lihat Tentang Cloud API. Jika server SAP Anda tidak memiliki akses internet publik, hubungkan server tersebut ke Google Cloud menggunakan salah satu metode berikut:

Untuk mengonfigurasi koneksi, ikuti petunjuk yang diberikan oleh produk konektivitas jaringan Google Cloud yang sesuai. Setiap produk memiliki serangkaian petunjuk yang berbeda untuk berbagai skenario, jadi tinjau dokumentasinya dan ikuti petunjuk sesuai skenario Anda.

Jika workload SAP Anda dijalankan di Google Cloud, ABAP SDK untuk Google Cloud akan menggunakan jaringan VPC yang mendasarinya.

Menginstal ABAP SDK untuk Google Cloud

ABAP SDK untuk Google Cloud disediakan dalam bentuk file transport yang Anda instal ke SAP NetWeaver.

Jika Anda mengalami masalah saat mengimpor file transpor ABAP SDK untuk Google Cloud ke lingkungan SAP, seperti masalah terkait peninjauan transpor oleh SAP atau pengelolaan antrean impor, hubungi Layanan Pelanggan Cloud untuk mendapatkan bantuan. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan dukungan untuk SAP di Google Cloud.

Jika Anda sudah menginstal ABAP SDK untuk Google Cloud dan perlu mengupdate ke SDK versi terbaru, lihat Mengupdate ABAP SDK untuk Google Cloud.

  1. Download paket penginstalan yang berisi file transport dari portal download.

  2. Salin file transport ABAP SDK untuk Google Cloud ke direktori impor transport SAP Server.

    ABAP SDK untuk Google Cloud menyediakan dua kumpulan file transpor:

    • Untuk membuat koneksi dengan Google Cloud API yang didukung dan mengautentikasi dengan token atau kunci API, salin file transpor berikut ke direktori impor transpor Server SAP:

      • /usr/sap/trans/cofiles/K900319.GM1
      • /usr/sap/trans/data/R900319.GM1

    • Untuk mengautentikasi dengan kredensial klien OAuth 2.0, salin file transport berikut ke direktori impor transport Server SAP:

      • /usr/sap/trans/cofiles/K900321.GM1

      • /usr/sap/trans/data/R900321.GM1

        File transpor ini tidak memberikan fungsi tambahan, selain autentikasi berbasis kredensial klien OAuth 2.0. Untuk autentikasi berbasis kredensial klien OAuth 2.0, pertama-tama impor file transpor untuk Google Cloud API yang didukung, lalu impor file transpor untuk kredensial klien OAuth 2.0.

        Untuk menggunakan kredensial klien OAuth 2.0, sistem SAP Anda harus mendukung OAuth 2.0. Untuk informasi tentang sistem SAP yang mendukung OAuth 2.0, lihat Catatan SAP 3041322 - Klien OAuth 2.0: Downport Kredensial Klien jenis pemberian.

  3. Di SAP GUI, gunakan kode transaksi STMS_IMPORT atau STMS untuk mengimpor file ke sistem SAP.

  4. Pastikan semua objek dalam paket /GOOG/ABAP_SDK aktif dan konsisten:

    1. Di SAP GUI, masukkan kode transaksi SE80.
    2. Di pemilih paket, pilih /GOOG/ABAP_SDK.
    3. Di kolom Object Name, klik kanan pada paket /GOOG/ABAP_SDK, lalu pilih Check > Package Check > Package Objects (Including Subpackages).

    4. Klik ikon Beralih ke Tampilan Daftar.

      Tampilan daftar

      Tanda centang hijau di kolom Result of Package Check menunjukkan bahwa semua objek lulus pemeriksaan paket.

Mengonfigurasi setelan keamanan SAP

Ikuti langkah-langkah berikut untuk menghubungkan ABAP SDK untuk Google Cloud ke Google Cloud API dengan aman.

Menyiapkan sertifikat SSL

Download dan impor sertifikat Google yang diperlukan ke STRUST.

  1. Download sertifikat berikut dari repositori Layanan Kepercayaan Google:

    • GTS Root R1
    • GTS CA 1C3

    PEM dan DER adalah format sertifikat yang umum digunakan. Anda dapat mendownload sertifikat dalam format yang kompatibel dengan sistem SAP Anda. Jika format yang diperlukan tidak tersedia, lihat Catatan SAP 2755238 - Cara mengonversi sertifikat ke format yang sesuai dengan OpenSSL untuk mengonversi sertifikat ke format yang diperlukan.

  2. Di SAP GUI, masukkan kode transaksi STRUST.

  3. Beralih ke mode ubah.

  4. Klik dua kali di SSL client SSL Client (Standard).

  5. Klik Certificate  > Import, lalu impor sertifikat yang Anda download dari repositori Layanan Kepercayaan Google.

  6. Klik tombol dengan centang hijau.

  7. Klik Edit  > Tambahkan ke daftar sertifikat. Pastikan informasi sertifikat terlihat di area Certificate di panel kanan bawah.

  8. Simpan entri.

Untuk informasi selengkapnya dari SAP tentang cara mengimpor sertifikat ke STRUST, lihat Catatan SAP 3238733 - Cara mengimpor Sertifikat ke Daftar Sertifikat STRUST PSE di NetWeaver AS ABAP.

Memvalidasi port HTTP dan HTTPS di Internet Communication Manager (ICM)

Untuk sistem SAP yang dihosting di Google Cloud, metadata VM disimpan di server metadata, yang hanya dapat diakses melalui port HTTP. Aktivasi port HTTP diperlukan untuk autentikasi. Oleh karena itu, saat sistem SAP Anda dihosting di instance VM Compute Engine, Anda harus memastikan bahwa port HTTP aktif untuk mengakses metadata VM dan mengaktifkan autentikasi. Anda juga harus memastikan bahwa port HTTPS aktif untuk panggilan API berikutnya.

Jika sistem SAP Anda dihosting di luar Google Cloud, aktivasi port HTTP tidak diperlukan.

Untuk memvalidasi port HTTP dan HTTPS, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi SMICM.
  2. Pada panel menu, klik Go to > Services. Tanda centang hijau di kolom Actv menunjukkan bahwa port HTTP dan HTTPS telah aktif.

Untuk informasi tentang cara mengonfigurasi port HTTP dan HTTPS, lihat Setelan HTTP(S) di ICM.

Memastikan traffic keluar jaringan keluar

Server aplikasi SAP harus terhubung ke Google Cloud API melalui HTTPS.

  • Untuk sistem host SAP Anda, pastikan bahwa aturan firewall dan proxy mengizinkan koneksi HTTPS dari server di luar instance VM Compute Engine. Untuk mengetahui informasi selengkapnya, baca bagian Membuat dan memulai instance VM.
  • Pastikan bahwa akses untuk menjangkau Google Cloud API tidak dibatasi dari perspektif jaringan.

Mengelola otorisasi

Untuk mengakses transaksi khusus ABAP SDK untuk Google Cloud, Anda perlu memberi pengguna akses ke objek otorisasi SDK. File transport SDK menyertakan objek otorisasi SDK ZGOOG_SDK dan grup otorisasi ZSGC.

Untuk memberikan akses ke transaksi SDK, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi PFCG.
  2. Tentukan peran untuk SDK.
  3. Untuk objek otorisasi ZGOOG_SDK, berikan akses peran ke otorisasi Activity 16.

Untuk membatasi akses ke tabel konfigurasi SDK, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi PFCG.
  2. Tentukan peran untuk membatasi akses ke tabel konfigurasi SDK.
  3. Untuk membatasi akses ke objek otorisasi S_TABU_DIS, kecualikan grup otorisasi ZSGC.

Menyiapkan keamanan Google Cloud

Jika sistem SAP Anda dihosting di Google Cloud, konfigurasikan hal berikut di instance VM Compute Engine host:

  • Buat akun layanan IAM untuk instance VM host. Untuk mengetahui petunjuknya, lihat Membuat akun layanan.

  • Berikan peran Service Account Token Creator ke akun layanan. Untuk mengetahui petunjuknya, lihat Memberikan satu peran.

  • Lampirkan akun layanan ke instance VM. Selain itu, tetapkan cakupan akses VM ke cloud-platform sehingga izin IAM VM sepenuhnya ditentukan oleh peran IAM yang Anda berikan ke akun layanan VM. Untuk mengetahui petunjuknya, lihat Membuat VM dan melampirkan akun layanan.

  • Buat akun layanan IAM khusus untuk mengakses Google Cloud API. Untuk mengetahui petunjuknya, lihat Membuat akun layanan.

  • Berikan peran IAM yang diperlukan kepada akun layanan untuk mengakses fungsi API. Agar memahami persyaratan peran untuk Google Cloud API, lihat dokumentasi API individual dan ikuti prinsip hak istimewa terendah. Untuk mengetahui informasi selengkapnya tentang peran bawaan khusus API, lihat Referensi peran dasar dan bawaan IAM.

Menyiapkan autentikasi

Untuk menggunakan Google Cloud API, Anda harus mengonfirmasi identitas Anda dengan autentikasi. Untuk mengetahui informasi tentang opsi autentikasi ke Google Cloud dan langkah-langkah penyiapannya, lihat Autentikasi.

Setelah menyelesaikan penyiapan autentikasi, Anda dapat mulai menggunakan Panduan Memulai untuk membuat program contoh.

Mengonfigurasi ABAP SDK untuk Google Cloud

Bagian ini menjelaskan konfigurasi ABAP SDK untuk Google Cloud.

Menentukan endpoint Google Cloud

ABAP SDK untuk Google Cloud menyediakan opsi berikut untuk menentukan endpoint API saat memanggil Google Cloud API menggunakan class library klien API:

Endpoint default

Secara default, metode konstruktor class library klien API berisi endpoint HTTP untuk Google Cloud API yang didukung. Library klien menggunakan endpoint ini ketika sebuah metode dipanggil untuk menjalankan operasi pada resource API.

Menggunakan tujuan RFC untuk endpoint

Jika Anda perlu menggunakan salah satu fitur berikut, gunakan tujuan RFC untuk terhubung ke Google Cloud:

  • Jika Anda menggunakan server proxy dalam lanskap SAP dan ingin menggunakan server proxy yang sama untuk mengirim permintaan HTTP ke Google Cloud.
  • Jika Anda ingin SDK mengakses Google Cloud API melalui endpoint Private Service Connect di jaringan VPC Anda.
  • Jika Anda ingin menggunakan kompresi HTTP.
  • Jika Anda ingin mengakses endpoint API spesifik per region.

File transport ABAP SDK untuk Google Cloud berisi contoh tujuan RFC berikut untuk endpoint Google Cloud API:

Contoh nama tujuan RFC Catatan
GOOG_IAMCREDENTIALS Tujuan RFC ini menargetkan IAM API.
GOOG_OAUTH2_TOKEN Tujuan RFC ini menargetkan endpoint Google Cloud untuk autentikasi berbasis token.
GOOG_PUBSUB_V1 Tujuan RFC ini menargetkan Pub/Sub API.
GOOG_TRANSLATION_EU_V3 Tujuan RFC ini menargetkan Cloud Translation v3 API.

Untuk membuat tujuan RFC, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi SM59.

  2. Buat tujuan RFC baru dengan menyalin contoh tujuan RFC.

  3. Untuk tujuan RFC yang Anda buat, pastikan Connection Type ditetapkan sebagai berikut: G - HTTP connection to external server.

  4. Buka tab Technical Settings dan masukkan detail berikut:

    • Host Target: masukkan nama host Google Cloud API. Misalnya, Anda dapat menggunakan translation.googleapis.com.
    • Awalan Jalur: masukkan jalur resource. Misalnya, Anda dapat menggunakan /language/translate/.

    • No. Service: masukkan 443. Nomor port yang digunakan untuk komunikasi yang aman.

      Untuk mengumpulkan detail khusus Google Cloud API yang Anda perlukan guna membuat tujuan RFC, baca Mengumpulkan detail untuk membuat tujuan RFC.

  5. Buka tab Logon & Security, lalu pastikan kolom SSL Certificate ditetapkan dengan opsi DFAULT SSL Client (Standard).

  6. Opsional: Anda dapat mengonfigurasi setelan proxy, mengaktifkan kompresi HTTP, dan menentukan endpoint Private Service Connect.

  7. Simpan perubahan Anda.

Agar dapat menggunakan tujuan RFC untuk terhubung ke Google Cloud API, Anda harus mengonfigurasi tujuan RFC dalam tabel pemetaan layanan yang memetakan tujuan RFC ke kunci klien. Untuk mengetahui informasi selengkapnya tentang tabel pemetaan layanan, lihat Tabel /GOOG/SERVIC_MAP.

Mengumpulkan detail untuk membuat tujuan RFC

Untuk mendapatkan detail yang Anda perlukan untuk membuat tujuan RFC, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Utilities > Get RFC Settings for Google Cloud Services.
  3. Tentukan nama layanan Google Cloud.
  4. Klik Execute untuk melihat detailnya.
Mengonfigurasi setelan proxy

Saat menggunakan tujuan RFC untuk terhubung ke Google Cloud, Anda dapat merutekan komunikasi dari SDK melalui server proxy yang Anda gunakan di lanskap SAP.

Jika tidak ingin menggunakan server proxy atau tidak memilikinya dalam lanskap SAP, Anda dapat melewati langkah ini.

Untuk mengonfigurasi setelan server proxy, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi SM59.

  2. Pilih tujuan RFC yang menargetkan API yang diperlukan.

  3. Buka tab Technical Settings, lalu masukkan nilai untuk kolom di bagian HTTP Proxy Options.

Anda harus mengonfigurasi setelan server proxy untuk setiap API yang ingin diakses menggunakan SDK.

Mengaktifkan kompresi HTTP

Saat menggunakan tujuan RFC untuk terhubung ke Google Cloud, Anda dapat mengaktifkan kompresi HTTP.

Sebaiknya aktifkan kompresi HTTP jika sistem SAP Anda tidak berjalan di Google Cloud. Sebelum mengaktifkan kompresi HTTP di lingkungan produksi, uji dan bandingkan manfaatnya berdasarkan penyiapan lanskap Anda, karena kompresi HTTP mungkin melibatkan overhead kompresi dan dekompresi. Untuk informasi selengkapnya dari SAP, lihat Catatan SAP 1037677 - Kompresi HTTP hanya mengompresi dokumen tertentu.

Jika tidak ingin mengaktifkan fitur ini, Anda dapat melewati langkah ini.

Untuk mengaktifkan kompresi HTTP, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi SM59.

  2. Pilih tujuan RFC yang menargetkan API yang diperlukan.

  3. Buka tab Special Options.

  4. Untuk kolom HTTP Version, pilih HTTP 1.1.

  5. Untuk kolom Compression, pilih nilai yang sesuai.

Menentukan endpoint Private Service Connect

Jika ingin ABAP SDK untuk Google Cloud menggunakan endpoint Private Service Connect untuk mengizinkan penggunaan pribadi dari Google Cloud API dan IAM, Anda harus membuat endpoint tersebut di project Google Cloud dan menentukannya di tujuan RFC masing-masing.

Jika Anda ingin SDK terus menggunakan endpoint API publik default untuk terhubung ke Google Cloud API dan IAM, lewati langkah ini.

Untuk mengonfigurasi SDK agar menggunakan endpoint Private Service Connect, lakukan langkah-langkah berikut:

  1. Di SAP GUI, masukkan kode transaksi SM59.

  2. Pastikan Anda telah membuat tujuan RFC baru untuk Google Cloud API dan IAM yang diperlukan. Untuk mengetahui petunjuk cara membuat tujuan RFC ini, lihat Membuat tujuan RFC.

  3. Pilih tujuan RFC yang menargetkan Google Cloud API tertentu, lalu selesaikan langkah-langkah berikut:

    1. Buka tab Technical Settings.

    2. Untuk kolom Target Host, masukkan nama endpoint Private Service Connect yang Anda buat untuk mengakses API.

    3. Untuk kolom Service No., pastikan nilai 443 ditentukan.

    4. Buka tab Logon and Security.

    5. Untuk kolom SSL Certificate, pastikan opsi DFAULT SSL Client (Standard) telah dipilih.

  4. Pilih tujuan RFC yang menargetkan IAM, lalu selesaikan langkah-langkah berikut:

    1. Buka tab Technical Settings.

    2. Untuk kolom Target Host, masukkan nama endpoint Private Service Connect yang Anda buat untuk mengakses IAM.

    3. Untuk kolom Service No., pastikan nilai 443 ditentukan.

    4. Buka tab Logon and Security.

    5. Untuk kolom SSL Certificate, pastikan opsi DFAULT SSL Client (Standard) telah dipilih.

  5. Konfigurasikan tabel pemetaan layanan untuk IAM API, dan API lain yang ingin Anda gunakan menggunakan ABAP SDK untuk Google Cloud.

    1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

      Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

    2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Service Map.

    3. Klik New Entries.

    4. Tentukan tujuan RFC untuk IAM API dan API lainnya, misalnya, Cloud Pub/Sub API v1.

Kolom Deskripsi
Google Cloud Key Name Menetapkan nama konfigurasi kunci klien.
Google Service Name Menentukan layanan Google Cloud tempat Anda memetakan tujuan RFC.
RFC Destination Menentukan nama tujuan RFC.

Tujuan RFC yang ditentukan dalam tabel pemetaan layanan digunakan oleh SDK saat class library klien dibuat instance dan digunakan oleh kode sumber ABAP untuk memanggil Google Cloud API.

Logging aplikasi

Untuk menulis log aplikasi, ABAP SDK untuk Google Cloud dilengkapi dengan framework logging yang disematkan. Objek log ZGOOG dan subobjek ZABAP_SDK dikirim bersama file transpor SDK yang dapat Anda gunakan sebagai objek default untuk konfigurasi log. Anda juga dapat menambahkan objek dan subobjek log kustom Anda sendiri ke framework logging SDK.

Anda dapat melihat log aplikasi SAP standar menggunakan transaksi SLG1. Untuk mengetahui informasi selengkapnya, lihat Logging.

Mengonfigurasi logging menggunakan objek log dan subobjek yang dikirimkan bersama SDK

Anda dapat menggunakan objek log ZGOOG dan subobjek ZABAP_SDK yang dikirimkan bersama SDK sebagai objek default untuk konfigurasi log.

Untuk mengonfigurasi logging, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Klik New Entries.

  4. Masukkan nilai untuk kolom berikut:

    Kolom Deskripsi
    Objek Masukkan ZGOOG.
    Subobjek Masukkan ZABAP_SDK.
    Tingkat Log

    Menentukan level log minimum. Nilai yang didukung adalah:

    • I: Informasi, Peringatan, dan Error
    • W: Peringatan dan Error
    • E: Error Saja

    Sebaiknya Anda menetapkan level log ke I, sehingga sebagian besar pesan log dicatat ke dalam log.
    Retensi Menentukan berapa hari log akan dipertahankan.
    Berakhir Pada Tentukan tanggal akhir untuk masa aktif konfigurasi log ini. Tanggal akhir default-nya adalah 9999/12/31.
    Is Default Untuk menetapkan konfigurasi log ini sebagai default, centang kotak.

Menambahkan objek log kustom

Anda juga dapat menambahkan objek dan subobjek log kustom Anda sendiri ke framework logging SDK.

Untuk menambahkan objek dan subobjek log kustom, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Klik New Entries.

  4. Masukkan nilai untuk kolom berikut:

    Kolom Deskripsi
    Object Memasukkan nama objek log.
    Subobject Memasukkan nama subobjek log.
    Log Level

    Menentukan level log minimum. Kemungkinan nilainya adalah:

    • I: Informasi, Peringatan, dan Error
    • W: Peringatan dan Error
    • E: Error Saja

    Sebaiknya Anda menetapkan level log ke I, sehingga sebagian besar pesan log dicatat ke dalam log.
    Retention Menentukan berapa hari log akan dipertahankan.
    End At Tanggal akhir untuk masa aktif konfigurasi log ini. Tanggal akhir default-nya adalah 9999/12/31.
    Is Default Menentukan apakah ini adalah konfigurasi log default Anda.

Jika Anda perlu menetapkan objek dan subobjek log kustom sebagai konfigurasi logging default, kosongkan kolom Is Default untuk entri default saat ini, lalu pilih kolom Is Default untuk entri baru yang perlu Anda buat sebagai default.

Anda hanya dapat menyimpan satu konfigurasi log sebagai entri default pada waktu tertentu.

Anda juga dapat menggunakan objek dan subobjek log kustom meskipun tidak menjadikannya default. Untuk melakukannya, setelah membuat objek dan subobjek log kustom dalam framework logging, Anda harus meneruskan objek dan subobjek log saat membuat instance stub klien API. Untuk mengetahui informasi selengkapnya, lihat Logging.

Jika konfigurasi log tidak lagi diperlukan, Anda dapat menonaktifkannya.

Untuk menonaktifkan konfigurasi log, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

  3. Tetapkan kolom End At ke tanggal sebelumnya.

Tabel konfigurasi kunci di ABAP SDK untuk Google Cloud

Tabel /GOOG/CLIENT_KEY.

Untuk konfigurasi terkait autentikasi dan konektivitas, ABAP SDK untuk Google Cloud menggunakan tabel /GOOG/CLIENT_KEY. Pada tabel /GOOG/CLIENT_KEY, Anda mengonfigurasi kunci klien menggunakan detail khusus untuk metode autentikasi Anda. Untuk mengetahui informasi lebih lanjut tentang metode autentikasi dan konfigurasi kunci klien yang terkait, lihat Autentikasi.

Untuk melihat tabel /GOOG/CLIENT_KEY, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Client Key.

Tabel berikut menjelaskan kolom tabel kunci klien:

Kolom Jenis data Deskripsi
Google Cloud Key Name String Nama konfigurasi kunci klien. Contoh, CLIENT_KEY_API_KEY
Google Cloud Service Account Name String Nama akun layanan, dalam format alamat email.
Google Cloud Scope String Cakupan akses API, https://www.googleapis.com/auth/cloud-platform. Cakupan akses ini sesuai dengan setelan Izinkan akses penuh ke semua Cloud API di VM host.
Project ID String ID project Google Cloud yang berisi API target Anda.
Command Name String Nama perintah OS. Secara umum, Anda dapat membiarkan kolom ini kosong.
Authorization Class String Class otorisasi yang akan digunakan untuk komunikasi dengan Google Cloud.
Token Caching Boolean Flag yang menentukan apakah token akses yang diambil dari Google Cloud disimpan ke cache atau tidak. Sebaiknya aktifkan penyimpanan token ke dalam cache setelah Anda selesai mengonfigurasi dan menguji koneksi Anda ke Google Cloud. Untuk mengetahui informasi selengkapnya tentang penyimpanan token ke dalam cache, lihat Mengaktifkan penyimpanan token ke dalam cache.
Token Refresh Seconds String Lama waktu, dalam detik, sebelum masa berlaku token akses berakhir dan harus dimuat ulang. Menentukan nilai dari 1 hingga 3599 akan menggantikan waktu habis masa berlaku default, yaitu 3500 detik. Jika Anda menentukan 0, SDK akan menggunakan nilai default. Nilai defaultnya adalah 3500.
Authorization Parameter 1 String Ini adalah parameter otorisasi tambahan yang memerlukan konfigurasi dalam situasi tertentu. Secara umum, Anda dapat membiarkan kolom ini kosong.
Authorization Parameter 2 String Ini adalah parameter otorisasi tambahan yang memerlukan konfigurasi dalam situasi tertentu. Secara umum, Anda dapat membiarkan kolom ini kosong.

Tabel /GOOG/SERVIC_MAP

Untuk memetakan konfigurasi layanan ke tujuan RFC, ABAP SDK untuk Google Cloud menggunakan tabel /GOOG/SERVIC_MAP.

Bergantung pada metode autentikasi, tabel ini berisi beberapa entri wajib dan yang direkomendasikan.

Untuk melihat tabel /GOOG/SERVIC_MAP, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Service Mapping.

Tabel berikut menjelaskan kolom tabel pemetaan layanan:

Kolom Jenis data Deskripsi
Nama String Nama konfigurasi kunci klien.
Google Service Name String Nama layanan Google Cloud. Untuk menemukan layanan, gunakan bantuan penelusuran.
RFC Destination String Nama tujuan RFC. Untuk menemukan tujuan RFC yang relevan, gunakan bantuan penelusuran.

Bantuan penelusuran

Guna menemukan nilai yang tersedia untuk kolom, klik ikon seperti yang ditunjukkan dalam screenshot berikut:

Bantuan penelusuran

Tabel /GOOG/LOG_CONFIG

Untuk menulis log aplikasi, ABAP SDK untuk Google Cloud menggunakan tabel /GOOG/LOG_CONFIG.

Untuk melihat tabel /GOOG/LOG_CONFIG, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Logging Framework.

Tabel berikut menjelaskan kolom-kolom tabel konfigurasi logging:

Kolom Deskripsi
Object Nama objek log.
Subobject Nama subobjek log.
Log Level

Menampilkan level log minimum. Kemungkinan nilainya adalah:

  • I: Informasi, Peringatan, dan Error
  • W: Peringatan dan Error
  • E: Error Saja
Retention

Jumlah hari log akan dipertahankan.

Setelah periode retensi data, Anda dapat mempertimbangkan log untuk dihapus menggunakan transaksi SLG2.
End At Tanggal akhir untuk masa aktif konfigurasi log ini. Tanggal akhir default-nya adalah 9999/12/31.
Is Default Menunjukkan apakah ini adalah konfigurasi log default.
Changed by Nama pengguna yang mengubah konfigurasi log.
Changed on Tanggal saat konfigurasi log diubah.
Changed at Waktu saat konfigurasi log diubah.

Penyimpanan token dalam cache

Jika SDK digunakan dalam kasus penggunaan volume panggilan tinggi dengan beberapa panggilan metode API dilakukan dalam durasi singkat, aktifkan cache untuk token akses atau kunci API yang didapatkan dari konfigurasi kunci klien guna mengakses Google Cloud API.

Mengaktifkan penyimpanan token ke dalam cache akan memastikan bahwa token akses atau Kunci API digunakan kembali hingga habis masa berlakunya atau dicabut, yang pada akhirnya akan mengurangi jumlah panggilan HTTP yang dilakukan untuk mengambil token akses atau kunci API baru.

Untuk mengaktifkan penyimpanan token ke dalam cache, pilih flag Token Caching di tabel kunci klien.

Saat Anda mengaktifkan penyimpanan token ke dalam cache, token akses akan di-cache dalam Memori Bersama pada server aplikasi selama durasi yang ditetapkan untuk kolom Token Refresh Seconds dalam tabel kunci klien. JikaToken Refresh Seconds tidak ditentukan atau disetel ke 0, token akses akan disimpan dalam cache selama nilai yang ditentukan dalam parameter CMD_SECS_DEFLT dalam setelan lanjutan.

Menghapus token akses yang di-cache

Ketika penyimpanan token ke dalam cache diaktifkan dan Anda memperbarui peran yang ditetapkan ke akun layanan yang digunakan ABAP SDK untuk Google Cloud untuk mengakses API yang relevan, token akses baru yang sesuai dengan peran yang diperbarui akan diambil hanya setelah masa berlaku token yang di-cache berakhir. Dalam situasi seperti itu, Anda dapat menghapus token akses secara manual.

Untuk menghapus token akses yang di-cache, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Utilities > Clear Cache.

  3. Pilih opsi yang sesuai:

    • Hapus area memori bersama: untuk menghapus seluruh cache.
    • Hapus instance dari memori: untuk menghapus token akses yang di-cache untuk instance tertentu. Dengan opsi ini, Anda juga dapat menentukan suatu nama instance.

  4. Jalankan laporan.

Menemukan peran IAM untuk Google Cloud API

Untuk menerapkan prinsip hak istimewa terendah, Anda harus mengetahui peran IAM yang sesuai untuk Google Cloud API yang ingin Anda gunakan dalam program ABAP. Dengan hanya memberikan peran yang diperlukan, Anda dapat membatasi akses untuk akun layanan. Utilitas Pencari Peran, yang terintegrasi dalam SDK, memungkinkan Anda dengan mudah mengidentifikasi peran IAM yang terkait dengan berbagai Google Cloud API.

Untuk menemukan peran IAM, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Utilities > Fetch API Relevant Roles.

    Atau, Anda dapat mengakses utilitas Pencari Peran dengan mengeksekusi kode transaksi /GOOG/ROLE_FINDER.

  3. Di kolom Kunci klien, masukkan nama kunci klien yang valid yang dikonfigurasi di tabel /GOOG/CLIENT_KEY.

  4. Di kolom Google Service Name, tentukan Google Cloud API yang peran IAM-nya perlu Anda periksa.

  5. Jika ingin, untuk melihat izin IAM terkait dalam peran IAM, pilih kolom Detail Lengkap.

  6. Klik Jalankan. Peran IAM akan ditampilkan.

Setelan lanjutan

Secara opsional, Anda dapat mengubah parameter setelan lanjutan untuk SDK di tabel /GOOG/SDK_PARAM. Parameter value ini diterapkan di tingkat sistem dan umum di semua komponen SDK.

SDK secara internal menerapkan nilai default untuk parameter ini. Gunakan setelan lanjutan hanya jika Anda ingin mengganti nilai default.

Sebaiknya ubah parameter setelan lanjutan hanya setelah analisis yang komprehensif dan dampak nilai baru terhadap performa SDK. Anda bertanggung jawab untuk memastikan bahwa setelan lanjutan yang baru tidak menyebabkan kegagalan dan masalah performa.

Untuk mengubah parameter setelan lanjutan, lakukan langkah-langkah berikut:

  1. Di SAP GUI, jalankan kode transaksi /GOOG/SDK_IMG.

    Atau, jalankan kode transaksi SPRO, lalu klik IMG Referensi SAP.

  2. Klik ABAP SDK for Google Cloud > Basic Settings > Configure Parameters.

  3. Klik New Entries.

  4. Di baris yang ditampilkan, tentukan setelan berikut:

    1. Di kolom Parameter Name, masukkan nama parameter. Deskripsi parameter diisi secara otomatis.
    2. Di kolom Parameter Value, masukkan nilai.

    Untuk mengetahui parameter Setelan lanjutan, lihat Parameter setelan lanjutan.

  5. Simpan entri baru.

Parameter setelan lanjutan

Tabel berikut menunjukkan parameter setelan lanjutan untuk ABAP SDK untuk Google Cloud.

Nama parameter Deskripsi Nilai default Nilai yang valid
CMD_SECS_DEFLT Jika Anda telah mengaktifkan penyimpanan token ke dalam cache, nilai ini adalah durasi dalam detik yang menunjukkan bahwa setelahnya masa berlaku token yang di-cache akan berakhir. 3500 Nilai harus dari 1 hingga 3599.

Mengupdate ABAP SDK untuk Google Cloud

Google Cloud mengirimkan rilis baru ABAP SDK untuk Google Cloud sebagai transpor SAP.

Jika Anda mengalami masalah saat mengimpor file transpor ABAP SDK untuk Google Cloud ke lingkungan SAP, seperti masalah terkait peninjauan transpor oleh SAP atau pengelolaan antrean impor, hubungi Layanan Pelanggan Cloud untuk mendapatkan bantuan. Untuk mengetahui informasi tentang cara menghubungi Layanan Pelanggan, lihat Mendapatkan dukungan untuk SAP di Google Cloud.

Administrator SAP dapat mengupdate ABAP SDK untuk Google Cloud dengan mengikuti langkah-langkah berikut:

  1. Di lingkungan SAP, hentikan tugas latar belakang yang menggunakan stub klien API ABAP SDK untuk Google Cloud yang ada.

  2. Download paket penginstalan yang berisi file transport dari portal download.

  3. Impor permintaan transpor SAP berikut:

    • Jika Anda mengupdate SDK dari versi 1, 1.5, atau 1.6 ke versi terbaru, salin file transpor berikut ke direktori impor transpor Server SAP:

      • /usr/sap/trans/cofiles/K900323.GM1

      • /usr/sap/trans/data/R900323.GM1

        File transpor ini menghapus artefak yang terkait dengan fitur yang tidak digunakan lagi di ABAP SDK untuk Google Cloud. Untuk mengetahui informasi tentang penambahan, peningkatan, dan fitur yang tidak digunakan lagi, lihat Yang baru di ABAP SDK untuk Google Cloud edisi cloud atau on-premise.

        Jika Anda mengupdate SDK dari versi 1.7 atau yang lebih baru ke versi terbaru, Anda dapat melewati penyalinan file transpor ini.

    • Untuk membuat koneksi dengan Google Cloud API yang didukung dan mengautentikasi dengan token atau kunci API, salin file transpor berikut ke direktori impor transpor Server SAP:

      • /usr/sap/trans/cofiles/K900319.GM1
      • /usr/sap/trans/data/R900319.GM1

    • Untuk mengautentikasi dengan kredensial klien OAuth 2.0, salin file transport berikut ke direktori impor transport Server SAP:

      • /usr/sap/trans/cofiles/K900321.GM1

      • /usr/sap/trans/data/R900321.GM1

        File transpor ini tidak memberikan fungsi tambahan, selain autentikasi berbasis kredensial klien OAuth 2.0. Untuk autentikasi berbasis kredensial klien OAuth 2.0, pertama-tama impor file transpor untuk Google Cloud API yang didukung, lalu impor file transpor untuk kredensial klien OAuth 2.0.

        Untuk menggunakan kredensial klien OAuth 2.0, sistem SAP Anda harus mendukung OAuth 2.0. Untuk informasi tentang sistem SAP yang mendukung OAuth 2.0, lihat Catatan SAP 3041322 - Klien OAuth 2.0: Downport Kredensial Klien jenis pemberian.

  4. Setelah memvalidasi impor dan aktivasi objek yang berhasil, lanjutkan tugas latar belakang.

Metrik penggunaan

ABAP SDK untuk Google Cloud edisi cloud atau lokal mengumpulkan metrik penggunaan dan mengirimkannya ke Google untuk tujuan dukungan, sesuai dengan Pemberitahuan Privasi Google Cloud (Data Layanan yang Kami Kumpulkan). Metrik penggunaan ini dikumpulkan setiap kali Google Cloud API dipanggil dari ABAP SDK untuk Google Cloud.

SDK mengumpulkan metrik penggunaan berikut:

  • Metode autentikasi: informasi tentang metode autentikasi yang digunakan untuk memanggil layanan Google Cloud.
  • Versi ABAP SDK: nomor versi ABAP SDK untuk Google Cloud edisi cloud atau versi lokal.
  • Rilis SAP_ABA: versi komponen software SAP_ABA.
  • ID modul (Hanya dikumpulkan untuk Vertex AI SDK untuk ABAP): nama modul atau fitur yang digunakan dalam SDK, seperti Penelusuran Vektor.

Pemberian Lisensi

ABAP SDK untuk Google Cloud edisi cloud atau on-premise tersedia sebagai "Software" berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform oleh Anda, termasuk Persyaratan Khusus Layanan yang tersedia di https://cloud.google.com/terms/service-terms. Tanpa membatasi keumuman persyaratan di atas, Anda tidak boleh memodifikasi atau mendistribusikan ABAP SDK untuk Google Cloud tanpa izin tertulis yang jelas dari Google.

Software ABAP SDK untuk Google Cloud ditawarkan tanpa biaya. Agar lebih jelas, penggunaan "Software" dan "Layanan" lainnya oleh Anda berdasarkan perjanjian yang mengatur penggunaan Google Cloud Platform, seperti Cloud Translation API dan Pub/Sub API dapat dikenai biaya.

ABAP SDK untuk Google Cloud tidak menyertakan lisensi apa pun untuk software SAP. Harap lakukan pembelian lisensi yang sesuai secara terpisah untuk software SAP.

Dukungan bahasa

ABAP SDK untuk Google Cloud hanya mendukung bahasa Inggris (EN).

SDK ditetapkan secara default ke bahasa Inggris (EN) untuk bahasa login SAP berikut: bahasa China (CH), bahasa Prancis (FR), bahasa Jerman (DE), bahasa Jepang (JA), bahasa Portugis (PT), dan bahasa Rusia (RU).

Pesan error yang mungkin Anda temukan saat bekerja dengan SDK dibuat dalam bahasa Inggris, terlepas dari bahasa sistem Anda saat ini.

Siklus proses dukungan

Google Cloud mendukung dan mempertahankan versi utama ABAP SDK untuk Google Cloud saat ini selama minimal 12 bulan setelah publikasi pemberitahuan penghentian penggunaan versi utama sebelumnya pada halaman Catatan Rilis untuk SAP di Google Cloud.

Mendapatkan dukungan

Jika Anda memerlukan bantuan untuk menyelesaikan masalah terkait ABAP SDK untuk Google Cloud, lakukan hal berikut: