Dynamics 365 Customer Insights (プレビュー)
Dynamics 365 Customer Insights connector は、Dynamics 365 Customer Insights インスタンスと対話するための一連の API を提供します。
このコネクタは、次の製品および地域で利用可能です:
Service | クラス | 地域 |
---|---|---|
Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure China の地域 - 米国国防総省 (DoD) |
Power Automate | プレミアム | 以下を除くすべての Power Automate 地域 : - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
Power Apps | プレミアム | 以下を除くすべての Power Apps 地域 : - US Government (GCC High) - 21Vianet が運用する中国のクラウド - 国防総省 (DoD) |
連絡先 | |
---|---|
件名 | Microsoft |
URL | Microsoft LogicApps サポート Microsoft Power Automate サポート Microsoft Power Apps サポート |
コネクタ メタデータ | |
---|---|
公開元 | Microsoft |
Dynamics 365 Customer Insights にサインアップするには、ここをクリックしてください。
Power Apps でこのコネクタを使用するには、ここで詳細をご覧ください。
名前 | 呼び出し | 更新期間 |
---|---|---|
接続ごとの API 呼び出し | 100 | 60 秒 |
アイテムの作成 (プレビュー) |
この操作では、エンティティのアイテムを作成します |
アイテムの更新 (プレビュー) |
この操作では、エンティティのアイテムを更新します |
エンティティから項目を取得する |
この操作では、エンティティから項目を取得します。 エンティティに応じて、フィールドはフィルターとして定義できます:
|
エンティティのパーティションを取得します (プレビュー) |
エンティティのパーティションを取得します。 |
エンティティのパーティションを取得する (V2) (プレビュー) |
エンティティのパーティションを取得します (V2)。 |
エンティティを取得 |
この操作では、インスタンスからエンティティを取得します |
パーティションからデータを取得します (プレビュー) |
パーティションからデータを取得します。 |
状態レポート V2 を送信する |
状態レポート V2 を送信します。 |
状態レポートの送信 |
状態レポートを送信します。 |
項目を取得する |
この操作では、エンティティから項目を取得します |
この操作では、エンティティのアイテムを作成します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
entityName
|
table | True | string |
エンティティの名前 |
recordItem
|
item | True | dynamic |
作成するレコード |
この操作では、エンティティのアイテムを更新します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
entityName
|
table | True | string |
エンティティの名前 |
itemIdentifier
|
id | True | string |
項目の識別子 |
recordItem
|
item | True | dynamic |
更新するレコード |
戻り値
この操作では、エンティティから項目を取得します。 エンティティに応じて、フィールドはフィルターとして定義できます:
- UnifiedActivity エンティティ: ActivityId および CustomerId フィールド
- Customer エンティティ: Customer Insights インスタンスでインデックス付けされた CustomerId フィールドおよびその他のフィールド
- その他のエンティティ: CustomerId フィールド。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
instanceId
|
dataset | True | string |
インスタンスの識別子 |
entityName
|
table | True | string |
エンティティの名前 |
フィルター クエリ
|
$filter | string |
返されるエントリを制限する ODATA フィルター クエリです (例: stringColumn eq 'string' OR numberColumn lt 123)。 |
|
上位カウント
|
$top | integer |
取得するエントリの合計数です (既定値 = すべて)。 |
|
クエリを選択する
|
$select | string |
エントリから取得する特定のフィールドです (既定値 = すべて)。 |
戻り値
エンティティのパーティションを取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Customer Insights データセット
|
dataset | True | string |
Customer Insights のデータセットです。 |
エンティティ
|
table | True | string |
エンティティです。 |
戻り値
エンティティのパーティションを取得します (V2)。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Customer Insights データセット
|
dataset | True | string |
Customer Insights のデータセットです。 |
エンティティ
|
table | True | string |
エンティティです。 |
フィルターする partitionDisplayName 値
|
partitionDisplayName | string |
フィルターする partitionDisplayName 値です。 |
戻り値
パーティションの一覧
この操作では、インスタンスからエンティティを取得します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
戻り値
テーブルの一覧を表します。
- 本文
- TablesList
パーティションからデータを取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Customer Insights データセット
|
dataset | True | string |
Customer Insights データセットです。 |
エンティティ
|
table | True | string |
エンティティ。 |
パーティションの参照 (URI または名前)
|
partitionUri | True | string |
パーティションの参照 (URI または名前)。 |
列のコンマ区切り行
|
select | string |
列のコンマ区切り行。 |
|
読み取りを開始する位置 (バイト単位)
|
offsetStart | integer |
読み取りを開始する位置 (バイト単位)。 |
|
読み取る最大バイト数
|
maxSize | integer |
読み取る最大バイト数。 |
|
返す最大レコード数
|
maxResults | integer |
返す最大レコード数。 |
戻り値
パーティションからのデータ。
状態レポート V2 を送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス ID
|
dataset | True | string |
インスタンスを選択します。 |
Report type
|
reportType | True | string |
レポートの種類を選択します。 |
状態レポートを送信します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス ID
|
dataset | True | string |
インスタンスを選択します。 |
レポートの種類
|
reportType | True | string |
レポートの種類を選択します。 |
この操作では、エンティティから項目を取得します
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
InstanceId
|
dataset | True | string |
インスタンスの識別子 |
entityName
|
table | True | string |
エンティティの名前 |
itemIdentifier
|
id | True | string |
項目の識別子 |
戻り値
Customer Insights でプロセスが完了したときにフローをトリガーする |
選択したプロセスのスケジュールされた更新に対してフローがトリガーされます。 さらに、手動更新のフローをトリガーすることを選択できます。 |
Customer Insights で完全な更新が完了した際にフローをトリガーする |
この操作は Customer Insights (データ ソース、セグメント、メジャーなど) の完全な更新が完了するとフローをトリガーします。 |
セグメントのしきい値を超えたときにフローをトリガーします |
この操作は、Dynamics 365 Customer Insights でセグメントのしきい値を超えたときにフローをトリガーします。 |
ビジネス メジャーのしきい値を超えたときにフローをトリガーします |
この操作は、Dynamics 365 Customer Insights でビジネス メジャーのしきい値を超えたときにフローをトリガーします。 |
更新の失敗時にデータソースのフローをトリガーする |
この操作は、Dynamics 365 Customer Insights で更新が失敗したときに、データ ソースのフローをトリガーします。 |
更新の完了時にデータソースのフローをトリガーする |
この操作は、Dynamics 365 Customer Insights で更新が完了したときに、データ ソースのフローをトリガーします。 |
選択したプロセスのスケジュールされた更新に対してフローがトリガーされます。 さらに、手動更新のフローをトリガーすることを選択できます。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
プロセス
|
process | string |
プロセスを選択します。 |
|
手動でトリガーするプロセスを含める
|
includingManualRefreshes | boolean |
手動でトリガーするプロセスを含める場合は [はい] を選択します。 |
戻り値
実行済みのプロセスに関する情報
- 本文
- ProcessData
この操作は Customer Insights (データ ソース、セグメント、メジャーなど) の完全な更新が完了するとフローをトリガーします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
戻り値
実行済みの完全更新に関する情報
この操作は、Dynamics 365 Customer Insights でセグメントのしきい値を超えたときにフローをトリガーします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
セグメント名
|
segment | True | string |
セグメントを選択します。 |
しきい値
|
threshold | True | integer |
任意の数をしきい値として設定します。 |
戻り値
セグメント データ
- 本文
- SegmentData
この操作は、Dynamics 365 Customer Insights でビジネス メジャーのしきい値を超えたときにフローをトリガーします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
インスタンス名
|
dataset | True | string |
インスタンスを選択します。 |
ビジネス メジャー名
|
measure | True | string |
メジャーを選択する。 |
しきい値
|
threshold | True | double |
任意の数をしきい値として設定します。 |
戻り値
ビジネス メジャー データ
- 本文
- MeasureData
この操作は、Dynamics 365 Customer Insights で更新が失敗したときに、データ ソースのフローをトリガーします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
環境
|
dataset | True | string |
データセット名。 |
戻り値
DataSourcesList
- 本文
- DataSourcesList
この操作は、Dynamics 365 Customer Insights で更新が完了したときに、データ ソースのフローをトリガーします。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
環境
|
dataset | True | string |
データセット名。 |
戻り値
DataSourcesList
- 本文
- DataSourcesList
DataSourcesList
名前 | パス | 型 | 説明 |
---|---|---|---|
値
|
value | array of DataSource |
データ ソース一覧 |
DataSource クラス
名前 | パス | 型 | 説明 |
---|---|---|---|
RefreshType
|
RefreshType | string |
データ更新の種類 |
RefreshObjectId
|
RefreshObjectId | string |
更新オブジェクト ID |
RefreshObjectVersion
|
RefreshObjectVersion | integer |
更新オブジェクトのバージョン |
操作
|
Operation | string |
操作名 |
JobType
|
JobType | string |
ジョブの種類 |
エラーコード
|
ErrorCode | string |
データを更新する際のエラー コード。 |
エラーメッセージ
|
ErrorMessage | string |
更新する際のエラー メッセージ |
ErrorSeverity
|
ErrorSeverity | string |
更新する際のエラー重大度 |
StartTimeUtc
|
StartTimeUtc | string |
データ更新の開始時刻 |
EndTimeUtc
|
EndTimeUtc | string |
データ更新の終了時刻 |
セグメント データ
名前 | パス | 型 | 説明 |
---|---|---|---|
件名
|
Name | string |
セグメント名 |
表示名
|
DisplayName | string |
セグメントの表示名 |
EvaluationDate
|
EvaluationDate | date-time |
セグメントの評価日 |
EntityCount
|
EntityCount | integer |
セグメント メンバーの実際の数 |
しきい値
|
Threshold | integer |
セグメントのしきい値 |
ビジネス メジャー データ
名前 | パス | 型 | 説明 |
---|---|---|---|
件名
|
Name | string |
メジャー名 |
表示名
|
DisplayName | string |
メジャーの表示名 |
EvaluationDate
|
EvaluationDate | date-time |
メジャーの評価日 |
値
|
Value | double |
メジャーの値 |
ValueDisplayName
|
ValueDisplayName | string |
値の表示名 |
しきい値
|
Threshold | double |
メジャーのしきい値 |
実行済みの完全更新に関する情報
名前 | パス | 型 | 説明 |
---|---|---|---|
NumberOfFailedTasks
|
NumberOfFailedTasks | integer |
失敗したタスクの件数 |
StartTime
|
StartTime | date-time |
ワークフロー ステップの開始時間 |
EndTime
|
EndTime | date-time |
ワークフロー ステップの終了時間 |
時間
|
Duration | integer |
プロセスの期間 (分) |
ステータス
|
Status | string |
ワークフロー ステップの状態 |
StatusPage
|
StatusPage | string |
状態ページへのリンク |
実行済みのプロセスに関する情報
名前 | パス | 型 | 説明 |
---|---|---|---|
StartTime
|
StartTime | date-time |
ワークフロー ステップの開始時間 |
EndTime
|
EndTime | date-time |
ワークフロー ステップの終了時間 |
時間
|
Duration | integer |
プロセスの期間 (分) |
ステータス
|
Status | string |
ワークフロー ステップの状態 |
StatusPage
|
StatusPage | string |
状態ページへのリンク |
テーブルを表します。
名前 | パス | 型 | 説明 |
---|---|---|---|
件名
|
Name | string |
テーブルの名前です。 名前は実行時に使用されます。 |
表示名
|
DisplayName | string |
テーブルの表示名です。 |
DynamicProperties
|
DynamicProperties | object |
コネクタによってクライアントに提供された追加のテーブル プロパティです。 |
パーティションの一覧
名前 | パス | 型 | 説明 |
---|---|---|---|
ヘッダー
|
Header | string |
エンティティの属性を含むヘッダー |
Partitions
|
Partitions | array of Table |
パーティションの一覧 |
パーティションからのデータ。
名前 | パス | 型 | 説明 |
---|---|---|---|
OffsetStart
|
OffsetStart | integer |
開始オフセット。 |
OffsetEnd
|
OffsetEnd | integer |
終了オフセット。 |
サイズ
|
Size | integer |
返されるデータ件数。 |
項目
|
Items | array of object |
オフセット「OffsetStart」から「OffsetEnd」までの、パーティションからの最大「サイズ」アイテムのデータを含む辞書。 |
項目
|
Items | object |
テーブルの一覧を表します。
名前 | パス | 型 | 説明 |
---|---|---|---|
値
|
value | array of Table |
テーブルの一覧 |