dataApi-Referenz für generative Seiten

Wenn Sie eine Seite mit natürlicher Sprache generieren, erstellt die KI eine React-Seite in TypeScript. Die generierte Seite deckt sowohl die Front-End-Benutzeroberfläche ab, indem sie die richtigen Komponenten auswählen und das beste Layout und die entsprechende Geschäftslogik bestimmen.

Sie können den generierten Code anzeigen und bearbeiten, um die Ausgabe zu verfeinern. Datenvorgänge verwenden ein dataApi Objekt, das öffentliche Methoden verfügbar macht, die in diese Kategorien unterteilt sind:

Kategorie	Description
Dataverse-Tabellenmethoden	Erstellen, Abrufen, Aktualisieren und Löschen von Dataverse-Tabellenzeilen und Abfrageauswahlspalten.
Connector-Methoden	Arbeiten Mit Daten, die von einem Power Platform-Connector verfügbar gemacht werden, der an die Seite gebunden ist.
Dataverse-Vorgangsmethoden	Aufrufen von benutzerdefinierten Dataverse-APIs, die als Aktionen oder Funktionen an die Seite gebunden sind.
Page-Methoden	Steuern Sie die generative Seite selbst, z. B. das Zurückgeben eines Werts, wenn die Seite als Dialogfeld verwendet wird.

Verbindermethoden und Aktions- und Funktionsmethoden sind optionale Member des dataApi Vertrags. Einige Hosts implementieren sie nicht. Überprüfen Sie daher immer, if (dataApi.executeAction) { ... }ob eine Methode vorhanden ist (z. B. ), bevor Sie sie aufrufen. Eine vorhandene Methode bedeutet nicht, dass die Seite über einen Connector oder eine benutzerdefinierte Dataverse-API verfügt oder die benutzerdefinierte API für den aktuellen Benutzer aktiviert oder zulässig ist. Behandeln Sie nicht verfügbare Funktionen und benutzerdefinierte API-Fehler explizit, anstatt erfolglos anzunehmen.

Dataverse-Tabellenmethoden

Verwenden Sie die Dataverse-Tabellenmethoden des dataApi Objekts, um Dataverse-Tabellenzeilen und Abfrageauswahlspalten zu erstellen, abzurufen, zu aktualisieren und zu löschen.

Methode	Description
createRow	Erstellt eine neue Zeile in der angegebenen Tabelle.
deleteRow	Löscht eine Zeile aus der angegebenen Tabelle.
getChoices	Ruft die Auswahlmöglichkeiten für den angegebenen Auswahlspaltennamen ab.
queryTable	Fragt eine Tabelle mit den angegebenen Optionen ab.
retrieveRow	Ruft eine Zeile aus der angegebenen Tabelle mit den angegebenen Optionen ab.
updateRow	Aktualisiert eine vorhandene Zeile in der angegebenen Tabelle.

Connector-Methoden

Verwenden Sie die Connectormethoden des dataApi Objekts, um mit Daten zu arbeiten, die von einem An die Seite gebundenen Power Platform-Connector verfügbar gemacht werden.

Methode	Description
createConnectorRow	Erstellt eine neue Zeile in der angegebenen Verbindertabelle.
deleteConnectorRow	Löscht eine Zeile aus der angegebenen Verbindertabelle.
executeConnectorOperation	Ruft einen benannten Vorgang auf, der von einem REST-Connector (Operation-Keyed) verfügbar gemacht wird, z. B. Office 365-Benutzer.
getConnectorSwagger	Ruft die Swagger-Definition (OpenAPI) für den Connector ab.
getConnectorTableSchema	Ruft das Schema für eine Tabelle (auch als Entität oder Liste bezeichnet) ab, die vom Connector verfügbar gemacht wird.
listConnectorDatasets	Listet die datasets auf, die für den Connector verfügbar sind.
listConnectorOperations	Listet die Vorgänge auf, die von einem REST-Connector (operation-keyed) verfügbar gemacht werden.
listConnectorTables	Listet die Tabellen auf, die im angegebenen Connector-Dataset verfügbar sind.
queryConnectorTable	Fragt eine Tabelle ab, die vom Connector mit den angegebenen Optionen verfügbar gemacht wird.
retrieveConnectorRow	Ruft eine einzelne Zeile aus der angegebenen Verbindertabelle ab.
updateConnectorRow	Aktualisiert eine vorhandene Zeile in der angegebenen Verbindertabelle.

Dataverse-Aktions- und Funktionsmethoden

Verwenden Sie die Aktions- und Funktionsmethoden des dataApi Objekts, um benutzerdefinierte Dataverse-APIs aufzurufen, die an die Seite gebunden sind.

Methode	Description
executeAction	Ruft eine benutzerdefinierte Dataverse-API auf, die als Aktion an die Seite gebunden ist.
executeFunction	Ruft eine benutzerdefinierte Dataverse-API auf, die als Funktion an die Seite gebunden ist.
listBoundActions	Listet die an die Seite gebundenen benutzerdefinierten Dataverse-APIs (Aktionen und Funktionen) auf.

Page-Methoden

Verwenden Sie die Seitenmethoden des dataApi Objekts, um die generative Seite selbst zu steuern, z. B. das Zurückgeben eines Werts, wenn die Seite als Dialogfeld verwendet wird.

Methode	Description
setPageOutput	Legt den Wert fest, der an das aufrufende Skript zurückgegeben wird, wenn ein generatives Seitendialogfeld geschlossen wird.