dataApi-referencia generatív oldalakhoz

Amikor természetes nyelv használatával hoz létre lapot, az AI létrehoz egy React-lapot a TypeScriptben. A létrehozott oldal a megfelelő összetevők kiválasztásával és a legjobb elrendezés és a megfelelő üzleti logika meghatározásával lefedi az előtérbeli felhasználói élményt.

A kimenet finomításához megtekintheti és szerkesztheti a létrehozott kódot. Az adatműveletek olyan objektumot dataApi használnak, amely az alábbi kategóriákba csoportosított nyilvános metódusokat teszi elérhetővé:

Category Description
Dataverse table metódusok Dataverse-táblasorok és lekérdezésválasztó oszlopok létrehozása, lekérése, frissítése és törlése.
Összekötő metódusai Az oldalhoz kötött Power Platform-összekötő által közzétett adatok használata.
Dataverse műveleti metódusok Egyéni Dataverse API-k meghívása a laphoz műveletként vagy függvényként.
Oldal metódusai A generatív lap szabályozása, például érték visszaadása a lap párbeszédpanelként való használatakor.

Az összekötő metódusok, valamint a művelet- és függvénymetelyek a dataApi szerződés opcionális tagjai. Egyes gazdagépek nem implementálják őket, ezért a meghívás előtt mindig ellenőrizze, if (dataApi.executeAction) { ... }hogy létezik-e metódus (például). A jelen lévő metódusok nem jelentik azt, hogy a laphoz összekötő vagy Dataverse egyéni API van kötve, vagy hogy az egyéni API engedélyezve van vagy engedélyezve van az aktuális felhasználó számára. A nem elérhető funkciók és az egyéni API-hibák kezelése kifejezetten ahelyett, hogy sikert feltételez.

Dataverse table metódusok

Az objektum Dataverse táblametódusainak dataApi használatával dataverse táblasorokat és lekérdezésválasztó oszlopokat hozhat létre, kérdezhet le, frissíthet és törölhet.

Metódus Description
createRow Új sort hoz létre a megadott táblában.
deleteRow Töröl egy sort a megadott táblából.
getChoices Lekéri a megadott választási lehetőségek oszlopának nevét.
queryTable Lekérdez egy táblát a megadott beállításokkal.
retrieveRow Beolvas egy sort a megadott táblából a megadott beállításokkal.
updateRow Frissíti a megadott tábla egy meglévő sorát.

Összekötő metódusai

Az objektum összekötőmetódusaival dataApi az oldalhoz kötött Power Platform-összekötő által közzétett adatokkal dolgozhat.

Metódus Description
createConnectorRow Új sort hoz létre a megadott összekötőtáblában.
deleteConnectorRow Töröl egy sort a megadott összekötőtáblából.
executeConnectorOperation Meghív egy rest (műveletkulcsú) összekötő által közzétett elnevezett műveletet, például Office 365 Felhasználók.
getConnectorSwagger Lekéri az összekötő Swagger (OpenAPI) definícióját.
getConnectorTableSchema Lekéri az összekötő által közzétett tábla (más néven entitás vagy lista) sémáját.
listConnectorDatasets Az összekötőhöz elérhető adatkészletek listája.
listConnectorOperations A REST (műveletkulcsos) összekötő által közzétett műveleteket sorolja fel.
listConnectorTables A megadott összekötő-adatkészletben elérhető táblákat sorolja fel.
queryConnectorTable Lekérdezi az összekötő által közzétett táblát a megadott beállításokkal.
retrieveConnectorRow Egyetlen sort kér le a megadott összekötőtáblából.
updateConnectorRow Frissíti a megadott összekötőtábla egy meglévő sorát.

Dataverse action and function methods

Az objektum művelet- és függvénymetódusaival meghívhatja a dataApi laphoz kötött Dataverse egyéni API-kat .

Metódus Description
executeAction Műveletként meghívja a laphoz kötött Egyéni Dataverse API-t.
executeFunction Függvényként meghívja a laphoz kötött egyéni Dataverse API-t.
listBoundActions A laphoz kötött Dataverse egyéni API-k (műveletek és függvények) listája.

Oldal metódusai

Az objektum lapmetódusainak dataApi használatával szabályozhatja magát a generatív lapot, például egy értéket ad vissza, amikor a lap párbeszédpanelként van használatban.

Metódus Description
setPageOutput Beállítja a hívó szkriptnek visszaadott értéket egy generatív lap párbeszédpaneljének bezárásakor.