Dynamics 365 Customer Insights

Konektor Dynamics 365 Customer Insights poskytuje sadu rozhraní API pro interakci s instancemi Dynamics 365 Customer Insights.

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Automatizace napájení Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Microsoft
URL https://support.microsoft.com
Metadata konektoru
Vydavatel Microsoft
Internetová stránka https://dynamics.microsoft.com/en-us/ai/customer-insights/
Zásady ochrany osobních údajů https://privacy.microsoft.com/
Categories Data

Pokud se chcete zaregistrovat k Dynamics 365 Customer Insights, klikněte sem.

Pokud chcete tento konektor použít v Power Apps, přečtěte si další informace tady.

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizovat položku (Preview)

Tato operace aktualizuje položku entity.
Načtení dat z oddílu (Preview)

Načtěte data z oddílu.
Načtení oddílů pro entitu (Preview)

Načtěte oddíly pro entitu.
Načtení oddílů pro entitu V2 (Preview)

Načtěte oddíly pro entitu V2.
Odešle zprávu o stavu V2.

Odešle zprávu o stavu V2.
Odešle zprávu o stavu.

Odešle zprávu o stavu.
Vytvoření položky (Preview)

Tato operace vytvoří položku v entitě.
Získat položku

Tato operace získá položku z entity.
Získání entit

Tato operace získá entity z instance.
Získání položek z entity

Tato operace získává položky z entity. V závislosti na entitě je možné pole definovat jako filtry:

  • Entita UnifiedActivity: Pole ActivityId a CustomerId
  • Entita zákazníka: Pole CustomerId a všechna ostatní pole indexovaná v instanci Customer Insights
  • Všechny ostatní entity: Pole CustomerId.

Aktualizovat položku (Preview)

ID operace:
PatchItem

Tato operace aktualizuje položku entity.

Parametry

Name Klíč Vyžadováno Typ Description
instanceId
 dataset True string

Identifikátor instance
entityName
 table True string

Název entity
itemIdentifier
 id True string

Identifikátor položky
recordItem
 item True dynamic

Záznam pro aktualizaci

Návraty

Výstupy této operace jsou dynamické.

Načtení dat z oddílu (Preview)

ID operace:
GetPartitionData

Načtěte data z oddílu.

Parametry

Name Klíč Vyžadováno Typ Description
Datová sada Customer Insights
 dataset True string

Datová sada Customer Insights.
Entita
 table True string

Entita.
Odkaz (identifikátor URI nebo název) oddílu
 partitionUri True string

Odkaz (identifikátor URI nebo název) oddílu.
Čárka oddělená řádky sloupců
 select string

Čárka oddělená řádky sloupců.
Pozice od místa, kde začít číst, v bajtech
 offsetStart integer

Pozice od místa, kde začít číst, v bajtech.
Maximální počet bajtů pro čtení
 maxSize integer

Maximální počet bajtů, které se mají číst.
Maximální počet záznamů, které se mají vrátit
 maxResults integer

Maximální počet záznamů, které se mají vrátit.

Návraty

Data z oddílu.

Body
PartitionDataResponse

Načtení oddílů pro entitu (Preview)

ID operace:
GetPartitions

Načtěte oddíly pro entitu.

Parametry

Name Klíč Vyžadováno Typ Description
Datová sada Customer Insights
 dataset True string

Datová sada Customer Insights.
Entita
 table True string

Entita.

Návraty

response
array of Table

Načtení oddílů pro entitu V2 (Preview)

ID operace:
GetPartitionsV2

Načtěte oddíly pro entitu V2.

Parametry

Name Klíč Vyžadováno Typ Description
Datová sada Customer Insights
 dataset True string

Datová sada Customer Insights.
Entita
 table True string

Entita.
Hodnota partitionDisplayName, která se má filtrovat
 partitionDisplayName string

Hodnota partitionDisplayName, pro kterou chcete filtrovat.

Návraty

Seznam oddílů

Body
PartitionListResponse

Odešle zprávu o stavu V2.

ID operace:
SendStatusReportV2

Odešle zprávu o stavu V2.

Parametry

Name Klíč Vyžadováno Typ Description
ID instance
 dataset True string

Vyberte instanci.
Typ sestavy
 reportType True string

Vyberte typ sestavy.

Odešle zprávu o stavu.

ID operace:
SendStatusReport

Odešle zprávu o stavu.

Parametry

Name Klíč Vyžadováno Typ Description
ID instance
 dataset True string

Vyberte instanci.
Typ sestavy
 reportType True string

Vyberte typ sestavy.

Vytvoření položky (Preview)

ID operace:
PostItem

Tato operace vytvoří položku v entitě.

Parametry

Name Klíč Vyžadováno Typ Description
instanceId
 dataset True string

Identifikátor instance
entityName
 table True string

