Odkaz na dataApi pre generatívne stránky

Keď vygenerujete stránku pomocou prirodzeného jazyka, umelá inteligencia vytvorí stránku React v jazyku TypeScript. Vygenerovaná stránka zahŕňa klientske používateľské prostredie tým, že vyberie správne súčasti, určí najlepšie rozloženie a zodpovedajúcu obchodnú logiku.

Vygenerovaný kód môžete zobraziť a upraviť a spresniť výstup. Operácie s údajmi používajú dataApi objekt, ktorý sprístupňuje verejné metódy zoskupené do týchto kategórií:

Kategória Popis
Metódy tabuľky Dataverse Vytvárajte, načítajte, aktualizujte a odstraňujte riadky tabuľky Dataverse a stĺpce výberu dotazu.
Metódy konektora Práca s údajmi zverejnenými konektorom Power Platformy naviazaným na stránku.
Metódy operácií dataverse Vyvolať vlastné rozhrania API služby Dataverse viazané na stránku ako akcie alebo funkcie.
Metódy strany Ovládajte samotnú generatatívnu stránku, ako je napríklad vrátenie hodnoty, keď sa strana použije ako dialógové okno.

Metódy konektora, metódy akcie a funkcie sú voliteľnými členmi dataApi zmluvy. Niektorí hostitelia ich implementujú, takže pred volaním vždy skontrolujte, if (dataApi.executeAction) { ... }či existuje metóda (napríklad ). Metóda, ktorá je prítomná, neznamená, že stránka má konektor alebo vlastné rozhranie API služby Dataverse, ktoré je k nemu viazané, alebo že vlastné rozhranie API je povolené alebo povolené pre aktuálneho používateľa. Spracujte explicitne nedostupné funkcie a vlastné zlyhania rozhrania API namiesto za predpokladu úspechu.

Metódy tabuľky Dataverse

Pomocou metód dataApi tabuľky Dataverse objektu môžete vytvoriť, načítať, aktualizovať a odstrániť riadky tabuľky Dataverse a stĺpce výberu dotazu.

Metóda Popis
createRow Vytvorí nový riadok v zadanej tabuľke.
deleteRow Odstráni riadok zo zadanej tabuľky.
getChoices Načíta možnosti pre zadaný názov stĺpca výberu.
queryTable Dotazuje tabuľku so zadanými možnosťami.
retrieveRow Načíta riadok zo zadanej tabuľky so zadanými možnosťami.
updateRow Aktualizuje existujúci riadok v zadanej tabuľke.

Metódy konektora

Pomocou metód konektora dataApi objektu môžete pracovať s údajmi zverejnenými konektorom Power Platformy naviazaným na stranu.

Metóda Popis
createConnectorRow Vytvorí nový riadok v zadanej tabuľke konektora.
deleteConnectorRow Odstráni riadok zo zadanej tabuľky konektora.
executeConnectorOperation Vyvolá pomenovanú operáciu vystavenú konektorom REST (s kľúčom operácie), napríklad Používatelia pre Office 365.
getConnectorSwagger Načíta definíciu súboru Swagger (OpenAPI) pre konektor.
getConnectorTableSchema Načíta schému tabuľky (nazývanej aj entita alebo zoznam) zobrazenú konektorom.
listConnectorDatasets Uvádza zoznam množín údajov dostupných pre konektor.
listConnectorOperations Zobrazí zoznam operácií exponovaných konektorom REST (s kľúčom operácie).
listConnectorTables Uvádza zoznam tabuliek dostupných v zadanej množine údajov konektora.
queryConnectorTable Dotazuje tabuľku zobrazenú konektorom so zadanými možnosťami.
retrieveConnectorRow Načíta jeden riadok zo zadanej tabuľky konektora.
updateConnectorRow Aktualizuje existujúci riadok v zadanej tabuľke konektora.

Metódy akcie a funkcie Dataverse

Pomocou metód dataApi akcie a funkcie objektu vyvolajte vlastné rozhrania API Dataverse viazané na stranu.

Metóda Popis
executeAction Vyvolá vlastné rozhranie API služby Dataverse viazané na stránku ako akciu.
executeFunction Vyvolá vlastné rozhranie API služby Dataverse viazané na stránku ako funkciu.
listBoundActions Zoznam vlastných rozhraní API dataverse (akcií a funkcií) naviazaných na stranu.

Metódy strany

Pomocou metód dataApi strany objektu môžete ovládať samotnú generatatívnu stránku, napríklad vrátenie hodnoty, keď sa strana používa ako dialógové okno.

Metóda Popis
setPageOutput Nastaví hodnotu vrátenú do skriptu volania po zatvorení dialógového okna generativnej stránky.