dataApi-verwijzing voor generatieve pagina's

Wanneer u een pagina genereert met natuurlijke taal, maakt de AI een React-pagina in TypeScript. Op de gegenereerde pagina wordt zowel de front-endgebruikerservaring behandeld door de juiste onderdelen te selecteren en de beste indeling en de bijbehorende bedrijfslogica te bepalen.

U kunt de gegenereerde code weergeven en bewerken om de uitvoer te verfijnen. Gegevensbewerkingen maken gebruik van een dataApi object dat openbare methoden beschikbaar maakt die zijn gegroepeerd in deze categorieën:

Categorie	Description
Dataverse-tabelmethoden	Dataverse-tabelrijen en querykeuzekolommen maken, ophalen, bijwerken en verwijderen.
Connectormethoden	Werk met gegevens die worden weergegeven door een Power Platform-connector die is gebonden aan de pagina.
Dataverse-bewerkingsmethoden	Roep aangepaste API's van Dataverse aan die zijn gebonden aan de pagina als acties of functies.
Paginamethoden	Beheer de generatieve pagina zelf, zoals het retourneren van een waarde wanneer de pagina wordt gebruikt als een dialoogvenster.

Connectormethoden en actie- en functiemethoden zijn optionele leden van het dataApi contract. Sommige hosts implementeren ze niet, dus controleer altijd of er een methode bestaat (bijvoorbeeld if (dataApi.executeAction) { ... }) voordat u deze aanroept. Een methode die aanwezig is, betekent niet dat op de pagina een connector of aangepaste Dataverse-API is gekoppeld, of dat de aangepaste API is ingeschakeld of toegestaan voor de huidige gebruiker. Afhandelen van niet-beschikbare functionaliteit en aangepaste API-fouten expliciet in plaats van ervan uit te gaan dat het lukt.

Dataverse-tabelmethoden

Gebruik de Dataverse-tabelmethoden van het dataApi object om dataverse-tabelrijen te maken, op te halen, bij te werken en te verwijderen en kolommen met querykeuzes te maken.

Methode	Description
createRow	Hiermee maakt u een nieuwe rij in de opgegeven tabel.
deleteRow	Hiermee verwijdert u een rij uit de opgegeven tabel.
getChoices	Hiermee worden de opties opgehaald voor de opgegeven naam van de keuzekolom.
queryTable	Query's uitvoeren op een tabel met de opgegeven opties.
retrieveRow	Haalt een rij op uit de opgegeven tabel met de opgegeven opties.
updateRow	Hiermee wordt een bestaande rij in de opgegeven tabel bijgewerkt.

Connectormethoden

Gebruik de connectormethoden van het dataApi object om te werken met gegevens die worden weergegeven door een Power Platform-connector die is gebonden aan de pagina.

Methode	Description
createConnectorRow	Hiermee maakt u een nieuwe rij in de opgegeven connectortabel.
deleteConnectorRow	Hiermee verwijdert u een rij uit de opgegeven connectortabel.
executeConnectorOperation	Roept een benoemde bewerking aan die wordt weergegeven door een REST-connector (bewerkingssleutel) zoals Office 365-gebruikers.
getConnectorSwagger	Haalt de Swagger-definitie (OpenAPI) voor de connector op.
getConnectorTableSchema	Hiermee haalt u het schema voor een tabel (ook wel een entiteit of lijst genoemd) op die door de connector wordt weergegeven.
listConnectorDatasets	Geeft een lijst weer van de gegevenssets die beschikbaar zijn voor de connector.
listConnectorOperations	Geeft een lijst weer van de bewerkingen die worden weergegeven door een REST-connector (bewerkingssleutel).
listConnectorTables	Geeft een lijst weer van de tabellen die beschikbaar zijn in de opgegeven connectorgegevensset.
queryConnectorTable	Query's uitvoeren op een tabel die door de connector wordt weergegeven met de opgegeven opties.
retrieveConnectorRow	Haalt één rij op uit de opgegeven connectortabel.
updateConnectorRow	Hiermee wordt een bestaande rij in de opgegeven connectortabel bijgewerkt.

Dataverse-actie- en functiemethoden

Gebruik de actie- en functiemethoden van het dataApi object om aangepaste API's van Dataverse aan te roepen die zijn gebonden aan de pagina.

Methode	Description
executeAction	Roept een aangepaste Dataverse-API aan die is gebonden aan de pagina als een actie.
executeFunction	Roept een aangepaste Dataverse-API aan die is gebonden aan de pagina als een functie.
listBoundActions	Geeft een lijst weer van de aangepaste API's (acties en functies) die zijn gebonden aan de pagina.

Paginamethoden

Gebruik de paginamethoden van het dataApi object om de generatieve pagina zelf te beheren, zoals het retourneren van een waarde wanneer de pagina wordt gebruikt als dialoogvenster.

Methode	Description
setPageOutput	Hiermee stelt u de waarde in die wordt geretourneerd aan het aanroepende script wanneer een dialoogvenster voor een generatieve pagina wordt gesloten.