共用方式為

Dynamics 365 Customer Insights （預覽版）

Dynamics 365 Customer Insights 連接器提供一組 API，可與 Dynamics 365 Customer Insights 執行個體互動。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher Microsoft

若要註冊 Dynamics 365 Customer Insights，請按一下 這裡。

若要在 Power Apps 中使用此連接器，請 在這裡深入瞭解。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

傳送狀態報告

傳送狀態報告。
傳送狀態報告 V2

傳送狀態報告 V2。
取得實體

此作業會從執行個體取得實體
取得物品

此作業會從實體取得專案
建立專案 （預覽）

此作業會在實體上建立專案
從分割區擷取資料 （預覽版）

從分割區擷取資料。
從實體取得項目

此作業會從實體取得專案。 視實體而定，欄位可以定義為篩選器：

  • UnifiedActivity 實體：ActivityId 和 CustomerId 欄位
  • 客戶實體：CustomerId 欄位和在 Customer Insights 執行個體中編製索引的任何其他欄位
  • 任何其他實體：CustomerId 欄位。
擷取實體 V2 的分割區 （預覽版）

擷取實體 V2 的分割區。
擷取實體的分割區 （預覽版）

擷取實體的分割區。
更新項目 （預覽）

此作業會更新實體上的項目

傳送狀態報告

作業識別碼：
SendStatusReport

傳送狀態報告。

參數

名稱 機碼 必要 類型 Description
執行個體識別碼
 dataset True string

選取執行個體。
報表類型
 reportType True string

選取報表類型。

傳送狀態報告 V2

作業識別碼：
SendStatusReportV2

傳送狀態報告 V2。

參數

名稱 機碼 必要 類型 Description
執行個體識別碼
 dataset True string

選取執行個體。
報表類型
 reportType True string

選取報表類型。

取得實體

作業識別碼：
GetTables

此作業會從執行個體取得實體

參數

名稱 機碼 必要 類型 Description
instanceId
 dataset True string

執行個體的識別碼

傳回

代表表格清單。

身體
TablesList

取得物品

作業識別碼：
GetItem

此作業會從實體取得專案

參數

名稱 機碼 必要 類型 Description
instanceId
 dataset True string

執行個體的識別碼
entityName
 table True string

實體名稱
項目識別碼
 id True string

項目的識別碼

傳回

此作業會輸出隨機的結果。

建立專案 （預覽）

作業識別碼：
PostItem

此作業會在實體上建立專案

參數

名稱 機碼 必要 類型 Description
instanceId
 dataset True string

執行個體的識別碼
entityName
 table True string

實體名稱
記錄項目
 item True dynamic

要創建的記錄

從分割區擷取資料 （預覽版）

作業識別碼：
GetPartitionData

從分割區擷取資料。

參數

名稱 機碼 必要 類型 Description
Customer Insights 資料集
 dataset True string

Customer Insights 資料集。
實體
 table True string

實體。
分割區的參照 （URI 或名稱）
 partitionUri True string

分割區的參考 （URI 或名稱）。
以逗號分隔的欄行
 select string

以逗號分隔的欄行。
開始讀取的位置，以位元組為單位
 offsetStart integer

開始讀取的位置，以位元組為單位。
要讀取的位元組數上限
 maxSize integer

要讀取的位元組數上限。
要傳回的記錄數目上限
 maxResults integer

要傳回的記錄數目上限。

傳回

來自分割區的資料。

身體
PartitionDataResponse

從實體取得項目

作業識別碼：
GetItems

此作業會從實體取得專案。 視實體而定，欄位可以定義為篩選器：

  • UnifiedActivity 實體：ActivityId 和 CustomerId 欄位
  • 客戶實體：CustomerId 欄位和在 Customer Insights 執行個體中編製索引的任何其他欄位
  • 任何其他實體：CustomerId 欄位。

參數

名稱 機碼 必要 類型 Description
instanceId
 dataset True string

執行個體的識別碼
entityName
 table True string

實體名稱
篩選查詢
 $filter string

ODATA 篩選查詢，以限制傳回的專案 （例如 stringColumn eq 'string' OR numberColumn lt 123）。
最高計數
 $top integer

要擷取的項目總數 （預設值 = 全部）。
選取查詢
 $select string

