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

On-premises or any cloud edition v1.8

• Edisi SAP BTP v1.0
• Lokal atau edisi cloud apa pun v1.8

Dokumen ini menunjukkan cara menginstal dan mengonfigurasi ABAP SDK versi lokal atau edisi cloud apa pun untuk Google Cloud di sistem host SAP di instance VM Compute Engine, di infrastruktur 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 daftar lengkap yang disediakan oleh ABAP SDK untuk Google Cloud, lihat ABAP SDK untuk library klien Google Cloud.

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

Mulai versi 1.8, ABAP SDK for Google Cloud edisi lokal atau edisi cloud apa pun 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 SAP Netweaver Anda . Untuk mengetahui informasi tentang kompatibilitas Add-On UI SAP, lihat: Panduan Utama untuk Add-On UI 2217489 - Strategi Pemeliharaan dan Update untuk Server Front-End SAP Fiori
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 artikel Tentang Cloud API. Jika server SAP Anda tidak memiliki internet publik akses, lalu menghubungkannya ke Google Cloud menggunakan salah satu metode berikut:

• Cloud Interconnect (direkomendasikan)
• Cloud VPN

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.

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 set transportasi file:

   • Untuk Google Cloud API dan autentikasi yang didukung menggunakan 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 autentikasi berbasis 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 transport ini tidak menyediakan fungsi tambahan, selain otentikasi berbasis kredensial klien OAuth 2.0. Sebagai Otentikasi berbasis klien OAuth 2.0, pertama mengimpor file transpor untuk Google Cloud API yang didukung, dan kemudian mengimpor file transport 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.

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

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

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

       File transportasi ini menghapus artefak yang terkait dengan aset yang tidak digunakan lagi di ABAP SDK untuk Google Cloud. Untuk mengetahui informasi tentang penambahan, penyempurnaan, dan fitur yang tidak digunakan lagi, lihat Yang baru di infrastruktur lokal atau edisi cloud ABAP SDK for Google Cloud.

       Jika Anda menginstal SDK untuk pertama kalinya atau mengupdate SDK dari versi 1.7 atau yang lebih baru hingga versi terbaru, tidak ada perlu menyalin file transport ini.

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 (Include Subpackages).

   4. Klik ikon Beralih ke 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 dalam format yang sesuai dengan OpenSSL untuk mengubah sertifikat ke format yang dibutuhkan.

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 Sertifikat > Impor, lalu impor sertifikat yang telah Anda download dari repositori Google Trust Services.

6. Klik tombol dengan centang hijau.

7. Klik Edit > Tambahkan ke daftar sertifikat. Pastikan informasi sertifikat terlihat di area Sertifikat 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 porta HTTP. Aktivasi port HTTP diperlukan untuk autentikasi. Oleh karena itu, ketika sistem SAP Anda dihosting di Anda harus memastikan bahwa porta HTTP aktif untuk mengakses metadata VM dan mengaktifkan otentikasi. Anda juga harus memastikan bahwa port HTTPS aktif untuk panggilan API berikutnya.

Jika sistem SAP Anda dihosting di luar Google Cloud, maka 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.

Perhatian: Untuk mencegah pengguna yang tidak berwenang mengakses resource Google Cloud, sebaiknya Anda mengontrol akses ke komponen ABAP SDK untuk Google Cloud (Setelan, Utilitas, dan Demo) sesuai dengan kebijakan keamanan organisasi Anda.

Menyiapkan keamanan Google Cloud

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

• Membuat 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 memasang akun layanan.

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

• Memberi akun layanan peran IAM yang diperlukan untuk mengakses fungsi API. Guna memahami persyaratan peran untuk Google Cloud API, melihat dokumentasi API individual dan ikuti prinsip hak istimewa terendah. Untuk selengkapnya Untuk mengetahui informasi 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
• Menggunakan tujuan RFC untuk endpoint

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.

Catatan: Anda harus membuat tujuan RFC sendiri menggunakan contoh Tujuan RFC sebagai {i>template<i}. Jangan ubah tujuan RFC contoh karena mengimpor transpor baru untuk ABAP SDK untuk Google Cloud menimpa tujuan contoh ini.

Untuk membuat tujuan RFC, lakukan langkah-langkah berikut:

1. Di SAP GUI, masukkan kode transaksi SM59.

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

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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Utilitas &gt; Dapatkan Setelan RFC untuk Layanan Google Cloud.
3. Tentukan nama layanan Google Cloud.
4. Klik Execute untuk melihat detailnya.

