référence dataApi pour les pages génératives

Lorsque vous générez une page à l’aide du langage naturel, l’IA crée une page React dans TypeScript. La page générée couvre à la fois l’expérience utilisateur frontale en sélectionnant les composants appropriés et en déterminant la meilleure disposition et la logique métier correspondante.

Vous pouvez afficher et modifier le code généré pour affiner la sortie. Les opérations de données utilisent un dataApi objet qui expose les méthodes publiques regroupées en catégories suivantes :

Category	Descriptif
Méthodes de table Dataverse	Créez, récupérez, mettez à jour et supprimez des lignes de table Dataverse et des colonnes de choix de requête.
Méthodes de connecteur	Utiliser des données exposées par un connecteur Power Platform lié à la page.
Méthodes d’opération Dataverse	Appelez des API personnalisées Dataverse liées à la page en tant qu’actions ou fonctions.
Méthodes de page	Contrôlez la page générative elle-même, par exemple le renvoi d’une valeur lorsque la page est utilisée comme boîte de dialogue.

Les méthodes de connecteur et les méthodes d’action et de fonction sont des membres facultatifs du dataApi contrat. Certains hôtes ne les implémentent pas. Vérifiez donc toujours qu’une méthode existe (par exemple) if (dataApi.executeAction) { ... }avant de l’appeler. Une méthode présente ne signifie pas que la page a un connecteur ou une API personnalisée Dataverse liée à celle-ci, ou que l’API personnalisée est activée ou autorisée pour l’utilisateur actuel. Gérez explicitement les fonctionnalités indisponibles et les échecs d’API personnalisés plutôt que d’assumer la réussite.

Méthodes de table Dataverse

Utilisez les méthodes de table Dataverse de l’objet dataApi pour créer, récupérer, mettre à jour et supprimer des lignes de table Dataverse et interroger des colonnes de choix.

Méthode	Descriptif
createRow	Crée une ligne dans la table spécifiée.
deleteRow	Supprime une ligne de la table spécifiée.
getChoices	Récupère les choix du nom de colonne de choix spécifié.
queryTable	Interroge une table avec les options spécifiées.
retrieveRow	Récupère une ligne à partir de la table spécifiée avec les options spécifiées.
updateRow	Met à jour une ligne existante dans la table spécifiée.

Méthodes de connecteur

Utilisez les méthodes de connecteur de l’objet dataApi pour utiliser les données exposées par un connecteur Power Platform lié à la page.

Méthode	Descriptif
createConnectorRow	Crée une ligne dans la table de connecteurs spécifiée.
deleteConnectorRow	Supprime une ligne de la table de connecteur spécifiée.
executeConnectorOperation	Appelle une opération nommée exposée par un connecteur REST (clé d’opération), telle que Utilisateurs d’Office 365.
getConnectorSwagger	Récupère la définition Swagger (OpenAPI) du connecteur.
getConnectorTableSchema	Récupère le schéma d’une table (également appelée entité ou liste) exposée par le connecteur.
listConnectorDatasets	Répertorie les jeux de données disponibles pour le connecteur.
listConnectorOperations	Répertorie les opérations exposées par un connecteur REST (clé d’opération).
listConnectorTables	Répertorie les tables disponibles dans le jeu de données du connecteur spécifié.
queryConnectorTable	Interroge une table exposée par le connecteur avec les options spécifiées.
retrieveConnectorRow	Récupère une seule ligne à partir de la table de connecteur spécifiée.
updateConnectorRow	Met à jour une ligne existante dans la table de connecteur spécifiée.

Méthodes d’action et de fonction Dataverse

Utilisez les méthodes d’action et de fonction de l’objet dataApi pour appeler des API personnalisées Dataverse liées à la page.

Méthode	Descriptif
executeAction	Appelle une API personnalisée Dataverse liée à la page en tant qu’action.
executeFunction	Appelle une API personnalisée Dataverse liée à la page en tant que fonction.
listBoundActions	Répertorie les API personnalisées Dataverse (actions et fonctions) liées à la page.

Méthodes de page

Utilisez les méthodes de page de l’objet dataApi pour contrôler la page générative elle-même, telles que le renvoi d’une valeur lorsque la page est utilisée comme boîte de dialogue.

Méthode	Descriptif
setPageOutput	Définit la valeur retournée au script appelant lorsqu’une boîte de dialogue de page dégénérative se ferme.