Langkah 1: Siapkan AWS akun Anda Langkah 2: Instal SDK Langkah 3: Konfigurasikan SDK Langkah 4: Pengaturan fungsional Langkah 5: Otorisasi Pengguna SAP Langkah 6: Tulis kodenya Langkah 7: Jalankan aplikasi

Memulai dengan AWS SDK untuk SAP ABAP

Bagian ini menjelaskan cara memulai denganSDK. Ini mencakup informasi tentang menginstalSDK, melakukan konfigurasi dasar, dan membuat contoh kode Hello World yang menerjemahkan frasa dari satu bahasa ke bahasa lain. Jika Anda baru mengenal AWS SDK, kami sarankan untuk melakukan langkah-langkah ini di lingkungan kotak pasir.

Langkah 1: Siapkan AWS akun Anda

Untuk memulai dengan SDK for SAPABAP, Anda harus memiliki yang aktif Akun AWS . Anda memerlukan Akun AWS bahkan jika SAP sistem Anda di-host di tempat, di Platform Teknologi SAP Bisnis (BTP) atau dengan penyedia cloud lain.

Jika SAP sistem Anda berjalan di AWS Cloud, maka Anda akan melakukan panggilan ke AWS layanan di Anda Akun AWS.

Topik

IAMperan untuk SAP pengguna
Autentikasi

IAMperan untuk SAP pengguna

Buat IAM peran dengan instruksi yang disediakan dalam Panduan AWS Identity and Access Management Pengguna. Untuk informasi selengkapnya, lihat Membuat peran untuk mendelegasikan izin ke layanan. AWS Perhatikan Amazon Resource Name (ARN) IAM peran untuk digunakan nanti.
Pilih Amazon EC2 sebagai kasus penggunaan.
Gunakan SapDemoTranslate sebagai nama peran.
Lampirkan TranslateReadOnly profil ke peran.
Peran harus memiliki entitas berikut untuk memungkinkan SAP sistem untuk mengambil peran. Ganti "111122223333" dengan nomor akun AWS Anda.
```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sts:AssumeRole"
            ],
            "Principal": { "AWS": "111122223333" }
        }
    ]
}
```
Contoh ini menunjukkan bahwa setiap prinsipal dari Akun AWS "111122223333" dapat mengambil peran. Ini adalah izin luas yang cocok untuk proof-of-concept. Anda dapat menggunakan prinsipal yang lebih sempit untuk produksi, seperti contoh berikut.
- Pengguna tertentu — ketika SAP sistem menggunakan salah satu dari berikut ini:
  - SSF-kredensil terenkripsi dari sistem lokal SAP
  - Kredensi dari layanan SAP Credential Store di, lingkungan SAP BTP ABAP
- Peran tertentu — ketika SAP sistem ada di Amazon EC2 dan ada profil instance.
- Amazon EC2 — ketika SAP sistem ada di Amazon EC2 dan tidak ada profil instance.

Untuk informasi selengkapnya, lihat Praktik terbaik untuk IAM Keamanan.

Autentikasi

Otentikasi tergantung pada tempat SAP sistem Anda di-host.

Lokasi

Di AWS Cloud
Lokal, SAP BTP atau cloud lainnya

Di AWS Cloud

Pastikan bahwa EC2 instance di mana SAP sistem Anda berjalan memiliki profil instance dengan izin berikut.


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": "sts:AssumeRole",
            "Resource": "arn:aws:iam::111122223333:role/SapDemoTranslate"
        }
    ]
}

Tambahkan ARN yang Anda catat di langkah sebelumnya.

Izin ini memungkinkan SAP sistem Anda untuk mengambil SapDemoTranslate peran atas nama ABAP pengguna.

Lokal, SAP BTP atau cloud lainnya

Jika SAP sistem Anda berada di lokasi lokal, di SAP BTP atau di cloud lain, gunakan langkah-langkah berikut untuk membuat sambungan untuk autentikasi menggunakan kunci akses rahasia.

