View a markdown version of this page

Memulai dengan AWS SDK for SAP ABAP - AWS SDK for SAP ABAP
Mendaftar untuk Akun AWSLangkah 1: Persiapkan AWS akunLangkah 2: Instal SDKLangkah 3: Konfigurasikan SDKLangkah 4: Pengaturan fungsionalLangkah 5: Otorisasi Pengguna SAPLangkah 6: Tulis kodeLangkah 7: Jalankan aplikasi

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memulai dengan AWS SDK for SAP ABAP

Bagian ini menjelaskan cara memulai dengan SDK. Ini mencakup informasi tentang menginstal SDK, melakukan konfigurasi dasar, dan membuat contoh kode Hello World yang menerjemahkan frasa dari satu bahasa ke bahasa lain. Jika Anda baru mengenal AWS SDK, sebaiknya lakukan langkah-langkah ini di lingkungan sandbox.

Mendaftar untuk Akun AWS

Untuk memulainya AWS, Anda membutuhkan Akun AWS. Untuk informasi tentang membuat Akun AWS, lihat Mem ulai dengan an Akun AWS di Panduan AWS Account Management Referensi.

Langkah 1: Persiapkan AWS akun

Untuk memulai dengan SDK untuk SAP ABAP, Anda harus memiliki yang aktif Akun AWS . Anda memerlukan sistem Akun AWS meskipun sistem SAP Anda di-host di lokasi, di SAP Business Technology Platform (BTP) atau dengan penyedia cloud lain.

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

Peran IAM untuk pengguna SAP

  • Buat peran IAM dengan instruksi yang disediakan dalam Panduan AWS Identity and Access Management Pengguna. Untuk informasi selengkapnya, lihat Membuat peran untuk mendelegasikan izin ke AWS layanan. Perhatikan Nama Sumber Daya Amazon (ARN) dari peran IAM 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 sistem SAP untuk mengambil peran. Ganti "111122223333" dengan nomor akun AWS Anda.

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "sts:AssumeRole"
            ],
            "Principal": {
                "AWS": "111122223333"
            }
        }
    ]
}

    Contoh ini menunjukkan bahwa setiap kepala sekolah dari Akun AWS "111122223333" dapat mengambil peran tersebut. Ini adalah izin luas yang cocok untuk pembuktian konsep. Anda dapat menggunakan prinsip yang lebih sempit untuk produksi, seperti contoh berikut.

    • Pengguna tertentu - ketika sistem SAP menggunakan salah satu dari berikut ini:

      • SSF-encrypted kredenSIAL dari sistem SAP lokal

      • Kredensi dari layanan SAP Credential Store pada lingkungan SAP BTP, ABAP

    • Peran khusus - ketika sistem SAP ada di Amazon EC2 dan ada profil instance.

    • Amazon EC2 — ketika sistem SAP ada di Amazon EC2 dan tidak ada profil instans.

Untuk informasi selengkapnya, lihat Praktik terbaik untuk Keamanan IAM.

Autentikasi

Otentikasi tergantung di mana sistem SAP Anda dihosting.

Pada AWS Cloud

Pastikan instans EC2 tempat sistem SAP Anda berjalan memiliki profil instance dengan izin berikut.

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

Tambahkan ARN yang Anda catat pada langkah sebelumnya.

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

On-premises, SAP BTP atau cloud lainnya

Jika sistem SAP Anda terletak di lokasi, di SAP BTP atau di cloud lain, gunakan langkah-langkah berikut untuk membuat koneksi untuk otentikasi menggunakan kunci akses rahasia.

  1. Buat pengguna IAM. Untuk informasi selengkapnya, lihat Membuat pengguna IAM (konsol).

  2. Gunakan SapDemoSID sebagai nama pengguna IAM. SIDadalah ID sistem sistem sistem SAP Anda.

  3. Tetapkan SapDemoTranslate peran untuk pengguna ini.

Pertahankan access_key dansecret_access_key. Anda harus mengonfigurasi kredenSIAL ini di sistem SAP Anda.

