Delen via

Dynamics 365 Customer Insights (preview)

De Dynamics 365 Customer Insights-connector biedt een set API's voor interactie met Dynamics 365 Customer Insights-exemplaren.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Logic-apps Standaard Alle Logic Apps-regio's , met uitzondering van het volgende:
     - Azure China-regio's
     - Us Department of Defense (DoD)
Power Apps Premium Alle Power Apps-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Alle Power Automate-regio's , met uitzondering van het volgende:
     - Amerikaanse overheid (GCC High)
     - China Cloud beheerd door 21Vianet
     - Us Department of Defense (DoD)
Contactpersoon
Naam Microsoft
URL Ondersteuning voor Microsoft LogicApps
Ondersteuning voor Microsoft Power Automate
Ondersteuning voor Microsoft Power Apps
Connectormetagegevens
Uitgever Microsoft

Klik hier om u aan te melden voor Dynamics 365 Customer Insights.

Voor meer informatie over het gebruik van deze connector in Power Apps vindt u hier meer informatie.

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden

Acties

Entiteiten ophalen

Met deze bewerking worden entiteiten opgehaald uit een exemplaar
Gegevens ophalen uit een partitie (preview)

Gegevens ophalen uit een partitie.
Het statusrapport verzenden

Hiermee wordt het statusrapport verzonden.
Hiermee wordt het statusrapport V2 verzonden

Hiermee wordt het statusrapport V2 verzonden.
Item bijwerken (preview)

Met deze bewerking wordt een item op een entiteit bijgewerkt
Item maken (preview)

Met deze bewerking maakt u een item op een entiteit
Item ophalen

Met deze bewerking wordt een item opgehaald uit een entiteit
Items ophalen uit een entiteit

Met deze bewerking worden items opgehaald uit een entiteit. Afhankelijk van de entiteit kunnen velden worden gedefinieerd als filters:

  • UnifiedActivity-entiteit: ActivityId- en CustomerId-velden
  • Klantentiteit: Het veld CustomerId en alle andere velden die zijn geïndexeerd in het Customer Insights-exemplaar
  • Alle andere entiteiten: het veld CustomerId.
Partities ophalen voor een entiteit (preview)

Partities voor een entiteit ophalen.
Partities ophalen voor een entiteit V2 (preview)

Partities ophalen voor een entiteit V2.

Entiteiten ophalen

Bewerkings-id:
GetTables

Met deze bewerking worden entiteiten opgehaald uit een exemplaar

Parameters

Name Sleutel Vereist Type Description
instanceId
 dataset True string

Id van een exemplaar

Retouren

Vertegenwoordigt een lijst met tabellen.

Body
TablesList

Gegevens ophalen uit een partitie (preview)

Bewerkings-id:
GetPartitionData

Gegevens ophalen uit een partitie.

Parameters

Name Sleutel Vereist Type Description
De gegevensset Customer Insights
 dataset True string

De gegevensset Customer Insights.
De entiteit
 table True string

De entiteit.
De verwijzing (URI of naam) van de partitie
 partitionUri True string

De verwijzing (URI of naam) van de partitie.
Een door komma's gescheiden lijn kolommen
 select string

Een door komma's gescheiden regel kolommen.
Positie vanaf waar te beginnen met lezen, in bytes
 offsetStart integer

Positie vanaf waar u wilt beginnen met lezen, in bytes.
Maximum aantal bytes dat moet worden gelezen
 maxSize integer

Maximum aantal bytes dat moet worden gelezen.
Maximum aantal records dat moet worden geretourneerd
 maxResults integer

Maximum aantal records dat moet worden geretourneerd.

Retouren

De gegevens uit een partitie.

Body
PartitionDataResponse

Het statusrapport verzenden

Bewerkings-id:
SendStatusReport

Hiermee wordt het statusrapport verzonden.

Parameters

Name Sleutel Vereist Type Description
Exemplaar-id
 dataset True string

Selecteer een exemplaar.
Rapporttype
 reportType True string

Selecteer een rapporttype.

Hiermee wordt het statusrapport V2 verzonden

Bewerkings-id:
SendStatusReportV2

