

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erste Schritte mit AWS SDK für SAP ABAP
<a name="getting-started"></a>

In diesem Abschnitt werden die ersten Schritte mit dem SDK beschrieben. Er enthält Informationen zur Installation des SDK, zur Durchführung der Grundkonfiguration und zum Erstellen eines Hello World-Codebeispiels, das eine Phrase von einer Sprache in eine andere übersetzt. Wenn Sie mit AWS SDK noch nicht vertraut sind, empfehlen wir, diese Schritte in einer Sandbox-Umgebung durchzuführen.

**Topics**
+ [Schritt 1: Bereiten Sie Ihr AWS Konto vor](#prepare-account)
+ [Schritt 2: Installieren Sie das SDK](#installation-sdk)
+ [Schritt 3: Konfigurieren Sie das SDK](#configure)
+ [Schritt 4: Funktionaler Aufbau](#functional-setup)
+ [Schritt 5: SAP-Benutzer autorisieren](#authorize-users)
+ [Schritt 6: Schreiben Sie den Code](#write-code)
+ [Schritt 7: Führen Sie die Anwendung aus](#run-application)

## Schritt 1: Bereiten Sie Ihr AWS Konto vor
<a name="prepare-account"></a>

Um mit dem SDK für SAP ABAP beginnen zu können, benötigen Sie ein aktives AWS-Konto . Sie benötigen ein Event, AWS-Konto wenn Ihr SAP-System vor Ort, auf der SAP Business Technology Platform (BTP) oder bei einem anderen Cloud-Anbieter gehostet wird.

Wenn Ihr SAP-System in der AWS Cloud läuft, rufen Sie AWS Dienste in Ihrem auf. AWS-Konto

**Topics**
+ [IAM-Rolle für SAP-Benutzer](#iamrole)
+ [Authentifizierung](#authentication)

### IAM-Rolle für SAP-Benutzer
<a name="iamrole"></a>
+ Erstellen Sie eine IAM-Rolle mit den Anweisungen im *AWS Identity and Access Management Benutzerhandbuch*. Weitere Informationen finden Sie unter [Eine Rolle zum Delegieren von Berechtigungen für einen AWS Dienst erstellen](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html). Notieren Sie sich den Amazon-Ressourcennamen (ARN) der IAM-Rolle für die spätere Verwendung.
+ Wählen Sie Amazon EC2 als Anwendungsfall aus.
+ Verwenden Sie `SapDemoTranslate` es als Namen der Rolle.
+ Hängen Sie das `TranslateReadOnly` Profil an die Rolle an.
+ Die Rolle muss die folgenden Entitäten haben, damit das SAP-System die Rolle übernehmen kann. Ersetzen Sie `{{"111122223333"}}` durch Ihre AWS -Kontonummer.

------
#### [ JSON ]

****  

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

------

  Dieses Beispiel zeigt, dass jeder Principal von die Rolle übernehmen AWS-Konto `{{"111122223333"}}` kann. Dies ist eine umfassende Genehmigung, die für geeignet ist proof-of-concept. Sie können für die Produktion ein engeres Prinzip verwenden, z. B. in den folgenden Beispielen.
  + Ein bestimmter Benutzer — wenn das SAP-System eine der folgenden Optionen verwendet:
    + SSF-verschlüsselte Anmeldeinformationen von einem lokalen SAP-System
    + Anmeldeinformationen vom SAP Credential Store-Dienst in der SAP BTP-, ABAP-Umgebung
  + Eine bestimmte Rolle — wenn sich das SAP-System auf Amazon EC2 befindet und es ein Instance-Profil gibt.
  + Amazon EC2 — wenn sich das SAP-System auf Amazon EC2 befindet und es *kein* Instance-Profil gibt.

Weitere Informationen finden Sie unter [Bewährte Methoden für IAM-Sicherheit](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/best-practices.html).

### Authentifizierung
<a name="authentication"></a>

Die Authentifizierung hängt davon ab, wo Ihr SAP-System gehostet wird.

**Topics**
+ [In der AWS Cloud](#aws-cloud)
+ [Lokal, SAP BTP oder eine andere Cloud](#on-premises-other)

#### In der AWS Cloud
<a name="aws-cloud"></a>

Stellen Sie sicher, dass die EC2-Instanz, auf der Ihr SAP-System läuft, über ein Instanzprofil mit den folgenden Berechtigungen verfügt.

------
#### [ JSON ]

****  

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

------

Fügen Sie den ARN hinzu, den Sie im vorherigen Schritt notiert haben.

Diese Berechtigung ermöglicht es Ihrem SAP-System, die `SapDemoTranslate` Rolle im Namen des ABAP-Benutzers zu übernehmen. 

#### Lokal, SAP BTP oder eine andere Cloud
<a name="on-premises-other"></a>

Wenn sich Ihr SAP-System vor Ort, auf SAP BTP oder in einer anderen Cloud befindet, gehen Sie wie folgt vor, um eine Verbindung für die Authentifizierung mithilfe eines geheimen Zugriffsschlüssels herzustellen.

1. Erstellen Sie einen IAM-Benutzer. Weitere Informationen finden Sie unter [IAM-Benutzer erstellen (](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console)Konsole).

1. Verwenden Sie `SapDemoSID` ihn als Namen des IAM-Benutzers. `SID`ist die System-ID Ihres SAP-Systems.

1. Weisen Sie diesem Benutzer `SapDemoTranslate` eine Rolle zu.

Behalten Sie das `access_key` und bei`secret_access_key`. Sie müssen diese Anmeldeinformationen in Ihrem SAP-System konfigurieren.

**Anmerkung**  
Wenn sich Ihr SAP-System vor Ort, auf SAP BTP oder in einer anderen Cloud befindet, können Sie sich mit einer der folgenden Optionen authentifizieren.  
[Authentifizierung mit geheimer Zugriffsschlüssel](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/system-authentication.html#key-authentication) mithilfe von SSF oder SAP Credential Store
[Verwendung von Zertifikaten mit IAM Roles Anywhere](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/using-iam.html)

## Schritt 2: Installieren Sie das SDK
<a name="installation-sdk"></a>

Installationsanweisungen finden Sie auf den folgenden Registerkarten.

------
#### [ SDK for SAP ABAP ]

Importieren Sie das SDK für SAP-ABAP-Transporte in Ihr SAP-System. Sie können die Transporte in jeden Client importieren. Weitere Informationen finden Sie unter [SDK für SAP ABAP installieren](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/installation.html).

------
#### [ SDK for SAP ABAP - BTP edition ]

Installieren Sie das SDK für SAP ABAP — BTP Edition mithilfe der **Deploy** Product-Anwendung. Weitere Informationen finden Sie unter [SDK für SAP ABAP installieren —](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/installation-btp.html) BTP Edition.

------

## Schritt 3: Konfigurieren Sie das SDK
<a name="configure"></a>

Stellen Sie vor der Konfiguration des SDK sicher, dass Sie über die erforderlichen Autorisierungen verfügen. Weitere Informationen finden Sie unter [SAP-Autorisierungen](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/authorizations.html).

Anweisungen zur Konfiguration finden Sie auf den folgenden Registerkarten.

------
#### [ SDK for SAP ABAP ]

Führen Sie die `/AWS1/IMG` Transaktion aus, um den Implementierungsleitfaden für SDK for SAP ABAP zu öffnen. Um diese Transaktion auszuführen, geben Sie `/n/AWS1/IMG ` in die Befehlsleiste Ihres SAP-Systems ein und wählen Sie dann **Enter**.

Vervollständigen Sie die folgenden Konfigurationen.
+ Gehen Sie zu den **technischen Voraussetzungen**.
  + Lesen Sie die empfohlenen [Parameter](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#parameters) und die [HTTPS-Konnektivität](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#https-connectivity).
+ Gehen Sie zu **Allgemeine Einstellungen** → **Szenarien konfigurieren**.
  + Ändern Sie die Einstellungen gemäß den Empfehlungen in den [globalen Einstellungen](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html).
+ Gehen Sie zu **Allgemeine Einstellungen** → **Technische Einstellungen**.
  + Ändern Sie die Einstellungen gemäß den Empfehlungen in den [Allgemeinen Einstellungen](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html).
+ Gehen Sie zu **Runtime Settings** → **Log And Trace**.
  + Wählen Sie **Neue Einträge** aus.
    + **Trace-Ebene**: Keine Ablaufverfolgung.
    + **Maximale Anzahl an Dump-Leitungen**:`100`.
    + **OPT-IN: Enh-Telemetrie**: Lassen Sie dieses Feld leer.
  + Wählen Sie **Speichern** aus.
+ **Gehen Sie zu **Laufzeiteinstellungen** → Aktives Szenario.**
  + Wählen Sie unter **Neues Szenario** die Option aus`DEFAULT`.
  + Wählen Sie **Szenarioänderung** übernehmen aus.
  + Akzeptieren Sie die Aufforderung.

 **Voraussetzungen für lokale Systeme** 

Wenn Ihr SAP-System lokal oder in einer anderen Cloud ausgeführt wird, müssen die Anmeldeinformationen in Ihrer SAP-Datenbank gespeichert werden. Die Anmeldeinformationen werden mit SAP SSF verschlüsselt und erfordern eine konfigurierte kryptografische Bibliothek, z. B. die von SAP. CommonCryptoLib

Die Schritte zur Konfiguration von SSF für SDK für SAP ABAP werden in der Transaktion beschrieben. `/AWS1/IMG`

**Anmerkung**  
 Die vorstehende Voraussetzung gilt nicht, wenn Ihr SAP-System auf Amazon EC2 läuft. SAP-Systeme, die auf Amazon EC2 laufen, rufen kurzlebige, automatisch rotierende Anmeldeinformationen aus den Amazon EC2 EC2-Instance-Metadaten ab.

------
#### [ SDK for SAP ABAP - BTP edition ]

Öffnen Sie Ihre ABAP-Umgebung in einem Webbrowser und navigieren Sie zur Anwendung Custom Business Configurations.

Vervollständigen Sie die folgenden Konfigurationen.
+ Gehen Sie zu **Szenarien konfigurieren**.
  + Ändern Sie die Einstellungen gemäß den Empfehlungen unter [Allgemeine Einstellungen](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html).
+ Gehen Sie zu den **technischen Einstellungen**.
  + Ändern Sie die Einstellungen gemäß den Empfehlungen in den [Allgemeinen Einstellungen](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/global-settings.html).

------

## Schritt 4: Funktionaler Aufbau
<a name="functional-setup"></a>

Anweisungen zur Einrichtung finden Sie auf den folgenden Tabs.

------
#### [ SDK for SAP ABAP ]

Führen Sie die Transaktion aus `/AWS1/IMG` (geben Sie die Eingabe `/n/AWS1/IMG` in die Befehlsleiste ein und wählen Sie die **Eingabetaste**), um den Implementierungsleitfaden für das AWS SDK zu öffnen.
+ Gehen Sie zu **Anwendungskonfiguration** → **SDK-Profil**.
  + Wählen Sie **Neue Einträge** aus.
    + **Profil**:`DEMO`.
    + **Beschreibung**:`Demo profile`.
    + Wählen Sie **Speichern** aus.
+ Markieren Sie den Eintrag, den Sie erstellt haben, und klicken Sie auf den Baumzweig **Authentifizierung und Einstellungen**.
  + Wählen Sie **Neue Einträge** aus.
    + **SID**: Die System-ID des SAP-Systems, in dem Sie sich gerade befinden.
    + **Kunde**: Der Client des SAP-Systems, in dem Sie sich gerade befinden.
    + **Szenario-ID**: Die Dropdownliste, in der Sie das von Ihrem Basis-Administrator erstellte DEFAULT-Szenario finden.
    + **AWS Region**: Geben Sie die AWS Region ein, in die Sie telefonieren möchten. Wenn Ihr SAP-System läuft AWS, geben Sie die AWS Region ein, in der es läuft.
    + Authentifizierungsmethode:
      + Wählen Sie **Instanzrolle über Metadaten** aus, wenn Ihr SAP-System auf Amazon EC2 läuft.
      + Wählen Sie **Credentials from SSF Storage** aus, wenn Ihr SAP-System lokal oder in einer anderen Cloud läuft.
        + Wählen Sie Anmeldeinformationen **festlegen** aus.
        + Geben Sie die Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel ein, die Sie im vorherigen Schritt erstellt haben.
  + Lassen Sie das Feld **„IAM-Rollen deaktivieren**“ leer.
  + Wählen Sie **Speichern** aus.
+ Klicken Sie auf den Baumzweig „**IAM Role Mapping**“. 
  + Wählen Sie **Neue Einträge** aus.
    + Geben Sie die **Sequenznummer** ein: 010.
    + Geben Sie die **logische IAM-Rolle** ein: TESTUSER.
    + Geben Sie den **ARN für die IAM-Rolle** ein: Geben Sie arn:aws: der IAM-Rolle ein, die die im vorherigen Schritt erstellte `TranslateReadOnly` Richtlinie enthält.

------
#### [ SDK for SAP ABAP - BTP edition ]

Richten Sie die Authentifizierung mithilfe des SAP Credential Store ein. Weitere Informationen finden Sie unter [SAP Credential Store verwenden](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/credential-store.html).

Öffnen Sie Ihre ABAP-Umgebung in einem Webbrowser und navigieren Sie zur Anwendung Custom Business Configurations. 
+ Gehen Sie zu **SDK-Profil**.
  + Wählen Sie **Bearbeiten** aus, um ein neues Profil zu erstellen.
    + **Profil**:`DEMO`.
    + **Beschreibung**:`Demo profile`.
+ Wählen Sie die Rechtspfeiltaste neben dem erstellten Eintrag, um zur Registerkarte **Authentifizierung und Einstellungen** zu navigieren.

  Wählen Sie **Neue Einträge** aus.
  + **SID**: Die System-ID des SAP-Systems, in dem Sie sich gerade befinden.
  + **Kunde**: Der Client des SAP-Systems, in dem Sie sich gerade befinden.
  + **Szenario-ID**: Die Dropdownliste, in der Sie das von Ihrem Basis-Administrator erstellte DEFAULT-Szenario finden.
  + **AWS Region**: Geben Sie die AWS Region ein, in die Sie telefonieren möchten. Wenn Ihr SAP-System läuft AWS, geben Sie die AWS Region ein, in der es läuft.
  + Authentifizierungsmethode: Wählen Sie **Anmeldeinformationen aus dem SAP Credential Store** aus.
  + Geben Sie den **Namespace** und den **Schlüsselnamen** der im SAP Credentials Store gespeicherten Anmeldeinformationen ein.
  + Geben Sie den Namen der **Kommunikationsvereinbarung** ein, die erstellt wurde, um die Kommunikation zwischen SDK for SAP ABAP — BTP Edition und SAP Credential Store herzustellen.
  + Lassen Sie das Feld **„IAM-Rollen deaktivieren**“ leer.
+ Klicken Sie mit der rechten Maustaste auf den Rechtspfeil neben dem erstellten Eintrag, um zur Registerkarte **IAM-Rollenzuweisung** zu navigieren. 

  Wählen Sie **Neue Einträge** aus.
  + Geben Sie die **Sequenznummer** ein: 010.
  + Geben Sie die **logische IAM-Rolle** ein: TESTUSER.
  + Geben Sie den **ARN für die IAM-Rolle** ein: Geben Sie arn:aws: der IAM-Rolle ein, die die im vorherigen Schritt erstellte `TranslateReadOnly` Richtlinie enthält.

------

## Schritt 5: SAP-Benutzer autorisieren
<a name="authorize-users"></a>

SAP-Benutzer sind standardmäßig nicht berechtigt, AWS Funktionen zu verwenden. Die Benutzer müssen explizit mithilfe von SAP-Autorisierungen autorisiert werden. Weitere Informationen finden Sie auf den folgenden Registerkarten.

------
#### [ SDK for SAP ABAP ]

**Erstellen Sie eine PFCG-Rolle**
+ Gehe zur Transaktion `PFCG`
+ Geben Sie den Rollennamen ein `ZAWS_SDK_DEMO_TESTUSER` und wählen Sie **Einzelne Rolle erstellen** aus.
  + **Beschreibung**:`Role for demo AWS SDK functionality`.
  + Gehen Sie zur Registerkarte **Autorisierungen**.
  + Wählen Sie **Autorisierungsdaten ändern** aus und akzeptieren Sie das Informations-Popup. 
  + *Wählen Sie im Popup-Fenster „Vorlage* auswählen“ die Option **Keine Vorlagen auswählen aus**. 
  + Wählen Sie in der Werkzeugleiste die Option **Manuell hinzufügen** aus.
  +  Fügen Sie die folgenden Autorisierungsobjekte hinzu: 
    +  `/AWS1/LROL` 
    +  `/AWS1/SESS` 
  +  Geben Sie im Autorisierungsbaum Folgendes ein: 
    +  Profil für den Zugriff auf AWS APIs: `DEMO`
    +  Logische IAM-Rolle: `TESTUSER` 
  + Wählen Sie **Speichern** aus.
  + Wählen Sie **Generieren** aus.
  + Wählen Sie **Zurück** aus.
  + Wählen Sie **Speichern** aus, um die Rolle zu speichern.

**Weisen Sie SAP-Benutzern die PFCG-Rolle zu**

Jeder Benutzer, dem die `ZAWS_SDK_DEMO_TESTUSER` Rolle zugewiesen wurde, ist berechtigt, AWS SDK-Funktionen mit den im `DEMO` SDK-Profil konfigurierten Einstellungen zu verwenden. Der autorisierte Benutzer übernimmt außerdem die IAM-Rolle, die der `TESTUSER` logischen IAM-Rolle in diesem Profil zugeordnet ist.
+ Transaktion ausführen. `SU01`
  + Geben Sie die Benutzer-ID eines SAP-Benutzers ein, der die AWS SDK-Funktionalität testen wird. 
  + Wählen Sie **Ändern** aus.
  + Gehen Sie zur Registerkarte **Rollen** und weisen Sie dem Benutzer `ZAWS_SDK_DEMO_TESTUSER` eine Rolle zu.
  + Wählen Sie **Speichern** aus.

------
#### [ SDK for SAP ABAP - BTP edition ]

**Erstellen Sie eine Geschäftsrolle**
+ Öffnen Sie Ihre ABAP-Umgebung in einem Webbrowser und navigieren Sie zur Anwendung **Maintain Business Roles**. 
+ Wählen Sie **Aus Vorlage erstellen** und geben Sie die folgenden Details ein.
  + **Vorlage** — Wählen Sie`/AWS1/RT_BTP_ENDUSER`.
  + **Neue Geschäftsrollen-ID** — Geben Sie eine ID ein.
  + **Beschreibung der neuen Geschäftsrolle** — Geben Sie eine Beschreibung ein.
+ Wählen Sie **OK** aus, um die Seite für die Geschäftsrolle aufzurufen.
+ Gehen Sie auf der Registerkarte **Allgemeine Rollendetails** zu **Zugriffskategorien** und legen Sie für das Feld **Hilfe zum Schreiben, Lesen und Werten** die Option **Eingeschränkt** fest.
+ Wählen Sie **Einschränkungen beibehalten** aus und erweitern Sie im linken Navigationsbereich die Option **Zugewiesene Einschränkungstypen**. Aktualisieren Sie das folgende Feld im Abschnitt „**Einschränkungen und Werte**“.
  + **Wählen Sie unter SDK-Sitzung** auswählen das Stiftsymbol neben **SDK-Profil** aus und wechseln Sie zur Registerkarte **Bereiche**. Geben Sie ein `DEMO` und wählen Sie **Hinzufügen** aus.
  + **Wählen Sie unter Logische IAM-Rolle** auswählen das Stiftsymbol neben **Logische IAM-Rolle** aus und navigieren Sie zur Registerkarte **Bereiche**. **Geben Sie ein `TESTUSER` und wählen Sie Hinzufügen aus.**

    Wählen Sie das Stiftsymbol neben **SDK-Profil** aus und navigieren Sie zur Registerkarte **Bereiche**. Geben Sie `DEMO` ein und wählen Sie **Hinzufügen**
+ Gehen Sie zurück zur Vorlage für Geschäftsrollen und öffnen Sie die Registerkarte **Geschäftsbenutzer**. Wählen Sie **Hinzufügen** aus, um die neu erstellte Geschäftsrolle einem SAP-Geschäftsbenutzer zuzuweisen, der die SDK-Funktionalität testen wird. Wählen Sie **Speichern** aus.

Jeder Geschäftsbenutzer, der der erstellten Geschäftsrolle zugewiesen ist, ist berechtigt, AWS SDK-Funktionen mit den im `DEMO` SDK-Profil konfigurierten Einstellungen zu verwenden. Der autorisierte Benutzer übernimmt außerdem die IAM-Rolle, die der `TESTUSER` logischen IAM-Rolle in diesem Profil zugeordnet ist.

------

## Schritt 6: Schreiben Sie den Code
<a name="write-code"></a>

Weitere Informationen finden Sie auf den folgenden Registerkarten.

------
#### [ SDK for SAP ABAP ]

1. Transaktion öffnen`SE38`.
   + Geben Sie `ZDEMO_TRANSLATE_HELLO_WORLD` als Programmnamen ein. 
   + Wählen Sie `Create`.
   + Geben Sie `AWS SDK Hello World In Any Language` als Titel ein. 
   + Typ: Wählen Sie **Ausführbares Programm**.
   + Status: Wählen Sie **Testprogramm**.
   + Wählen Sie **Speichern** aus.
   + Speichern Sie das Programm als **lokales Objekt**.

**Fügen Sie den folgenden Code** hinzu.

```
*&---------------------------------------------------------------------*
*& 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. Klicken Sie mit der rechten Maustaste auf das Paket, in dem die ABAP-Klasse erstellt werden muss, und wählen Sie dann **Neu** > **ABAP-Klasse**.

1. Geben Sie `ZCL_DEMO_XL8_SIMPLE` Klassenname ein und fügen Sie eine Klassenbeschreibung hinzu. Klicken Sie auf **Weiter**.

1. Erstellen Sie eine Transportanfrage oder wählen Sie eine aus. Wählen Sie **Fertig stellen** aus.

**Fügen Sie den folgenden Code** hinzu.

```
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.
```

------

Einzelheiten zum Schreiben von ABAP-Code, der das SDK verwendet, finden Sie unter [Verwenden AWS SDK für SAP ABAP](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/using-sdk.html).

## Schritt 7: Führen Sie die Anwendung aus
<a name="run-application"></a>

Weitere Informationen finden Sie auf den folgenden Registerkarten.

------
#### [ SDK for SAP ABAP ]

Führen Sie die Anwendung in aus`SE38`. Wenn dies erfolgreich ist, wird das Folgende Ihre Ausgabe sein.

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

Wenn Ihnen Autorisierungen, Konfigurationen oder Basisvoraussetzungen fehlen, wird möglicherweise eine Fehlermeldung angezeigt. Sehen Sie sich das folgende Beispiel an.

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

Wenn Ihre SAP-Rolle Sie autorisiert, ein SDK-Profil zu verwenden und es einer logischen IAM-Rolle zuzuordnen, obwohl Ihre IAM-Berechtigungen nicht so konfiguriert sind, dass das SAP-System die IAM-Rolle übernimmt, erhalten Sie Folgendes.

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

Überprüfen Sie in diesem Fall Ihre IAM-Berechtigungen und die Vertrauenskonfiguration für die IAM-Rollen, Benutzer oder beides, die in definiert sind. [Schritt 1: Bereiten Sie Ihr AWS Konto vor](#prepare-account)

------
#### [ SDK for SAP ABAP - BTP edition ]

Führen Sie die Anwendung auf **Eclipse** > **Ausführen als** > **ABAP-Anwendung (**Konsole) aus. Wenn dies erfolgreich ist, wird das Folgende Ihre Ausgabe sein.

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

Wenn Ihnen Autorisierungen, Konfigurationen oder Basisvoraussetzungen fehlen, wird möglicherweise eine Fehlermeldung angezeigt. Sehen Sie sich das folgende Beispiel an.

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

Wenn Ihre SAP-Rolle Sie autorisiert, ein SDK-Profil zu verwenden und es einer logischen IAM-Rolle zuzuordnen, obwohl Ihre IAM-Berechtigungen nicht so konfiguriert sind, dass das SAP-System die IAM-Rolle übernimmt, erhalten Sie Folgendes.

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

Überprüfen Sie in diesem Fall Ihre IAM-Berechtigungen und die Vertrauenskonfiguration für die IAM-Rollen, Benutzer oder beides, die in definiert sind. [Schritt 1: Bereiten Sie Ihr AWS Konto vor](#prepare-account)

------