Mengonfigurasi setelan proxy

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

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 Anda 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 Anda ingin ABAP SDK untuk Google Cloud menggunakan Private Service Connect endpoint untuk mengizinkan penggunaan pribadi Google Cloud API dan IAM, selanjutnya Anda perlu membuat endpoint tersebut di project Google Cloud Anda 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

   2. Klik ABAP SDK for Google Cloud &gt; Setelan Dasar &gt; Konfigurasi Peta Layanan.

   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 dikirimkan dengan file transpor SDK yang dapat Anda gunakan sebagai objek default untuk konfigurasi log. Anda juga dapat menambahkan objek log kustom Anda sendiri dan subobjek 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 dikirim dengan SDK

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

Untuk mengonfigurasi logging, lakukan langkah-langkah berikut:

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

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

2. Klik ABAP SDK for Google Cloud &gt; Setelan Dasar &gt; Konfigurasi 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 hingga konfigurasi log ini akan aktif. Tanggal akhir default adalah 9999/12/31.
   Default	Untuk menetapkan konfigurasi log ini sebagai default, pilih kotak centang.

Menambahkan objek log kustom

Anda juga bisa menambahkan objek dan subobjek log kustom ke logging SDK Google Workspace for Education.

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

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

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

2. Klik ABAP SDK for Google Cloud &gt; Basic Settings &gt; 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 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Basic Settings &gt; 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Setelan Dasar &gt; Konfigurasi Kunci Klien.

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. Biasanya, Anda 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. Biasanya, Anda membiarkan kolom ini kosong.
Authorization Parameter 2	String	Ini adalah parameter otorisasi tambahan yang memerlukan konfigurasi dalam situasi tertentu. Biasanya, Anda 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Setelan Dasar &gt; Konfigurasi Pemetaan Layanan.

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:

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 &gt; Basic Settings &gt; 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 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Utilitas &gt; Hapus 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 perlu mengetahui peran IAM yang sesuai untuk Google Cloud API yang akan 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, memudahkan Anda mengidentifikasi peran IAM yang terkait dengan berbagai Google Cloud API.

Untuk menemukan peran IAM, lakukan langkah-langkah berikut:

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

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

2. Klik ABAP SDK for Google Cloud &gt; Utilitas &gt; Fetch API Relevant Roles.

   Atau, Anda dapat mengakses utilitas Role Finder dengan menjalankan kode transaksi /GOOG/ROLE_FINDER.

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

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

5. Secara opsional, untuk melihat izin IAM yang terkait dalam Peran IAM, pilih kolom Detail Lengkap.

6. Klik Jalankan. Peran IAM 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 GUI SAP, jalankan kode transaksi /GOOG/SDK_IMG.

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

2. Klik ABAP SDK for Google Cloud &gt; Setelan Dasar &gt; Konfigurasi Parameter.

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 menghadirkan rilis baru ABAP SDK untuk Google Cloud saat transpor SAP.

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

1. Menghentikan tugas latar belakang yang menggunakan stub klien API dari ABAP SDK untuk Google Cloud yang sudah ada.
2. Impor permintaan transpor SAP yang baru. Untuk informasi selengkapnya tentang langkah-langkahnya, lihat Menginstal ABAP SDK untuk Google Cloud.
3. Setelah memvalidasi impor dan aktivasi objek yang berhasil, lanjutkan proses pekerjaan di latar belakang.

Metrik penggunaan

ABAP SDK untuk Google Cloud edisi lokal atau cloud lainnya 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 yang 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 secara lokal atau edisi cloud apa pun.
• Rilis SAP_ABA: versi komponen software SAP_ABA.
• ID modul (Dikumpulkan hanya untuk Vertex AI SDK untuk ABAP): nama modul atau fitur yang digunakan dalam SDK, misalnya Vector Search.

Pemberian Lisensi

ABAP SDK untuk Google Cloud edisi lokal atau edisi cloud apa pun tersedia sebagai "Software" di bawah perjanjian yang mengatur penggunaan Anda atas Google Cloud Platform, 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 dengan ABAP SDK untuk Google Cloud, lakukan hal berikut:

• Lihat panduan pemecahan masalah ABAP SDK for Google Cloud.

• Ajukan pertanyaan dan diskusikan ABAP SDK untuk Google Cloud dengan komunitas nyala Forum Cloud.

• Mengumpulkan semua informasi diagnostik yang tersedia dan menghubungi Cloud Customer Care. Untuk mengetahui informasi tentang cara menghubungi Customer Care, lihat Mendapatkan dukungan untuk SAP di Google Cloud.