

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

# 資料湖
<a name="data-connections"></a>

您可以使用 AWS Supply Chain 擷取存放在下列資料來源中的資料，並擷取供應鏈資訊。 AWS Supply Chain 可以將擷取的資訊存放在 Amazon S3 儲存貯體中，並使用資料進行*需求規劃*、*洞見*、*供應規劃*、*N 層可見性*、*工作訂單洞*見和*永續性*。
+ **Amazon S3 來源資料** – 如果您沒有 ERP 系統，或者使用其他擷取工具，您可以使用 Amazon S3 資料來源流程選項。您可以從資料來源擷取原始資料、將資料欄位與 AWS Supply Chain 資料模型對應，然後使用您選擇的整合工具將其上傳至 Amazon S3。您只能在使用自動關聯時將 CSV 檔案上傳至 Amazon S3。
+ **電子資料交換 (EDI)** – AWS Supply Chain 支援 EDI 訊息 850、860 和 856 的 X12 ANSI 4010 版。支援的資料格式為 .edi 或 .txt。您可以使用您選擇的整合工具，將原始 EDI 訊息新增至 Amazon S3。 AWS Supply Chain 可以透過自然語言處理 (NLP) 擷取原始 EDI 訊息，並使用 EDI 856 的預設範本建立關聯。EDI 850 和 860 不支援 NLP 範本，並隨附預先定義但可自訂的配方 AWS Supply Chain。
+ **SAP S/4HANA** – 若要從 SAP S/4HANA 資料來源擷取您的供應鏈資料， AWS Supply Chain 可以使用 Amazon AppFlow 連接器連線到此來源。 AWS Supply Chain 可以使用 將儲存在 SAP S/4HANA 系統中的供應鏈資料與 AWS Supply Chain 資料模型建立關聯 AWS Glue DataBrew。
+  **SAP ECC 6.0** – 您可以使用整合工具 （例如 ETL 或 iPaaS) 擷取儲存在 SAP ECC 6.0 系統中的供應鏈資料，並使用 API 將其放入 Amazon S3 儲存貯體。 AWS Supply Chain 可以使用 DataBrew 將儲存在 SAP ECC 6.0 系統中的供應鏈資料與 AWS Supply Chain 資料模型建立關聯。

**Topics**
+ [資料湖中使用的術語](data_lake_terminology.md)
+ [Data lake 儀表板](data_ingestion.md)
+ [新增資料來源](adding_new_flows.md)
+ [擷取現有連線的資料](ingesting-data.md)

# 資料湖中使用的術語
<a name="data_lake_terminology"></a>

下列術語用於資料湖：
+ **實體** – 每個類別的資料物件相關資訊。例如，公司、地理位置和 trade\$1partner 是組織的實體。如需詳細資訊，請參閱[中使用的資料實體和資料欄 AWS Supply Chain](data-model.md)。
+ **資料集** – 與實體相關的資訊。每個實體只能有一個資料集。
+ **連接器** – 將資料匯入 的方法 AWS Supply Chain。
+ **配方** – 一組步驟，說明如何將來源資料映射至一個資料集。
+ **來源流程 1** – 顯示您上傳的資料集和欄位。
+ **目的地流程 1** – 將資料集中的資料與資料湖中的 AWS Supply Chain 資料實體建立關聯。
+ **來源系統 1** – 您現有的企業資源規劃 (ERP) 系統、倉儲管理系統 (WMS) 或任何供應鏈資料管理系統。

1 – 只有在您透過 Amazon S3 擷取資料 （或 Web 應用程式中**的任何 CSV 上傳**選項） 時，才會顯示這些條款。

# Data lake 儀表板
<a name="data_ingestion"></a>

您可以使用 AWS Supply Chain 資料湖從各種資料來源擷取資料。如需支援資料來源的資訊，請參閱 [資料湖](data-connections.md)。

