Microsoft Dataverse

現在の環境で、Microsoft Dataverse 上の組織ベースのデータベースへのアクセスを提供します。

このコネクタは、次の製品および地域で利用可能です:

サービス クラス リージョン
Power Automate プレミアム すべての Power Automate 地域
Power Apps プレミアム すべての Power Apps 地域
Contact
件名 マイクロソフト
URL https://us.flow.microsoft.com/en-us/support/
コネクタ メタデータ
公開元 Microsoft
Web サイト https://flow.microsoft.com/
プライバシー ポリシー https://privacy.microsoft.com
カテゴリ データ​​

接続の作成

コネクタは、次の認証タイプをサポートしています:

既定 接続を作成するためのパラメーター。 すべての地域 共有不可

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 パワー アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

調整制限

Name 呼び出し 更新期間
接続ごとの API 呼び出し6000300 秒

アクション

ID で行を取得する

この操作を実行すると、Microsoft Dataverse テーブルで、ID が一致する行を取得できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

バインドしていないアクションを実行する

この操作を実行すると、どのテーブルにも関連付けられていない環境で、Microsoft Dataverse の使用可能な操作を実行できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

バインド済みアクションを実行する

この操作を実行すると、選択したテーブルに関連付けられた Microsoft Dataverse のアクションを実行できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

ファイルまたは画像をアップロードする

この操作を実行すると、ファイルまたは画像コンテンツを、Microsoft Dataverse テーブルに、互換性を持つ列の種類を使用してアップロードできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

ファイルまたは画像をダウンロードする

この操作を実行すると、ファイルまたは画像コンテンツを、Microsoft Dataverse テーブルからダウンロードできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

変更セット要求を実行する

この操作により、Microsoft Dataverse コネクタ操作のグループを単一のトランザクションとして実行できます。 操作の 1 つが失敗した場合、成功したすべてのアクションがロールバックされます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

新しい行を追加する

この操作を実行すると、選択した Microsoft Dataverse テーブルに新しい行を追加できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行の検索 (プレビュー)

この操作により、関連性検索を使用して Microsoft Dataverse 環境を検索し、検索語句に最も近い行を返すことができます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行の関連付けを解除する

この操作を実行すると、Microsoft Dataverse のテーブル間に一対多または多対多の関連付けがある場合に、テーブル間で行と行のリンクを削除できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行を一覧にする

この操作を実行すると、選択したオプションに一致する Microsoft Dataverse テーブルの行でリストを作成できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行を削除する

この操作を実行すると、Microsoft Dataverse テーブルから行を削除できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行を更新する

この操作を実行すると、Microsoft Dataverse テーブルで選択した行を変更したり、行を新しく追加したりできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

行を関連付ける

この操作を実行すると、Microsoft Dataverse のテーブル間に一対多または多対多の関連付けがある場合に、テーブル間で行と行のリンクを作成できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

ID で行を取得する

この操作を実行すると、Microsoft Dataverse テーブルで、ID が一致する行を取得できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

列を選択する
$select string

一覧に入れる列を制限するために、一意の列の名前をコンマ区切りで入力します

クエリの展開
$expand string

Odata スタイルを入力すると、クエリが展開され、関連する行が一覧で表示されます

パーティション ID
partitionId string

NoSQL テーブルのデータを取得する際に partitionId を指定するオプションです

戻り値

応答
object

バインドしていないアクションを実行する

この操作を実行すると、どのテーブルにも関連付けられていない環境で、Microsoft Dataverse の使用可能な操作を実行できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
アクション名
actionName True string

アクションを選択する

戻り値

応答
object

バインド済みアクションを実行する

この操作を実行すると、選択したテーブルに関連付けられた Microsoft Dataverse のアクションを実行できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

アクション名
actionName True string

アクションを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

戻り値

応答
object

ファイルまたは画像をアップロードする

この操作を実行すると、ファイルまたは画像コンテンツを、Microsoft Dataverse テーブルに、互換性を持つ列の種類を使用してアップロードできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

列名
fileImageFieldName True string

列を選択する

内容
item True binary

ファイルや画像コンテンツを追加する

コンテンツ名
x-ms-file-name True string

ファイルや画像の名前を入力してください

ファイルまたは画像をダウンロードする

この操作を実行すると、ファイルまたは画像コンテンツを、Microsoft Dataverse テーブルからダウンロードできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

列名
fileImageFieldName True string

列を選択する

画像サイズ
size string

有効にすると、画像全体が完全に入力されます (既定 = サムネイル)

戻り値

ファイルや画像のコンテンツ

ファイルまたは画像コンテンツ
binary

変更セット要求を実行する

