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.
  • Dernière mise à jour :