Partager via

Microsoft Dataverse [DÉCONSEILLÉ]

Fournit l’accès à la base de données d’environnement dans Microsoft Dataverse.

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

Service classe Régions
Copilot Studio Premium Toutes les régions Power Automate
Applications logiques Norme Toutes les régions Logic Apps
Power Apps - Non disponible
Power Automate Premium Toutes les régions Power Automate
Contact
Nom Microsoft
URL Microsoft LogicApps Support
Prise en charge de Microsoft Power Automate
Métadonnées du connecteur
Éditeur Microsoft
Site internet https://powerapps.microsoft.com/common-data-service/

Note

Le connecteur Microsoft Dataverse (hérité) sera pris en charge par Microsoft jusqu’à ce que le connecteur Microsoft Dataverse prenne en charge Logic Apps.

Pour utiliser ce connecteur dans Power Apps, apprenez-en davantage sur l’utilisation de ce connecteur dans Power Apps.

Problèmes connus et limitations

  1. Il existe des occurrences lorsque les déclencheurs CDS ne fonctionnent pas dans l’environnement de production avec le mode d’administration défini sur « activé ». Si vous rencontrez ce problème, une solution de contournement consiste à désactiver le mode d’administration dans le Centre d’administration Power Platforms.
  2. Si le mode d’administration est activé pour l’environnement utilisé (bac à sable ou production), le flux Power Automate avec quand un enregistrement est modifié ne se déclenche pas lorsqu’un enregistrement est modifié. Pour plus d’informations sur la définition du mode d’administration, reportez-vous à cette page.
  3. Lorsque vous utilisez le déclencheur « Quand un enregistrement est sélectionné » dans un flux et que vous disposez d’une étape If Condition juste après, vous recevrez une erreur si l’attribut de la condition a une valeur Null. Le message d’erreur que vous verrez est « Type non valide. Chaîne attendue, mais a obtenu La valeur Null. La solution de contournement suggérée consiste à insérer une action « Obtenir une ligne » entre l’étape « Lorsque l’enregistrement est sélectionné » et l’étape If Condition. En utilisant la sortie de l’action « Obtenir la ligne » dans votre condition, vous serez en mesure d’éviter cette erreur.

Mappages de types de données Power Apps

Power Apps Microsoft Dataverse (hérité)
Choix Choix, Oui/Non
Date et heure Date, date et heure, date uniquement
Image Image
Number Nombre à virgule flottante, devise, nombre décimal, durée, langue, fuseau horaire, nombre entier
Texto E-mail, texte multiligne, téléphone, texte, zone de texte, symbole de graduation, URL
GUID Identificateur unique

Fonctions et opérations délégables Power Apps pour Dataverse

Ces opérations Power Apps, pour un type de données donné, peuvent être déléguées à Dataverse à des fins de traitement (plutôt que de traiter localement dans Power Apps).