Hiermee wordt het statusrapport V2 verzonden.

Parameters

Name Sleutel Vereist Type Description
Exemplaar-id
 dataset True string

Selecteer een exemplaar.
Rapporttype
 reportType True string

Selecteer een rapporttype.

Item bijwerken (preview)

Bewerkings-id:
PatchItem

Met deze bewerking wordt een item op een entiteit bijgewerkt

Parameters

Name Sleutel Vereist Type Description
instanceId
 dataset True string

Id van een exemplaar
entityName
 table True string

Naam van een entiteit
itemIdentifier
 id True string

Id voor het item
recordItem
 item True dynamic

Record die moet worden bijgewerkt

Retouren

De uitvoer van deze bewerking is dynamisch.

Item maken (preview)

Bewerkings-id:
PostItem

Met deze bewerking maakt u een item op een entiteit

Parameters

Name Sleutel Vereist Type Description
instanceId
 dataset True string

Id van een exemplaar
entityName
 table True string

Naam van een entiteit
recordItem
 item True dynamic

Record die moet worden gemaakt

Item ophalen

Bewerkings-id:
GetItem

Met deze bewerking wordt een item opgehaald uit een entiteit

Parameters

Name Sleutel Vereist Type Description
instanceId
 dataset True string

Id van een exemplaar
entityName
 table True string

Naam van een entiteit
itemIdentifier
 id True string

Id voor het item

Retouren

De uitvoer van deze bewerking is dynamisch.

Items ophalen uit een entiteit

Bewerkings-id:
GetItems

Met deze bewerking worden items opgehaald uit een entiteit. Afhankelijk van de entiteit kunnen velden worden gedefinieerd als filters:

  • UnifiedActivity-entiteit: ActivityId- en CustomerId-velden
  • Klantentiteit: Het veld CustomerId en alle andere velden die zijn geïndexeerd in het Customer Insights-exemplaar
  • Alle andere entiteiten: het veld CustomerId.

Parameters

Name Sleutel Vereist Type Description
instanceId
 dataset True string

Id van een exemplaar
entityName
 table True string

Naam van een entiteit
Filterquery
 $filter string

Een ODATA-filterquery om de geretourneerde vermeldingen te beperken (bijvoorbeeld stringColumn eq 'string' OR numberColumn lt 123).
Aantal tops
 $top integer

Totaal aantal items dat moet worden opgehaald (standaard = alle).
Query selecteren
 $select string

Specifieke velden die moeten worden opgehaald uit vermeldingen (standaard = alle).

Retouren

De uitvoer van deze bewerking is dynamisch.

Partities ophalen voor een entiteit (preview)

Bewerkings-id:
GetPartitions

Partities voor een entiteit ophalen.

Parameters

Name Sleutel Vereist Type Description
De gegevensset Customer Insights
 dataset True string

De gegevensset Customer Insights.
De entiteit
 table True string

De entiteit.

Retouren

response
array of Table

Partities ophalen voor een entiteit V2 (preview)

Bewerkings-id:
GetPartitionsV2

Partities ophalen voor een entiteit V2.

Parameters

Name Sleutel Vereist Type Description
De gegevensset Customer Insights
 dataset True string

De gegevensset Customer Insights.
De entiteit
 table True string

De entiteit.
De waarde partitionDisplayName voor het filteren op
 partitionDisplayName string

De waarde partitionDisplayName om op te filteren.

Retouren

De lijst met partities

Body
PartitionListResponse

Triggers

Activeert een stroom uit de gegevensbron wanneer vernieuwen is mislukt

Met deze bewerking wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is mislukt in Dynamics 365 Customer Insights.
Activeert een stroom wanneer een segmentdrempel wordt overschreden

Met deze bewerking wordt een stroom geactiveerd wanneer een segmentdrempel wordt overschreden in Dynamics 365 Customer Insights.
Hiermee wordt een stroom geactiveerd wanneer een drempelwaarde voor een zakelijke meting wordt overschreden

Met deze bewerking wordt een stroom geactiveerd wanneer een drempelwaarde voor een zakelijke meting wordt overschreden in Dynamics 365 Customer Insights.
Hiermee wordt een stroom geactiveerd wanneer een proces in Customer Insights is voltooid

