の開始方法AWS SDK for SAP ABAP

SDK for SAP ABAP のトランスポートを SAP システムにインポートします。トランスポートは任意のクライアントにインポートできます。詳細については、「 SDK for SAP ABAP のインストール」を参照してください。

Deploy Product アプリケーションを使用して SDK for SAP ABAP - BTP Edition をインストールします。詳細については、「 SDK for SAP ABAP - BTP エディションのインストール」を参照してください。

/AWS1/IMG トランザクションを実行して、 SDK for SAP ABAP の実装ガイドを開きます。このトランザクションを実行するには、SAP システムのコマンドバーに /n/AWS1/IMG と入力し、[Enter] を選択します。

次の設定を完了します。

オンプレミスシステムの前提条件

SAP システムがオンプレミスまたは別のクラウドで実行されている場合、認証情報は SAP データベースに保存する必要があります。認証情報は SAP SSF を使用して暗号化されるため、SAP の CommonCryptoLib などの設定済みの暗号化ライブラリが必要です。

SDK for SAP ABAP 用に SSF を設定する手順は、/AWS1/IMG トランザクションで説明されています。

ウェブブラウザで ABAP 環境を開き、カスタムビジネス設定アプリケーションに移動します。

次の設定を完了します。

トランザクション (コマンドバー/n/AWS1/IMGに/AWS1/IMG 「」と入力し、「Enter」を選択します) を実行して AWSSDK の実装ガイドを開きます。

SAP 認証情報ストアを使用して認証を設定します。詳細については、「SAP 認証情報ストアの使用」を参照してください。

ウェブブラウザで ABAP 環境を開き、カスタムビジネス設定アプリケーションに移動します。

PFCG ロールを作成する

PFCG ロールを SAP ユーザーに割り当てる

ZAWS_SDK_DEMO_TESTUSER ロールが割り当てられているユーザーには、AWSSDK プロファイルで設定された設定で DEMO SDK 関数を使用する権限が付与されます。また、承認されたユーザーは、そのプロファイルの TESTUSER 論理 IAM ロールにマップされた IAM ロールも引き受けます。

ビジネスロールを作成する

作成されたビジネスロールに割り当てられたビジネスユーザーは、AWSSDK プロファイルで設定された設定で DEMO SDK 関数を使用する権限が付与されます。また、承認されたユーザーは、そのプロファイルの TESTUSER 論理 IAM ロールにマップされた IAM ロールも引き受けます。

次のコードを追加します。

*&---------------------------------------------------------------------*
*& 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.

次のコードを追加します。

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.

SE38 でアプリケーションを実行します。成功すると、次のような出力が表示されます。

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

認証、設定、または Basis の前提条件を満たしていない場合、エラーメッセージが表示されることがあります。次の例を参照してください。

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

SAP ロールで SDK プロファイルの使用と論理 IAM ロールへのマッピングが許可されているのに、SAP システムが IAM ロールを引き受けるように IAM 権限が設定されていない場合、次のような出力になります。

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

この場合は、ステップ 1: AWSアカウントを準備する で定義されている IAM ロール、ユーザー、またはその両方で IAM 権限と信頼設定を確認してください。

Eclipse > Run As > ABAP Application (コンソール) でアプリケーションを実行します。成功すると、次のような出力が表示されます。

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

認証、設定、または Basis の前提条件を満たしていない場合、エラーメッセージが表示されることがあります。次の例を参照してください。

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

SAP ロールで SDK プロファイルの使用と論理 IAM ロールへのマッピングが許可されているのに、SAP システムが IAM ロールを引き受けるように IAM 権限が設定されていない場合、次のような出力になります。

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

この場合は、ステップ 1: AWSアカウントを準備する で定義されている IAM ロール、ユーザー、またはその両方で IAM 権限と信頼設定を確認してください。