Élément Nombre [1] Texte [2] Choix DateTime [3] GUID
Filter Oui Oui Oui Oui Oui
Trier Oui Oui Non Oui -
SortByColumns Oui Oui Non Oui -
Recherche Oui Oui Oui Oui Oui
=, <> Oui Oui Oui Oui Oui
<, <=, >, >= Oui Oui Non Oui -
Et/ou non Oui Oui Oui Oui Oui
StartsWith - Oui - - -
IsBlank Oui [4] Oui [4] Non [4] Oui [4] Oui
Somme, Min, Max, Avg Oui [5] - - Non -
  1. Les valeurs numériques avec des expressions arithmétiques (par exemple, Filter(table, champ + 10 > 100) ne sont pas délégables. La langue et le fuseau horaire ne sont pas délégables.
  2. Ne prend pas en charge Trim[Ends] ou Len. Prend en charge d’autres fonctions telles que Left, Mid, Right, Upper, Lower, Replace, Substitute, etc.
  3. DateTime est généralement délegatable à l’exception des fonctions DateTime Now() et Today().
  4. Prend en charge les comparaisons. Par exemple, Filter(TableName, MyCol = Blank()).
  5. Les fonctions d’agrégation sont limitées à une collection de 50 000 lignes. Si nécessaire, utilisez la fonction Filter pour sélectionner 50 000 lignes d’un ensemble plus grand avant d’utiliser la fonction d’agrégation.

Note

Les choix, guid et fonctions d’agrégation pour Dataverse sont pris en charge uniquement avec la nouvelle version du connecteur. Selon la version de Power Apps que vous utilisez, activez ce connecteur avec le commutateur Preview intitulé :

  • Données relationnelles, choix et autres nouvelles fonctionnalités pour Dataverse
    ou ce commutateur expérimental :
  • Utiliser le connecteur Dataverse
    Pour rechercher ces commutateurs, ouvrez le menu Fichier, puis sélectionnezParamètres avancés des paramètres>d’application.

Connecteur en profondeur

Pour plus d’informations sur le connecteur, consultez la section détaillée.

Création d’une connexion

Le connecteur prend en charge les types d’authentification suivants :
Authentification de certificat client Fournir des informations d’identification d’ID Microsoft Entra à l’aide du certificat PFX et du mot de passe Toutes les régions Partageable
Oauth Oauth Toutes les régions Partageable
Service Principal Fournir des informations d’identification d’ID Microsoft Entra à l’aide de l’ID client et du secret Toutes les régions Partageable
Valeur par défaut [DÉCONSEILLÉE] Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante. Toutes les régions Non partageable

Authentification de certificat client

ID d’authentification : CertOauth

Applicable : Toutes les régions

Fournir des informations d’identification d’ID Microsoft Entra à l’aide du certificat PFX et du mot de passe

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom Type Descriptif Obligatoire
Locataire ficelle Vrai
ID de client ficelle ID client de l’application Microsoft Entra ID Vrai
Secret du certificat client clientCertificate Secret de certificat client autorisé par cette application Vrai

Oauth

ID d’authentification : Oauth

Applicable : Toutes les régions

Oauth

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Principal de service

ID d’authentification : ServicePrincipalOauth

Applicable : Toutes les régions

Fournir des informations d’identification d’ID Microsoft Entra à l’aide de l’ID client et du secret

Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs

Nom Type Descriptif Obligatoire
ID de client ficelle ID client (ou application) de l’application Microsoft Entra ID. Vrai
Clé secrète client securestring Clé secrète client de l’application Microsoft Entra ID. Vrai
Locataire ficelle ID de locataire de l’application Microsoft Entra ID. Vrai

Valeur par défaut [DÉCONSEILLÉE]

Applicable : Toutes les régions

Cette option concerne uniquement les connexions plus anciennes sans type d’authentification explicite et est fournie uniquement pour la compatibilité descendante.

Cette connexion n’est pas partageable. Si l’application power est partagée avec un autre utilisateur, un autre utilisateur est invité à créer une connexion explicitement.

Limitations

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

Actions

Ajouter une nouvelle ligne (héritée) [DÉCONSEILLÉ]

Cette opération ajoute une nouvelle ligne d’une table
Ajouter une nouvelle ligne [DÉPRÉCIÉ]

Cette opération ajoute une nouvelle ligne d’une table
Get row (legacy) [DEPRECATED]

Cette opération récupère la ligne spécifiée pour une table
Mettre à jour une ligne (héritée) [DÉCONSEILLÉ]

Cette opération met à jour une ligne existante pour une table
Mettre à jour une ligne [DÉCONSEILLÉ]

Cette opération met à jour une ligne existante pour une table
Obtient une ligne de la table [DÉPRÉCIÉ]

Obtient une ligne de la table
Répertorier les lignes (héritées) [DÉCONSEILLÉE]

Cette opération obtient des lignes pour une table
Répertorier les lignes [DÉCONSEILLÉE]

Cette opération obtient des lignes pour une table
Supprimer une ligne (héritée) [DÉPRÉCIÉE]

Cette opération supprime une ligne d’une collection de tables

Ajouter une nouvelle ligne (héritée) [DÉCONSEILLÉ]

ID d’opération :
PostItem_V2

Cette opération ajoute une nouvelle ligne d’une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Élément de ligne
 item True dynamic

Ligne à créer

Retours

Les sorties de cette opération sont dynamiques.

Ajouter une nouvelle ligne [DÉPRÉCIÉ]

ID d’opération :
PostItem

Cette opération ajoute une nouvelle ligne d’une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Élément de ligne
 item True dynamic

Ligne à créer

Retours

Les sorties de cette opération sont dynamiques.

Get row (legacy) [DEPRECATED]

ID d’opération :
GetItem_V2

Cette opération récupère la ligne spécifiée pour une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Identificateur d’élément
 id True string

Identificateur de la ligne

Retours

Les sorties de cette opération sont dynamiques.

Mettre à jour une ligne (héritée) [DÉCONSEILLÉ]

ID d’opération :
PatchItem_V2

Cette opération met à jour une ligne existante pour une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Identificateur de ligne
 id True string

Identificateur de la ligne
Élément de ligne
 item True dynamic

Ligne à mettre à jour

Retours

Les sorties de cette opération sont dynamiques.

Mettre à jour une ligne [DÉCONSEILLÉ]

ID d’opération :
PatchItem

Cette opération met à jour une ligne existante pour une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Identificateur de ligne
 id True string

Identificateur de la ligne
Élément de ligne
 item True dynamic

Ligne à mettre à jour

Retours

Les sorties de cette opération sont dynamiques.

Obtient une ligne de la table [DÉPRÉCIÉ]

ID d’opération :
GetItem

Obtient une ligne de la table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Identificateur d’élément
 id True string

Identificateur de la ligne

Retours

Les sorties de cette opération sont dynamiques.

Répertorier les lignes (héritées) [DÉCONSEILLÉE]

ID d’opération :
GetItems_V2

Cette opération obtient des lignes pour une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Transformation d’agrégation
 $apply string

Séquence de transformations d’agrégation OData
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).
Commande par
 $orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées.
Nombre supérieur
 $top integer

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

Entrées associées à inclure avec les entrées demandées (par défaut = aucun)

Retours

