Partager via

Dynamics 365 Customer Insights (préversion)

Le connecteur Dynamics 365 Customer Insights fournit un ensemble d’API permettant d’interagir avec les instances Dynamics 365 Customer Insights.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Applications logiques Norme Toutes les régions Logic Apps , à l’exception des suivantes :
     - Régions Azure Chine
     - Us Department of Defense (DoD)
Power Apps Premium Toutes les régions Power Apps , à l’exception des suivantes :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Power Automate Premium Toutes les régions Power Automate , à l’exception des éléments suivants :
     - Us Government (GCC High)
     - China Cloud géré par 21Vianet
     - Us Department of Defense (DoD)
Contact
Nom Microsoft
URL Microsoft LogicApps Support
Prise en charge de Microsoft Power Automate
Prise en charge de Microsoft Power Apps
Métadonnées du connecteur
Éditeur Microsoft

Pour vous inscrire à Dynamics 365 Customer Insights, cliquez ici.

Pour utiliser ce connecteur dans Power Apps, apprenez-en davantage ici.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes

Actions

Créer un élément (préversion)

Cette opération crée un élément sur une entité
Envoie le rapport d’état

Envoie le rapport d’état.
Envoie le rapport d’état V2

Envoie le rapport d’état V2.
Mettre à jour l’élément (préversion)

Cette opération met à jour un élément sur une entité
Obtenir des entités

Cette opération obtient des entités d’une instance
Obtenir des éléments à partir d’une entité

Cette opération obtient des éléments d’une entité. Selon l’entité, les champs peuvent être définis en tant que filtres :

  • Entité UnifiedActivity : Champs ActivityId et CustomerId
  • Entité client : champ CustomerId et tous les autres champs indexés dans l’instance Customer Insights
  • Toutes les autres entités : champ CustomerId.
Obtenir un élément

Cette opération obtient un élément d’une entité
Récupérer des données à partir d’une partition (préversion)

Récupérer des données à partir d’une partition.
Récupérer des partitions pour une entité (préversion)

Récupérer des partitions pour une entité.
Récupérer des partitions pour une entité V2 (préversion)

Récupérer des partitions pour une entité V2.

Créer un élément (préversion)

ID d’opération :
PostItem

Cette opération crée un élément sur une entité

Paramètres

Nom Clé Obligatoire Type Description
instanceId
 dataset True string

Identificateur d’une instance
entityName
 table True string

Nom d’une entité
recordItem
 item True dynamic

Enregistrement à créer

Envoie le rapport d’état

ID d’opération :
SendStatusReport

Envoie le rapport d’état.

Paramètres

Nom Clé Obligatoire Type Description
ID d’instance
 dataset True string

Sélectionnez une instance.
Type de rapport
 reportType True string

Sélectionnez un type de rapport.

Envoie le rapport d’état V2

ID d’opération :
SendStatusReportV2

Envoie le rapport d’état V2.

Paramètres

Nom Clé Obligatoire Type Description
ID d’instance
 dataset True string

Sélectionnez une instance.
Type de rapport
 reportType True string

Sélectionnez un type de rapport.

Mettre à jour l’élément (préversion)

ID d’opération :
PatchItem

Cette opération met à jour un élément sur une entité

Paramètres

Nom Clé Obligatoire Type Description
instanceId
 dataset True string

Identificateur d’une instance
entityName
 table True string

Nom d’une entité
itemIdentifier
 id True string

Identificateur de l’élément
recordItem
 item True dynamic

Enregistrement à mettre à jour

Retours

Les sorties de cette opération sont dynamiques.

Obtenir des entités

ID d’opération :
GetTables

Cette opération obtient des entités d’une instance

Paramètres

Nom Clé Obligatoire Type Description
instanceId
 dataset True string

Identificateur d’une instance

Retours

Représente une liste de tables.

Corps
TablesList

Obtenir des éléments à partir d’une entité

ID d’opération :
GetItems

Cette opération obtient des éléments d’une entité. Selon l’entité, les champs peuvent être définis en tant que filtres :

  • Entité UnifiedActivity : Champs ActivityId et CustomerId
  • Entité client : champ CustomerId et tous les autres champs indexés dans l’instance Customer Insights
  • Toutes les autres entités : champ CustomerId.

Paramètres

Nom Clé Obligatoire Type Description
instanceId
 dataset True string

Identificateur d’une instance
entityName
 table True string

Nom d’une entité
Filtrer la requête
 $filter string

Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123).
Nombre supérieur
 $top integer

Nombre total d’entrées à récupérer (valeur par défaut = all).
Sélectionner la requête
 $select string

Champs spécifiques à récupérer à partir d’entrées (valeur par défaut = all).

Retours

Les sorties de cette opération sont dynamiques.

Obtenir un élément

ID d’opération :
GetItem

Cette opération obtient un élément d’une entité

Paramètres

Nom Clé Obligatoire Type Description
instanceId
 dataset True string

Identificateur d’une instance
entityName
 table True string

Nom d’une entité
itemIdentifier
 id True string

Identificateur de l’élément

Retours