Buat IAM pengguna. Untuk informasi selengkapnya, lihat Membuat IAM pengguna (konsol).
Gunakan SapDemoSID sebagai nama IAM pengguna. SIDadalah ID sistem SAP sistem Anda.
Tetapkan SapDemoTranslate peran untuk pengguna ini.

Pertahankan access_key dansecret_access_key. Anda harus mengonfigurasi kredensil ini di sistem AndaSAP.

catatan

Jika SAP sistem Anda berada di tempat, di SAP BTP atau di cloud lain, Anda dapat melakukan autentikasi menggunakan salah satu opsi berikut.

Autentikasi kunci akses rahasia menggunakan SSF atau SAP Credential Store
Menggunakan sertifikat dengan IAM Peran Di Mana Saja

Langkah 2: Instal SDK

Lihat tab berikut untuk petunjuk penginstalan.

Langkah 3: Konfigurasikan SDK

Sebelum mengonfigurasiSDK, pastikan Anda memiliki otorisasi yang diperlukan. Untuk informasi selengkapnya, lihat SAPotorisasi.

Lihat tab berikut untuk petunjuk konfigurasi.

SDK for SAP ABAP

Jalankan /AWS1/IMG transaksi untuk membuka Panduan Implementasi untuk SDK untuk SAPABAP. Untuk menjalankan transaksi ini, masukkan /n/AWS1/IMG di bilah perintah SAP sistem Anda, lalu pilih Enter.

Selesaikan konfigurasi berikut.

Pergi ke Prasyarat Teknis.
- Tinjau Parameter dan HTTPSkonektivitas yang direkomendasikan.
Buka Pengaturan Global → Konfigurasi Skenario.
- Ubah pengaturan, sesuai dengan rekomendasi dalam pengaturan Global.
Buka Pengaturan Global → Pengaturan Teknis.
- Ubah pengaturan, sesuai dengan rekomendasi dalam pengaturan Global.
Buka Pengaturan Runtime → Log Dan Trace.
- Pilih Entri Baru.
  - Level jejak: Tidak Ada Jejak.
  - Garis Dump Maksimum:100.
  - OPT-IN: enh telemetri: Kosongkan ini.
- Pilih Simpan.
Buka Pengaturan Runtime → Skenario Aktif.
- Di bawah Skenario Baru, pilihDEFAULT.
- Pilih Perubahan Skenario Komit.
- Terima prompt.

Prasyarat untuk Sistem Lokal

Jika SAP sistem Anda berjalan di tempat atau di cloud lain, kredensialnya harus disimpan di database Anda. SAP Kredensialnya dienkripsi menggunakan SAP SSF dan memerlukan pustaka kriptografi yang dikonfigurasi, seperti's. SAP CommonCryptoLib

Langkah-langkah untuk mengkonfigurasi SSF SDK untuk SAP ABAP dijelaskan dalam /AWS1/IMG transaksi.

catatan

Prasyarat sebelumnya tidak berlaku jika sistem Anda SAP berjalan di Amazon. EC2 SAPsistem yang berjalan di Amazon EC2 mengambil kredenal yang berumur pendek dan berputar secara otomatis dari metadata instans Amazon. EC2

SDK for SAP ABAP - BTP edition

Buka ABAP lingkungan Anda di browser web, dan arahkan ke aplikasi Konfigurasi Bisnis Kustom.

Selesaikan konfigurasi berikut.

Pergi ke Konfigurasi Skenario.
- Ubah pengaturan, sesuai dengan rekomendasi dalam pengaturan Global.
Buka Pengaturan Teknis.
- Ubah pengaturan, sesuai dengan rekomendasi dalam pengaturan Global.

Langkah 4: Pengaturan fungsional

Lihat tab berikut untuk petunjuk penyiapan.

SDK for SAP ABAP

Jalankan transaksi /AWS1/IMG (masukkan /n/AWS1/IMG di bilah perintah, dan pilih Enter) untuk membuka panduan implementasi untuk AWS SDK.

Buka Konfigurasi Aplikasi → SDKProfil.
- Pilih Entri Baru.
  - Profil:DEMO.
  - Keterangan:Demo profile.
  - Pilih Simpan.
