SAP 工作負載整合 - Amazon Quick Suite
您可以做什麼開始之前準備 SAP 系統組態和身分驗證設定 SAP 整合依連接器類型分類的可用操作查詢參數管理 SAP 工作負載整合故障診斷 SAP 工作負載整合

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

SAP 工作負載整合

透過 SAP 工作負載整合，您可以在各種 SAP 系統中執行動作。管理業務資料、庫存、資料和業務流程。這些整合僅支援動作執行，且需要 Amazon Quick Suite Pro 層或更高層。

您可以做什麼

SAP 工作負載整合提供企業級連線，協助您使用 SAP 系統。

動作連接器

在 SAP 系統中執行動作。透過 SAP APIs 建立、更新和管理業務資料、庫存記錄、材料資訊和其他企業操作。

多個 SAP 模組

支援五種不同的整合類型：物料清單、業務合作夥伴、物料庫存、實體庫存文件和產品主檔。

開始之前

設定 SAP 工作負載整合之前，請確定您有下列項目：

  • 已安裝並設定適當模組的 SAP 系統。

  • 具有必要許可和授權的 SAP 使用者帳戶。

  • Amazon Quick Suite 作者或更新版本。

  • Amazon Quick Suite 和 SAP 系統之間的網路連線。

準備 SAP 系統組態和身分驗證

在 Amazon Quick Suite 中設定整合之前，請準備 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 組態指南

SAP API 啟用

確保必要的 SAP API 服務處於作用中狀態：

  • 為您選擇的 SAP 連接器啟用特定 API 服務

  • 驗證 SAP 系統中的 API 服務狀態

  • 請參閱 API 啟用的 SAP 文件：SAP API 服務啟用指南

可用的 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 Suite 主控台中，選擇整合。

  2. 選取其中一個可用的 SAP 連接器：

    • SAP 物料清單

    • SAP 業務合作夥伴

    • SAP 物料庫存

    • SAP 實體庫存文件

    • SAP 產品主伺服器

  3. 按一下新增 （加 "+" 按鈕）。

  4. 填寫 SAP 整合的名稱和描述。

  5. 選擇整合的連線類型。

  6. 使用其中一種支援的方法來設定身分驗證：

    1. OAuth 2.0 組態

      對於 OAuth 2.0 身分驗證，請提供：

      • 用戶端 ID - 您的 SAP OAuth 用戶端 ID

      • 用戶端秘密 - 您的 SAP OAuth 用戶端秘密

      • 權杖 URL - OAuth 權杖端點 URL

      • 網域 URL - SAP 系統 API 端點 URL

    2. 基本身分驗證組態

      針對基本身分驗證，請提供：

      • 使用者名稱 - 您的 SAP 系統使用者名稱

      • 密碼 - 您的 SAP 系統密碼

      • 網域 URL - SAP 系統 API 端點 URL

  7. 選取建立並繼續。

  8. 選擇要與之共用整合的使用者。

  9. 按一下 Next (下一步)。

預期的結果

成功設定後，您的 SAP 工作負載整合會出現在整合清單中，可用於 Amazon Quick Suite 工作流程、自動化和 AI 代理器。您可以使用設定的身分驗證憑證，直接從 Amazon Quick Suite 執行 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 回應。使用這些參數來最佳化資料擷取和處理。

支援的查詢參數
# 參數 Description (描述) 類型
1 $top 限制傳回項目的數量 integer
2 $skip 略過指定數量的項目 integer
3 $filter 根據指定的條件篩選結果 string
4 $orderby 依指定欄位排序結果 陣列
5 $select 選取要傳回的特定屬性 陣列
6 $expand 展開相關實體 陣列
7 $inlinecount 包含回應中的項目計數 string

管理 SAP 工作負載整合

建立 SAP 工作負載整合之後，您可以透過數個選項來管理它。

編輯整合設定

請依照下列步驟修改 SAP 工作負載整合設定。

  1. 在 Amazon Quick Suite 主控台中，選擇整合。

  2. 從整合網格中選擇您的 SAP 工作負載整合類型。

  3. 從清單中選擇您的整合，然後選擇編輯。

  4. 修改整合設定：

    • 更新身分驗證憑證 （使用者名稱和密碼）。

    • 變更 SAP 系統 URL 或連線設定。

    • 修改整合名稱或描述。

  5. 選擇儲存變更以套用您的修改。

共用整合

您可以與組織中的其他使用者共用 SAP 工作負載動作連接器。

  1. 在 SAP 整合詳細資訊頁面中，選擇共用。

  2. 設定共用選項：

    • 與特定使用者共用 - 輸入使用者名稱或電子郵件地址。

    • 與組織共用 - 可供組織中的所有使用者使用。

  3. 設定共用存取的許可層級。

  4. 選擇共用整合以套用共用設定。

刪除整合

請依照下列步驟永久移除您的 SAP 整合。

  1. 在 SAP 工作負載整合詳細資訊頁面中，選擇刪除。

  2. 檢閱刪除影響，包括使用此整合的任何工作流程或自動化。

  3. 輸入整合名稱以確認刪除。

  4. 選擇刪除整合以永久移除它。

故障診斷 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 系統提醒或已知問題

  • 在確認系統可用性後重試操作