

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 安裝 適用於 SAP ABAP 的 AWS SDK
<a name="installation"></a>

**Topics**
+ [下載適用於 SAP ABAP 的 SDK](#download)
+ [驗證適用於 SAP ABAP 的 SDK 檔案 – *選用*](#verification)
+ [AWS SDK 傳輸](#transports)

## 下載適用於 SAP ABAP 的 SDK
<a name="download"></a>

從 **[https://sdk-for-sapabap.aws.amazon.com/awsSdkSapabapV1/release/abapsdk-LATEST.zip](https://sdk-for-sapabap.aws.amazon.com/awsSdkSapabapV1/release/abapsdk-LATEST.zip)：// **下載 SDK。

```
curl "https://sdk-for-sapabap.aws.amazon.com/awsSdkSapabapV1/release/abapsdk-LATEST.zip" -o "abapsdk-LATEST.zip"
```

下載完成時，建議您將下載的檔案解壓縮至目錄，例如 `/tmp/awssdk`。

## 驗證適用於 SAP ABAP 的 SDK 檔案 – *選用*
<a name="verification"></a>

驗證 SDK 檔案簽章的這個選用步驟可協助您確認 SDK 未遭到竄改。使用下列步驟來驗證 SDK 檔案。

1. 使用下列命令下載 SDK SIGNATURE 檔案。

   ```
   curl "https://sdk-for-sapabap.aws.amazon.com/awsSdkSapabapV1/release/abapsdk-LATEST.sig" -o "abapsdk-LATEST.sig"
   ```

1. 複製下列公有金鑰，並將它儲存至名為 `abapsdk-signing-key.pem` 的檔案。

   ```
   -----BEGIN PUBLIC KEY-----
   MIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAmS3oN3wKBh4HJOGaOtye
   15RR5909nuw0JxOvEDCT7O9wUrXS3mjgEw6b6hvr2dLdoFr+eH4ewT5bVl6U3gDv
   051sTdEJJpfLEWJJZZNK3v9fGWKyXgYe+ifmsPmf4lhNd2auzpvIy2UrlSYijCRB
   BWZFW+Ux0OkILz+8vCFSXMZ6Z0qtLIlZFbGrn6A5adbwwzfOqkg9BUEZK0wB6TAi
   ZTnkMdBZGCBM9K2MRKKMxtrxUn+TFcAYyh5pM9tUAb2q4XE5m7092UnZG7ur/QYl
   1FSZwAhQmk8hUPgUaqOOQRC6z3TRzIGKOA/DI0cUPJMzFR4LCxEJkgh4rkRaU9V2
   O7DthUpj8b7QcQaiOpnMpBf3zWLgbjNmX0hB0Eprg8/nVRHspf3zuiscJ2lMPkz0
   cHOR3lMNsMLzm+d/gVkLt31R/JwAcFCkXTWvR8/VOWNGZZXdVUbefrfI/k7fP60B
   bzUrIlN4poq16rc4Tk5Derg+wQ7rOWjXkXop2kiCMjbYo0ol0kS/At64PLjpz8dH
   Zg25o79U9EJln+lpqZ297Ks+HoctOv2GPbeeh0s7+N0fRTyOr81EZIURLPKLVQUw
   otVRzNDgLOA7eA667NrmegZfHCmqEwK9tXakZUHAcMzRPyhALc/HtmovxdStN9h1
   JC4exOGqstAv1fX5QaTbMSECAwEAAQ==
   -----END PUBLIC KEY-----
   ```

1. 使用以下命令驗證下載的 SDK ZIP 檔案。 命令需要 `openssl` 作為許多 Linux 發行版本的一部分。

   ```
   openssl dgst -sha256 -verify abapsdk-signing-key.pem -keyform PEM -signature abapsdk-LATEST.sig abapsdk-LATEST.zip
   ```

1. 確認上述命令的輸出為 `Verified OK`。

1. 如果輸出為 `Verification Failure`，請重複上述步驟。如果您繼續收到失敗的輸出，請勿安裝 SDK 並聯絡 支援。

## AWS SDK 傳輸
<a name="transports"></a>

**Topics**
+ [目錄](#contents)
+ [匯入中](#importing)
+ [命名空間](#namespace)

### 目錄
<a name="contents"></a>

適用於 SAP ABAP 的 SDK 安裝是透過 ABAP Transports 完成。您必須將這些傳輸匯入您的開發或沙盒環境。

每個適用於 SAP ABAP 的 SDK 版本都會完全取代先前的版本。  不需要套用增量傳輸。  傳輸會封裝在 ZIP 檔案中。 下列是 ZIP 檔案的結構。

```
transports/
transports/core/
transports/core/Knnnnnn.AWS
transports/core/Rnnnnnn.AWS
transports/tla1/
transports/tla1/Knnnnnn.AWS
transports/tla1/Rnnnnnn.AWS
transports/tla2/
transports/tla2/Knnnnnn.AWS
transports/tla2/Rnnnnnn.AWS
.
.
.
```

`transports` 資料夾包含`core`子資料夾。`core` 子資料夾包含每個模組的核心執行時間傳輸和子資料夾，以模組的三個字母縮寫命名。如需 TLAs 的完整模組清單，請參閱 [適用於 SAP ABAP 的 AWS SDK - 模組清單](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/tla.html)。

AWS SDK 傳輸是工作台請求。視 TMS 路由的組態而定，軟體開發套件可能不會在匯入先前的系統之後自動轉送至您的品質保證和生產佇列。您必須手動將它們新增至每個系統的佇列。

當您的專案準備好進入下一個階段時，可以匯入 AWS SDK 以及包含您自己的`Z`程式碼和業務功能的個別傳輸。如果您使用的是變更控制系統，例如 SAP 變更請求管理 (ChaRM)，請洽詢您的 ChaRM 管理員，以正確處理第三方傳輸。

### 匯入中
<a name="importing"></a>

**Topics**
+ [索引鍵指標](#importing-key-pointers)
+ [匯入時間](#importing-time)

AWS SDK 傳輸與用戶端無關。核心傳輸是強制性的，並包含 SDK 執行期程式碼、 的 API AWS Security Token Service和 Amazon Simple Storage Service 的 API。  剩餘的 SDK 模組會以個別傳輸方式交付。若要將 SDK 的大小保留在您的系統中，每個 SDK 模組都是選用的。如果業務邏輯需要，您可以稍後安裝其他模組。

例如，如果您想要使用 Amazon S3 APIs Amazon Translate，並匯入`core`傳輸 （包含核心執行時間、Amazon S3 和 AWS STS 模組） 和`xl8`傳輸 （包含模組的 Amazon Translate) 傳輸。

若要查看適用於 SAP ABAP APIs 的完整清單，請參閱[適用於 SAP ABAP 的 SDK - API 參考指南](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html)。

以下是匯入 AWS SDK 傳輸時的索引鍵。
+ 每個傳輸都會以 `Knnnnnn.AWS`和 的形式交付 `Rnnnnnn.AWS`
  + `Knnnnnn.AWS` 必須複製到 `/usr/sap/trans/cofiles`
  + `Rnnnnnn.AWS` 必須複製到 `/usr/sap/trans/data`。
+ 匯入傳輸時，您必須選取*匯入傳輸請求* > *選項* > *匯入選項*中找到**的忽略無效元件版本**。
+ 您可以同時匯入所有所需的傳輸。
+ 如果單獨匯入傳輸，則必須先匯入`core`傳輸。
+ 所有傳輸的發行層級必須相同。

**匯入時間**

AWS SDK 傳輸可能需要幾分鐘的時間才能匯入。如果 STMS 顯示綠色 (`RC=0`) 或黃色 (`RC=4`) 光線，則傳輸會成功。
+ 紅燈 (`RC=8`) 表示匯入發生語法錯誤。
  + 選取**請求** → **顯示** → **日誌以檢查匯入錯誤**。
  + 在匯入期間，如果因為缺少界面 而擲回錯誤`IF_SYSTEM_UUID_RFC4122_STATIC`，請確保 SAP Note 2619546 已套用至系統。如需詳細資訊，請參閱[備註](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#parameters)。
  + 如果錯誤的原因不明，請聯絡 支援。
+ 紅色閃電 (`RC=12`) 表示傳輸檔案未正確載入至 ，`/usr/sap/trans`或沒有必要的許可。

#### 索引鍵指標
<a name="importing-key-pointers"></a>

以下是匯入 AWS SDK 傳輸時的索引鍵。
+ 每個傳輸都會以 `Knnnnnn.AWS`和 的形式交付 `Rnnnnnn.AWS`
  + `Knnnnnn.AWS` 必須複製到 `/usr/sap/trans/cofiles`
  + `Rnnnnnn.AWS` 必須複製到 `/usr/sap/trans/data`。
+ 匯入傳輸時，您必須選取*匯入傳輸請求* > *選項* > *匯入選項*中找到**的忽略無效元件版本**。
+ 您可以同時匯入所有所需的傳輸。
+ 如果單獨匯入傳輸，則必須先匯入`core`傳輸。
+ 所有傳輸的發行層級必須相同。

#### 匯入時間
<a name="importing-time"></a>

AWS SDK 傳輸可能需要幾分鐘的時間才能匯入。如果 STMS 顯示綠色 (`RC=0`) 或黃色 (`RC=4`) 光線，則傳輸會成功。
+ 紅燈 (`RC=8`) 表示匯入發生語法錯誤。
  + 選取**請求** → **顯示** → **日誌以檢查匯入錯誤**。
  + 在匯入期間，如果因為缺少界面 而擲出錯誤`IF_SYSTEM_UUID_RFC4122_STATIC`，請確保 SAP Note 2619546 已套用至系統。如需詳細資訊，請參閱[備註](https://docs.aws.amazon.com/sdk-for-sapabap/latest/developer-guide/prerequisites.html#parameters)。
  + 如果錯誤的原因不明，請聯絡 支援。
+ 紅色閃電 (`RC=12`) 表示傳輸檔案未正確載入至 ，`/usr/sap/trans`或沒有必要的許可。

### 命名空間
<a name="namespace"></a>

適用於 SAP ABAP 的 SDK 使用 `/AWS1/` 命名空間，不會修改您系統中的 SAP 物件或任何其他物件，但有下列例外。
+ AWS `auth` 物件位於**驗證物件類別**中。驗證物件類別限制為四個字元，不支援命名空間。適用於 SAP ABAP 的 SDK 使用身分驗證物件類別為 `YAW1`。如果您在交易 `YAW1` 中已有身分驗證物件類別`SU21`，請在安裝 支援 之前聯絡 。