Sorot entri yang Anda buat dan klik cabang pohon Otentikasi Dan Pengaturan.
- Pilih Entri Baru.
  - SID: ID sistem dari SAP sistem yang Anda gunakan saat ini.
  - Klien: Klien dari SAP sistem tempat Anda berada saat ini.
  - ID Skenario: Daftar tarik-turun tempat Anda akan menemukan DEFAULT skenario yang dibuat oleh administrator Basis Anda.
  - AWS Wilayah: masukkan AWS Wilayah tempat Anda ingin melakukan panggilan. Jika SAP sistem Anda berjalan AWS, masukkan AWS Wilayah yang sedang berjalan.
  - Metode otentikasi:
    
    Pilih Peran Instance melalui Metadata jika SAP sistem Anda berjalan di Amazon. EC2
    
    Pilih Kredensial dari SSF Penyimpanan jika SAP sistem Anda berjalan di tempat atau di cloud lain.
    
    Pilih Tetapkan Kredensial.
    
    Masukkan ID Kunci Akses dan Kunci Akses Rahasia yang Anda buat di langkah sebelumnya.
- Biarkan IAMperan Nonaktifkan kosong.
- Pilih Simpan.
Klik pada cabang pohon Pemetaan IAM Peran.
- Pilih Entri Baru.
  - Masukkan nomor Urutan: 010.
  - Masukkan IAMperan Logis:TESTUSER.
  - Masukkan IAMRole ARN: masukkan arn:aws: dari IAM peran yang berisi TranslateReadOnly kebijakan yang dibuat pada langkah sebelumnya.

SDK for SAP ABAP - BTP edition

Siapkan otentikasi menggunakan SAP Credential Store. Untuk informasi selengkapnya, lihat Menggunakan SAP Credential Store.

Buka ABAP lingkungan Anda di browser web, dan arahkan ke aplikasi Konfigurasi Bisnis Kustom.

Pergi ke SDKProfil.
- Pilih Edit untuk membuat profil baru.
  - Profil:DEMO.
  - Keterangan:Demo profile.
Pilih tombol panah kanan di sebelah entri yang dibuat untuk menavigasi ke tab Otentikasi dan Pengaturan.

Pilih Entri Baru.
- SID: ID sistem dari SAP sistem yang Anda gunakan saat ini.
- Klien: Klien dari SAP sistem tempat Anda berada saat ini.
- ID Skenario: Daftar tarik-turun tempat Anda akan menemukan DEFAULT skenario yang dibuat oleh administrator Basis Anda.
- AWS Wilayah: masukkan AWS Wilayah tempat Anda ingin melakukan panggilan. Jika SAP sistem Anda berjalan AWS, masukkan AWS Wilayah yang sedang berjalan.
- Metode Otentikasi: Pilih Kredensial dari SAP Credential Store.
- Masukkan Namespace dan nama Kunci dari kredensial yang disimpan di Credentials Store. SAP
- Masukkan nama Pengaturan Komunikasi yang dibuat untuk menjalin komunikasi antara SDK for SAP ABAP - BTP edition dan SAP Credential Store.
- Biarkan IAMperan Nonaktifkan kosong.
Klik kanan pada tombol panah kanan di sebelah entri yang dibuat untuk menavigasi ke tab Pemetaan IAM Peran.

Pilih Entri Baru.
- Masukkan nomor Urutan: 010.
- Masukkan IAMperan Logis:TESTUSER.
- Masukkan IAMRole ARN: masukkan arn:aws: dari IAM peran yang berisi TranslateReadOnly kebijakan yang dibuat pada langkah sebelumnya.

Langkah 5: Otorisasi Pengguna SAP

SAPpengguna tidak diizinkan untuk menggunakan AWS fungsionalitas secara default. Pengguna harus diberi wewenang secara eksplisit menggunakan SAP otorisasi. Lihat tab berikut untuk lebih jelasnya.

SDK for SAP ABAP

Buat PFCG peran