要從項目擷取的特定欄位（預設值 = all）。

傳回

此作業會輸出隨機的結果。

擷取實體 V2 的分割區 （預覽版）

作業識別碼：
GetPartitionsV2

擷取實體 V2 的分割區。

參數

名稱 機碼 必要 類型 Description
Customer Insights 資料集
 dataset True string

Customer Insights 資料集。
實體
 table True string

實體。
要篩選的 partitionDisplayName 值
 partitionDisplayName string

要篩選的 partitionDisplayName 值。

傳回

分割區清單

身體
PartitionListResponse

擷取實體的分割區 （預覽版）

作業識別碼：
GetPartitions

擷取實體的分割區。

參數

名稱 機碼 必要 類型 Description
Customer Insights 資料集
 dataset True string

Customer Insights 資料集。
實體
 table True string

實體。

傳回

response
array of Table

更新項目 （預覽）

作業識別碼：
PatchItem

此作業會更新實體上的項目

參數

名稱 機碼 必要 類型 Description
instanceId
 dataset True string

執行個體的識別碼
entityName
 table True string

實體名稱
項目識別碼
 id True string

項目的識別碼
記錄項目
 item True dynamic

記錄更新

傳回

此作業會輸出隨機的結果。

觸發程序

當 Customer Insights 中的流程完成時觸發流程

系統會針對所選程序的排程重新整理觸發流程。 此外，您可以選擇觸發手動重新整理的流程。
當 Customer Insights 的完整重新整理完成時觸發流程

當 Customer Insights （資料來源、客戶細分、量值,...） 的完整重新整理完成時，此作業會觸發流程。
當重新整理失敗時，從資料來源觸發流程

當 Dynamics 365 Customer Insights 中的重新整理失敗時，此作業會觸發資料來源的流程。
超過區段臨界值時觸發流程

當 Dynamics 365 Customer Insights 中超過客戶細分閾值時，此作業會觸發流程。
超過商務量值閾值時觸發流程

當 Dynamics 365 Customer Insights 中超過商務量值閾值時，此作業會觸發流程。
重新整理完成時，觸發資料來源的流程

此作業會在 Dynamics 365 Customer Insights 中完成重新整理時，觸發資料來源的流程。

當 Customer Insights 中的流程完成時觸發流程

作業識別碼：
GetOnProcessCompleted

系統會針對所選程序的排程重新整理觸發流程。 此外，您可以選擇觸發手動重新整理的流程。

參數

名稱 機碼 必要 類型 Description
執行個體名稱
 dataset True string

選取執行個體。
流程
 process string

選取處理程序。
包括手動觸發的流程
 includingManualRefreshes boolean

如果應包含手動觸發的程式，請選取 [是]。

傳回

已執行程序的相關資訊

身體
ProcessData

當 Customer Insights 的完整重新整理完成時觸發流程

作業識別碼：
GetOnFullDagRefreshCompleted

當 Customer Insights （資料來源、客戶細分、量值,...） 的完整重新整理完成時，此作業會觸發流程。

參數

名稱 機碼 必要 類型 Description
執行個體名稱
 dataset True string

選取執行個體。

傳回

已執行完整重新整理的相關資訊

身體
FullRefreshProcessData

當重新整理失敗時，從資料來源觸發流程

作業識別碼：
GetOnDataSourceRefreshFail

當 Dynamics 365 Customer Insights 中的重新整理失敗時，此作業會觸發資料來源的流程。

參數

名稱 機碼 必要 類型 Description
環境
 dataset True string

資料集名稱。

傳回

資料來源清單

身體
DataSourcesList

超過區段臨界值時觸發流程

作業識別碼：
GetOnSegmentUpdated

當 Dynamics 365 Customer Insights 中超過客戶細分閾值時，此作業會觸發流程。

參數

名稱 機碼 必要 類型 Description
執行個體名稱
 dataset True string

選取執行個體。
客戶細分名稱
 segment True string

選取區段。
閾值
 threshold True integer

將任何數字設置為閾值。

傳回

區隔資料

身體
SegmentData

超過商務量值閾值時觸發流程

作業識別碼：
GetOnBusinessMeasureUpdated