この操作により、Microsoft Dataverse コネクタ操作のグループを単一のトランザクションとして実行できます。 操作の 1 つが失敗した場合、成功したすべてのアクションがロールバックされます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

新しい行を追加する

この操作を実行すると、選択した Microsoft Dataverse テーブルに新しい行を追加できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

戻り値

応答
object

行の検索 (プレビュー)

この操作により、関連性検索を使用して Microsoft Dataverse 環境を検索し、検索語句に最も近い行を返すことができます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
検索語句
search True string

検索語句を入力してください。例: Contoso。 ブール演算子、ワイルドカード、あいまい検索、近接性検索などの検索修飾子には、完全な検索タイプが必要です

検索の種類
searchtype string

単純な検索構文と完全な検索構文のどちらを使用するかを入力します (既定は単純です)

検索モード
searchmode string

検索語の一部またはすべてを一致させる必要があるかどうかを入力します (既定は一部)

行数
top integer

リストを作成する検索結果数を入力します (既定 = 50)

行フィルター
filter string

Odata スタイルのフィルター式を入力して、検索を絞り込みます

テーブル フィルター
Table filter string

検索するテーブルの一意の名前を入力します (既定ははすべてのテーブルです)

並べ替え基準
Sort by string

列の一意の名前に続けて asc または desc を入力します

ファセット クエリ
Facet query string

ファセット クエリを入力して検索を絞り込みます

行をスキップする
skip integer

スキップする検索結果数を入力します

行数を返す
returntotalrecordcount boolean

オプションの選択

戻り値

検索出力。

本文​​
SearchOutput

行の関連付けを解除する

この操作を実行すると、Microsoft Dataverse のテーブル間に一対多または多対多の関連付けがある場合に、テーブル間で行と行のリンクを削除できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

関係
associationEntityRelationship True string

関係の種類を選択する

関連付け解除:
$id True string

