Microsoft Dataverse [非推奨]
Microsoft Dataverse の環境データベースへのアクセスを提供します。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | すべての Power Automate リージョン |
| ロジック アプリ | Standard | すべての Logic Apps リージョン |
| Power Apps | - | 利用できません |
| Power Automate | Premium | すべての Power Automate リージョン |
| お問い合わせ | |
|---|---|
| 名前 | Microsoft |
| URL |
Microsoft LogicApps のサポート Microsoft Power Automate のサポート |
| コネクタ メタデータ | |
|---|---|
| Publisher | Microsoft |
| Website | https://powerapps.microsoft.com/common-data-service/ |
注
Microsoft Dataverse (レガシ) コネクタは、Microsoft Dataverse コネクタ が Logic Apps をサポートするまで、Microsoft によってサポートされます。
Power Apps でこのコネクタを使用するには、Power Apps でこのコネクタを使用する方法の詳細を確認してください。
既知の問題と制限事項
- 管理モードが "オン" に設定されている運用環境で CDS トリガーが機能しない場合があります。 この問題が発生した場合の回避策は、Power Platforms 管理センターで管理モードをオフにすることです。
- 使用環境 (サンドボックスまたは運用環境) に対して管理モードが有効になっている場合、 レコードが変更 されたときに Power Automate フローがトリガーされ、レコードが変更されても起動しません。 管理モードの設定方法の詳細については、 このページを参照してください。
- フローで "レコードが選択されたとき" トリガーを使用し、その直後に If 条件ステップを実行すると、条件の属性に null 値がある場合にエラーが発生します。 表示されるエラー メッセージは、"無効な型です。 String が必要ですが、Null が返されました。"。 推奨される回避策は、"レコードが選択されたとき" と If 条件ステップの間に "行の取得" アクションを挿入することです。 条件で "行の取得" アクションの出力を使用すると、このエラーを回避できます。
Power Apps のデータ型のマッピング
| Power Apps | Microsoft Dataverse (レガシ) |
|---|---|
| 選択肢 | 選択肢、はい/いいえ |
| DateTime | 日付時刻、日付と時刻、日付のみ |
| Image | Image |
| Number | 浮動小数点数、通貨、10 進数、期間、言語、タイムゾーン、整数 |
| テキスト | 電子メール、複数行テキスト、電話、テキスト、テキスト領域、ティッカー 記号、URL |
| Guid | 一意識別子 |
Dataverse の Power Apps の委任可能な関数と操作
特定のデータ型に対するこれらの Power Apps 操作は、(Power Apps 内でローカルに処理するのではなく) 処理のために Dataverse に委任される場合があります。
| Item | 数値 [1] | テキスト [2] | 選択肢 | DateTime [3] | Guid |
|---|---|---|---|---|---|
| Filter | イエス | イエス | イエス | イエス | イエス |
| ソート | イエス | イエス | いいえ | イエス | - |
| SortByColumns | イエス | イエス | いいえ | イエス | - |
| 参照 | イエス | イエス | イエス | イエス | イエス |
| =, <> | イエス | イエス | イエス | イエス | イエス |
| <、 <=、 >、 >= | イエス | イエス | いいえ | イエス | - |
| And/Or/Not | イエス | イエス | イエス | イエス | イエス |
| StartsWith | - | イエス | - | - | - |
| IsBlank | はい [4] | はい [4] | いいえ [4] | はい [4] | イエス |
| Sum、Min、Max、Avg | はい [5] | - | - | いいえ | - |
- 算術式 (たとえば、Filter(table, field + 10 > 100) を含む数値は委任できません。 言語とタイムゾーンは委任できません。
- Trim[Ends] または Len はサポートされていません。 Left、Mid、Right、Upper、Lower、Replace、Substitute などの他の関数をサポートしています。
- DateTime は、通常、DateTime 関数 Now() と Today() を除き、委任可能です。
- 比較をサポートします。 たとえば、Filter(TableName, MyCol = Blank()) などです。
- 集計関数は、50,000 行のコレクションに制限されます。 必要に応じて、Filter 関数を使用して、集計関数を使用する前に、より大きなセットから 50,000 行を選択します。
注
Dataverse の選択肢、Guid、集計関数は、新しいバージョンのコネクタでのみサポートされます。 使用している Power Apps のバージョンに応じて、次のいずれかのタイトルのプレビュー スイッチでこのコネクタを有効にします。
-
Dataverse のリレーショナル データ、選択肢、およびその他の新機能
またはこの試験段階のスイッチ: -
Dataverse コネクタを使用する
これらのスイッチを見つけるには、[ファイル] メニューを開き、[アプリの設定]、[Advanced 設定>を選択します。
コネクタの詳細
コネクタの詳細については、 詳細なセクションを参照してください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| クライアント証明書の認証 | PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する | すべてのリージョン | 共有可能 |
| Oauth | Oauth | すべてのリージョン | 共有可能 |
| サービス プリンシパル | クライアント ID とシークレットを使用して Microsoft Entra ID 資格情報を指定する | すべてのリージョン | 共有可能 |
| 既定 [非推奨] | このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。 | すべてのリージョン | 共有不可 |
クライアント証明書の認証
認証 ID: CertOauth
適用対象: すべてのリージョン
PFX 証明書とパスワードを使用して Microsoft Entra ID 資格情報を指定する
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| Tenant | 文字列 | 正しい | |
| クライアントID | 文字列 | Microsoft Entra ID アプリケーションのクライアント ID | 正しい |
| クライアント証明書シークレット | クライアント証明書 | このアプリケーションで許可されるクライアント証明書シークレット | 正しい |
Oauth
認証 ID: Oauth
適用対象: すべてのリージョン
Oauth
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
サービス プリンシパル
認証 ID: ServicePrincipalOauth
適用対象: すべてのリージョン
クライアント ID とシークレットを使用して Microsoft Entra ID 資格情報を指定する
これは共有可能な接続です。 電源アプリが別のユーザーと共有されている場合は、接続も共有されます。 詳細については、 キャンバス アプリのコネクタの概要 - Power Apps |Microsoft Docs
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| クライアントID | 文字列 | Microsoft Entra ID アプリケーションのクライアント (またはアプリケーション) ID。 | 正しい |
| クライアント シークレット | securestring | Microsoft Entra ID アプリケーションのクライアント シークレット。 | 正しい |
| Tenant | 文字列 | Microsoft Entra ID アプリケーションのテナント ID。 | 正しい |
既定 [非推奨]
適用対象: すべてのリージョン
このオプションは、明示的な認証の種類がない古い接続に対してのみ行われ、下位互換性のためにのみ提供されます。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1000 | 60 秒 |
アクション
| テーブルから行を取得します [非推奨] |
テーブルから行を取得します。 |
| 新しい行を追加する (レガシ) [非推奨] |
この操作により、テーブルの新しい行が追加されます |
| 新しい行を追加する [非推奨] |
この操作により、テーブルの新しい行が追加されます |
| 行の一覧表示 (レガシ) [非推奨] |
この操作では、テーブルの行を取得します |
| 行の一覧表示 [非推奨] |
この操作では、テーブルの行を取得します |
| 行の取得 (レガシ) [非推奨] |
この操作は、テーブルの指定された行を取得します。 |
| 行を削除する (レガシ) [非推奨] |
この操作により、テーブル コレクションから行が削除されます |
| 行を更新する (レガシ) [非推奨] |
この操作では、テーブルの既存の行が更新されます |
| 行を更新する [非推奨] |
この操作では、テーブルの既存の行が更新されます |
テーブルから行を取得します [非推奨]
テーブルから行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
アイテム識別子
|
id | True | string |
行の識別子 |
戻り値
新しい行を追加する (レガシ) [非推奨]
この操作により、テーブルの新しい行が追加されます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
行の項目
|
item | True | dynamic |
作成する行 |
戻り値
新しい行を追加する [非推奨]
この操作により、テーブルの新しい行が追加されます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
行の項目
|
item | True | dynamic |
作成する行 |
戻り値
行の一覧表示 (レガシ) [非推奨]
この操作では、テーブルの行を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
集計変換
|
$apply | string |
OData 集計変換のシーケンス |
|
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
クエリの展開
|
$expand | string |
要求されたエントリに含める関連エントリ (既定値 = なし) |
戻り値
行の一覧表示 [非推奨]
この操作では、テーブルの行を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリ (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
|
並べ替え
|
$orderby | string |
エントリの順序を指定するための ODATA orderBy クエリ。 |
|
|
上位カウント
|
$top | integer |
取得するエントリの合計数 (既定値 = すべて)。 |
|
|
クエリの展開
|
$expand | string |
要求されたエントリに含める関連エントリ (既定値 = なし) |
戻り値
行の取得 (レガシ) [非推奨]
この操作は、テーブルの指定された行を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
アイテム識別子
|
id | True | string |
行の識別子 |
戻り値
行を削除する (レガシ) [非推奨]
この操作により、テーブル コレクションから行が削除されます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
アイテム識別子
|
id | True | string |
行の識別子 |
行を更新する (レガシ) [非推奨]
この操作では、テーブルの既存の行が更新されます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
行識別子
|
id | True | string |
行の識別子 |
|
行の項目
|
item | True | dynamic |
更新する行 |
戻り値
行を更新する [非推奨]
この操作では、テーブルの既存の行が更新されます
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
|
行識別子
|
id | True | string |
行の識別子 |
|
行の項目
|
item | True | dynamic |
更新する行 |
戻り値
トリガー
| 行が削除されたとき (管理者のみ) [非推奨] |
Dataverse で行が削除されたときにフローをトリガーします |
| 行が削除されたとき [非推奨] |
Dataverse で行が削除されたときにフローをトリガーします。 |
| 行が変更されたとき (管理者のみ) [非推奨] |
Dataverse で行が変更されたときにフローをトリガーします |
| 行が変更されたとき (管理者のみ) [非推奨] |
Dataverse で行が変更されたときにフローをトリガーします |
| 行が変更されたとき [非推奨] |
Dataverse で行が変更されたときにフローをトリガーします。 |
| 行が追加されたとき (管理者のみ) [非推奨] |
Dataverse で行が追加されたときにフローをトリガーします |
| 行が追加されたとき (管理者のみ) [非推奨] |
Dataverse で行が追加されたときにフローをトリガーします |
| 行が追加されたとき [非推奨] |
Dataverse で行が追加されたときにフローをトリガーします。 |
| 行の選択時 |
コマンド バーの [フロー] メニューから行が選択されたときにフローをトリガーします。 (Power Automate でのみ使用可能です。) |
行が削除されたとき (管理者のみ) [非推奨]
Dataverse で行が削除されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
戻り値
行が削除されたとき [非推奨]
Dataverse で行が削除されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します。 |
|
テーブル名
|
table | True | string |
テーブルを選択します。 |
|
Scope
|
scope | True | string |
スコープ。 |
戻り値
行が変更されたとき (管理者のみ) [非推奨]
Dataverse で行が変更されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
戻り値
行が変更されたとき (管理者のみ) [非推奨]
Dataverse で行が変更されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
戻り値
行が変更されたとき [非推奨]
Dataverse で行が変更されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します。 |
|
テーブル名
|
table | True | string |
テーブルを選択します。 |
|
Scope
|
scope | True | string |
スコープ。 |
|
列フィルター
|
AttributeFilters | array of string |
列フィルター |
戻り値
行が追加されたとき (管理者のみ) [非推奨]
Dataverse で行が追加されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
戻り値
行が追加されたとき (管理者のみ) [非推奨]
Dataverse で行が追加されたときにフローをトリガーします
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択する |
|
テーブル名
|
table | True | string |
テーブルを選択する |
戻り値
行が追加されたとき [非推奨]
Dataverse で行が追加されたときにフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します。 |
|
テーブル名
|
table | True | string |
テーブルを選択します。 |
|
Scope
|
scope | True | string |
スコープ。 |
戻り値
行の選択時
コマンド バーの [フロー] メニューから行が選択されたときにフローをトリガーします。 (Power Automate でのみ使用可能です。)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
ホスティング
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
スキーマ
|
schema | True | object | |
|
headersSchema
|
headersSchema | object |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
行
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
ユーザー ID
|
headers.x-ms-user-id-encoded | guid |
AAD でフローをトリガーしたユーザーを表す一意識別子です。 |
|
ユーザーの電子メール
|
headers.x-ms-user-email-encoded | byte |
フローをトリガーしたユーザーの電子メール アドレス。 |
|
ユーザー名
|
headers.x-ms-user-name-encoded | byte |
フローをトリガーしたユーザーの表示名。 |
|
タイムスタンプ
|
headers.x-ms-user-timestamp | string |
フローがトリガーされた時刻。 |