![\[資料湖概觀\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_lake_overvoew.png)


## 資料擷取
<a name="ingestion"></a>

您可以檢視目前的連線、來源和目的地流程。若要檢視擷取資料的狀態，請遵循下列程序。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**，然後選擇 **Data Ingestion** 索引標籤。

   **資料擷取**頁面隨即出現。  
![\[資料湖擷取\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data-lake-ingestion.png)

1. 選擇**來源流程**索引標籤。
   + 來源流程 – 顯示已上傳資料集的檔案或資料夾結構。
   + S3 字首 – 顯示上傳來源檔案的 Amazon S3 路徑。
   + 狀態 – 顯示來源檔案的上傳狀態。
   + 上次同步 – 顯示檔案上次同步或更新的時間。
   + 動作 – 您可以檢視下列項目：
     + 管理流程 – 您可以更新資料映射。
     + 上傳檔案 – 您可以將其他來源檔案新增至現有的來源流程。
     + 刪除流程 – 您可以完全刪除來源流程。

1. 選擇**目的地流程**索引標籤。

1. 在**動作**下，選擇**管理流程**以檢視和更新資料映射。

   隨即顯示**管理目的地流程**頁面。  
![\[Data lake 工作流程\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data-lake-flow.png)

1. 將來源資料欄下任何未關聯的**來源資料欄**移至**目的地資料欄**。

1. 選擇**結束並檢閱目的地流程**，以返回**目的地流程**頁面來檢閱目的地流程。

1. 選擇 **Connections (連線)** 索引標籤。

   您可以檢視所有現有的連線。

## 資料集
<a name="viewing-datasets"></a>

您可以檢視擷取的資料集狀態。

若要檢視上傳至現有連線的所有資料集，請遵循下列程序。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**，然後選擇**資料集**索引標籤。

   **資料集**頁面隨即出現。

1. 若要檢視資料集，請選擇**檢視**。

1. 在**資料集欄位**索引標籤下，您可以檢視資料集中的所有現有資料集欄位。

1. 在**來源連線**索引標籤下，您可以檢視饋送該資料集的連線。

# 資料品質
<a name="data_quality_datalake"></a>

任何已識別的資料品質錯誤會顯示在 Web 應用程式模組錯誤下。您可以檢視發生錯誤的資料集和受影響的 AWS Supply Chain 模組。此外，您可以從 Amazon S3 儲存貯體下載資料品質報告。報告提供擷取資料中資料集錯誤的詳細資訊。

## 檢視資料品質報告
<a name="data_qual"></a>

若要檢視 AWS Supply Chain 模組錯誤，請完成下列步驟：

**注意**  
如需每個 AWS Supply Chain 模組所需和選用資料實體的資訊，請參閱 [AWS Supply Chain 中使用的資料實體和資料欄下的需求規劃、洞見和](https://docs.aws.amazon.com/aws-supply-chain/latest/userguide/data-model.html)工作訂單洞見章節。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**，然後選擇 **Data Quality** 索引標籤。

1. 選擇**模組錯誤**索引標籤。您可以檢視 AWS Supply Chain 模組的資料擷取錯誤。
**注意**  
您也可以在第一次擷取完成且目的地流程成功後，檢視資料集錯誤和受影響的模組。如果目的地流程不成功，您可以在**目的地流程**索引標籤**的詳細資訊**欄下檢視資料品質錯誤。

   您可以使用**模組**下拉式清單中的下列篩選條件來篩選錯誤：
   + 全部
   + 多個應用程式
   + 需求規劃
   + 深入分析
   + 訂單洞見  
![\[模組篩選條件下拉式清單。\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/module_filters.png)

1. 在**受影響的模組**和**狀態訊息**欄下檢視資料品質錯誤。

   **受影響的模組**欄會顯示 AWS Supply Chain 應用程式和受影響的相關功能。

   **狀態訊息**欄會顯示產品實體和每個產品實體下的錯誤數目。例如，"channel\$1id" 欄位有 null 或空白值..." 錯誤表示擷取的 outbound\$1order\$1line 檔案中的 "channel\$1id" 資料遺失。  
![\[受影響的模組和狀態訊息欄。\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_quality_columns.png)

## 下載資料品質報告
<a name="data_qual_reports"></a>

若要下載資料品質報告，請完成下列步驟：

1. 在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台並登入。

1. 導覽至 **aws-supply-chain-data** 執行個體 ID 資料夾，然後 **data-quality-report**。

1. 選取您要檢視之資料實體的資料夾。

   將顯示每個資料擷取的個別資料夾。  
![\[產品資料實體資料夾，其中包含資料擷取資料夾。\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_entity_folder.png)

1. 選取您要檢視之資料擷取的資料夾。

   資料品質報告隨即顯示。  
![\[資料品質報告 json 檔案。\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_quality_report.png)

1. 選取 檔案，然後選擇**下載**以下載 json 格式的資料品質報告。

# 新增資料來源
<a name="adding_new_flows"></a>

您可以使用 AWS Supply Chain 擷取存放在資料來源中的資料，並擷取供應鏈資訊。 AWS Supply Chain 可以將擷取的資訊存放在 Amazon S3 儲存貯體中，並使用資料進行*需求規劃*、*洞見*、*供應規劃*、*N 層可見性*、*工作訂單洞*見和*永續性*。

**Topics**
+ [擷取資料的先決條件](#data_prerequisites-profiles)
+ [第一次上傳檔案](uploading_files.md)
+ [連線至 EDI](connecting-edi.md)
+ [連線至 S/4 HANA](connecting-sap-hana.md)
+ [連線至 SAP ECC 6.0](connecting-sap-ecc.md)
+ [新增用於供應規劃的新傳出來源](adding_new_outbound_connector.md)

## 擷取資料的先決條件
<a name="data_prerequisites-profiles"></a>

上傳資料集以進行擷取之前，請注意下列事項：
+ 您上傳的檔案應小於 5 GB。
+ 資料集中的內容應遵循 UTF-8 編碼格式。
+ 連接器必須支援 檔案類型。SAP 系統的連接器支援 CSV、EDI 連接器支援 .txt 和 .edi 格式，而 Amazon S3 支援 CSV。
+ 資料列必須包含必要欄位的非空值。
+ 日期和時間格式應遵循 ISO8601 標準。例如，2020-07-10 15：00：00.000， 代表 2020 年 7 月 10 日下午 3 點。
+ 資料集中的資料欄名稱不應包含空格或特殊字元。欄名稱應以兩個字之間的底線 (\$1) 分隔。
+ 使用 Amazon S3 來源路徑時， AWS Supply Chain 會建立名為 的父資料夾，以您選取的來源系統命名。子資料夾會以您選取的來源資料表命名。請確定檔案名稱是唯一的。您建置的檔案結構將用於建立 Amazon S3 路徑。
+ AWS Supply Chain 遵循具有預先指派 URLs多步驟上傳程序。由於瀏覽器安全限制，若要上傳資料集，您的 S3 儲存貯體跨來源資源共用 (CORS) 許可必須允許 *PUT* 請求並傳回 *ETag* 標頭。若要更新 Amazon S3 儲存貯體上的 CORS 政策，請在 **Connections** 下向下捲動至 CORS 並貼上下列政策：

  ```
                  
   [
   {
   "AllowedHeaders": [
   "*"
   ],
   "AllowedMethods": [
   "PUT"
   ],
   "AllowedOrigins": [
   "https://instance-id.scn.global.on.aws"
   ],
   "ExposeHeaders": [
   "Etag"
   ]
   }
   ]
  ```

# 第一次上傳檔案
<a name="uploading_files"></a>

您可以使用 AWS Supply Chain 自動關聯功能上傳原始資料，並自動將原始資料與 AWS Supply Chain 資料模型建立關聯。您也可以在 AWS Supply Chain Web 應用程式中檢視每個 AWS Supply Chain 模組*所需的*資料欄和資料表。

如需自動關聯運作方式的簡短示範，請觀看下列影片：




**注意**  
您只能在使用自動關聯時將 CSV 檔案上傳至 Amazon S3。

資料集的來源資料欄與目的地資料欄建立關聯後， AWS Supply Chain 會自動產生 SQL 配方。

**注意**  
AWS Supply Chain 使用 Amazon Bedrock 進行自動關聯，但並非所有 AWS Supply Chain 可用的 &AWS Regions 都支援此關聯。因此， AWS Supply Chain 將從最近的可用區域、歐洲 （愛爾蘭） 區域 – 歐洲 （法蘭克福） 和亞太區域 （雪梨） 區域 – 美國西部 （奧勒岡） 呼叫 Amazon Bedrock 端點。

**注意**  
只有在透過 Amazon S3 擷取資料時，才支援使用大型語言模型 (LLM) 進行自動關聯。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**，然後選擇 **Data Ingestion** 索引標籤。

   **資料擷取**頁面隨即出現。

1. 選擇**新增來源**。

   隨即顯示**選取您的資料來源**頁面。

1. 在**選取資料來源**頁面上，選擇**上傳檔案**。

1. 選擇**繼續**。  
![\[上傳您的來源檔案\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_lake.png)

1. 在**您要執行哪些功能**頁面上，選擇您要使用的 AWS Supply Chain 模組。您可以選擇多個模組。

1. 在**上傳來源檔案**區段下，將尾碼新增至**來源系統名稱**。例如，oracle\$1test。

1. 若要上傳來源資料集，請選擇**檔案**或拖放檔案。

   會顯示具有名稱和狀態的來源資料表。

1. 選擇**上傳至 S3**。*上傳狀態*會變更為顯示狀態。

1. 在**檢閱資料需求**下，檢閱所選 AWS Supply Chain 功能所有必要的資料實體和資料欄。會顯示所有必要的主要和外部金鑰。

1. 選擇**繼續**。

1. 在**管理您的來源資料表**下，下列來源資料表和列出的資料欄將自動關聯並匯入資料湖。

   選擇**刪除資料表**，在匯入資料湖之前刪除任何來源資料表。  
![\[管理您的來源檔案\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_lake1.png)

1. 選擇**全部接受並繼續**。

   系統會顯示自動將資料表與 AWS Supply Chain 資料湖建立關聯的訊息。  
![\[管理目的地流程\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/data_lake3.png)

1. 在**管理目的地流程**下，您可以檢閱每個自動關聯的資料表。

   預設會啟用**自動關聯**，來源資料欄會自動與目的地資料欄建立關聯。若要更新自動關聯的欄，您可以更新 SQL 配方來建立自訂配方。

1. 在**來源資料欄**下，會列出所有未關聯的來源資料欄。將未關聯的資料欄拖放至右側的**目的地資料欄**。

1. 請遵循每個自動關聯資料表的上述步驟。

1. 選擇**提交**。

1. 選擇**結束並檢閱目的地流程**。

# 將後續檔案上傳至現有來源
<a name="incremental_file_upload"></a>

有兩種方式可將後續資料集上傳至現有來源。您可以在**來源流程**索引標籤下顯示的 Amazon S3 路徑上上傳資料集，或選擇**動作**索引標籤下的**上傳檔案**。

如果您使用自動連接器、執行指令碼或使用中間軟體解決方案來擷取資料集 AWS Supply Chain，則必須Amazon S3使用**來源流程**索引標籤下顯示的 Amazon S3 路徑來更新 Amazon S3 路徑。

**注意**  
如果具有相同檔案名稱的現有檔案重新上傳至 Amazon S3， AWS Supply Chain 將覆寫 Amazon S3 上的檔案。

![\[後續檔案上傳的資料擷取\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/Data_lake_upload.png)


# 連線至 EDI
<a name="connecting-edi"></a>

若要從 EDI 資料來源擷取資料，請遵循下列程序。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**。

1. 在**資料湖**頁面上，選擇**新增來源**。

   隨即顯示**選取您的供應鏈資料來源**頁面。

1. 選擇 **EDI**。

1. 在 **EDI Connection Details** 頁面的**命名連線**下，輸入連線的名稱。

1. （選用） 在**連線描述**下，輸入連線的描述。

1. 在 **Amazon S3 儲存貯體帳單**下，檢閱 Amazon S3 帳單資訊，然後選取**確認**。

1. 選擇 **Next (下一步)**。

1. 在**資料映射**下，選擇**開始使用**。

1. 
**注意**  
支援 EDI 850、EDI 860 和 EDI 856 AWS Supply Chain。
**注意**  
必要欄位已映射。只有在您想要對預設轉換配方進行特定變更時，才執行此步驟。

   在**映射配方**頁面上，您可以在**欄位映射**下檢視預設轉換配方。

   選擇**新增映射**，以映射任何其他目的地欄位。**必要目的地欄位**為必要欄位。選擇**目的地欄位**以新增其他自訂目的地欄位。
**注意**  
檢閱每個實體群組下的所有實體 （例如 EDI 850 實體群組的傳入訂單、傳入訂單行和傳入訂單行排程）。

1. 若要從轉換配方檢視來源欄位值和資料映射，您可以上傳範例資料。在**映射配方**頁面的**上傳範例資料**下，選擇**瀏覽檔案**或拖放檔案。範例資料檔案必須包含必要的參數，並包含來源欄位名稱。

1. 選擇**全部接受並繼續**。

1. 在**檢閱並確認**下，您可以檢視資料連線摘要。若要編輯資料欄位映射，請選擇**返回資料映射**。

1. 選擇**確認並設定資料擷取**，以檢閱必須上傳來源資料的 Amazon S3 路徑，以開始擷取程序。

1. 如果您想要**稍後再擷取資料，請選擇確認並稍後設定**資料擷取。從 AWS Supply Chain 儀表板建立連線之後，您可以隨時擷取資料。

1. 在 AWS Supply Chain 儀表板上，選擇**開啟連線**。選取您要擷取資料的連線資料流程，選擇垂直省略，然後選取**擷取設定**。

# 連線至 S/4 HANA
<a name="connecting-sap-hana"></a>

您必須先完成下列先決條件，才能連線至 S/4 HANA 資料來源。之後， AWS Supply Chain 會自動建立 Amazon S3 路徑，並從 SAP 來源資料表擷取資料。

## 連線至 S/4 HANA 的先決條件
<a name="prerequisites-s4hana"></a>

若要連線至 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 連線
<a name="connecting-s4hana"></a>

若要從 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 資料來源
<a name="s4-datasources"></a>

設定下列 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  | 

# 連線至 SAP ECC 6.0
<a name="connecting-sap-ecc"></a>

若要從 SAP ECC 6.0 擷取您的資料，請遵循下列程序。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**。

1. 在**資料湖**頁面上，選擇**新增來源**。

   隨即顯示**選取您的供應鏈資料來源**頁面。

1. 選擇 **SAP ECC**。

1. 在 **SAP ECC 連線詳細資訊**下，輸入下列項目：
   + **連線名稱** – 輸入連線的名稱。連線名稱只能包含字母、數字和破折號。
   + **連線描述** – 輸入連線的描述。

1. 在 **Amazon S3 儲存貯體帳單**下，檢閱 Amazon S3 帳單資訊，然後選取**確認**。

1. 選擇 **Next (下一步)**。

1. 在**資料映射**下，選擇**開始使用**。

1. 
**注意**  
必要欄位已映射。只有在您想要對預設轉換配方進行特定變更時，才執行此步驟。

   在**映射配方**頁面上，您可以在**欄位映射**下檢視預設轉換配方。

   選擇**新增映射**以映射任何其他目的地欄位。**必要目的地欄位**為必要欄位。選擇**目的地欄位**以新增其他自訂目的地欄位。

1. 
**注意**  
您只能使用 AWS Glue DataBrew 編輯交易實體的配方。使用 AWS Supply Chain 下載您的配方，並在 DataBrew 中編輯它們。然後將配方上傳回 AWS Supply Chain。您無法使用 AWS Supply Chain Web 應用程式編輯配方中的交易資料欄位。

    （選用） 在**配方動作**下，您可以執行下列動作：
   + **下載配方檔案** - 選取**下載**以使用 DataBrew 離線編輯配方檔案。
   + **上傳配方檔案** - 選擇**瀏覽檔案**，或移動 （拖放） 您編輯的配方檔案。選取**確認上傳**以上傳編輯的配方檔案，並修改您的資料欄位映射。
   + **重設為預設配方** - 選取**是，重設我的配方**以移除所有自訂映射，並還原為 建議的預設配方 AWS Supply Chain。

1. 若要編輯來源欄位映射並驗證轉換配方，您可以上傳範例資料。在**映射配方**頁面的**上傳範例資料**下，選擇**瀏覽檔案**或移動 （拖放） 檔案。範例資料檔案必須包含必要的參數，並包含來源欄位名稱。

1. 選擇**全部接受並繼續**。

1. 在**檢閱並確認**下，您可以檢視資料連線摘要。若要編輯資料欄位映射，請選擇**返回資料映射**。

1. 若要檢閱您必須上傳 SAP 來源資料的 Amazon S3 路徑以進行擷取，請選擇**確認並設定資料擷取**。或者，您可以選擇**確認，稍後再設定資料擷取**。您可以隨時檢視資料擷取資訊。從 AWS Supply Chain 儀表板中選取**連線**。選取您要擷取資料的連線資料流程，選擇垂直省略，然後選取**擷取設定**。

1. 如果您未使用 Amazon S3 API 擷取資料，請在 Amazon S3 主控台上手動建立 Amazon S3 路徑。如需如何建立路徑的詳細資訊，請參閱[將資料上傳至 Amazon S3 儲存貯體](manually-uploading-data.md)。

1. 檢閱下表，將 AWS Supply Chain 資料實體與 SAP 來源對應。
**重要**  
在 **Amazon S3 路徑**頁面上，您必須在子實體之前上傳父實體。您可以先上傳所有父實體，然後一起上傳所有子實體。

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/connecting-sap-ecc.html)

# 新增用於供應規劃的新傳出來源
<a name="adding_new_outbound_connector"></a>

您可以使用新的傳出來源上傳更新的 *Supply Planning* 採購訂單請求或計劃增強功能。

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**，然後選擇 **Data Ingestion** 索引標籤。

   **資料擷取**頁面隨即出現。

1. 選擇**新增傳出來源**。

   **Amazon S3 Connection 詳細資訊**頁面隨即出現。

1. 在**連線名稱**下，輸入 Amazon S3 連線的名稱。

1. 在**傳出資料**下，選取您要匯出的傳出資料流程。支援採購訂單請求和供應預測資料流程。

1. 選擇**確認**。

   建立新的傳出來源，並顯示**連線**頁面。

# 擷取現有連線的資料
<a name="ingesting-data"></a>

如果您使用的是 Amazon S3，以下是擷取選項：
+ **附加** – 若要附加擷取資料或增量擷取，來源路徑中的所有檔案都會合併為單一資料集，然後再擷取至資料湖。此方法可確保跨越數天的檔案資料的完整性。當您從 S3 儲存貯體中的來源路徑移除檔案時，只有來源路徑中可用的檔案會擷取到資料湖中。

   *附加*選項可確保在資料湖中複寫和同步 Amazon S3 中的檔案。
+ **覆寫** – 在取代期間，資料檔案會在來源路徑中更新時擷取到資料湖中。每個新檔案都會完全取代資料集。
**注意**  
您可以在*附加*和*覆寫*選項中刪除來源流程和對應的資料。

以下是 *EDI*、*SAP S/4 HANA* 和 *SAP ECC* 的擷取操作選項：
+ **更新** – 使用配方中使用的相同欄位更新現有資料列。
+ **取代** – 刪除現有上傳的資料，並將其取代為新的傳入資料。
+ **刪除** – 使用主要 IDs刪除一或多個資料列。

**若要開始資料擷取，請遵循下列程序。**

1. 在 AWS Supply Chain 儀表板的左側導覽窗格中，選擇 **Data Lake**。

1. 在**資料擷取**索引標籤上，選擇**連線**。

1. 選取要擷取資料的連線，然後選擇 **Data Ingestion**。

   **資料擷取組態**頁面隨即出現。

1. 選擇**開始使用**。

1. 在**資料擷取詳細資訊**頁面上，選取您是否要*更新*、*取代**或刪除*資料。選擇複製，複製 Amazon S3 路徑****。

# 將資料上傳至 Amazon S3 儲存貯體
<a name="manually-uploading-data"></a>

**注意**  
請遵循 SAP ERP 元件中心 (ECC) 連接器和 EDI 連接器的此程序，在與 AWS Supply Chain 執行個體相關聯的 S3 儲存貯體中手動擷取資料。如果您使用 Amazon S3 API 上傳資料，請參閱 [連線至 SAP ECC 6.0](connecting-sap-ecc.md)或 [連線至 EDI](connecting-edi.md)。

若要將資料上傳至與 AWS Supply Chain 執行個體相關聯的 Amazon S3 儲存貯體，請遵循下列程序。

1. 在 AWS Supply Chain 儀表板的左側導覽列上，選擇**開啟連線**。

1. 選取所需的連線。

1. 在**連線詳細資訊**頁面上，記下 Amazon S3 路徑，或選擇**複製**以複製 Amazon S3 路徑。

1. 在 [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)：// 開啟 Amazon S3 主控台並登入。

1. 在**儲存貯**體下，選取您要上傳資料夾或檔案的儲存貯體名稱 (Amazon S3 路徑中的名字）。

1. 導覽至您從 AWS Supply Chain 儀表板複製的 Amazon S3 路徑。

1. 選擇**上傳**。  
![\[將資料上傳至 Amazon S3 儲存貯體\]](http://docs.aws.amazon.com/zh_tw/aws-supply-chain/latest/userguide/images/S3_console.png)