前の手順の OData ID を使用するか、完全な URL を入力して行の URL を入力します (例: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

行を一覧にする

この操作を実行すると、選択したオプションに一致する Microsoft Dataverse テーブルの行でリストを作成できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

列を選択する
$select string

一覧に入れる列を制限するために、一意の列の名前をコンマ区切りで入力します

行のフィルター
$filter string

リストが作成される行を制限する OData スタイル フィルター式を入力します

並べ替え順
$orderby string

OData orderBy スタイルで並べ替える列 (検索を除く)

展開クエリ
$expand string

Odata スタイルを入力すると、クエリが展開され、関連する行が一覧で表示されます

Fetch Xml クエリ
fetchXml string

高度なカスタマイズのための Fetch XML クエリを入力します

行数
$top integer

リストを作成する行数を入力します (既定 = 5000)

スキップ トークン
$skiptoken string

前の実行から取得したスキップ トークンを、次のページにある一覧の行に入力します

パーティション ID
partitionId string

NoSQL テーブルのデータを取得する際に partitionId を指定するオプションです

戻り値

テーブルの一覧

本文​​
EntityItemList

行を削除する

この操作を実行すると、Microsoft Dataverse テーブルから行を削除できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

パーティション ID
partitionId string

NoSQL テーブルの行を削除する際に partitionId を指定するオプションです

行を更新する

この操作を実行すると、Microsoft Dataverse テーブルで選択した行を変更したり、行を新しく追加したりできます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

戻り値

応答
object

行を関連付ける

この操作を実行すると、Microsoft Dataverse のテーブル間に一対多または多対多の関連付けがある場合に、テーブル間で行と行のリンクを作成できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
テーブル名
entityName True string

テーブルを選択する

行 ID
recordId True string

行のグローバル一意識別子 (GUID) を入力してください

関係
associationEntityRelationship True string

関係の種類を選択する

関連付け:
@odata.id True string

前の手順の OData ID を使用するか、完全な URL を入力して行の URL を入力します (例: https://org0.crm.dynamics.com/api/data/v9.0/faxes(3ce6c728-3c8a-4b55-a4ee-a251b253c3ee)

トリガー

アクションが実行されたとき

Microsoft Dataverse アクションの完了時にトリガーします。

ビジネス プロセス フローからフロー ステップが実行された場合

このトリガーにより、ビジネス プロセス フローのステップで [フローの実行] ボタンがクリックされた時に、フローを開始できます。 (Power Automate にのみ使用可能です。)

行が追加、変更、または削除された場合

このトリガーを使用すると、Microsoft Dataverse テーブルで行が追加、変更、または削除された場合に、選択したオプションと一致するフローを開始できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

アクションが実行されたとき

Microsoft Dataverse アクションの完了時にトリガーします。

パラメーター

Name キー 必須 説明
カタログCatalog
catalog True string

テーブルとアクションをフィルター処理するオプションを選択します。

カテゴリ
category True string

テーブルとアクションをフィルター処理するオプションを選択します。

テーブル名
entityname True string

アクションをフィルター処理するテーブルを選択します。

アクション名
sdkmessagename True string

アクションを選択します。

戻り値

アクションとテーブル項目です。

ビジネス プロセス フローからフロー ステップが実行された場合

このトリガーにより、ビジネス プロセス フローのステップで [フローの実行] ボタンがクリックされた時に、フローを開始できます。 (Power Automate にのみ使用可能です。)

戻り値

Name パス 説明
Flow ワークフローのログ ID
entity.FlowsWorkflowLogId string

Flow ワークフローのログ ID。

BPF のインスタンス ID
entity.BPFInstanceId string

ビジネス プロセス フローのインスタンス ID。

BPF インスタンスのテーブル名
entity.BPFInstanceEntityName string

ビジネス プロセス フロー インスタンスのテーブル名です。

BPF の定義 ID
entity.BPFDefinitionId string

ビジネス プロセス フローの定義 ID。

BPF 定義のテーブル名
entity.BPFDefinitionEntityName string

ビジネス プロセス フロー定義のテーブル名です。

ステップ ID
entity.StepId string

ビジネス プロセス フローのステップ ID。

BPF の定義名
entity.BPFDefinitionName string

ビジネス プロセス フローの定義名。

BPF のインスタンス名
entity.BPFInstanceName string

ビジネス プロセス フローのインスタンス名。

BPF のフロー ステージのローカライズされた名前
entity.BPFFlowStageLocalizedName string

ビジネス プロセス フローのステージのローカライズされた名前。

BPF フロー ステージのテーブル名
entity.BPFFlowStageEntityName string

ビジネス プロセス フロー ステージのテーブル名です。

BPF フロー ステージのテーブル コレクション名
entity.BPFFlowStageEntityCollectionName string

ビジネス プロセス フロー ステージのテーブル コレクション名です。

BPF フロー ステージのテーブル行 ID
entity.BPFFlowStageEntityRecordId string

ビジネス プロセス フロー ステージのテーブル行 ID です。

BPF のアクティブ ステージ ID
entity.BPFActiveStageId string

ビジネス プロセス フローのアクティブ ステージ ID。

BPF のアクティブ ステージのテーブル名
entity.BPFActiveStageEntityName string

ビジネス プロセス フローのアクティブ ステージのテーブル名。

BPF のアクティブ ステージのローカライズされた名前
entity.BPFActiveStageLocalizedName string

ビジネス プロセス フローのアクティブ ステージのローカライズされた名前。

行が追加、変更、または削除された場合

このトリガーを使用すると、Microsoft Dataverse テーブルで行が追加、変更、または削除された場合に、選択したオプションと一致するフローを開始できます。 このコネクタは、以前は Common Data Service (現在の環境) と呼ばれていました。

パラメーター

Name キー 必須 説明
種類の変更
message True integer

フローをトリガーする条件を選択する

テーブル名
entityname True string

テーブルを選択する

Scope
scope True integer

フローをトリガーできる行を制限するスコープを選択します

列を選択する
filteringattributes string

列の一意の名前をコンマ区切りでリストに入力します。 それらのいずれかが変更されると、フローがトリガーされます

行のフィルター
filterexpression string

フローをトリガーできる行を制限する OData 式、例 statecode eq 0

延期期限
postponeuntil string

トリガーの評価を遅延させる時間を入力します、例: 2020-01-01T10:10:00Z

実行するユーザー
runas integer

呼び出し元の接続が使用されているステップの実行ユーザーを選択します

戻り値

テーブル項目です。

定義

EntityItemList

テーブルの一覧

Name パス 説明
value array of EntityItem

アイテムの一覧

次のリンク
@odata.nextLink string

次のページ データをフェッチする URL。

EntityItem

テーブル項目

Name パス 説明
dynamicProperties
dynamicProperties object

オブジェクト

WebhookNotificationContent

テーブル項目です。

Name パス 説明
スキーマ
schema Object

SearchOutput

検索出力。

Name パス 説明
行の一覧
value array of object

行の一覧

行の検索スコア
value.@search.score number

行の検索スコア

行のテーブル名
value.@search.entityname string

行を含むテーブル

行のオブジェクト ID
value.@search.objectid string

行の Objectid

行オブジェクトの種類コード
value.@search.objecttypecode integer

行の Objecttypecode

合計行数
totalrecordcount integer

結果の総数 (returntotalrecordcount が false に設定されている場合は -1)

WebhookNotificationContentForWhenAnActionIsPerformed

アクションとテーブル項目です。

Name パス 説明
スキーマ
schema Object

オブジェクト

’オブジェクト’ という種類です。

バイナリ

これは基本的なデータ型 [バイナリ] です。