Microsoft Dataverse (legacy)
Microsoft Dataverse の環境データベースへのアクセスを提供します。
このコネクタは、次の製品および地域で利用可能です。
| サービス | クラス | リージョン |
|---|---|---|
| Logic Apps | 標準 | すべての Logic Apps 地域 |
| Power Automate | Premium | すべての Power Automate 地域 |
| Power Apps | - | 該当なし |
| 取引先担当者 | |
|---|---|
| 名前 | マイクロソフト |
| URL | Microsoft LogicApps サポート Microsoft Power Automate サポート |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | 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 値の場合、エラーが発生します。 表示されるエラー メッセージは「'無効な種類です。 文字列が必要ですが、Null になりました。」。 推奨される回避策は、「レコードが選択されたとき」と If 条件ステップの間に「行の取得」アクションを挿入することです。 条件で「行の取得」アクションの出力を使用することにより、このエラーを回避できます。
Power Apps データ型のマッピング
| Power Apps | Microsoft Dataverse (legacy) |
|---|---|
| 選択肢 | 選択肢、はい/いいえ |
| 日時 | 日付と時間、日付のみ |
| Image | Image |
| 数 | 浮動小数点数、通貨、10 進数、期間、言語、タイムゾーン、整数 |
| テキスト | メール、複数行のテキスト、電話、テキスト、テキスト領域、ティッカー シンボル、URL |
| GUID | 一意識別子 |
Power Apps は Dataverse の機能と操作を委任できる
特定のデータ型に対するこれらの Power Apps 操作は、Dataverse に処理を委任することができます (Power Apps 内でローカルに処理するのではなく)。
| アイテム | 数 [1] | テキスト [2] | 選択肢 | DateTime [3] | GUID |
|---|---|---|---|---|---|
| フィルター | 有効 | 有効 | 有効 | 有効 | 有効 |
| 並べ替え | 有効 | 有効 | 無効 | 有効 | - |
| SortByColumns | 可 | 可 | No | 可 | - |
| 参照 | 可 | 可 | 可 | 可 | 可 |
| =、<> | 可 | 可 | 可 | 可 | 可 |
| <, <=, >, >= | 可 | 可 | No | 可 | - |
| かつ/または/ではない | 可 | 可 | 有効 | 有効 | 有効 |
| StartsWith | - | 有効 | - | - | - |
| IsBlank | はい [4] | はい [4] | いいえ [4] | はい [4] | 有効 |
| 合計、最小、最大、平均 | はい [5] | - | - | 無効 | - |
- 算術式を使用した数値 (たとえば、Filter(table, field + 10 > 100) ) は、委任できません。 Language および TimeZone は委任できません。
- Trim[Ends] または Len をサポートしていません。 Left、Mid、Right、Upper、Lower、Replace、Substitute などのその他の関数はサポートしています。
- DateTime は委任可能です。ただし、DateTime 関数 Now() と Today() は除きます。
- 比較をサポートしています。 たとえば、Filter(TableName, MyCol = Blank()) をサポートしています。
- 集計関数は、50,000 行のコレクションに制限されます。 必要な場合は、フィルター関数を使って大きなセットから 50,000 行を選んで集計関数を使用します。
注意
Dataverse の選択肢、ガイド、集計関数は、新しいバージョンのコネクターでのみサポートされています。 Power Apps のバージョンに応じて、タイトルのプレビュー スイッチのいずれかでこのコネクタを有効にしてください。
- Dataverse のリレーショナル データ、選択肢、その他の新機能
またはこの実験的スイッチ: - Dataverse コネクタの使用
これらのスイッチを見つけるには、ファイル メニューを開き、アプリの設定 > 高度な設定を選択します。
コネクタの詳細
コネクタの詳細については、詳細セクション を参照してください。
接続の作成
コネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 1000 | 60 秒 |
アクション
| テーブルから行を取得する [非推奨] |
テーブルから行を取得する |
| 新しい行を追加する (レガシ) |
この操作はテーブルに新しい行を追加します |
| 新しい行を追加する [非推奨] |
この操作はテーブルに新しい行を追加します |
| 行の一覧 (レガシ) |
この操作はテーブルの行を取得します |
| 行の取得 (レガシ) |
この操作はテーブルの指定した行を取得する |
| 行を一覧にする [非推奨] |
この操作はテーブルの行を取得します |
| 行を削除する (レガシ) |
この操作はテーブル コレクションから行を削除します |
| 行を更新する (レガシ) |
この操作はテーブルにある既存の行を更新します |
| 行を更新する [非推奨] |
この操作はテーブルにある既存の行を更新します |
テーブルから行を取得する [非推奨]
テーブルから行を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
|
アイテム識別子
|
id | True | string |
行の識別子 |
戻り値
新しい行を追加する (レガシ)
この操作はテーブルに新しい行を追加します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
|
行の項目
|
item | True | dynamic |
作成する行 |
戻り値
新しい行を追加する [非推奨]
この操作はテーブルに新しい行を追加します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
|
行の項目
|
item | True | dynamic |
作成する行 |
戻り値
行の一覧 (レガシ)
この操作はテーブルの行を取得します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
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 |
要求されたエントリに含める関連エントリ (既定値 = なし) |
戻り値
行の取得 (レガシ)
この操作はテーブルの指定した行を取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
|
アイテム識別子
|
id | True | 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 |
要求されたエントリに含める関連エントリ (既定値 = なし) |
戻り値
行を削除する (レガシ)
この操作はテーブル コレクションから行を削除します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
|
アイテム識別子
|
id | True | string |
行の識別子 |
行を更新する (レガシ)
この操作はテーブルにある既存の行を更新します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
Environment
|
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 |
テーブルを選択します。 |
|
Scope
|
scope | True | string |
スコープです。 |
戻り値
行の削除時 (管理者のみ) [非推奨]
Dataverse で行が削除された際にフローをトリガーする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
戻り値
行の変更時
Dataverse で行を変更する際にフローをトリガーします。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルを選択します。 |
|
範囲
|
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 |
スコープです。 |
戻り値
行の追加時 (管理者のみ) [非推奨]
Dataverse で行を追加する際にフローをトリガーする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
戻り値
行の追加時 (管理者のみ) [非推奨]
Dataverse で行を追加する際にフローをトリガーする
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
環境
|
dataset | True | string |
環境を選択します |
|
テーブル名
|
table | True | string |
テーブルの選択 |
戻り値
行の選択時
コマンド バーの [フロー] メニューで行が選択されたときにフローをトリガーします。 (Power Automate でのみ使用可能です。)
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
スキーマ
|
schema | True | object | |
|
headersSchema
|
headersSchema | object |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
行
|
body.rows | array of object | |
|
アイテム
|
body.rows | object | |
|
ユーザー ID
|
headers.x-ms-user-id-encoded | guid |
AAD でフローをトリガーしたユーザーを表す一意識別子です。 |
|
User email
|
headers.x-ms-user-email-encoded | byte |
フローをトリガーしたユーザーのメール アドレスです。 |
|
User name
|
headers.x-ms-user-name-encoded | byte |
フローをトリガーしたユーザーの表示名です。 |
|
Timestamp
|
headers.x-ms-user-timestamp | string |
フローがトリガーされた時刻です。 |