Název entity
recordItem
 item True dynamic

Záznam pro vytvoření

Získat položku

ID operace:
GetItem

Tato operace získá položku z entity.

Parametry

Name Klíč Vyžadováno Typ Description
instanceId
 dataset True string

Identifikátor instance
entityName
 table True string

Název entity
itemIdentifier
 id True string

Identifikátor položky

Návraty

Výstupy této operace jsou dynamické.

Získání entit

ID operace:
GetTables

Tato operace získá entity z instance.

Parametry

Name Klíč Vyžadováno Typ Description
instanceId
 dataset True string

Identifikátor instance

Návraty

Představuje seznam tabulek.

Body
TablesList

Získání položek z entity

ID operace:
GetItems

Tato operace získává položky z entity. V závislosti na entitě je možné pole definovat jako filtry:

  • Entita UnifiedActivity: Pole ActivityId a CustomerId
  • Entita zákazníka: Pole CustomerId a všechna ostatní pole indexovaná v instanci Customer Insights
  • Všechny ostatní entity: Pole CustomerId.

Parametry

Name Klíč Vyžadováno Typ Description
instanceId
 dataset True string

Identifikátor instance
entityName
 table True string

Název entity
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek (např. stringColumn eq 'string' OR numberColumn lt 123).
Nejvyšší počet
 $top integer

Celkový počet položek, které se mají načíst (výchozí = vše).
Výběr dotazu
 $select string

Konkrétní pole, která se mají načíst z položek (výchozí = vše).

Návraty

Výstupy této operace jsou dynamické.

Aktivační události

Aktivuje tok, když se dokončí úplná aktualizace Customer Insights.

Tato operace aktivuje tok, když se dokončí úplná aktualizace Customer Insights (zdroje dat, segmenty, míry,...).
Aktivuje tok po dokončení procesu v Customer Insights.

Tok se aktivuje pro plánované aktualizace vybraného procesu. Kromě toho můžete aktivovat tok pro ruční aktualizace.
Aktivuje tok při překročení prahové hodnoty obchodní míry.

Tato operace aktivuje tok při překročení prahové hodnoty obchodní míry v Dynamics 365 Customer Insights.
Aktivuje tok při překročení prahové hodnoty segmentu.

Tato operace aktivuje tok při překročení prahové hodnoty segmentu v Dynamics 365 Customer Insights.
Aktivuje tok ze zdroje dat, když se aktualizace nezdaří.

Tato operace aktivuje tok ze zdroje dat, když v Dynamics 365 Customer Insights selže aktualizace.
Aktivuje tok ze zdroje dat po dokončení aktualizace.

Tato operace aktivuje tok ze zdroje dat po dokončení aktualizace v Dynamics 365 Customer Insights.

Aktivuje tok, když se dokončí úplná aktualizace Customer Insights.

ID operace:
GetOnFullDagRefreshCompleted

Tato operace aktivuje tok, když se dokončí úplná aktualizace Customer Insights (zdroje dat, segmenty, míry,...).

Parametry

Name Klíč Vyžadováno Typ Description
Název instance
 dataset True string

Vyberte instanci.

Návraty

Informace o provedené úplné aktualizaci

Body
FullRefreshProcessData

Aktivuje tok po dokončení procesu v Customer Insights.

ID operace:
GetOnProcessCompleted

Tok se aktivuje pro plánované aktualizace vybraného procesu. Kromě toho můžete aktivovat tok pro ruční aktualizace.

Parametry

Name Klíč Vyžadováno Typ Description
Název instance
 dataset True string

Vyberte instanci.
Proces
 process string

Vyberte proces.
Zahrnout ručně aktivovaný proces
 includingManualRefreshes boolean

Pokud by se měl zahrnout ručně aktivovaný proces, vyberte ano.

Návraty

Informace o provedeném procesu

Body
ProcessData

Aktivuje tok při překročení prahové hodnoty obchodní míry.

ID operace:
GetOnBusinessMeasureUpdated

Tato operace aktivuje tok při překročení prahové hodnoty obchodní míry v Dynamics 365 Customer Insights.

Parametry

Name Klíč Vyžadováno Typ Description
Název instance
 dataset True string

Vyberte instanci.
Název obchodní míry
 measure True string

Vyberte míru.
Prahová hodnota
 threshold True double

Nastavte libovolné číslo jako prahovou hodnotu.

Návraty

Data obchodních měr

Body
MeasureData

Aktivuje tok při překročení prahové hodnoty segmentu.

ID operace:
GetOnSegmentUpdated

Tato operace aktivuje tok při překročení prahové hodnoty segmentu v Dynamics 365 Customer Insights.

Parametry

Name Klíč Vyžadováno Typ Description
Název instance
 dataset True string

Vyberte instanci.
Název segmentu
 segment True string

