dataApi-referanse for generative sider

Når du genererer en side ved hjelp av naturlig språk, oppretter AI en React-side i TypeScript. Den genererte siden dekker både frontbrukeropplevelsen ved å velge de riktige komponentene og bestemme det beste oppsettet og den tilsvarende forretningslogikken.

Du kan vise og redigere den genererte koden for å begrense utdataene. Dataoperasjoner bruker et dataApi objekt som viser offentlige metoder gruppert i disse kategoriene:

Kategori Description
Dataverse tabellmetoder Opprett, hent, oppdater og slett dataverse tabellrader og spørringsvalgkolonner.
Koblingsmetoder Arbeid med data som vises av en Power Platform-kobling som er bundet til siden.
Dataverse operasjonsmetoder Aktiver egendefinerte API-er for dataverse som er bundet til siden som handlinger eller funksjoner.
Sidemetoder Kontroller selve genereringssiden, for eksempel å returnere en verdi når siden brukes som en dialogboks.

Koblingsmetoder og handlings- og funksjonsmetoder er valgfrie medlemmer av dataApi kontrakten. Enkelte verter implementerer dem ikke, så kontroller alltid at det finnes en metode (for eksempel if (dataApi.executeAction) { ... }) før du kaller den. En metode som finnes betyr ikke at siden har en kobling eller datavers egendefinert API bundet til den, eller at den egendefinerte API-en er aktivert eller tillatt for gjeldende bruker. Håndter utilgjengelig funksjonalitet og egendefinerte API-feil eksplisitt i stedet for å anta suksess.

Dataverse tabellmetoder

Bruk dataverse tabellmetoder dataApi for objektet til å opprette, hente, oppdatere og slette dataverse tabellrader og spørringsvalgkolonner.

Metode Description
createRow Oppretter en ny rad i den angitte tabellen.
deleteRow Sletter en rad fra den angitte tabellen.
getChoices Henter valgene for det angitte navnet på valgkolonnen.
queryTable Spør en tabell med de angitte alternativene.
retrieveRow Henter en rad fra den angitte tabellen med de angitte alternativene.
updateRow Oppdaterer en eksisterende rad i den angitte tabellen.

Koblingsmetoder

Bruk koblingsmetodene dataApi for objektet til å arbeide med data som vises av en Power Platform-kobling som er bundet til siden.

Metode Description
createConnectorRow Oppretter en ny rad i den angitte koblingstabellen.
deleteConnectorRow Sletter en rad fra den angitte koblingstabellen.
executeConnectorOperation Aktiverer en navngitt operasjon som vises av en REST-kobling (operasjonstavet), for eksempel Office 365-brukere.
getConnectorSwagger Henter Swagger-definisjonen (OpenAPI) for koblingen.
getConnectorTableSchema Henter skjemaet for en tabell (også kalt en enhet eller liste) som vises av koblingen.
listConnectorDatasets Viser datasettene som er tilgjengelige for koblingen.
listConnectorOperations Viser operasjonene som vises av en REST-kobling (operasjonstavet).
listConnectorTables Viser tabellene som er tilgjengelige i det angitte koblingsdatasettet.
queryConnectorTable Spør en tabell som vises av koblingen med de angitte alternativene.
retrieveConnectorRow Henter én rad fra den angitte koblingstabellen.
updateConnectorRow Oppdaterer en eksisterende rad i den angitte koblingstabellen.

Dataverse handlings- og funksjonsmetoder

Bruk handlingen og funksjonsmetodene dataApi for objektet til å aktivere dataverse egendefinerte API-er som er bundet til siden.

Metode Description
executeAction Aktiverer en egendefinert datavers-API som er bundet til siden som en handling.
executeFunction Aktiverer en datavers egendefinert API som er bundet til siden som en funksjon.
listBoundActions Viser egendefinerte API-er for datavers (handlinger og funksjoner) som er bundet til siden.

Sidemetoder

Bruk sidemetodene dataApi for objektet til å kontrollere selve den generative siden, for eksempel å returnere en verdi når siden brukes som en dialogboks.

Metode Description
setPageOutput Angir verdien som returneres til kallskriptet når en dialogboks for generativ side lukkes.
  • Sist oppdatert