本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# SAP 工作負載整合
透過 SAP 工作負載整合，您可以在各種 SAP 系統中執行動作。管理業務資料、庫存、資料和業務流程。這些整合僅支援動作執行，且需要 Amazon Quick Pro 層或更高版本。
## 您可以做什麼
SAP 工作負載整合提供企業級連線，協助您使用 SAP 系統。
**動作連接器**
在 SAP 系統中執行動作。透過 SAP APIs 建立、更新和管理業務資料、庫存記錄、材料資訊和其他企業操作。
**多個 SAP 模組**
支援五種不同的整合類型：物料清單、業務合作夥伴、物料庫存、實體庫存文件和產品主檔。
## 開始之前
設定 SAP 工作負載整合之前，請確定您有下列項目：
+ 已安裝並設定適當模組的 SAP 系統。
+ 具有必要許可和授權的 SAP 使用者帳戶。
+ Amazon Quick Author 或更新版本。
+ Amazon Quick 和 SAP 系統之間的網路連線。
## 準備 SAP 系統組態和身分驗證
在 Amazon Quick 中設定整合之前，請準備您的 SAP 系統組態和使用者身分驗證。SAP 工作負載整合支援多種身分驗證方法，且需要適當的系統設定。
### 身分驗證方法
SAP 工作負載整合支援兩種身分驗證方法：
**OAuth 2.0 （建議）**
自動化工作流程的安全身分驗證方法。在您的 SAP 系統中需要 OAuth 組態。
**必要參數：**
+ **用戶端 ID** - SAP OAuth 用戶端 ID
+ **用戶端秘密** - SAP OAuth 用戶端秘密
+ **權杖 URL** - OAuth 權杖端點 （例如 `https://hostname:port/sap/bc/sec/oauth2/token?sap-client=100`)
+ **網域 URL** - SAP 系統 API 端點 （例如 `https://hostname:port/sap/opu/odata/sap/API_BUSINESS_PARTNER`)
**基本身分驗證**
直接 SAP 系統存取的使用者名稱和密碼身分驗證。
**必要參數：**
+ **使用者名稱** - SAP 系統使用者名稱
+ **密碼** - SAP 系統密碼
+ **網域 URL** - SAP 系統 API 端點
### SAP 系統組態需求
使用 SAP 工作負載整合之前，請確定您的 SAP 系統已正確設定：
#### OAuth 2.0 設定
對於 OAuth 2.0 身分驗證：
+ 使用適當的範圍設定 OAuth 授權伺服器
+ 使用交易代碼驗證服務已啟用 OAuth `/IWFND/MAINT_SERVICE`
+ 如需詳細的 OAuth 2.0 組態，請參閱 SAP 文件：[OAuth 2.0 組態指南](https://help.sap.com/docs/ABAP_PLATFORM_NEW/fd0fc52fd22b45f29d274a7f8236e768/cdb122d5b0784c77bf1bcce17f730e74.html)
#### SAP API 啟用
確保必要的 SAP API 服務處於作用中狀態：
+ 為您選擇的 SAP 連接器啟用特定 API 服務
+ 驗證 SAP 系統中的 API 服務狀態
+ 請參閱 API 啟用的 SAP 文件：[SAP API 服務啟用指南](https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/1b/023c1cad774eeb8b85b25c86d94f87/frameset.htm)
### 可用的 SAP 工作負載整合類型
選擇符合您業務需求的 SAP 整合類型，並確保系統中有對應的 SAP 模組可用。
**SAP 物料清單**
管理物料清單資料，包括元件清單、數量和製造規格。
**必要範圍：** `ZAPI_BILL_OF_MATERIAL_SRV_0002`
**SAP 業務合作夥伴**
處理業務合作夥伴資訊，包括客戶和廠商資料、聯絡詳細資訊和關係管理。
**必要範圍：** `ZAPI_BUSINESS_PARTNER_0001`
**SAP 物料庫存**
存取和管理物料庫存層級、庫存移動和倉儲資訊。
**必要範圍：** `ZAPI_MATERIAL_STOCK_SRV_0001`
**SAP 實體庫存文件**
建立和管理實體庫存文件、庫存計數和庫存對帳程序。
**必要範圍：** `ZAPI_MATERIAL_STOCK_SRV_0001`
**SAP 產品主伺服器**
維護產品主資料，包括材料規格、分類和產品階層。
**必要範圍：** `ZAPI_PRODUCT_SRV_0001`
### SAP 工作負載身分驗證設定
準備 SAP 使用者身分驗證憑證，並確保適當的系統存取許可。
+ **SAP 系統 URL** - 取得 SAP 系統的基本 URL 或伺服器地址。
+ **使用者登入**資料 - 建立或識別具有適當許可的 SAP 使用者帳戶。
+ **系統許可** - 確保使用者帳戶具有您計劃整合的特定 SAP 模組所需的 SAP 授權和交易代碼。
+ **網路存取** - 確認您的 SAP 系統可從外部連線存取，且防火牆規則允許整合。
## 設定 SAP 整合
準備 SAP 系統組態和身分驗證登入資料後，所有 SAP 整合類型的設定程序都類似。根據您的安全需求，選擇 OAuth 2.0 或基本身分驗證。
1. 在 Amazon Quick 主控台中，選擇**整合**。
1. 選取其中一個可用的 SAP 連接器：
+ **SAP 物料清單**
+ **SAP 業務合作夥伴**
+ **SAP 物料庫存**
+ **SAP 實體庫存文件**
+ **SAP 產品主伺服器**
1. 按一下**新增** （加 "\$1" 按鈕）。
1. 填寫 SAP 整合的名稱和描述。
1. 選擇整合的連線類型。
1. 使用其中一種支援的方法來設定身分驗證：
1. **OAuth 2.0 組態**
對於 OAuth 2.0 身分驗證，請提供：
+ **用戶端 ID** - 您的 SAP OAuth 用戶端 ID
+ **用戶端秘密** - 您的 SAP OAuth 用戶端秘密
+ **權杖 URL** - OAuth 權杖端點 URL
+ **網域 URL** - SAP 系統 API 端點 URL
1. **基本身分驗證組態**
針對基本身分驗證，請提供：
+ **使用者名稱** - 您的 SAP 系統使用者名稱
+ **密碼** - 您的 SAP 系統密碼
+ **網域 URL** - SAP 系統 API 端點 URL
1. 選取**建立並繼續**。
1. 選擇要與之共用整合的使用者。
1. 按一下 **Next (下一步)**。
### 預期的結果
成功設定後，您的 SAP 工作負載整合會出現在整合清單中，可用於 Amazon Quick 工作流程、自動化和 AI 代理器。您可以使用設定的身分驗證憑證，直接從 Amazon Quick 執行 SAP 特定動作。
## 依連接器類型分類的可用操作
每個 SAP 工作負載連接器都提供專為其業務網域量身打造的特定操作。檢閱所選連接器類型的可用操作。
### SAP 物料清單操作
管理物料清單資料的可用操作：
+ **取得物料 BOM 項目** - 擷取指定物料的物料明細
**操作 ID：**`getMaterialBOMItem`
**端點：** `GET /MaterialBOMItem`
### SAP 業務合作夥伴操作
管理業務合作夥伴資料的可用操作：
+ **取得業務合作夥伴** - 擷取業務合作夥伴一般資料
**操作 ID：**`getBusinessPartner`
+ **取得業務合作夥伴地址** - 擷取業務合作夥伴地址資料
**操作 ID：**`getBusinessPartnerAddress`
+ **取得業務合作夥伴角色** - 擷取業務合作夥伴角色資料
**操作 ID：**`getBusinessPartnerRole`
+ **依 ID 取得業務合作夥伴** - 依業務合作夥伴號碼擷取業務合作夥伴資料
**操作 ID：**`getBusinessPartnerByID`
**必要參數：**`BusinessPartner`（字串，最多 10 個字元）
+ **依 ID 取得業務合作夥伴角色** - 使用金鑰欄位擷取業務合作夥伴角色資料
**操作 ID：**`getBusinessPartnerRoleByID`
**必要參數：** `BusinessPartner` （字串，最多 10 個字元）、 `BusinessPartnerRole`（字串，最多 6 個字元）
### SAP 物料庫存操作
管理物料庫存資料的可用操作：
+ **取得帳戶中的物料庫存** - 擷取帳戶模型中張貼的物料庫存資訊
**操作 ID：**`getMaterialStockInAccount`
### SAP 實體庫存文件操作
管理實體庫存文件的可用操作：
+ **取得 PhysInventory 文件項目** - 讀取實體庫存項目的相關資訊
**操作 ID：**`getPhysInventoryDocItem`
### SAP 產品主控操作
管理產品主資料的可用操作：
+ **取得產品主要項目** - 傳回產品主要記錄
**操作 ID：**`getProductMaster`
+ **依物料取得工廠資料** - 傳回產品主要記錄的工廠資料
**操作 ID：**`getPlantDataByMaterial`
**必要參數：**`Product`（字串，最多 40 個字元）
+ **依材料取得供應規劃資料** - 依產品編號和工廠傳回供應規劃資料
**操作 ID：**`getSupplyPlanningDataByMaterial`
**必要參數：** `Product` （字串，最多 40 個字元）、 `Plant`（字串，最多 4 個字元）
## 查詢參數
SAP 連接器支援標準查詢參數來篩選、排序和格式化 API 回應。使用這些參數來最佳化資料擷取和處理。
**支援的查詢參數**
| \$1 | 參數 | 說明 | Type |
| --- | --- | --- | --- |
| 1 | \$1top | 限制傳回項目的數量 | integer |
| 2 | \$1skip | 略過指定數量的項目 | integer |
| 3 | \$1filter | 根據指定的條件篩選結果 | string |
| 4 | \$1orderby | 依指定欄位排序結果 | 陣列 |
| 5 | \$1select | 選取要傳回的特定屬性 | 陣列 |
| 6 | \$1expand | 展開相關實體 | 陣列 |
| 7 | \$1inlinecount | 包含回應中的項目計數 | string |
## 管理 SAP 工作負載整合
建立 SAP 工作負載整合之後，您可以透過數個選項來管理它。
### 編輯整合設定
請依照下列步驟修改 SAP 工作負載整合設定。
1. 在 Amazon Quick 主控台中，選擇**整合**。
1. 從整合網格中選擇您的 SAP 工作負載整合類型。
1. 從清單中選擇您的整合，然後選擇**編輯**。
1. 修改整合設定：
+ 更新身分驗證登入資料 （使用者名稱和密碼）。
+ 變更 SAP 系統 URL 或連線設定。
+ 修改整合名稱或描述。
1. 選擇**儲存變更**以套用您的修改。
### 共用整合
您可以與組織中的其他使用者共用 SAP 工作負載動作連接器。
1. 在 SAP 整合詳細資訊頁面中，選擇**共用**。
1. 設定共用選項：
+ **與特定使用者共用** - 輸入使用者名稱或電子郵件地址。
+ **與組織共用** - 可供組織中的所有使用者使用。
1. 設定共用存取的許可層級。
1. 選擇**共用整合**以套用共用設定。
### 刪除整合
請依照下列步驟永久移除您的 SAP 整合。
1. 在 SAP 工作負載整合詳細資訊頁面中，選擇**刪除**。
1. 檢閱刪除影響，包括使用此整合的任何工作流程或自動化。
1. 輸入整合名稱以確認刪除。
1. 選擇**刪除整合**以永久移除它。
## 故障診斷 SAP 工作負載整合
使用這些疑難排解秘訣來解決常見的 SAP 工作負載整合問題。
### 驗證問題
OAuth 2.0 身分驗證失敗
**徵狀：**字符產生失敗、無效的用戶端登入資料或 OAuth 範圍錯誤。
**解決方法：**
+ 驗證 OAuth 用戶端 ID 和用戶端秘密是否正確
+ 檢查 OAuth 是否使用交易在 SAP 中正確設定 `/IWFND/MAINT_SERVICE`
+ 確定已針對 SAP 工作負載連接器類型正確設定所需的範圍
+ 驗證字符 URL 格式與您的 SAP 系統組態相符
基本身分驗證失敗
**徵狀：**登入失敗、無效登入資料或存取遭拒錯誤。
**解決方法：**
+ 驗證 SAP 使用者名稱和密碼是否正確
+ 檢查使用者帳戶是否具有必要的 SAP 授權
+ 確保使用者帳戶未鎖定或過期
+ 驗證網域 URL 是否可存取且格式正確
### SAP 系統組態問題
API 服務未啟用
**症狀：**服務無法使用錯誤、找不到 API 端點或 HTTP 404 回應。
**解決方法：**
+ 確認您的系統中已啟用必要的 SAP API 服務
+ 使用 SAP 交易代碼檢查 API 服務狀態
+ 確保 API 服務對應至您選擇的 SAP 連接器類型
+ 請聯絡您的 SAP 管理員以啟用缺少的 API 服務
連線逾時。
**症狀：**請求逾時、網路連線錯誤或回應時間緩慢。
**解決方法：**
+ 檢查您的 SAP 系統 URL 是否正確且可存取
+ 驗證網路連線允許連線至 SAP 系統
+ 確保防火牆規則允許整合流量
+ 檢查 SAP 系統效能和可用性
### 許可和授權錯誤
SAP 授權不足
**症狀：**存取遭拒的錯誤、缺少授權訊息或受限的操作失敗。
**解決方法：**
+ 確保已驗證的使用者擁有特定模組所需的 SAP 授權
+ 確認使用者可存取必要的交易代碼
+ 檢查使用者帳戶是否具有適當的角色指派
+ 請聯絡您的 SAP 管理員以授予缺少的許可
範圍許可錯誤
**徵狀：**OAuth 範圍錯誤、API 操作的許可不足，或存取訊息受限。
**解決方法：**
+ 驗證 OAuth 組態包含連接器類型所需的範圍
+ 檢查 SAP 系統中是否適當授予範圍許可
+ 確保已授予 OAuth 用戶端必要的 API 存取權
### 資料格式和參數錯誤
無效的參數格式
**徵狀：**資料驗證錯誤、無效的欄位長度訊息或參數格式例外狀況。
**解決方法：**
+ 檢閱動作參數，並確保它們符合預期的 SAP 資料格式
+ 檢查欄位長度是否符合 SAP 系統需求 （例如 BusinessPartner 最多 10 個字元）
+ 驗證特定 SAP 模組的資料類型是否正確
+ 確保為操作提供所有必要欄位
查詢參數錯誤
**徵狀：**查詢語法錯誤、不支援的參數訊息或格式不正確的請求錯誤。
**解決方法：**
+ 驗證參數是否使用正確的語法 （例如 、`$filter``$top`、`$skip`)
+ 檢查參數值的格式是否正確
+ 確保 SAP API 支援使用的特定參數
+ 如需支援的查詢選項，請參閱 SAP API 文件
### SAP 系統可用性問題
SAP 系統無法使用
**症狀：**連線遭拒的錯誤、系統未回應或服務無法使用的訊息。
**解決方法：**
+ 向您的 SAP 管理員檢查 SAP 系統狀態和可用性
+ 確認是否有排定的維護時段會影響系統
+ 檢查是否有任何 SAP 系統提醒或已知問題
+ 在確認系統可用性後重試操作