catatan

Jika sistem SAP Anda terletak di lokasi, di SAP BTP atau di cloud lain, Anda dapat mengotentikasi menggunakan salah satu opsi berikut.

Langkah 2: Instal SDK

Lihat tab berikut untuk petunjuk pemasangan.

SDK for SAP ABAP

Impor SDK untuk transportasi SAP ABAP di sistem SAP Anda. Anda dapat mengimpor transportasi ke klien mana pun. Untuk informasi selengkapnya, lihat Menginstal SDK untuk SAP ABAP.

SDK for SAP ABAP - BTP edition

Instal SDK untuk SAP ABAP - edisi BTP menggunakan aplikasi Deploy Produc t. Untuk informasi selengkapnya, lihat Menginstal SDK untuk SAP ABAP - edisi BTP.

Langkah 3: Konfigurasikan SDK

Sebelum mengkonfigurasi SDK, pastikan Anda memiliki otorisasi yang diperlukan. Untuk informasi selengkapnya, lihat otorisasi SAP.

Lihat tab berikut untuk petunjuk konfigurasi.

SDK for SAP ABAP

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

Lengkapi konfigurasi berikut.

  • Pergi ke Pr asyarat Teknis.

  • Buka Pengaturan Global → Konfigurasi Skenario.

  • Buka Pengaturan Global → Peng aturan Teknis.

  • Buka Pengaturan Runtime → Log And Trace.

    • Pilih Entri Baru.

      • Tingkat jejak: Tidak Ada Jejak.

      • Garis Pembuangan Maksimum:100.

      • OPT-IN: enh telemetri: Kosongkan ini.

    • Pilih Simpan.

  • Buka Pengaturan Runtime → Skenario Aktif.

    • Di bawah Skenario Baru, pilihDEFAULT.

    • Pilih Kom it Perubahan Skenario.

    • Terima prompt.

Prasyarat untuk On-Premises Sistem

Jika sistem SAP Anda berjalan di lokasi atau di cloud lain, maka kredenSIAL harus disimpan dalam database SAP Anda. KredenSIAL dienkripsi menggunakan SAP SSF dan memerlukan pustaka kriptografi yang dikonfigurasi, seperti SAP. CommonCryptoLib

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

catatan

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

SDK for SAP ABAP - BTP edition

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

Lengkapi konfigurasi berikut.

  • Pergi ke Konfigurasi Skenario.

  • Pergi ke Peng aturan Teknis.

Langkah 4: Pengaturan fungsional

Lihat tab berikut untuk petunjuk penyiapan.