Een stroom wordt geactiveerd voor geplande vernieuwingen van het geselecteerde proces. Daarnaast kunt u ervoor kiezen om een stroom te activeren voor handmatige vernieuwingen.
Hiermee wordt een stroom geactiveerd wanneer een volledige vernieuwing van Customer Insights is voltooid

Met deze bewerking wordt een stroom geactiveerd wanneer een volledige vernieuwing van Customer Insights (gegevensbronnen, segmenten, metingen,...) is voltooid.
Hiermee wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is voltooid

Met deze bewerking wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is voltooid in Dynamics 365 Customer Insights.

Activeert een stroom uit de gegevensbron wanneer vernieuwen is mislukt

Bewerkings-id:
GetOnDataSourceRefreshFail

Met deze bewerking wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is mislukt in Dynamics 365 Customer Insights.

Parameters

Name Sleutel Vereist Type Description
Milieu
 dataset True string

naam van de gegevensset.

Retouren

DataSourcesList

Body
DataSourcesList

Activeert een stroom wanneer een segmentdrempel wordt overschreden

Bewerkings-id:
GetOnSegmentUpdated

Met deze bewerking wordt een stroom geactiveerd wanneer een segmentdrempel wordt overschreden in Dynamics 365 Customer Insights.

Parameters

Name Sleutel Vereist Type Description
Instantie-naam
 dataset True string

Selecteer een exemplaar.
Segmentnaam
 segment True string

Selecteer een segment.
Drempel
 threshold True integer

Stel een willekeurig getal in als drempelwaarde.

Retouren

Segmentgegevens

Body
SegmentData

Hiermee wordt een stroom geactiveerd wanneer een drempelwaarde voor een zakelijke meting wordt overschreden

Bewerkings-id:
GetOnBusinessMeasureUpdated

Met deze bewerking wordt een stroom geactiveerd wanneer een drempelwaarde voor een zakelijke meting wordt overschreden in Dynamics 365 Customer Insights.

Parameters

Name Sleutel Vereist Type Description
Instantie-naam
 dataset True string

Selecteer een exemplaar.
Naam van bedrijfsmaatregel
 measure True string

Selecteer een meting.
Drempel
 threshold True double

Stel een willekeurig getal in als drempelwaarde.

Retouren

Zakelijke metinggegevens

Body
MeasureData

Hiermee wordt een stroom geactiveerd wanneer een proces in Customer Insights is voltooid

Bewerkings-id:
GetOnProcessCompleted

Een stroom wordt geactiveerd voor geplande vernieuwingen van het geselecteerde proces. Daarnaast kunt u ervoor kiezen om een stroom te activeren voor handmatige vernieuwingen.

Parameters

Name Sleutel Vereist Type Description
Instantie-naam
 dataset True string

Selecteer een exemplaar.
Proces
 process string

Selecteer een proces.
Handmatig geactiveerd proces opnemen
 includingManualRefreshes boolean

Selecteer Ja als handmatig geactiveerd proces moet worden opgenomen.

Retouren

De informatie over het uitgevoerde proces

Body
ProcessData

Hiermee wordt een stroom geactiveerd wanneer een volledige vernieuwing van Customer Insights is voltooid

Bewerkings-id:
GetOnFullDagRefreshCompleted

Met deze bewerking wordt een stroom geactiveerd wanneer een volledige vernieuwing van Customer Insights (gegevensbronnen, segmenten, metingen,...) is voltooid.

Parameters

Name Sleutel Vereist Type Description
Instantie-naam
 dataset True string

Selecteer een exemplaar.

Retouren

De informatie over het uitvoeren van volledige vernieuwing

Body
FullRefreshProcessData

Hiermee wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is voltooid

Bewerkings-id:
GetOnDataSourceRefreshComplete

Met deze bewerking wordt een stroom van de gegevensbron geactiveerd wanneer het vernieuwen is voltooid in Dynamics 365 Customer Insights.

Parameters

Name Sleutel Vereist Type Description
Milieu
 dataset True string

naam van de gegevensset.

