本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 連線至 S/4 HANA
您必須先完成下列先決條件，才能連線至 S/4 HANA 資料來源。之後， AWS Supply Chain 會自動建立 Amazon S3 路徑，並從 SAP 來源資料表擷取資料。
## 連線至 S/4 HANA 的先決條件
若要連線至 S/4 HANA 資料來源，必須先完成下列先決條件，才能擷取資料。
1. 設定 SAP S/4 HANA 系統，透過 Amazon AppFlow 的 SAP OData 連接器開啟以 ODP 為基礎的資料擷取。如需詳細資訊，請參閱 [Amazon AppFlow 的 SAP OData 連接器](https://docs.aws.amazon.com/appflow/latest/userguide/sapodata.html)。
1. 設定 SAP 資料來源或擷取器，並為 產生以 ODP 為基礎的 OData 服務 AWS Supply Chain ，以連接和擷取資訊。如需詳細資訊，請參閱[SAP 資料來源](#s4-datasources)。
1. 使用下列其中一種身分驗證來設定 SAP 系統：
+ 基本
+ OAuth
1. 在 SAP 系統中設定安全角色以開啟資料擷取。
1. 設定與 SAP S/4 HANA 的網路連線。如果您的 SAP 執行個體位於安全 VPN 中，且您無法開啟連接埠 AWS Supply Chain 讓 進行連線，建議您使用 AWS PrivateLink。若要手動設定 AWS PrivateLink，請參閱 [AWS 以取得 SAP](https://aws.amazon.com/blogs/awsforsap/share-sap-odata-services-securely-through-aws-privatelink-and-the-amazon-appflow-sap-connector/)，若要使用 自動設定 CloudFormation，請參閱 [CloudFormation](https://github.com/aws-cloudformation/aws-cloudformation-templates/tree/main/AWSSupplyChain/SapPrivateLink)。
## 設定 S/4 HANA 連線
若要從 SAP S/4HANA 資料來源擷取資料，請遵循下列程序。
1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**。
1. 在**資料湖**頁面上，選擇**新增來源**。
隨即顯示**選取您的供應鏈資料來源**頁面。
1. 選擇 **SAP S/4HANA**。
1. 選擇 **Next (下一步)**。
1. 在 ** SAP S/4HANA 連線詳細資訊**下，輸入下列項目：
+ **連線名稱** – 輸入此連線的名稱。
+ （選用） **連線描述** – 輸入此連線的名稱。
+ **使用現有 AppFlow 連接器** – 選擇**是**以使用現有的 AppFlow 連接器。
+ **應用程式主機 URL** – 輸入 SAP 帳戶的 URL。
+ **應用程式服務路徑** – 輸入 SAP 應用程式服務路徑。
+ **連接埠號碼** – 輸入 SAP 連接埠號碼。
+ **用戶端號碼** – 輸入 SAP 用戶端號碼。
+ **登入語言** – 輸入 SAP 語言碼。例如，英文為 EN。
+ **PrivateLink** – 選擇**已啟用**，以啟用 SAP 伺服器與 AWS 帳戶 託管 之間的私有連線 AWS Supply Chain。
+ **使用者名稱** – 輸入 SAP 帳戶的使用者名稱。
+ **密碼** – 輸入 SAP 帳戶的密碼。
**注意**
Amazon AppFlow 會使用您****提供的 SAP **使用者名稱和密碼**來連線至 SAP。
1. 選擇**連線至 SAP**。
如果正確輸入 SAP 使用者名稱和密碼，則會顯示**連線成功**訊息。
1. （選用） 在**選用 AppFlow 組態****下的步驟 1 - 下載 JSON 範本檔案**，選擇**下載現有的 JSON 範本檔案**以修改 appflow 擷取設定。
**注意**
您可以使用自己的編輯器來編輯 .json 檔案。您無法在 中編輯 .json 檔案 AWS Supply Chain。
更新 .json 檔案後，在**步驟 2 - 上傳修改過的 JSON 範本檔案**下，選擇要上傳的**瀏覽檔案**。
**注意**
如果此上傳失敗，**上傳摘要**會顯示 .json 檔案中的錯誤或衝突。您可以更新 .json 檔案以修正問題並重新上傳檔案。
以下是範例 .json 檔案，其中包含所需的排程、資料流程和來源資料表。
```
{
"schedule" : {
"scheduleExpression" : "rate(1days)", // scheduleExpression key should be available and the value cannot be null/empty. Format starts with rate and having time values in minutes, hours, or days. For example, rate(1days)
"scheduleStartTime" : null // Supported format - "yyyy-MM-dd'T'hh:mm:ss[+|-]hh:mm". For example, 2022-04-26T13:00:00-07:00. ScheduleStartTime should atleast be 5 minutes after current time. A null value will automatically set the start time as 5 minutes after the connection creation time
},
"dataFlows" : [ // DataFlows cannot be null or empty. Make sure to choose from the list below
"Company-Company",
"Geography-Geography",
"Inventory-Inventory Level",
"Inventory-Inventory Policy",
"Outbound-Outbound Order Line",
"Outbound-Outbound Shipment",
"Product-Product",
"Product-Product Hierarchy",
"Production Order-Inbound Order",
"Production Order-Inbound Order Line",
"Purchase Order-Inbound Order",
"Purchase Order-Inbound Order Line",
"Purchase Order-Inbound Order Line Schedule",
"Reference-Reference Fields",
"Shipment-Shipment",
"Site-Site",
"Site-Transportation Lane",
"Trading Partner-Trading Partner",
"Transfer Order-Inbound Order Line",
"Vendor Management-Vendor Lead Time",
"Vendor Management-Vendor Product",
"Product-Product UOM"
],
"sourceTables" : [ // sourceTables cannot be empty
{
"tableName" : "SomeString", // Should be an existing table name from the SAP instance
"extractType" : "DELTA", // Should either be DELTA or FULL
"tableCols" : [ // TableCols cannot be empty. Enter valid column names for the table
"col1",
"col2",
"col3"
],
"filters" : [// Optional field
"colName" : "col1", // colName value should be part of tableCols
"dataType" : "String", // Should contain values `STRING` or `DATETIME`
"value" : "String",
"operator" : "String" // Choose a string value from the pre-defined value of "PROJECTION", "LESS_THAN", "CONTAINS","GREATER_THAN","LESS_THAN_OR_EQUAL_TO","GREATER_THAN_OR_EQUAL_TO","EQUAL_TO","NOT_EQUAL_TO","ADDITION","MULTIPLICATION","DIVISION","SUBTRACTION","MASK_ALL","MASK_FIRST_N","MASK_LAST_N","VALIDATE_NON_NULL","VALIDATE_NON_ZERO","VALIDATE_NON_NEGATIVE",or "VALIDATE_NUMERIC","NO_OP";
]
},
{
// sourceTables with same keys - tableName, extractType, tableCols, filters(not mandatory)
}
]
}
```
1. 在 **Amazon S3 儲存貯體帳單**下，檢閱 Amazon S3 帳單資訊，然後選取**確認**。
1. 選擇 **Next (下一步)**。
1. 在**資料映射**下，選擇**開始使用**。
1.
**注意**
必要欄位已映射。只有在您想要對預設轉換配方進行特定變更時，才執行此步驟。
在**映射配方**頁面上，您可以在**欄位映射**下檢視預設轉換配方。
選擇**新增映射**，以映射任何其他目的地欄位。**必要目的地欄位**為必要欄位。選擇**目的地欄位**以新增其他自訂目的地欄位。
1. 若要從轉換配方檢視來源欄位值和資料映射，您可以上傳範例資料。在**映射配方**頁面的**上傳範例資料**下，選擇**瀏覽檔案**或拖放檔案。範例資料檔案必須包含必要的參數，並包含來源欄位名稱。
1. 選擇**全部接受並繼續**。
1. 在**檢閱並確認**下，您可以檢視資料連線摘要。若要編輯資料欄位映射，請選擇**返回資料映射**。
1. （選用） 在**配方動作**下，您可以執行下列動作：
+ **下載配方檔案** - 選取**下載**，以將 SQL 中的配方檔案編輯為文字檔案。
**注意**
如需內建 SQL 函數的資訊，請參閱 [Spark SQL](https://spark.apache.org/docs/latest/api/sql/index.html)。
+ **上傳配方檔案** - 選擇**瀏覽檔案**，或拖放已編輯的配方文字檔案。選取**確認上傳**以上傳編輯的配方檔案，並修改您的資料欄位映射。
1. 若要檢閱您必須上傳 SAP 來源資料的 Amazon S3 位置路徑以進行擷取，請選擇**確認並設定資料擷取**。或者，您可以選擇**確認，稍後再設定資料擷取**。您可以隨時檢視資料擷取資訊。從 AWS Supply Chain 儀表板中，選取**連線**。選取您要擷取資料的連線資料流程，選擇垂直省略，然後選取**擷取設定**。
## SAP 資料來源
設定下列 SAP 資料表來源 AWS Supply Chain ，讓 連線並擷取資訊。
**注意**
當您搜尋 SAP 資料來源時， 會在資料來源名稱前面加上 *EntityOf*。例如，對於資料來源 *0BP\$1DEF\$1ADDRESS\$1ATTR*，實體名稱應為 *EntityOf0BP\$1DEF\$1ADDRESS\$1ATTR*。
當 Amazon AppFlow 擷取每個 SAP 資料來源時，會使用實體名稱格式來擷取資訊。例如，若要從 *0BP\$1DEF\$1ADDRESS\$1ATTR* 擷取資料，資料會從實體路徑 */sap/opu/odata/sap/Z0BP\$1DEF\$1ADDRESS\$1ATTR\$1SRV/EntityOf0BP\$1DEF\$1ADDRESS\$1ATT* 擷取。
| SAP 資料來源 | SAP 資料來源描述 | SAP 來源資料表 | OData 服務名稱 | BW 資料來源 | SAP 資料 | Delta /Full |
| --- | --- | --- | --- | --- | --- | --- |
| 0BP\$1DEF\$1 ADDRESS\$1ATTR | BP 標準地址擷取 | NA | Z0BP\$1DEF\$1 ADDRESS\$1ATTR \$1SRV | 資料來源 | 主資料 | Delta |
| 0BPARTNER\$1 ATTR | BP：BW 擷取中央資料 | NA | Z0BPARTNER\$1 ATTR\$1SRV | 資料來源 | 主資料 | Delta |
| 0BPARTNER\$1 TEXT | BP：適用於業務合作夥伴文字的 DataSource | NA | Z0BPARTNER\$1 TEXT\$1SRV | 資料來源 | 主資料 | Delta |
| 0CO\$1PC\$1ACT \$105 | 材質評價：價格 | NA | Z0CO\$1PC\$1 ACT\$105\$1SRV | 資料來源 | 主資料 | 完整 |
| 0COMP\$1CODE \$1TEXT | 公司代碼文字 | NA | Z0COMP\$1CODE \$1TEXT\$1SRV | 資料來源 | 主資料 | 完整 |
| 0CUSTOMER\$1 ATTR | 客戶 | NA | Z0CUSTOMER\$1 ATTR\$1SRV | 資料來源 | 主資料 | Delta |
| 0MAT\$1VEND\$1 ATTR | 材料或廠商 | NA | Z0MAT\$1VEND\$1 ATTR\$1SRV | 資料來源 | 主資料 | Delta |
| 0MATERIAL\$1 ATTR | Material (材質) | NA | Z0MATERIAL\$1 ATTR\$1SRV | 資料來源 | 主資料 | Delta |
| 0MATERIAL\$1 TEXT | 材質文字 | NA | Z0MATERIAL\$1 TEXT\$1SRV | 資料來源 | 主資料 | Delta |
| 0PURCH\$1ORG\$1 TEXT | 購買組織文字 | NA | Z0PURCH\$1ORG\$1 TEXT\$1SRV | 資料來源 | 主資料 | 完整 |
| 0VENDOR\$1 ATTR | 廠商 | NA | Z0VENDOR\$1 ATTR\$1SRV | 資料來源 | 主資料 | Delta |
| 2LIS\$102\$1HDR | 購買資料 （標頭層級） | NA | Z2LIS\$102\$1 HDR\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$102\$1ITM | 購買資料 （項目層級） | NA | Z2LIS\$102\$1 ITM\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$102\$1SCL | 購買資料 （排程行層級） | NA | Z2LIS\$102\$1 SCL\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$102\$1SCN | 確認排程行 | NA | Z2LIS\$102\$1 SCN\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$103\$1BF | 來自庫存管理的貨物移動 | NA | Z2LIS\$103\$1 BF\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$104\$1P \$1MATNR | 來自 PP/PP-PI 的材料檢視 | NA | Z2LIS\$104\$1P\$1 MATNR\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$108TRFKP | 項目層級的寄件成本 | NA | Z2LIS\$108TRFKP \$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$108TRTLP | 寄件：依區段的交付項目資料 | NA | Z2LIS\$108TRTLP \$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$108TRTK | 寄件：標頭資料 | NA | Z2LIS\$108TRTK \$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$111 \$1VAHDR | 銷售文件標頭 | NA | Z2LIS\$111 \$1VAHDR\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$111 \$1VAITM | 銷售文件項目 | NA | Z2LIS\$111\$1 VAITM\$1SRV | 資料來源 | Transa 字典 | Delta |
| 2LIS\$112\$1VCITM | 交付項目資料 | NA | Z2LIS\$112 \$1VCITM\$1SRV | 資料來源 | Transa 字典 | Delta |
| ZADRC | 地址 | ADRC | ZADRC\$1SRV | 資料表 | 主資料 | 完整 |
| ZBUT021\$1FS | 合作夥伴地址 | BUT021\$1FS | ZBUT021\$1FS \$1SRV | 資料表 | 主資料 | 完整 |
| ZCDHDR | 變更文件標頭 | CDHDR | ZCDHDR\$1SRV | 資料表 | 主資料 | Delta |
| ZEINA | 購買資訊記錄：一般資料 | EINA | ZEINA\$1SRV | 資料表 | 主資料 | 完整 |
| ZEINE | 購買資訊記錄：購買組織資料 | ZV\$1EINE | ZEINE\$1SRV | 資料表 | 主資料 | 完整 |
| ZEKKO | 購買文件標頭 | ZV\$1EKKO | ZEKKO\$1SRV | 資料表 | Transa 字典 | Delta |
| ZEKPO | 購買文件項目 | ZV\$1EKPO | ZEKPO\$1SRV | 資料表 | Transa 字典 | Delta |
| ZEQUI | 設備主資料 | EQUI | ZEQUI\$1SRV | 資料表 | 主資料 | 完整 |
| ZGEOLOC | 地理位置 | GEOLOC | ZGEOLOC\$1SRV | 資料表 | 主資料 | 完整 |
| ZLIKP | 交付標頭資料 | LIKP | ZLIKP\$1SRV | 資料表 | Transa 字典 | Delta |
| ZLIPS | 交付：項目資料 | ZV\$1LIPS | ZLIPS\$1SRV | 資料表 | Transa 字典 | Delta |
| ZMDRP\$1 NODTT | DRP 網路的節點類型 | MDRP\$1NODTT | ZMDRP\$1NODTT \$1SRV | 資料表 | 主資料 | 完整 |
| ZMARC | 物料的工廠資料 | ZQ\$1MARC | ZMARC\$1SRV | 資料表 | 主資料 | 完整 |
| ZMARD | 材料的儲存位置資料 | ZQ\$1MARD | ZMARD\$1SRV | 資料表 | 主資料 | 完整 |
| ZMCHB | 批次庫存 | ZQ\$1MCHB | ZMCHB\$1SRV | 資料表 | 主資料 | 完整 |
| ZT001W | 工廠 | T001W | ZT001W\$1SRV | 資料表 | 主資料 | 完整 |
| ZT005T | 國家名稱 | T005T | ZT005T\$1SRV | 資料表 | 主資料 | 完整 |
| ZT141T | 材料狀態的說明 | T141T | ZT141T\$1SRV | 資料表 | 主資料 | 完整 |
| ZT173T | 傳輸文字的運送類型 | T173T | ZT173T\$1SRV | 資料表 | 主資料 | 完整 |
| ZT179 | 材質：產品階層 | T179 | ZT179\$1SRV | 資料表 | 主資料 | 完整 |
| ZT179T | 材質：產品階層文字 | T179T | ZT179T\$1SRV | 資料表 | 主資料 | 完整 |
| ZT370U | 設備類別文字 | T370U | ZT370U\$1SRV | 資料表 | 主資料 | 完整 |
| ZT618T | 傳輸模式描述 | T618T | ZT618T\$1SRV | 資料表 | 主資料 | 完整 |
| ZTVRAB | 路由階段 | TVRAB | ZTVRAB\$1SRV | 資料表 | 主資料 | 完整 |
| ZTVRO | 路由 | TVRO | ZTVRO\$1SRV | 資料表 | 主資料 | 完整 |
| ZVALW | 路由排程 | VALW | ZVALW\$1SRV | 資料表 | 主資料 | 完整 |
| ZVBBE | 銷售需求：個別記錄 | VBBE | ZVBBE\$1SRVs | 資料表 | 主資料 | 完整 |
| ZINB\$1 寄件 | 寄件標頭和項目 （傳入） | 以聯結條件為基礎的 ZV\$1INB\$1 SHIPMENT：VTTK.MANDT = VTTP.MANDT 和 VTTK.TKNUM = VTTP.TKNUM | ZINB\$1SHIPMENT \$1SRV | 資料表 | Transa 字典 | 完整 |
| ZAUFK | 訂購主資料 | AUFK | ZAUFK\$1SRV | 資料表 | 主資料 | 完整 |
| ZMARM | 物料的度量單位 | MARM | ZMARM\$1SRV | 資料表 | 主資料 | 完整 |
| ZEBAN | 購買請求 | EBAN | ZEBAN\$1SRV | 資料表 | 交易資料 | Delta |