SDK for SAP ABAP

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

  • Buka Konfigur asi Aplikasi → Profil SDK.

    • Pilih Entri Baru.

      • Profil:DEMO.

      • Deskripsi:Demo profile.

      • Pilih Simpan.

  • Sorot entri yang Anda buat dan klik cabang pohon O tentikasi Dan Pengaturan.

    • Pilih Entri Baru.

      • SID: ID sistem dari sistem SAP yang Anda gunakan saat ini.

      • Kli en: Klien dari sistem SAP yang Anda gunakan saat ini.

      • ID skenario: Daftar dropdown tempat Anda akan menemukan skenario DEFAULT yang dibuat oleh administrator Basis Anda.

      • AWS Wilayah: masukkan AWS Wilayah tempat Anda ingin melakukan panggilan. Jika sistem SAP Anda berjalan AWS, masukkan Wil AWS ayah tempat ia berjalan.

      • Metode otentikasi:

        • Pilih Peran Instance melalui Metadata jika sistem SAP Anda berjalan di Amazon EC2.

        • Pilih Kredensi dari Penyimpanan SSF jika sistem SAP Anda berjalan di lokasi atau di cloud lain.

          • Pilih Setel KredenSIAL.

          • Masukkan ID Kunci Akses dan Kunci Akses Rahasia yang Anda buat pada langkah sebelumnya.

    • Biarkan N onaktifkan peran IAM kosong.

    • Pilih Simpan.

  • Klik pada cabang pohon Pemetaan Peran IAM.

    • Pilih Entri Baru.

      • Masukkan nomor urut: 010.

      • Masukkan peran IAM logis: TESTUSER.

      • Masukkan Peran IAM ARN: masukkan arn:aws: dari peran IAM 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 lingkungan ABAP Anda di browser web, dan navigasikan ke aplikasi Konfigurasi Bisnis Kustom.

  • Buka Profil SDK.

    • Pilih Edit untuk membuat profil baru.

      • Profil:DEMO.

      • Deskripsi:Demo profile.

  • Pilih tombol panah kanan di sebelah entri yang dibuat untuk menavigasi ke tab O tentikasi dan Pengaturan.

    Pilih Entri Baru.

    • SID: ID sistem dari sistem SAP yang Anda gunakan saat ini.

    • Kli en: Klien dari sistem SAP yang Anda gunakan saat ini.

    • ID skenario: Daftar dropdown tempat Anda akan menemukan skenario DEFAULT yang dibuat oleh administrator Basis Anda.

    • AWS Wilayah: masukkan AWS Wilayah tempat Anda ingin melakukan panggilan. Jika sistem SAP Anda berjalan AWS, masukkan Wil AWS ayah tempat ia berjalan.

    • Metode Otentikasi: Pilih Kre denSIAL dari SAP Credential Store.

    • Masukkan Namespace dan nama K unci dari kredenSIAL yang disimpan di SAP Credentials Store.

    • Masukkan nama Pengaturan Komunikasi yang dibuat untuk membangun komunikasi antara SDK untuk SAP ABAP - edisi BTP dan SAP Credential Store.

    • Biarkan N onaktifkan peran IAM kosong.

  • Right-click pada tombol panah kanan di sebelah entri yang dibuat untuk menavigasi ke tab Pemetaan Peran IAM.

    Pilih Entri Baru.

    • Masukkan nomor urut: 010.

    • Masukkan peran IAM logis: TESTUSER.

    • Masukkan Peran IAM ARN: masukkan arn:aws: dari peran IAM yang berisi TranslateReadOnly kebijakan yang dibuat pada langkah sebelumnya.

Langkah 5: Otorisasi Pengguna SAP

Pengguna SAP tidak diizinkan untuk menggunakan AWS fungsionalitas secara default. Pengguna harus diberi otorisasi secara eksplisit menggunakan otorisasi SAP. Lihat tab berikut untuk detail selengkapnya.

SDK for SAP ABAP

Buat peran PFCG

  • Pergi ke transaksi PFCG

  • Masukkan nama peran ZAWS_SDK_DEMO_TESTUSER dan pilih Buat Peran Tunggal.

    • Deskripsi:Role for demo AWS SDK functionality.

    • Buka tab O torisasi.

    • Pilih Ubah Data O torisasi dan terima pop-up informasi.

    • Pada pop-up Pilih Template, pilih Jangan pilih templat.

    • Pilih Tambah Secara Manual dari toolbar.

    • Tambahkan objek otorisasi berikut:

      • /AWS1/LROL

      • /AWS1/SESS

    • Di pohon otorisasi, masukkan:

      • Profil untuk mengakses AWS API: DEMO

      • Peran IAM Logis: TESTUSER

    • Pilih Simpan.

    • Pilih Hasilkan.

    • Pilih Kembali.

    • Pilih Simpan untuk menyimpan peran.

Tetapkan peran PFCG ke pengguna SAP

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

  • Jalankan transaksiSU01.

    • Masukkan ID pengguna pengguna dari pengguna SAP yang akan menguji fungsionalitas AWS SDK.

    • Pilih Ubah.

    • Buka tab Per an dan tetapkan ZAWS_SDK_DEMO_TESTUSER peran kepada pengguna.

    • Pilih Simpan.

SDK for SAP ABAP - BTP edition