Les sorties de cette opération sont dynamiques.

Récupérer des données à partir d’une partition (préversion)

ID d’opération :
GetPartitionData

Récupérer des données à partir d’une partition.

Paramètres

Nom Clé Obligatoire Type Description
Jeu de données Customer Insights
 dataset True string

Jeu de données Customer Insights.
Entité
 table True string

Entité.
Référence (URI ou nom) de la partition
 partitionUri True string

Référence (URI ou Nom) de la partition.
Ligne séparée par des virgules de colonnes
 select string

Ligne séparée par des virgules de colonnes.
Position à partir de l’emplacement où commencer la lecture, en octets
 offsetStart integer

Position de l’endroit où commencer la lecture, en octets.
Nombre maximal d’octets à lire
 maxSize integer

Nombre maximal d’octets à lire.
Nombre maximal d’enregistrements à retourner
 maxResults integer

Nombre maximal d’enregistrements à retourner.

Retours

Données d’une partition.

Corps
PartitionDataResponse

Récupérer des partitions pour une entité (préversion)

ID d’opération :
GetPartitions

Récupérer des partitions pour une entité.

Paramètres

Nom Clé Obligatoire Type Description
Jeu de données Customer Insights
 dataset True string

Jeu de données Customer Insights.
Entité
 table True string

Entité.

Retours

response
array of Table

Récupérer des partitions pour une entité V2 (préversion)

ID d’opération :
GetPartitionsV2

Récupérer des partitions pour une entité V2.

Paramètres

Nom Clé Obligatoire Type Description
Jeu de données Customer Insights
 dataset True string

Jeu de données Customer Insights.
Entité
 table True string

Entité.
Valeur partitionDisplayName à filtrer pour
 partitionDisplayName string

Valeur partitionDisplayName à filtrer.

Retours

Liste des partitions

Corps
PartitionListResponse

Déclencheurs

Déclenche un flux lorsqu’un processus dans Customer Insights est terminé

Un flux est déclenché pour les actualisations planifiées du processus sélectionné. En outre, vous pouvez choisir de déclencher un flux pour les actualisations manuelles.
Déclenche un flux lorsqu’un seuil de mesure métier est franchi

Cette opération déclenche un flux lorsqu’un seuil de mesure métier est franchi dans Dynamics 365 Customer Insights.
Déclenche un flux lorsqu’un seuil de segment est franchi

Cette opération déclenche un flux lorsqu’un seuil de segment est franchi dans Dynamics 365 Customer Insights.
Déclenche un flux lorsqu’une actualisation complète de Customer Insights est terminée

Cette opération déclenche un flux lorsqu’une actualisation complète de Customer Insights (sources de données, segments, mesures,...) est terminée.
Déclenche un flux à partir de la source de données lors de l’échec de l’actualisation

Cette opération déclenche un flux à partir de la source de données lors de l’échec de l’actualisation dans Dynamics 365 Customer Insights.
Déclenche un flux à partir de la source de données lorsque l’actualisation est terminée

Cette opération déclenche un flux à partir de la source de données lorsque l’actualisation est terminée dans Dynamics 365 Customer Insights.

Déclenche un flux lorsqu’un processus dans Customer Insights est terminé

ID d’opération :
GetOnProcessCompleted

Un flux est déclenché pour les actualisations planifiées du processus sélectionné. En outre, vous pouvez choisir de déclencher un flux pour les actualisations manuelles.

Paramètres

Nom Clé Obligatoire Type Description
Nom de l’instance
 dataset True string

Sélectionnez une instance.
Processus
 process string

Sélectionnez un processus.
Inclure un processus déclenché manuellement
 includingManualRefreshes boolean

Sélectionnez Oui si le processus déclenché manuellement doit être inclus.

Retours

Informations sur le processus exécuté

Corps
ProcessData

Déclenche un flux lorsqu’un seuil de mesure métier est franchi

ID d’opération :
GetOnBusinessMeasureUpdated

Cette opération déclenche un flux lorsqu’un seuil de mesure métier est franchi dans Dynamics 365 Customer Insights.

Paramètres

Nom Clé Obligatoire Type Description
Nom de l’instance
 dataset True string

Sélectionnez une instance.
Nom de la mesure métier
 measure True string

Sélectionnez une mesure.
Seuil
 threshold True double

Définissez n’importe quel nombre comme seuil.

Retours

Données de mesure métier

Corps
MeasureData

Déclenche un flux lorsqu’un seuil de segment est franchi

ID d’opération :
GetOnSegmentUpdated

Cette opération déclenche un flux lorsqu’un seuil de segment est franchi dans Dynamics 365 Customer Insights.

Paramètres

Nom Clé Obligatoire Type Description
Nom de l’instance
 dataset True string

Sélectionnez une instance.
Nom du segment
 segment True string

Sélectionnez un segment.
Seuil
 threshold True integer

Définissez n’importe quel nombre comme seuil.

Retours

Segmenter les données

Corps
SegmentData

Déclenche un flux lorsqu’une actualisation complète de Customer Insights est terminée

