SAP OData
エンティティの作成、読み取り、更新、削除、サービスでの関数の呼び出しなど、さまざまな操作を実行するために SAP ODATA サービスを呼び出すために使用できる OData コネクタ。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | すべてのPower Automateリージョン |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - 中国リージョンAzure - 米国国防総省 (DoD) |
| Power Apps | Premium | すべてのPower Appsリージョン |
| Power Automate（パワーオートメート） | Premium | すべてのPower Automateリージョン |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL | https://support.microsoft.com/ |
| abapi@microsoft.com |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Web サイト | https://www.odata.org/ |
| プライバシー ポリシー | https://privacy.microsoft.com/privacystatement |
| カテゴリ | IT 運用;コラボレーション |
既知の問題と制限事項
- コネクタは OData プロトコルの完全な実装ではなく、すべてのシナリオをサポートしているわけではありません。
- Power Apps表形式機能の "読み取り" サポートのみ。
- $metadata応答が大きい OData サービスの場合は、パフォーマンスの問題を回避するために、"任意の種類の OData 要求を作成する" アクションと "bypassMetadata" パラメーターを使用してください。
Authentication
コネクタでは、次の認証の種類がサポートされています。
- 基本 – ユーザー名とパスワード。
- 匿名 – 資格情報なし。
- Microsoft Entra ID統合 (APIM を使用) – APIM を介してブローカー化されたMicrosoft Entra IDベースのサインイン。
- SuccessFactors を使用したMicrosoft Entra ID – SAP SuccessFactors のサインインMicrosoft Entra IDします。
- OAuth 2.0 (プレビュー) – 汎用 OAuth 2.0 ID プロバイダー (SAP Identity Authentication Service など)。 ID プロバイダーの承認 URL、トークン URL、クライアント ID、およびクライアント シークレットを指定します。 これにより、承認コード フローが使用されるため、ユーザーは対話形式でサインインします。クラウド (ゲートウェイ以外) 接続で使用できます。
OAuth 2.0 (プレビュー) 認証の種類を使用する場合は、クライアント ID とクライアント シークレットを入力した OAuth クライアント アプリケーション (SAP Identity Authentication Service に登録されているアプリケーションなど) に、コネクタのリダイレクト URI を有効なリダイレクト/コールバック URI として登録します。 リダイレクト URI は、 https://global.consent.azure-apim.net/redirect/sapodata フォームの標準的な Power Platform のコネクタごとの同意 URL です (クラウドの接続の作成時に表示される正確な値を確認してください)。 ID プロバイダーがアップストリームの企業 ID プロバイダー (Microsoft Entra ID など) にサインインをフェデレーションする場合、そのフェデレーションは 2 つのプロバイダー間で個別に構成され、このリダイレクト URI は使用されません。
Virtual Network のサポート (パブリック プレビュー)
コネクタが Power Platform 環境で使用されている場合、Virtual Network にリンクされている場合、次の制限が適用されます。
- オンプレミス データ ゲートウェイはサポートされていません
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| アノニマス | OData サービスには匿名アクセスを使用します。 | すべてのリージョン | 共有不可 |
| Basic | OData サービスにアクセスするには、ユーザー名とパスワードを使用します。 | すべてのリージョン | 共有不可 |
| Microsoft Entra ID 統合 (APIM) | Microsoft Entra IDを使用して SAP インスタンスにアクセスします。 | すべてのリージョン | 共有不可 |
| SuccessFactors を使用した Microsoft Entra ID | SuccessFactors への認証にはMicrosoft Entra IDを使用します。 | すべてのリージョン | 共有不可 |
| OAuth 2.0 (プレビュー) | 汎用 OAuth 2.0 ID プロバイダー (SAP Identity Authentication Service など) を使用して、SAP OData サービスにアクセスします。 | すべてのリージョン | 共有不可 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
アノニマス
認証 ID: 匿名
適用対象: すべてのリージョン
OData サービスには匿名アクセスを使用します。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| OData ベース URI | 文字列 | 正しい | |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) | |
| API キー名 | 文字列 | ||
| API キー値 | securestring | ||
| SAP クライアント名 | 文字列 | ||
| SAP クライアント値 | securestring |
Basic
認証 ID: 基本
適用対象: すべてのリージョン
OData サービスにアクセスするには、ユーザー名とパスワードを使用します。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| OData ベース URI | 文字列 | 正しい | |
| ユーザー名 | securestring | 正しい | |
| パスワード | securestring | 正しい | |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) | |
| API キー名 | 文字列 | ||
| API キー値 | securestring | ||
| SAP クライアント名 | 文字列 | ||
| SAP クライアント値 | securestring |
統合Microsoft Entra ID (APIM を使用)
認証 ID: oauth
適用対象: すべてのリージョン
Microsoft Entra IDを使用して SAP インスタンスにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Microsoft Entra ID リソース URI (アプリケーション ID URI) | 文字列 | ターゲット リソースを識別するためにMicrosoft Entra IDで使用される識別子。 | 正しい |
| OData ベース URI | 文字列 | 正しい | |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 https://docs.microsoft.com/data-integration/gateway を参照してください) | |
| API キー名 | 文字列 | ||
| API キー値 | securestring | ||
| SAP クライアント名 | 文字列 | ||
| SAP クライアント値 | securestring |
SuccessFactors を使用した Microsoft Entra ID
認証 ID: oauthsuccessfactors
適用対象: すべてのリージョン
SuccessFactors への認証にはMicrosoft Entra IDを使用します。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| 成功要因トークンの URL | 文字列 | SuccessFactors OAuth トークン エンドポイント URL (形式: https://<api-server>/oauth/token)。 |
正しい |
| サービス プロバイダー クライアント ID | 文字列 | SuccessFactors OAuth2 クライアント ID。 | 正しい |
| 会社 ID | 文字列 | CompanyId | 正しい |
| Microsoft Entra リソース URL (アプリケーション ID URI) | 文字列 | ターゲット リソースを識別するためにMicrosoft Entra IDで使用される識別子。 | 正しい |
| OData ベース URI | 文字列 | 正しい |
OAuth 2.0 (プレビュー)
認証 ID: oauth2generic
適用対象: すべてのリージョン
汎用 OAuth 2.0 ID プロバイダー (SAP Identity Authentication Service など) を使用して、SAP OData サービスにアクセスします。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| OAuth 承認 URL | 文字列 | ID プロバイダーの OAuth 2.0 承認エンドポイント URL。 | 正しい |
| OAuth トークン URL | 文字列 | ID プロバイダーの OAuth 2.0 トークン エンドポイント URL。 この URL は、トークンの更新にも使用されます。 | 正しい |
| OAuth クライアント ID | 文字列 | ID プロバイダーに登録されている OAuth 2.0 クライアント ID。 | 正しい |
| OAuth クライアント シークレット | securestring | ID プロバイダーに登録されている OAuth 2.0 クライアント シークレット。 | 正しい |
| OData ベース URI | 文字列 | 正しい | |
| API キー名 | 文字列 | ||
| API キー値 | securestring | ||
| SAP クライアント名 | 文字列 | ||
| SAP クライアント値 | securestring |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| OData ベース URI | 文字列 | 正しい | |
| 認証の種類 | 文字列 | OData サービスに接続するための認証の種類。 | 正しい |
| ユーザー名 | securestring | OData サービスへの接続に使用するユーザー名。 | 正しい |
| パスワード | securestring | OData サービスへの接続に使用するパスワード。 | 正しい |
| Gateway | gatewaySetting | オンプレミス ゲートウェイ (詳細については、 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 エンティティ データのクエリを実行します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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 エンティティを削除します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
OData エンティティ名
|
entity | True | string |
OData エンティティ名を指定してください。 |
|
OData エンティティの入力
|
entryInput | True | dynamic |
OData エンティティ入力を指定してください。 |
|
relativePath (相対パス)
|
relativePath | string |
接続の OData URI と組み合わせて、対話する完全な URI を作成します。 |
返品
- response
- object
OData エンティティの更新
OData エンティティを更新します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
OData エンティティ名
|
entity | True | string |
OData エンティティ名を指定してください。 |
|
OData エンティティの入力
|
entryInput | True | dynamic |
OData エンティティ入力を指定してください。 |
|
relativePath (相対パス)
|
relativePath | string |
接続の OData URI と組み合わせて、対話する完全な URI を作成します。 |
返品
OData エンティティの読み取り
OData エンティティを読み取る。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
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クエリ オプション。 |
返品
OData エンティティを作成する
OData エンティティを作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
OData エンティティ名
|
entity | True | string |
OData エンティティ名を指定してください。 |
|
OData エンティティの入力
|
entryInput | True | dynamic |
OData エンティティ入力を指定してください。 |
|
relativePath (相対パス)
|
relativePath | string |
接続の OData URI と組み合わせて、対話する完全な URI を作成します。 |
返品
任意の種類の OData 要求を作成する
任意の種類の OData 要求を作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
relativePath (相対パス)
|
relativePath | True | string |
接続の OData URI と組み合わせて、対話する完全な URI を作成します。 |
|
httpMethod
|
httpMethod | True | string | |
|
クエリ文字列
|
queryString | object | ||
|
ペイロード
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
CSRF トークンのフェッチを除き、(パフォーマンスのために) $metadata呼び出しをバイパスします。 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータスコード
|
statusCode | integer | |
|
構造
|
response.structured | object | |
|
unstructured
|
response.unstructured | string |
任意の種類の一括 OData 要求を作成する (プレビュー)
任意の種類の一括 OData 要求を作成します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
relativePath (相対パス)
|
relativePath | True | string |
接続の OData URI と組み合わせて、対話する完全な URI を作成します。 |
|
httpMethod
|
httpMethod | True | string | |
|
クエリ文字列
|
queryString | object | ||
|
ペイロード
|
payload | object | ||
|
bypassMetadata
|
bypassMetadata | boolean |
CSRF トークンのフェッチを除き、(パフォーマンスのために) $metadata呼び出しをバイパスします。 |
返品
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ステータスコード
|
statusCode | integer | |
|
構造
|
response.structured | object | |
|
unstructured
|
response.unstructured | string |
定義
オブジェクト
これは型 'object' です。