Retouren

DataSourcesList

Body
DataSourcesList

Definities

DataSourcesList

DataSourcesList

Name Pad Type Description
waarde
 value array of DataSource

Lijst met gegevensbronnen

gegevensbron

Gegevensbronklasse

Name Pad Type Description
RefreshType
 RefreshType string

Het type voor gegevensvernieuwing
RefreshObjectId
 RefreshObjectId string

De object-id vernieuwen
RefreshObjectVersion
 RefreshObjectVersion integer

De versie van het vernieuwingsobject
Operation
 Operation string

De naam van de bewerking
JobType
 JobType string

Het taaktype
ErrorCode
 ErrorCode string

De foutcode tijdens het vernieuwen van gegevens.
Foutmelding
 ErrorMessage string

Het foutbericht tijdens het vernieuwen
Foutseverity
 ErrorSeverity string

De foutserveriteit tijdens het vernieuwen
StartTimeUtc
 StartTimeUtc string

De begintijd voor het vernieuwen van gegevens
EndTimeUtc
 EndTimeUtc string

De eindtijd voor het vernieuwen van gegevens

SegmentData

Segmentgegevens

Name Pad Type Description
Naam
 Name string

De segmentnaam
Schermnaam
 DisplayName string

De weergavenaam van het segment
EvaluationDate
 EvaluationDate date-time

De evaluatiedatum van het segment
EntityCount
 EntityCount integer

Het werkelijke aantal segmentleden
Drempel
 Threshold integer

De segmentdrempelwaarde

MeasureData

Zakelijke metinggegevens

Name Pad Type Description
Naam
 Name string

De naam van de meting
Schermnaam
 DisplayName string

De weergavenaam van de meting
EvaluationDate
 EvaluationDate date-time

De evaluatiedatum van de meting
Waarde
 Value double

De waarde van de meting
ValueDisplayName
 ValueDisplayName string

De weergavenaam van de waarde
Drempel
 Threshold double

De drempelwaarde voor meting

FullRefreshProcessData

De informatie over het uitvoeren van volledige vernieuwing

Name Pad Type Description
NumberOfFailedTasks
 NumberOfFailedTasks integer

Het aantal mislukte taken
StartTime
 StartTime date-time

De begintijd van de werkstroomstap
EndTime
 EndTime date-time

De eindtijd van de werkstroomstap
Duur
 Duration integer

De duur van het proces in minuten
Toestand
 Status string

De status van de werkstroomstap
Statuspagina
 StatusPage string

De koppeling naar de statuspagina

ProcessData

De informatie over het uitgevoerde proces

Name Pad Type Description
StartTime
 StartTime date-time

De begintijd van de werkstroomstap
EndTime
 EndTime date-time

De eindtijd van de werkstroomstap
Duur
 Duration integer

De duur van het proces in minuten
Toestand
 Status string

De status van de werkstroomstap
Statuspagina
 StatusPage string

De koppeling naar de statuspagina

Table

Vertegenwoordigt een tabel.

Name Pad Type Description
Naam
 Name string

De naam van de tabel. De naam wordt tijdens runtime gebruikt.
Schermnaam
 DisplayName string

De weergavenaam van de tabel.
DynamicProperties
 DynamicProperties object

Aanvullende tabeleigenschappen die door de connector aan de clients worden geleverd.

PartitionListResponse

De lijst met partities

Name Pad Type Description
Header
 Header string

Header met de kenmerken van de entiteit
Partitions
 Partitions array of Table

Lijst met partities

PartitionDataResponse

De gegevens uit een partitie.

Name Pad Type Description
OffsetStart
 OffsetStart integer

De beginverschil.
OffsetEnd
 OffsetEnd integer

De eindverschil.
Grootte
 Size integer

Het aantal geretourneerde gegevens.
Artikelen
 Items array of object

De woordenlijst met gegevens van het maximum aantal 'Grootte'-items van een partitie, van offset 'OffsetStart' tot 'OffsetEnd'.
items
 Items object

TablesList

Vertegenwoordigt een lijst met tabellen.

Name Pad Type Description
waarde
 value array of Table

Lijst met tabellen