Freigeben über

Dynamics 365 Customer Insights (Vorschau)

Der Dynamics 365 Customer Insights-Connector bietet eine Reihe von APIs für die Interaktion mit Dynamics 365 Customer Insights-Instanzen.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Microsoft
URL Microsoft LogicApps-Unterstützung
Microsoft Power Automate-Support
Microsoft Power Apps-Unterstützung
Connectormetadaten
Herausgeber Microsoft

Um sich für Dynamics 365 Customer Insights zu registrieren, klicken Sie hier.

Weitere Informationen zum Verwenden dieses Connectors in Power Apps finden Sie hier.

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Abrufen von Daten aus einer Partition (Vorschau)

Abrufen von Daten aus einer Partition.
Abrufen von Elementen aus einer Entität

Dieser Vorgang ruft Elemente aus einer Entität ab. Je nach Entität können Felder als Filter definiert werden:

  • UnifiedActivity-Entität: ActivityId- und CustomerId-Felder
  • Kundenentität: CustomerId-Feld und alle anderen Felder, die in der Customer Insights-Instanz indiziert sind
  • Alle anderen Entitäten: CustomerId-Feld.
Abrufen von Partitionen für eine Entität (Vorschau)

Rufen Sie Partitionen für eine Entität ab.
Abrufen von Partitionen für eine Entität V2 (Vorschau)

Abrufen von Partitionen für eine Entität V2.
Element abrufen

Dieser Vorgang ruft ein Element aus einer Entität ab.
Element aktualisieren (Vorschau)

Dieser Vorgang aktualisiert ein Element in einer Entität.
Element erstellen (Vorschau)

Mit diesem Vorgang wird ein Element für eine Entität erstellt.
Entitäten abrufen

Dieser Vorgang ruft Entitäten aus einer Instanz ab.
Sendet den Statusbericht

Sendet den Statusbericht.
Sendet den Statusbericht V2

Sendet den Statusbericht V2.

Abrufen von Daten aus einer Partition (Vorschau)

Vorgangs-ID:
GetPartitionData

Abrufen von Daten aus einer Partition.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Das Dataset "Customer Insights"
 dataset True string

Das Dataset "Customer Insights".
Die Entität
 table True string

Die Entität.
Der Verweis (URI oder Name) der Partition
 partitionUri True string

Der Verweis (URI oder Name) der Partition.
Eine durch Trennzeichen getrennte Zeile von Spalten
 select string

Eine durch Trennzeichen getrennte Zeile von Spalten.
Position von wo aus mit dem Lesen beginnen, in Byte
 offsetStart integer

Position von wo aus mit dem Lesen beginnen, in Byte.
Maximale Anzahl zu lesende Bytes
 maxSize integer

Maximal zu lesende Bytes.
Maximale Anzahl der zurückzugebenden Datensätze
 maxResults integer

Maximale Anzahl der zurückzugebenden Datensätze.

Gibt zurück

Die Daten aus einer Partition.

Body
PartitionDataResponse

Abrufen von Elementen aus einer Entität

Vorgangs-ID:
GetItems

Dieser Vorgang ruft Elemente aus einer Entität ab. Je nach Entität können Felder als Filter definiert werden:

  • UnifiedActivity-Entität: ActivityId- und CustomerId-Felder
  • Kundenentität: CustomerId-Feld und alle anderen Felder, die in der Customer Insights-Instanz indiziert sind
  • Alle anderen Entitäten: CustomerId-Feld.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
instanceId
 dataset True string

Bezeichner einer Instanz
entityName
 table True string

Name einer Entität
Filterabfrage
 $filter string

Eine ODATA-Filterabfrage, um die zurückgegebenen Einträge einzuschränken (z. B. stringColumn eq 'string' OR numberColumn lt 123).
Höchste Anzahl
 $top integer

Gesamtzahl der abzurufenden Einträge (Standard = alle).
Abfrage auswählen
 $select string

Bestimmte Felder, die aus Einträgen abgerufen werden sollen (Standard = alle).

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Abrufen von Partitionen für eine Entität (Vorschau)