當 Dynamics 365 Customer Insights 中超過商務量值閾值時，此作業會觸發流程。

參數

名稱 機碼 必要 類型 Description
執行個體名稱
 dataset True string

選取執行個體。
商務量值名稱
 measure True string

選取量值。
閾值
 threshold True double

將任何數字設置為閾值。

傳回

商務量值資料

身體
MeasureData

重新整理完成時，觸發資料來源的流程

作業識別碼：
GetOnDataSourceRefreshComplete

此作業會在 Dynamics 365 Customer Insights 中完成重新整理時，觸發資料來源的流程。

參數

名稱 機碼 必要 類型 Description
環境
 dataset True string

資料集名稱。

傳回

資料來源清單

身體
DataSourcesList

定義

資料來源清單

資料來源清單

名稱 路徑 類型 Description
value
 value array of DataSource

資料來源清單

資料來源

DataSource 類別

名稱 路徑 類型 Description
重新整理類型
 RefreshType string

資料重新整理的類型
RefreshObjectId
 RefreshObjectId string

重新整理物件識別碼
RefreshObjectVersion
 RefreshObjectVersion integer

重新整理物件版本
行動
 Operation string

作業名稱
工作類型
 JobType string

工作類型
ErrorCode
 ErrorCode string

資料重新整理期間的錯誤碼。
錯誤訊息
 ErrorMessage string

重新整理期間的錯誤訊息
錯誤嚴重性
 ErrorSeverity string

重新整理期間的錯誤伺服器
開始時間UTC
 StartTimeUtc string

資料重新整理的開始時間
結束時間UTCC
 EndTimeUtc string

資料重新整理的結束時間

區段資料

區隔資料

名稱 路徑 類型 Description
名稱
 Name string

區段名稱
顯示名稱
 DisplayName string

區段顯示名稱
評估日期
 EvaluationDate date-time

區段評估日期
實體計數
 EntityCount integer

區段成員的實際計數
閾值
 Threshold integer

區段臨界值

測量數據

商務量值資料

名稱 路徑 類型 Description
名稱
 Name string

量值名稱
顯示名稱
 DisplayName string

量值顯示名稱
評估日期
 EvaluationDate date-time

量值評估日期
價值觀
 Value double

量值
值顯示名稱
 ValueDisplayName string

值的顯示名稱
閾值
 Threshold double

量值臨界值

FullRefreshProcessData

已執行完整重新整理的相關資訊

名稱 路徑 類型 Description
失敗任務數
 NumberOfFailedTasks integer

失敗的任務數目
StartTime
 StartTime date-time

工作流程步驟的開始時間
EndTime
 EndTime date-time

工作流程步驟的結束時間
持續時間
 Duration integer

該過程的持續時間（以分鐘為單位）
地位
 Status string

工作流程步驟的狀態
狀態頁面
 StatusPage string

狀態頁面的連結

處理資料

已執行程序的相關資訊

名稱 路徑 類型 Description
StartTime
 StartTime date-time

工作流程步驟的開始時間
EndTime
 EndTime date-time

工作流程步驟的結束時間
持續時間
 Duration integer

該過程的持續時間（以分鐘為單位）
地位
 Status string

工作流程步驟的狀態
狀態頁面
 StatusPage string

狀態頁面的連結

Table

代表一個表格。

名稱 路徑 類型 Description
名稱
 Name string

數據表的名稱。 該名稱在運行時使用。
顯示名稱
 DisplayName string

資料表的顯示名稱。
動態屬性
 DynamicProperties object

連接器提供給用戶端的其他資料表屬性。

PartitionList回應

分割區清單

名稱 路徑 類型 Description
Header
 Header string

包含實體屬性的標頭
Partitions
 Partitions array of Table

分割區清單

PartitionData回應

來自分割區的資料。

名稱 路徑 類型 Description
偏移開始
 OffsetStart integer

起始偏移。
偏移結束
 OffsetEnd integer

結束偏移。
大小
 Size integer

傳回的資料數目。
物品
 Items array of object

字典包含分割區中最大 'Size' 項目的數據，從偏移量 'OffsetStart' 到 'OffsetEnd'。
items
 Items object

表格清單

代表表格清單。

名稱 路徑 類型 Description
value
 value array of Table

表格列表