ID d’opération :
GetOnFullDagRefreshCompleted

Cette opération déclenche un flux lorsqu’une actualisation complète de Customer Insights (sources de données, segments, mesures,...) est terminée.

Paramètres

Nom Clé Obligatoire Type Description
Nom de l’instance
 dataset True string

Sélectionnez une instance.

Retours

Informations sur l’actualisation complète exécutée

Corps
FullRefreshProcessData

Déclenche un flux à partir de la source de données lors de l’échec de l’actualisation

ID d’opération :
GetOnDataSourceRefreshFail

Cette opération déclenche un flux à partir de la source de données lors de l’échec de l’actualisation dans Dynamics 365 Customer Insights.

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

nom du jeu de données.

Retours

DataSourcesList

Corps
DataSourcesList

Déclenche un flux à partir de la source de données lorsque l’actualisation est terminée

ID d’opération :
GetOnDataSourceRefreshComplete

Cette opération déclenche un flux à partir de la source de données lorsque l’actualisation est terminée dans Dynamics 365 Customer Insights.

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

nom du jeu de données.

Retours

DataSourcesList

Corps
DataSourcesList

Définitions

DataSourcesList

DataSourcesList

Nom Chemin d’accès Type Description
value
 value array of DataSource

Liste des sources de données

Source de données

DataSource, classe

Nom Chemin d’accès Type Description
RefreshType
 RefreshType string

Type d’actualisation des données
RefreshObjectId
 RefreshObjectId string

ID d’objet d’actualisation
RefreshObjectVersion
 RefreshObjectVersion integer

Version de l’objet d’actualisation
Opération
 Operation string

Nom de l’opération
JobType
 JobType string

Type de travail
ErrorCode
 ErrorCode string

Code d’erreur pendant l’actualisation des données.
Message d'erreur
 ErrorMessage string

Message d’erreur lors de l’actualisation
ErrorSeverity
 ErrorSeverity string

Serveurité d’erreur pendant l’actualisation
StartTimeUtc
 StartTimeUtc string

Heure de début de l’actualisation des données
EndTimeUtc
 EndTimeUtc string

Heure de fin de l’actualisation des données

SegmentData

Segmenter les données

Nom Chemin d’accès Type Description
Nom
 Name string

Nom du segment
DisplayName
 DisplayName string

Nom d’affichage du segment
EvaluationDate
 EvaluationDate date-time

Date d’évaluation du segment
EntityCount
 EntityCount integer

Nombre réel de membres de segment
Seuil
 Threshold integer

Seuil du segment

MeasureData

Données de mesure métier

Nom Chemin d’accès Type Description
Nom
 Name string

Nom de la mesure
DisplayName
 DisplayName string

Nom d’affichage de la mesure
EvaluationDate
 EvaluationDate date-time

Date d’évaluation de la mesure
Valeur
 Value double

Valeur de la mesure
ValueDisplayName
 ValueDisplayName string

Nom complet de la valeur
Seuil
 Threshold double

Seuil de mesure

FullRefreshProcessData

Informations sur l’actualisation complète exécutée

Nom Chemin d’accès Type Description
NumberOfFailedTasks
 NumberOfFailedTasks integer

Nombre de tâches ayant échoué
StartTime
 StartTime date-time

Heure de début de l’étape de flux de travail
EndTime
 EndTime date-time

Heure de fin de l’étape de flux de travail
Durée
 Duration integer

Durée du processus en minutes
Statut
 Status string

État de l’étape de flux de travail
StatusPage
 StatusPage string

Lien vers la page d’état

ProcessData

Informations sur le processus exécuté

Nom Chemin d’accès Type Description
StartTime
 StartTime date-time

Heure de début de l’étape de flux de travail
EndTime
 EndTime date-time

Heure de fin de l’étape de flux de travail
Durée
 Duration integer

Durée du processus en minutes
Statut
 Status string

État de l’étape de flux de travail
StatusPage
 StatusPage string

Lien vers la page d’état

Table

Représente une table.

Nom Chemin d’accès Type Description
Nom
 Name string

Nom de la table. Le nom est utilisé au moment de l’exécution.
DisplayName
 DisplayName string

Nom complet de la table.
DynamicProperties
 DynamicProperties object

Propriétés de table supplémentaires fournies par le connecteur aux clients.

PartitionListResponse

Liste des partitions

Nom Chemin d’accès Type Description
Header
 Header string

En-tête contenant les attributs de l’entité
Partitions
 Partitions array of Table

Liste des partitions

PartitionDataResponse

Données d’une partition.

Nom Chemin d’accès Type Description
OffsetStart
 OffsetStart integer

Décalage de départ.
OffsetEnd
 OffsetEnd integer

Décalage de fin.
Taille
 Size integer

Nombre de données retournées.
Objets
 Items array of object

Dictionnaire contenant des données de nombre maximal d’éléments « Taille » d’une partition, de décalage « OffsetStart » à « OffsetEnd ».
items
 Items object

TablesList

Représente une liste de tables.

Nom Chemin d’accès Type Description
value
 value array of Table

Liste des tables