Vorgangs-ID:
GetPartitions

Rufen Sie Partitionen für eine Entität ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Das Dataset "Customer Insights"
 dataset True string

Das Dataset "Customer Insights".
Die Entität
 table True string

Die Entität.

Gibt zurück

response
array of Table

Abrufen von Partitionen für eine Entität V2 (Vorschau)

Vorgangs-ID:
GetPartitionsV2

Abrufen von Partitionen für eine Entität V2.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Das Dataset "Customer Insights"
 dataset True string

Das Dataset "Customer Insights".
Die Entität
 table True string

Die Entität.
Der partitionDisplayName-Wert, nach dem gefiltert werden soll
 partitionDisplayName string

Der partitionDisplayName-Wert, nach dem gefiltert werden soll.

Gibt zurück

Die Liste der Partitionen

Body
PartitionListResponse

Element abrufen

Vorgangs-ID:
GetItem

Dieser Vorgang ruft ein Element aus einer Entität ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
instanceId
 dataset True string

Bezeichner einer Instanz
entityName
 table True string

Name einer Entität
itemIdentifier
 id True string

Bezeichner für das Element

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Element aktualisieren (Vorschau)

Vorgangs-ID:
PatchItem

Dieser Vorgang aktualisiert ein Element in einer Entität.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
instanceId
 dataset True string

Bezeichner einer Instanz
entityName
 table True string

Name einer Entität
itemIdentifier
 id True string

Bezeichner für das Element
recordItem
 item True dynamic

Zu aktualisierende Aufzeichnung

Gibt zurück

Die Ausgaben dieses Vorgangs sind dynamisch.

Element erstellen (Vorschau)

Vorgangs-ID:
PostItem

Mit diesem Vorgang wird ein Element für eine Entität erstellt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
instanceId
 dataset True string

Bezeichner einer Instanz
entityName
 table True string

Name einer Entität
recordItem
 item True dynamic

Zu erstellende Datensatz

Entitäten abrufen

Vorgangs-ID:
GetTables

Dieser Vorgang ruft Entitäten aus einer Instanz ab.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
instanceId
 dataset True string

Bezeichner einer Instanz

Gibt zurück

Stellt eine Liste von Tabellen dar.

Body
TablesList

Sendet den Statusbericht

Vorgangs-ID:
SendStatusReport

Sendet den Statusbericht.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanz-ID
 dataset True string

Wählen Sie eine Instanz aus.
Berichtstyp
 reportType True string

Wählen Sie einen Berichtstyp aus.

Sendet den Statusbericht V2

Vorgangs-ID:
SendStatusReportV2

Sendet den Statusbericht V2.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanz-ID
 dataset True string

Wählen Sie eine Instanz aus.
Berichtstyp
 reportType True string

Wählen Sie einen Berichtstyp aus.

Auslöser

Löst einen Fluss aus, wenn ein Prozess in Customer Insights abgeschlossen ist.

Ein Ablauf wird für geplante Aktualisierungen des ausgewählten Prozesses ausgelöst. Darüber hinaus können Sie einen Fluss für manuelle Aktualisierungen auslösen.
Löst einen Fluss aus, wenn ein Schwellenwert für geschäftskennzahlen überschritten wird.

Dieser Vorgang löst einen Fluss aus, wenn ein Schwellenwert für Geschäftsmaße in Dynamics 365 Customer Insights überschritten wird.
Löst einen Fluss aus, wenn ein Segmentschwellenwert überschritten wird.

Dieser Vorgang löst einen Fluss aus, wenn ein Segmentschwellenwert in Dynamics 365 Customer Insights überschritten wird.
Löst einen Fluss aus, wenn eine vollständige Aktualisierung von Customer Insights abgeschlossen ist.

Dieser Vorgang löst einen Fluss aus, wenn eine vollständige Aktualisierung von Customer Insights (Datenquellen, Segmente, Measures,...) abgeschlossen ist.
Löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung abgeschlossen ist.

