SAP OData
OData 連接器,可用來叫用 SAP ODATA 服務來執行各種作業,例如建立、讀取、更新和刪除實體,以及叫用服務上的函式。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 所有 Power Automate 區域 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 所有 Power Apps 區域 |
| Power Automate(自動化服務) | 進階 | 所有 Power Automate 區域 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://www.odata.org/ |
| 隱私策略 | https://privacy.microsoft.com/privacystatement |
已知問題與限制
- 連接器不是 OData 通訊協定的完整實作,而且可能不支援所有案例。
- 僅支援 Power Apps 表格式功能的「讀取」。
- 針對具有大型$metadata回應的 OData 服務,請使用「建立任何類型的 OData 要求」動作和 「bypassMetadata」 參數,以避免任何效能問題。
虛擬網路支援 (公開預覽)
在連到虛擬網路的 Power Platform 環境中使用連接器時,存在以下限制:
- 不支援內部部署資料閘道
正在建立連線
連接器支援下列驗證類型:
| 匿名 | 使用 OData 服務的匿名存取。 | 所有區域 | 不可共享 |
| 基本 | 使用使用者名稱和密碼存取 OData 服務。 | 所有區域 | 不可共享 |
| Microsoft Entra ID 整合 (與 APIM) | 使用 Microsoft Entra ID 來存取您的 SAP 執行個體。 | 所有區域 | 不可共享 |
| 使用 SuccessFactors (預覽) Microsoft Entra ID | 使用 Microsoft Entra ID 進行 SuccessFactors 的驗證。 | 所有區域 | 不可共享 |
| 預設值 [已棄用] | 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 | 所有區域 | 不可共享 |
匿名
驗證 ID:匿名
適用:所有地區
使用 OData 服務的匿名存取。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| OData 基底 URI | 字串 | 對 | |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 | |
| API 金鑰名稱 | 字串 | ||
| API 金鑰值 | securestring | ||
| SAP 用戶端名稱 | 字串 | ||
| SAP 客戶價值 | securestring |
基本
驗證 ID:基本
適用:所有地區
使用使用者名稱和密碼存取 OData 服務。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| OData 基底 URI | 字串 | 對 | |
| 用戶名稱 | securestring | 對 | |
| 密碼 | securestring | 對 | |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 | |
| API 金鑰名稱 | 字串 | ||
| API 金鑰值 | securestring | ||
| SAP 用戶端名稱 | 字串 | ||
| SAP 客戶價值 | securestring |
Microsoft Entra ID 整合 (與 APIM)
驗證 ID:oauth
適用:所有地區
使用 Microsoft Entra ID 來存取您的 SAP 執行個體。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| Microsoft Entra ID 資源 URI (應用程式識別碼 URI) | 字串 | Microsoft Entra ID 中用來識別目標資源的識別碼。 | 對 |
| OData 基底 URI | 字串 | 對 | |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 | |
| API 金鑰名稱 | 字串 | ||
| API 金鑰值 | securestring | ||
| SAP 用戶端名稱 | 字串 | ||
| SAP 客戶價值 | securestring |
使用 SuccessFactors 的 Microsoft Entra ID (預覽版)
驗證識別碼:oauthsuccessfactors
適用:所有地區
使用 Microsoft Entra ID 進行 SuccessFactors 的驗證。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| 成功因素權杖URL | 字串 | 您的 SuccessFactors OAuth 權杖端點 URL (格式: https://<api-server>/oauth/token)。 |
對 |
| 服務提供者用戶端識別碼 | 字串 | 您的 SuccessFactors OAuth2 用戶端 ID。 | 對 |
| 公司編號 | 字串 | 公司標識符 | 對 |
| Microsoft Entra 資源 URL (應用程式識別碼 URI) | 字串 | Microsoft Entra ID 中用來識別目標資源的識別碼。 | 對 |
| OData 基底 URI | 字串 | 對 |
預設值 [已棄用]
適用:所有地區
此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| OData 基底 URI | 字串 | 對 | |
| 驗證類型 | 字串 | 連線到 OData 服務的驗證類型。 | 對 |
| 用戶名稱 | securestring | 用來連線到 OData 服務的使用者名稱。 | 對 |
| 密碼 | securestring | 用來連線到 OData 服務的密碼。 | 對 |
| Gateway | 閘道設定 | 內部部署閘道 (請參閱更多 https://docs.microsoft.com/data-integration/gateway 詳細資料 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 2500 | 60 秒 |
動作
| 刪除 OData 實體 |
刪除 OData 實體。 |
| 建立 OData 實體 |
建立 OData 實體。 |
| 建立任何類型的 OData 要求 |
建立任何類型的 OData 要求。 |
| 建立任何類型的大量 OData 要求 (預覽) |
建立任何類型的大量 OData 要求。 |
| 更新 OData 實體 |
更新 OData 實體。 |
| 查詢 OData 實體 |
查詢 OData 實體資料。 |
| 讀取 OData 實體 |
讀取 OData 實體。 |
刪除 OData 實體
刪除 OData 實體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
OData 實體名稱
|
entity | True | string |
請指定 OData 實體名稱。 |
|
OData 實體輸入
|
entryInput | True | dynamic |
請指定 OData 實體輸入。 |
|
relativePath
|
relativePath | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
傳回
- response
- object
建立 OData 實體
建立 OData 實體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
OData 實體名稱
|
entity | True | string |
請指定 OData 實體名稱。 |
|
OData 實體輸入
|
entryInput | True | dynamic |
請指定 OData 實體輸入。 |
|
relativePath
|
relativePath | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
傳回
建立任何類型的 OData 要求
建立任何類型的 OData 要求。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
relativePath
|
relativePath | True | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
|
httpMethod
|
httpMethod | True | string | |
|
queryString 查詢字串
|
queryString | object | ||
|
承載
|
payload | object | ||
|
bypass元數據
|
bypassMetadata | boolean |
略過$metadata呼叫 (為了效能),但擷取 CSRF 權杖除外。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
StatusCode
|
statusCode | integer | |
|
結構化的
|
response.structured | object | |
|
非結構化
|
response.unstructured | string |
建立任何類型的大量 OData 要求 (預覽)
建立任何類型的大量 OData 要求。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
relativePath
|
relativePath | True | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
|
httpMethod
|
httpMethod | True | string | |
|
queryString 查詢字串
|
queryString | object | ||
|
承載
|
payload | object | ||
|
bypass元數據
|
bypassMetadata | boolean |
略過$metadata呼叫 (為了效能),但擷取 CSRF 權杖除外。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
StatusCode
|
statusCode | integer | |
|
結構化的
|
response.structured | object | |
|
非結構化
|
response.unstructured | string |
更新 OData 實體
更新 OData 實體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
OData 實體名稱
|
entity | True | string |
請指定 OData 實體名稱。 |
|
OData 實體輸入
|
entryInput | True | dynamic |
請指定 OData 實體輸入。 |
|
relativePath
|
relativePath | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
傳回
查詢 OData 實體
查詢 OData 實體資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
OData 實體名稱
|
entity | True | string |
請指定 OData 實體名稱。 |
|
relativePath
|
relativePath | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
|
|
$top
|
top | number |
選用$top查詢選項。 |
|
|
$skip
|
skip | number |
選用$skip查詢選項。 |
|
|
$select
|
select | string |
選用$select查詢選項。 |
|
|
$過濾器
|
filter | string |
選擇性$filter查詢選項。 |
|
|
$expand
|
expand | string |
選擇性$expand查詢選項。 |
|
|
$orderby
|
orderby | string |
選用$orderby查詢選項。 |
|
|
$search
|
search | string |
選擇性$search查詢選項。 |
|
|
$inlinecount
|
inlinecount | string |
選用$inlinecount查詢選項。 |
傳回
讀取 OData 實體
讀取 OData 實體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
OData 實體名稱
|
entity | True | string |
請指定 OData 實體名稱。 |
|
OData 實體輸入
|
entryInput | True | dynamic |
請指定 OData 實體輸入。 |
|
relativePath
|
relativePath | string |
結合連線中的 OData URI,以建立要與之互動的完整 URI。 |
|
|
$top
|
top | number |
選用$top查詢選項。 |
|
|
$skip
|
skip | number |
選用$skip查詢選項。 |
|
|
$select
|
select | string |
選用$select查詢選項。 |
|
|
$過濾器
|
filter | string |
選擇性$filter查詢選項。 |
|
|
$expand
|
expand | string |
選擇性$expand查詢選項。 |
|
|
$orderby
|
orderby | string |
選用$orderby查詢選項。 |
|
|
$search
|
search | string |
選擇性$search查詢選項。 |
|
|
$inlinecount
|
inlinecount | string |
選用$inlinecount查詢選項。 |
傳回
定義
物件
這是類型 'object'。