Les sorties de cette opération sont dynamiques.

Répertorier les lignes [DÉCONSEILLÉE]

ID d’opération :
GetItems

Cette opération obtient des lignes pour une table

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
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).
Commande par
 $orderby string

Requête ODATA orderBy pour spécifier l’ordre des entrées.
Nombre supérieur
 $top integer

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

Entrées associées à inclure avec les entrées demandées (par défaut = aucun)

Retours

Les sorties de cette opération sont dynamiques.

Supprimer une ligne (héritée) [DÉPRÉCIÉE]

ID d’opération :
DeleteItem

Cette opération supprime une ligne d’une collection de tables

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table
Identificateur d’élément
 id True string

Identificateur de la ligne

Déclencheurs

Lors de la sélection d’une ligne

Déclenchez un flux lorsqu’une ligne est sélectionnée dans le menu Flux dans la barre de commandes. (Disponible uniquement pour Power Automate.)
Lorsqu’une ligne est ajoutée (Administrateur uniquement) [DÉCONSEILLÉ]

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse
Lorsqu’une ligne est ajoutée (Administrateur uniquement) [DÉCONSEILLÉ]

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse
Lorsqu’une ligne est ajoutée [DÉCONSEILLÉE]

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse.
Lorsqu’une ligne est modifiée (Administrateur uniquement) [DÉCONSEILLÉ]

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse
Lorsqu’une ligne est modifiée (Administrateur uniquement) [DÉCONSEILLÉ]

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse
Lorsqu’une ligne est modifiée [DÉPRÉCIÉ]

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse.
Lorsqu’une ligne est supprimée (Administrateur uniquement) [DÉCONSEILLÉ]

Déclenche un flux lorsqu’une ligne est supprimée dans Dataverse
Lorsqu’une ligne est supprimée [DÉCONSEILLÉE]

Déclenche un flux lorsqu’une ligne est supprimée dans Dataverse.

Lors de la sélection d’une ligne

ID d’opération :
OnItemSelected

Déclenchez un flux lorsqu’une ligne est sélectionnée dans le menu Flux dans la barre de commandes. (Disponible uniquement pour Power Automate.)

Paramètres

Nom Clé Obligatoire Type Description
operationId
 operationId True string
host
 host object
parameters
 parameters True object
schéma
 schema True object
en-têtesSchéma
 headersSchema object

Retours

Nom Chemin d’accès Type Description
Lignes
 body.rows array of object
items
 body.rows object
Identifiant utilisateur
 headers.x-ms-user-id-encoded guid

Identificateur unique de l’utilisateur ayant déclenché le flux dans AAD.
Adresse e-mail de l’utilisateur
 headers.x-ms-user-email-encoded byte

Adresse e-mail de l’utilisateur qui a déclenché le flux.
Nom d'utilisateur
 headers.x-ms-user-name-encoded byte

Nom d’affichage de l’utilisateur qui a déclenché le flux.
Timestamp
 headers.x-ms-user-timestamp string

Heure de déclenchement du flux.

Lorsqu’une ligne est ajoutée (Administrateur uniquement) [DÉCONSEILLÉ]

ID d’opération :
GetOnNewItems

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est ajoutée (Administrateur uniquement) [DÉCONSEILLÉ]

ID d’opération :
GetOnNewItems_V2

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est ajoutée [DÉCONSEILLÉE]

ID d’opération :
SubscribeOnNewItems

Déclenche un flux lorsqu’une ligne est ajoutée dans Dataverse.

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionnez un environnement.
Nom de la table
 table True string

Sélectionnez une table.
Scope
 scope True string

Portée.

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est modifiée (Administrateur uniquement) [DÉCONSEILLÉ]

ID d’opération :
GetOnUpdatedItems_V2

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est modifiée (Administrateur uniquement) [DÉCONSEILLÉ]

ID d’opération :
GetOnUpdatedItems

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est modifiée [DÉPRÉCIÉ]

ID d’opération :
SubscribeOnUpdatedItems

Déclenche un flux lorsqu’une ligne est modifiée dans Dataverse.

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionnez un environnement.
Nom de la table
 table True string

Sélectionnez une table.
Scope
 scope True string

Portée.
Filtres de colonnes
 AttributeFilters array of string

Filtres de colonnes

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est supprimée (Administrateur uniquement) [DÉCONSEILLÉ]

ID d’opération :
GetOnDeletedItems

Déclenche un flux lorsqu’une ligne est supprimée dans Dataverse

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionner un environnement
Nom de la table
 table True string

Sélectionner une table

Retours

Les sorties de cette opération sont dynamiques.

Lorsqu’une ligne est supprimée [DÉCONSEILLÉE]

ID d’opération :
SubscribeOnDeletedItems

Déclenche un flux lorsqu’une ligne est supprimée dans Dataverse.

Paramètres

Nom Clé Obligatoire Type Description
Environnement
 dataset True string

Sélectionnez un environnement.
Nom de la table
 table True string

Sélectionnez une table.
Scope
 scope True string

Portée.

Retours

Les sorties de cette opération sont dynamiques.