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

Dynamics 365 Customer Insights にサインアップするには、ここをクリックしてください。

Power Apps でこのコネクタを使用するには、ここで詳細をご覧ください。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

アイテムの作成 (プレビュー)

この操作では、エンティティのアイテムを作成します

アイテムの更新 (プレビュー)

この操作では、エンティティのアイテムを更新します

エンティティから項目を取得する

この操作では、エンティティから項目を取得します。 エンティティに応じて、フィールドはフィルターとして定義できます:

  • UnifiedActivity エンティティ: ActivityId および CustomerId フィールド
  • Customer エンティティ: Customer Insights インスタンスでインデックス付けされた CustomerId フィールドおよびその他のフィールド
  • その他のエンティティ: CustomerId フィールド。
エンティティのパーティションを取得します (プレビュー)

エンティティのパーティションを取得します。

エンティティのパーティションを取得する (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) (プレビュー)

エンティティのパーティションを取得します (V2)。

パラメーター

名前 キー 必須 説明
Customer Insights データセット
dataset True string

Customer Insights のデータセットです。

エンティティ
table True string

エンティティです。

フィルターする partitionDisplayName 値
partitionDisplayName string

フィルターする partitionDisplayName 値です。

戻り値

パーティションの一覧

本文​​
PartitionListResponse

エンティティを取得

この操作では、インスタンスからエンティティを取得します

パラメーター

名前 キー 必須 説明
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

返す最大レコード数。

戻り値

パーティションからのデータ。

本文​​
PartitionDataResponse

状態レポート V2 を送信する

状態レポート 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 で更新が完了したときに、データ ソースのフローをトリガーします。

Customer Insights でプロセスが完了したときにフローをトリガーする

選択したプロセスのスケジュールされた更新に対してフローがトリガーされます。 さらに、手動更新のフローをトリガーすることを選択できます。

パラメーター

名前 キー 必須 説明
インスタンス名
dataset True string

インスタンスを選択します。

プロセス​​
process string

プロセスを選択します。

手動でトリガーするプロセスを含める
includingManualRefreshes boolean

手動でトリガーするプロセスを含める場合は [はい] を選択します。

戻り値

実行済みのプロセスに関する情報

本文​​
ProcessData

Customer Insights で完全な更新が完了した際にフローをトリガーする

この操作は Customer Insights (データ ソース、セグメント、メジャーなど) の完全な更新が完了するとフローをトリガーします。

パラメーター

名前 キー 必須 説明
インスタンス名
dataset True string

インスタンスを選択します。

戻り値

実行済みの完全更新に関する情報

本文​​
FullRefreshProcessData

セグメントのしきい値を超えたときにフローをトリガーします

この操作は、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

DataSourcesList

名前 パス 説明
value array of DataSource

データ ソース一覧

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

データ更新の終了時刻

SegmentData

セグメント データ

名前 パス 説明
件名
Name string

セグメント名

表示名
DisplayName string

セグメントの表示名

EvaluationDate
EvaluationDate date-time

セグメントの評価日

EntityCount
EntityCount integer

セグメント メンバーの実際の数

しきい値
Threshold integer

セグメントのしきい値

MeasureData

ビジネス メジャー データ

名前 パス 説明
件名
Name string

メジャー名

表示名
DisplayName string

メジャーの表示名

EvaluationDate
EvaluationDate date-time

メジャーの評価日

Value double

メジャーの値

ValueDisplayName
ValueDisplayName string

値の表示名

しきい値
Threshold double

メジャーのしきい値

FullRefreshProcessData

実行済みの完全更新に関する情報

名前 パス 説明
NumberOfFailedTasks
NumberOfFailedTasks integer

失敗したタスクの件数

StartTime
StartTime date-time

ワークフロー ステップの開始時間

EndTime
EndTime date-time

ワークフロー ステップの終了時間

時間
Duration integer

プロセスの期間 (分)

ステータス
Status string

ワークフロー ステップの状態

StatusPage
StatusPage string

状態ページへのリンク

ProcessData

実行済みのプロセスに関する情報

名前 パス 説明
StartTime
StartTime date-time

ワークフロー ステップの開始時間

EndTime
EndTime date-time

ワークフロー ステップの終了時間

時間
Duration integer

プロセスの期間 (分)

ステータス
Status string

ワークフロー ステップの状態

StatusPage
StatusPage string

状態ページへのリンク

テーブル

テーブルを表します。

名前 パス 説明
件名
Name string

テーブルの名前です。 名前は実行時に使用されます。

表示名
DisplayName string

テーブルの表示名です。

DynamicProperties
DynamicProperties object

コネクタによってクライアントに提供された追加のテーブル プロパティです。

PartitionListResponse

パーティションの一覧

名前 パス 説明
ヘッダー​​
Header string

エンティティの属性を含むヘッダー

Partitions
Partitions array of Table

パーティションの一覧

PartitionDataResponse

パーティションからのデータ。

名前 パス 説明
OffsetStart
OffsetStart integer

開始オフセット。

OffsetEnd
OffsetEnd integer

終了オフセット。

サイズ
Size integer

返されるデータ件数。

項目
Items array of object

オフセット「OffsetStart」から「OffsetEnd」までの、パーティションからの最大「サイズ」アイテムのデータを含む辞書。

項目
Items object

TablesList

テーブルの一覧を表します。

名前 パス 説明
value array of Table

テーブルの一覧