Pergi ke transaksi PFCG
Masukkan nama peran ZAWS_SDK_DEMO_TESTUSER dan pilih Buat Peran Tunggal.
- Keterangan:Role for demo AWS SDK functionality.
- Buka tab Otorisasi.
- Pilih Ubah Data Otorisasi dan terima pop-up informasi.
- Pada pop-up Pilih Template, pilih Jangan pilih templat.
- Pilih Tambahkan Secara Manual dari bilah alat.
- Tambahkan objek otorisasi berikut:
  - /AWS1/LROL
  - /AWS1/SESS
- Di pohon otorisasi, masukkan:
  - Profil untuk mengakses AWSAPIs: DEMO
  - IAMPeran Logis: TESTUSER
- Pilih Simpan.
- Pilih Hasilkan.
- Pilih Kembali.
- Pilih Simpan untuk menyimpan peran.

Tetapkan PFCG peran ke pengguna SAP

Setiap pengguna yang memiliki ZAWS_SDK_DEMO_TESTUSER peran yang ditetapkan akan diberi wewenang untuk menggunakan AWS SDK fungsi dengan pengaturan yang dikonfigurasi di DEMO SDK profil. Pengguna yang berwenang juga akan menganggap IAM peran yang dipetakan ke IAM peran TESTUSER logis dalam profil itu.

Jalankan transaksiSU01.
- Masukkan ID pengguna SAP pengguna yang akan menguji AWS SDK fungsionalitas.
- Pilih Ubah.
- Buka tab Peran dan tetapkan ZAWS_SDK_DEMO_TESTUSER peran ke pengguna.
- Pilih Simpan.

SDK for SAP ABAP - BTP edition

Buat peran Bisnis

Buka ABAP lingkungan Anda di browser web, dan arahkan ke aplikasi Pertahankan Peran Bisnis.
Pilih Buat dari Template, dan masukkan detail berikut.
- Template - Pilih/AWS1/RT_BTP_ENDUSER.
- ID Peran Bisnis Baru - Masukkan ID.
- Deskripsi Peran Bisnis Baru — Masukkan deskripsi.
Pilih OK untuk melihat halaman untuk peran bisnis.
Di bawah tab Rincian Peran Umum, buka Kategori Akses, dan atur bidang Tulis, Baca, Nilai Bantuan sebagai Dibatasi.
Pilih Pertahankan Pembatasan, dan perluas Jenis Pembatasan yang Ditugaskan dari panel navigasi kiri. Perbarui bidang berikut di bagian Pembatasan dan Nilai.
- Di bawah Pilih SDK Sesi, pilih ikon pensil di sebelah SDKProfil, dan arahkan ke tab Ranges. MasukkanDEMO, dan pilih Tambah.
- Di bawah Pilih IAM Peran Logis, pilih ikon pensil di samping IAMPeran Logis, dan arahkan ke tab Ranges. MasukkanTESTUSER, dan pilih Tambah.
  
  Pilih ikon pensil di sebelah SDKProfil, dan arahkan ke tab Ranges. MasukkanDEMO, dan pilih Tambah
Arahkan kembali ke template Peran Bisnis, dan buka tab Pengguna Bisnis. Pilih Tambah untuk menetapkan Peran Bisnis yang baru dibuat ke pengguna SAP bisnis yang akan menguji SDK fungsionalitas. Pilih Simpan.

Setiap pengguna bisnis yang ditugaskan ke Peran Bisnis yang dibuat akan diberi wewenang untuk menggunakan AWS SDK fungsi dengan pengaturan yang dikonfigurasi di DEMO SDK profil. Pengguna yang berwenang juga akan menganggap IAM peran yang dipetakan ke IAM peran TESTUSER logis dalam profil itu.

Langkah 6: Tulis kodenya

Lihat tab berikut untuk lebih jelasnya.

SDK for SAP ABAP

Buka transaksiSE38.
- Masukkan ZDEMO_TRANSLATE_HELLO_WORLD sebagai nama program.
- Pilih Create.
- Masukkan AWS SDK Hello World In Any Language sebagai judul.
- Jenis: pilih Program yang Dapat Dieksekusi.
- Status: pilih Program Uji.
- Pilih Simpan.
- Simpan program sebagai Objek Lokal.

Tambahkan kode berikut.