Dieser Vorgang löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung in Dynamics 365 Customer Insights abgeschlossen ist.
Löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung fehlgeschlagen ist.

Dieser Vorgang löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung in Dynamics 365 Customer Insights fehlgeschlagen ist.

Löst einen Fluss aus, wenn ein Prozess in Customer Insights abgeschlossen ist.

Vorgangs-ID:
GetOnProcessCompleted

Ein Ablauf wird für geplante Aktualisierungen des ausgewählten Prozesses ausgelöst. Darüber hinaus können Sie einen Fluss für manuelle Aktualisierungen auslösen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanzname
 dataset True string

Wählen Sie eine Instanz aus.
Prozess
 process string

Wählen Sie einen Prozess aus.
Manuell ausgelösten Prozess einschließen
 includingManualRefreshes boolean

Wählen Sie "Ja" aus, wenn manuell ausgelöster Prozess eingeschlossen werden soll.

Gibt zurück

Die Informationen zum ausgeführten Prozess

Body
ProcessData

Löst einen Fluss aus, wenn ein Schwellenwert für geschäftskennzahlen überschritten wird.

Vorgangs-ID:
GetOnBusinessMeasureUpdated

Dieser Vorgang löst einen Fluss aus, wenn ein Schwellenwert für Geschäftsmaße in Dynamics 365 Customer Insights überschritten wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanzname
 dataset True string

Wählen Sie eine Instanz aus.
Name des Geschäftsmaßs
 measure True string

Wählen Sie ein Measure aus.
Schwellenwert
 threshold True double

Legen Sie eine beliebige Zahl als Schwellenwert fest.

Gibt zurück

Geschäftsmaßdaten

Body
MeasureData

Löst einen Fluss aus, wenn ein Segmentschwellenwert überschritten wird.

Vorgangs-ID:
GetOnSegmentUpdated

Dieser Vorgang löst einen Fluss aus, wenn ein Segmentschwellenwert in Dynamics 365 Customer Insights überschritten wird.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanzname
 dataset True string

Wählen Sie eine Instanz aus.
Segmentname
 segment True string

Wählen Sie ein Segment aus.
Schwellenwert
 threshold True integer

Legen Sie eine beliebige Zahl als Schwellenwert fest.

Gibt zurück

Segmentdaten

Body
SegmentData

Löst einen Fluss aus, wenn eine vollständige Aktualisierung von Customer Insights abgeschlossen ist.

Vorgangs-ID:
GetOnFullDagRefreshCompleted

Dieser Vorgang löst einen Fluss aus, wenn eine vollständige Aktualisierung von Customer Insights (Datenquellen, Segmente, Measures,...) abgeschlossen ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Instanzname
 dataset True string

Wählen Sie eine Instanz aus.

Gibt zurück

Die Informationen zur ausgeführten vollständigen Aktualisierung

Body
FullRefreshProcessData

Löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung abgeschlossen ist.

Vorgangs-ID:
GetOnDataSourceRefreshComplete

Dieser Vorgang löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung in Dynamics 365 Customer Insights abgeschlossen ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
 dataset True string

Datasetname.

Gibt zurück

DataSourcesList

Body
DataSourcesList

Löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung fehlgeschlagen ist.

Vorgangs-ID:
GetOnDataSourceRefreshFail

Dieser Vorgang löst einen Fluss aus der Datenquelle aus, wenn die Aktualisierung in Dynamics 365 Customer Insights fehlgeschlagen ist.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
Umwelt
 dataset True string

Datasetname.

Gibt zurück

DataSourcesList

Body
DataSourcesList

Definitionen

DataSourcesList

DataSourcesList

Name Pfad Typ Beschreibung
value
 value array of DataSource

Liste der Datenquellen

Datenquelle

DataSource-Klasse

Name Pfad Typ Beschreibung
RefreshType
 RefreshType string

Der Typ für die Datenaktualisierung
RefreshObjectId
 RefreshObjectId string

