dataApi-reference til generative sider

Når du genererer en side ved hjælp af et naturligt sprog, opretter AI'en en React-side i TypeScript. Den genererede side dækker både frontendbrugeroplevelsen ved at vælge de rigtige komponenter og bestemme det bedste layout og den tilsvarende forretningslogik.

Du kan få vist og redigere den genererede kode for at afgrænse outputtet. Datahandlinger bruger et dataApi objekt, der viser offentlige metoder, der er grupperet i disse kategorier:

Kategori	Beskrivelse
Metoder til dataverse-tabel	Opret, hent, opdater og slet Dataverse-tabelrækker og kolonner til valg af forespørgsler.
Connectormetoder	Arbejd med data, der vises af en Power Platform-connector, der er bundet til siden.
Metoder til dataversehandlinger	Aktivér brugerdefinerede API'er for Dataverse, der er bundet til siden, som handlinger eller funktioner.
Sidemetoder	Kontrollér selve den generative side, f.eks. returnering af en værdi, når siden bruges som en dialogboks.

Connectormetoder og handlings- og funktionsmetoder er valgfrie medlemmer af dataApi kontrakten. Nogle værter implementerer dem ikke, så kontrollér altid, at der findes en metode (f.eks. if (dataApi.executeAction) { ... }), før du kalder den. En metode, der findes, betyder ikke, at siden har en connector eller dataverse-brugerdefineret API, der er bundet til den, eller at den brugerdefinerede API er aktiveret eller tilladt for den aktuelle bruger. Håndter ikke-tilgængelig funktionalitet og brugerdefinerede API-fejl eksplicit i stedet for at antage, at det lykkedes.

Metoder til dataverse-tabel

Brug dataversetabelmetoderne dataApi for objektet til at oprette, hente, opdatere og slette Dataverse-tabelrækker og kolonner med forespørgselsvalg.

Metode	Beskrivelse
createRow	Opretter en ny række i den angivne tabel.
deleteRow	Sletter en række fra den angivne tabel.
getChoices	Henter valgmulighederne for det angivne valgkolonnenavn.
queryTable	Forespørger en tabel med de angivne indstillinger.
retrieveRow	Henter en række fra den angivne tabel med de angivne indstillinger.
updateRow	Opdaterer en eksisterende række i den angivne tabel.

Connectormetoder

Brug objektets dataApi connectormetoder til at arbejde med data, der vises af en Power Platform-connector, der er bundet til siden.

Metode	Beskrivelse
createConnectorRow	Opretter en ny række i den angivne forbindelsestabel.
deleteConnectorRow	Sletter en række fra den angivne forbindelsestabel.
executeConnectorOperation	Aktiverer en navngiven handling, der vises af en REST-connector (handlingsnøgle), f.eks. Office 365-brugere.
getConnectorSwagger	Henter Definitionen af Swagger (OpenAPI) for connectoren.
getConnectorTableSchema	Henter skemaet for en tabel (også kaldet en enhed eller liste), der vises af connectoren.
listConnectorDatasets	Viser de datasæt, der er tilgængelige for connectoren.
listConnectorOperations	Viser de handlinger, der vises af en REST-connector (handlingsnøgle).
listConnectorTables	Viser de tabeller, der er tilgængelige i det angivne connectordatasæt.
queryConnectorTable	Forespørger en tabel, der vises af connectoren, med de angivne indstillinger.
retrieveConnectorRow	Henter en enkelt række fra den angivne forbindelsestabel.
updateConnectorRow	Opdaterer en eksisterende række i den angivne forbindelsestabel.

Metoder til dataversehandling og -funktion

Brug objektets handlings- og funktionsmetoder dataApi til at aktivere brugerdefinerede API'er for Dataverse, der er bundet til siden.

Metode	Beskrivelse
executeAction	Aktiverer en brugerdefineret API til Dataverse, der er bundet til siden, som en handling.
executeFunction	Aktiverer en brugerdefineret DATAVERSE-API, der er bundet til siden, som en funktion.
listBoundActions	Viser de brugerdefinerede API'er (handlinger og funktioner) for Dataverse, der er bundet til siden.

Sidemetoder

Brug objektets dataApi sidemetoder til at styre selve den generative side, f.eks. returnere en værdi, når siden bruges som en dialogboks.

Metode	Beskrivelse
setPageOutput	Angiver den værdi, der returneres til kaldescriptet, når en generativ sidedialogboks lukkes.