Vyberte segment.
Prahová hodnota
 threshold True integer

Nastavte libovolné číslo jako prahovou hodnotu.

Návraty

Segmentace dat

Body
SegmentData

Aktivuje tok ze zdroje dat, když se aktualizace nezdaří.

ID operace:
GetOnDataSourceRefreshFail

Tato operace aktivuje tok ze zdroje dat, když v Dynamics 365 Customer Insights selže aktualizace.

Parametry

Name Klíč Vyžadováno Typ Description
Životní prostředí
 dataset True string

název datové sady.

Návraty

DataSourcesList

Body
DataSourcesList

Aktivuje tok ze zdroje dat po dokončení aktualizace.

ID operace:
GetOnDataSourceRefreshComplete

Tato operace aktivuje tok ze zdroje dat po dokončení aktualizace v Dynamics 365 Customer Insights.

Parametry

Name Klíč Vyžadováno Typ Description
Životní prostředí
 dataset True string

název datové sady.

Návraty

DataSourcesList

Body
DataSourcesList

Definice

DataSourcesList

DataSourcesList

Name Cesta Typ Description
value
 value array of DataSource

Seznam zdrojů dat

Zdroj dat

DataSource – třída

Name Cesta Typ Description
RefreshType
 RefreshType string

Typ aktualizace dat
RefreshObjectId
 RefreshObjectId string

ID objektu aktualizace
RefreshObjectVersion
 RefreshObjectVersion integer

Verze obnovovacího objektu
Operation
 Operation string

Název operace
JobType
 JobType string

Typ úlohy
ErrorCode
 ErrorCode string

Kód chyby během aktualizace dat.
Chybová zpráva
 ErrorMessage string

Chybová zpráva během aktualizace
Chybaeverity
 ErrorSeverity string

Chyba serverity během aktualizace
StartTimeUtc
 StartTimeUtc string

Čas zahájení aktualizace dat
EndTimeUtc
 EndTimeUtc string

Čas ukončení aktualizace dat

SegmentData

Segmentace dat

Name Cesta Typ Description
Název
 Name string

Název segmentu
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název segmentu
EvaluationDate
 EvaluationDate date-time

Datum vyhodnocení segmentu
EntityCount
 EntityCount integer

Skutečný počet členů segmentu
Prahová hodnota
 Threshold integer

Prahová hodnota segmentu

MeasureData

Data obchodních měr

Name Cesta Typ Description
Název
 Name string

Název míry
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název míry
EvaluationDate
 EvaluationDate date-time

Datum vyhodnocení míry
Hodnota
 Value double

Hodnota míry
ValueDisplayName
 ValueDisplayName string

Zobrazovaný název hodnoty
Prahová hodnota
 Threshold double

Prahová hodnota míry

FullRefreshProcessData

Informace o provedené úplné aktualizaci

Name Cesta Typ Description
NumberOfFailedTasks
 NumberOfFailedTasks integer

Počet neúspěšných úkolů
StartTime
 StartTime date-time

Počáteční čas kroku pracovního postupu
Konečný čas
 EndTime date-time

Koncový čas kroku pracovního postupu
Doba trvání
 Duration integer

Doba trvání procesu v minutách
Stav
 Status string

Stav kroku pracovního postupu
Stránka stavu
 StatusPage string

Odkaz na stránku stavu

ProcessData

Informace o provedeném procesu

Name Cesta Typ Description
StartTime
 StartTime date-time

Počáteční čas kroku pracovního postupu
Konečný čas
 EndTime date-time

Koncový čas kroku pracovního postupu
Doba trvání
 Duration integer

Doba trvání procesu v minutách
Stav
 Status string

Stav kroku pracovního postupu
Stránka stavu
 StatusPage string

Odkaz na stránku stavu

Table

Představuje tabulku.

Name Cesta Typ Description
Název
 Name string

Název tabulky. Název se používá za běhu.
ZobrazovanéJméno
 DisplayName string

Zobrazovaný název tabulky.
DynamicProperties
 DynamicProperties object

Další vlastnosti tabulky poskytované konektorem klientům

PartitionListResponse

Seznam oddílů

Name Cesta Typ Description
Header
 Header string

Hlavička obsahující atributy entity
Oddíly
 Partitions array of Table

Seznam oddílů

PartitionDataResponse

Data z oddílu.

Name Cesta Typ Description
OffsetStart
 OffsetStart integer

Počáteční posun.
OffsetEnd
 OffsetEnd integer

Konec posunu.
Velikost
 Size integer

Počet vrácených dat.
Položky
 Items array of object

Slovník obsahující data maximální velikosti položek z oddílu, od posunu OffsetStart do OffsetEnd.
items
 Items object

TablesList

Představuje seznam tabulek.

Name Cesta Typ Description
value
 value array of Table

Seznam tabulek