*&---------------------------------------------------------------------*
*& Report  ZAWS1_DEMO_XL8_SIMPLE
*&
*&---------------------------------------------------------------------*
*& A simple demo of language translation with AWS Translate
*&
*&---------------------------------------------------------------------*
REPORT zaws1_demo_xl8_simple.

START-OF-SELECTION.
  PARAMETERS pv_text TYPE /aws1/xl8boundedlengthstring DEFAULT 'Hello, World' OBLIGATORY.

  PARAMETERS pv_lang1 TYPE languageiso DEFAULT 'EN' OBLIGATORY.
  PARAMETERS pv_lang2 TYPE languageiso DEFAULT 'ES' OBLIGATORY.

  TRY.
      DATA(go_session) = /aws1/cl_rt_session_aws=>create( 'DEMO' ).
      DATA(go_xl8)     = /aws1/cl_xl8_factory=>create( go_session ).
      DATA(lo_output) = go_xl8->translatetext(
           iv_text               = pv_text
           iv_sourcelanguagecode = CONV /aws1/xl8languagecodestring( pv_lang1 )
           iv_targetlanguagecode = CONV /aws1/xl8languagecodestring( pv_lang2 )
      ).

      WRITE: / 'Source Phrase: ', pv_text.
      WRITE: / 'Target Phrase: ', lo_output->get_translatedtext( ).
    CATCH /aws1/cx_xl8unsuppedlanguage00 INTO DATA(lo_lang).
      WRITE: / 'ERROR' COLOR COL_NEGATIVE,
               'Cannot translate from',
               lo_lang->sourcelanguagecode,
               'to',
               lo_lang->targetlanguagecode.
    CATCH cx_root INTO DATA(lo_root).
      WRITE: / 'ERROR' COLOR COL_NEGATIVE, lo_root->get_text( ).
  ENDTRY.

SDK for SAP ABAP - BTP edition

Klik kanan pada paket di mana ABAP kelas perlu dibuat, lalu pilih New > ABAPclass.
Masukkan ZCL_DEMO_XL8_SIMPLE nama Kelas, dan tambahkan deskripsi Kelas. Pilih Selanjutnya.
Buat atau pilih permintaan transportasi. Pilih Selesai.

Tambahkan kode berikut.


CLASS zcl_demo_xl8_simple DEFINITION
  PUBLIC
  FINAL
  CREATE PUBLIC .

  PUBLIC SECTION.
    INTERFACES if_oo_adt_classrun.
  PROTECTED SECTION.
  PRIVATE SECTION.
ENDCLASS.


CLASS zcl_demo_xl8_simple IMPLEMENTATION.
  METHOD if_oo_adt_classrun~main.

    TRY.
        " input parameters
        DATA(pv_text) = |Hello, World|.
        DATA(pv_lang1) = |EN|.
        DATA(pv_lang2) = |ES|.

        DATA(go_session) = /aws1/cl_rt_session_aws=>create( 'DEMO' ).
        DATA(go_xl8)     = /aws1/cl_xl8_factory=>create( go_session ).
        DATA(lo_output) = go_xl8->translatetext(
             iv_text               = pv_text
             iv_sourcelanguagecode = pv_lang1
             iv_targetlanguagecode = pv_lang2
        ).

        out->write( |Source Phrase: { pv_text }| ).
        out->write( |Target Phrase: { lo_output->get_translatedtext( ) }| ).
      CATCH /aws1/cx_xl8unsuppedlanguage00 INTO DATA(lo_lang).
        out->write( |ERROR - Cannot translate from { lo_lang->sourcelanguagecode } to { lo_lang->targetlanguagecode }| ).
      CATCH cx_root INTO DATA(lo_root).
        out->write( |ERROR - { lo_root->get_text( ) }| ).
    ENDTRY.
  ENDMETHOD.
ENDCLASS.

Untuk detail tentang cara menulis ABAP kode yang menggunakan kodeSDK, lihat Menggunakan AWS SDK untuk SAP ABAP.

Langkah 7: Jalankan aplikasi

Lihat tab berikut untuk lebih jelasnya.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Apa itu AWS SDK untuk SAP ABAP?

Mengatur