Buat peran Bisnis

  • Buka lingkungan ABAP Anda di browser web, dan navigasikan ke aplikasi Maintain Business Roles.

  • 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 Detail Peran Umum, buka Kategori Akses, dan atur bidang Tulis, Baca, Bantuan Nilai sebagai Ter batas.

  • Pilih Per tahankan Pembatasan, dan perluas Jenis Pembatasan yang Ditugaskan dari panel navigasi kiri. Perbarui bidang berikut di bagian Batasan dan Nilai.

    • Di bawah Pilih Sesi SDK, pilih ikon pensil di sebelah Profil SDK, dan arahkan ke tab Rentang. MasukkanDEMO, dan pilih Tam bah.

    • Di bawah Pilih Peran IAM Logis, pilih ikon pensil di sebelah Peran IAM Logis, dan arahkan ke tab Rent ang. MasukkanTESTUSER, dan pilih Tam bah.

      Pilih ikon pensil di sebelah Profil SDK, dan arahkan ke tab Rentang. MasukDEMO, dan pilih Tam bah

  • Arahkan kembali ke template Peran Bisnis, dan buka tab Pengguna Bisnis. Pilih Tambah untuk menetapkan Peran Bisnis yang baru dibuat ke pengguna bisnis SAP yang akan menguji fungsionalitas SDK. Pilih Simpan.

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

Langkah 6: Tulis kode

Lihat tab berikut untuk detail selengkapnya.

SDK for SAP ABAP

  1. 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 Tes.

    • 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

  1. Right-click pada paket tempat kelas ABAP perlu dibuat, lalu pilih New > kelas ABAP.

  2. Masukkan ZCL_DEMO_XL8_SIMPLE nama Kelas, dan tambahkan deskripsi Kelas. Pilih Selanjutnya.

  3. 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 kode ABAP yang menggunakan SDK, lihat Menggunakan AWS SDK for SAP ABAP.

Langkah 7: Jalankan aplikasi

Lihat tab berikut untuk detail selengkapnya.

SDK for SAP ABAP

Jalankan aplikasi diSE38. Jika berhasil, berikut ini akan menjadi output Anda.

Source Phrase: Hello, World
Target Phrase: Hola, mundo

Jika Anda kehilangan otorisasi, konfigurasi, atau prasyarat Dasar, Anda mungkin mendapatkan pesan kesalahan. Lihat contoh berikut ini.

ERROR Could not find configuration under profile DEMO with 
scenario DEFAULT for SBX:001

Jika peran SAP Anda mengizinkan Anda untuk menggunakan profil SDK dan memetakannya ke peran IAM logis sementara izin IAM Anda tidak dikonfigurasi untuk sistem SAP untuk mengambil peran IAM, berikut ini akan menjadi output Anda.

ERROR Could not assume role arn:aws:iam::111122223333:role/SapDemoTranslate

Dalam hal ini, tinjau izin IAM dan konfigurasi kepercayaan Anda pada peran IAM, pengguna, atau keduanya yang ditentukan dalam. Langkah 1: Persiapkan AWS akun

SDK for SAP ABAP - BTP edition

Jalankan aplikasi pada Eclipse > Run As > ABAP Application (Console). Jika berhasil, berikut ini akan menjadi output Anda.

Source Phrase: Hello, World
Target Phrase: Hola, mundo

Jika Anda kehilangan otorisasi, konfigurasi, atau prasyarat Dasar, Anda mungkin mendapatkan pesan kesalahan. Lihat contoh berikut ini.

ERROR Could not find configuration under profile DEMO with 
scenario DEFAULT for SBX:001

Jika peran SAP Anda mengizinkan Anda untuk menggunakan profil SDK dan memetakannya ke peran IAM logis sementara izin IAM Anda tidak dikonfigurasi untuk sistem SAP untuk mengambil peran IAM, berikut ini akan menjadi output Anda.

ERROR Could not assume role arn:aws:iam::111122223333:role/SapDemoTranslate

Dalam hal ini, tinjau izin IAM dan konfigurasi kepercayaan Anda pada peran IAM, pengguna, atau keduanya yang ditentukan dalam. Langkah 1: Persiapkan AWS akun