Die Aktualisierungsobjekt-ID
RefreshObjectVersion
 RefreshObjectVersion integer

Die Aktualisierungsobjektversion
Operation
 Operation string

Der Vorgangsname
JobType
 JobType string

Der Auftragstyp
ErrorCode
 ErrorCode string

Der Fehlercode während der Datenaktualisierung.
Fehlermeldung
 ErrorMessage string

Fehlermeldung während der Aktualisierung
ErrorSeverity
 ErrorSeverity string

Die Fehlerserverität während der Aktualisierung
StartTimeUtc
 StartTimeUtc string

Die Startzeit für die Datenaktualisierung
EndTimeUtc
 EndTimeUtc string

Die Endzeit für die Datenaktualisierung

SegmentData

Segmentdaten

Name Pfad Typ Beschreibung
Name
 Name string

Der Segmentname
Anzeigename
 DisplayName string

Der Name der Segmentanzeige
EvaluationDate
 EvaluationDate date-time

Das Segmentauswertungsdatum
EntityCount
 EntityCount integer

Die tatsächliche Anzahl der Segmentmitglieder
Schwellenwert
 Threshold integer

Der Segmentschwellenwert

MeasureData

Geschäftsmaßdaten

Name Pfad Typ Beschreibung
Name
 Name string

Der Measurename
Anzeigename
 DisplayName string

Der Anzeigename des Measures
EvaluationDate
 EvaluationDate date-time

Das Bewertungsdatum des Measures
Wert
 Value double

Der Wert des Measures
ValueDisplayName
 ValueDisplayName string

Der Anzeigename des Werts
Schwellenwert
 Threshold double

Der Messschwellenwert

FullRefreshProcessData

Die Informationen zur ausgeführten vollständigen Aktualisierung

Name Pfad Typ Beschreibung
NumberOfFailedTasks
 NumberOfFailedTasks integer

Die Anzahl der fehlgeschlagenen Vorgänge
StartTime
 StartTime date-time

Die Startzeit des Workflowschritts
EndTime
 EndTime date-time

Die Endzeit des Workflowschritts
Dauer
 Duration integer

Die Dauer des Vorgangs in Minuten
Der Status
 Status string

Der Status des Workflowschritts
StatusPage
 StatusPage string

Der Link zur Statusseite

ProcessData

Die Informationen zum ausgeführten Prozess

Name Pfad Typ Beschreibung
StartTime
 StartTime date-time

Die Startzeit des Workflowschritts
EndTime
 EndTime date-time

Die Endzeit des Workflowschritts
Dauer
 Duration integer

Die Dauer des Vorgangs in Minuten
Der Status
 Status string

Der Status des Workflowschritts
StatusPage
 StatusPage string

Der Link zur Statusseite

Table

Stellt eine Tabelle dar.

Name Pfad Typ Beschreibung
Name
 Name string

Der Name der Tabelle. Der Name wird zur Laufzeit verwendet.
Anzeigename
 DisplayName string

Der Anzeigename der Tabelle.
DynamicProperties
 DynamicProperties object

Zusätzliche Tabelleneigenschaften, die vom Connector für die Clients bereitgestellt werden.

PartitionListResponse

Die Liste der Partitionen

Name Pfad Typ Beschreibung
Header
 Header string

Header mit den Attributen der Entität
Partitionen
 Partitions array of Table

Liste der Partitionen

PartitionDataResponse

Die Daten aus einer Partition.

Name Pfad Typ Beschreibung
OffsetStart
 OffsetStart integer

Der Anfangsoffset.
OffsetEnd
 OffsetEnd integer

Der Endoffset.
Größe
 Size integer

Die Anzahl der zurückgegebenen Daten.
Gegenstände
 Items array of object

Das Wörterbuch, das Daten der maximalen 'Size'-Elemente aus einer Partition enthält, von offset 'OffsetStart' auf 'OffsetEnd'.
items
 Items object

TablesList

Stellt eine Liste von Tabellen dar.

Name Pfad Typ Beschreibung
value
 value array of Table

Liste der Tabellen