dataApi-referens för generativa sidor

När du genererar en sida med naturligt språk skapar AI:n en React-sida i TypeScript. Den genererade sidan täcker både klientdelsanvändarupplevelsen genom att välja rätt komponenter och bestämma den bästa layouten och motsvarande affärslogik.

Du kan visa och redigera den genererade koden för att förfina utdata. Dataåtgärder använder ett dataApi objekt som exponerar offentliga metoder grupperade i följande kategorier:

Category	Description
Dataverse-tabellmetoder	Skapa, hämta, uppdatera och ta bort Dataverse-tabellrader och frågevalskolumner.
Anslutningsmetoder	Arbeta med data som exponeras av en Power Platform-anslutningsapp som är bunden till sidan.
Dataverse-åtgärdsmetoder	Anropa anpassade API:er för Dataverse som är bundna till sidan som åtgärder eller funktioner.
Sidmetoder	Kontrollera själva generativa sidan, till exempel returnera ett värde när sidan används som en dialogruta.

Anslutningsmetoder och åtgärds- och funktionsmetoder är valfria medlemmar i dataApi kontraktet. Vissa värdar implementerar dem inte, så kontrollera alltid att det finns en metod (till exempel if (dataApi.executeAction) { ... }) innan du anropar den. En metod som finns betyder inte att sidan har en anslutningsapp eller ett anpassat API för Dataverse som är bundet till den, eller att det anpassade API:et är aktiverat eller tillåtet för den aktuella användaren. Hantera otillgängliga funktioner och anpassade API-fel explicit i stället för att anta att det lyckas.

Dataverse-tabellmetoder

Använd dataverse-tabellmetoderna för dataApi objektet för att skapa, hämta, uppdatera och ta bort Dataverse-tabellrader och frågevalskolumner.

Metod	Description
createRow	Skapar en ny rad i den angivna tabellen.
deleteRow	Tar bort en rad från den angivna tabellen.
getChoices	Hämtar alternativen för det angivna valkolumnnamnet.
queryTable	Frågar en tabell med de angivna alternativen.
retrieveRow	Hämtar en rad från den angivna tabellen med de angivna alternativen.
updateRow	Uppdaterar en befintlig rad i den angivna tabellen.

Anslutningsmetoder

Använd anslutningsmetoderna för dataApi objektet för att arbeta med data som exponeras av en Power Platform-anslutningsapp som är bunden till sidan.

Metod	Description
createConnectorRow	Skapar en ny rad i den angivna anslutningstabellen.
deleteConnectorRow	Tar bort en rad från den angivna anslutningstabellen.
executeConnectorOperation	Anropar en namngiven åtgärd som exponeras av en REST-anslutningsapp (åtgärdsnyckel), till exempel Office 365-användare.
getConnectorSwagger	Hämtar Swagger-definitionen (OpenAPI) för anslutningsappen.
getConnectorTableSchema	Hämtar schemat för en tabell (kallas även en entitet eller lista) som exponeras av anslutningsappen.
listConnectorDatasets	Visar en lista över tillgängliga datauppsättningar för anslutningsappen.
listConnectorOperations	Visar en lista över de åtgärder som exponeras av en REST-anslutning (åtgärdsnyckel).
listConnectorTables	Visar en lista över tillgängliga tabeller i den angivna anslutningsdatauppsättningen.
queryConnectorTable	Frågar en tabell som exponeras av anslutningsappen med de angivna alternativen.
retrieveConnectorRow	Hämtar en enskild rad från den angivna anslutningstabellen.
updateConnectorRow	Uppdaterar en befintlig rad i den angivna anslutningstabellen.

Dataverse-åtgärder och funktionsmetoder

Använd åtgärden och funktionsmetoderna för dataApi objektet för att anropa anpassade API:er för Dataverse som är bundna till sidan.

Metod	Description
executeAction	Anropar ett anpassat API för Dataverse som är bundet till sidan som en åtgärd.
executeFunction	Anropar ett anpassat API för Dataverse som är bundet till sidan som en funktion.
listBoundActions	Visar en lista över anpassade API:er för Dataverse (åtgärder och funktioner) som är bundna till sidan.

Sidmetoder

Använd sidmetoderna för dataApi objektet för att styra själva generativa sidan, till exempel att returnera ett värde när sidan används som en dialogruta.

Metod	Description
setPageOutput	Anger värdet som returneras till det anropande skriptet när en generativ siddialogruta stängs.