Referència dataApi per a pàgines generatives

Quan generes una pàgina utilitzant llenguatge natural, la IA crea una pàgina de React a TypeScript. La pàgina generada cobreix tant l'experiència d'usuari frontal seleccionant els components adequats i determinant la millor disposició, com la lògica de negoci corresponent.

Pots veure i editar el codi generat per refinar la sortida. Les operacions de dades utilitzen un dataApi objecte que exposa mètodes públics agrupats en aquestes categories:

Categoria	Descripció
Mètodes de taules Dataverse	Crea, recupera, actualitza i elimina files de taules de Dataverse i columnes d'elecció de consultes.
Mètodes de connectors	Treballa amb dades exposades per un connector de Power Platform vinculat a la pàgina.
Mètodes d'operació Dataverse	Invoca APIs personalitzades de Dataverse vinculades a la pàgina com a accions o funcions.
Mètodes de pàgina	Controla la pàgina generativa en si, com ara retornar un valor quan la pàgina s'utilitza com a diàleg.

Els mètodes connectors i els mètodes d'acció i funció són membres opcionals del dataApi contracte. Alguns hosts no els implementen, així que sempre comprova que existeix un mètode (per exemple, if (dataApi.executeAction) { ... }) abans de cridar-lo. Que un mètode estigui present no vol dir que la pàgina tingui un connector o una API personalitzada de Dataverse vinculada, ni que l'API personalitzada estigui habilitada o permesa per a l'usuari actual. Gestiona explícitament funcionalitats no disponibles i fallades d'API personalitzades en lloc de suposar èxit.

Mètodes de taules Dataverse

Utilitza els mètodes de taules Dataverse de l'objecte dataApi per crear, recuperar, actualitzar i eliminar files de taules Dataverse i columnes de consultes d'elecció.

Mètode	Descripció
createRow	Crea una nova fila a la taula especificada.
deleteRow	Elimina una fila de la taula especificada.
getChoices	Recupera les opcions per al nom de la columna d'elecció especificada.
queryTable	Consulta una taula amb les opcions especificades.
retrieveRow	Recupera una fila de la taula especificada amb les opcions especificades.
updateRow	Actualitza una fila existent a la taula especificada.

Mètodes de connectors

Utilitza els mètodes de connector de l'objecte dataApi per treballar amb dades exposades per un connector de Power Platform vinculat a la pàgina.

Mètode	Descripció
createConnectorRow	Crea una nova fila a la taula de connectors especificada.
deleteConnectorRow	Elimina una fila de la taula de connectors especificada.
executeConnectorOperation	Invoca una operació amb nom exposada per un connector REST (clau d'operació), com ara Office 365 Users.
getConnectorSwagger	Recupera la definició de Swagger (OpenAPI) per al connector.
getConnectorTableSchema	Recupera l'esquema d'una taula (també anomenada entitat o llista) exposada pel connector.
listConnectorDatasets	Llista els conjunts de dades disponibles per al connector.
listConnectorOperations	Llista les operacions exposades per un connector REST (clau d'operació).
listConnectorTables	Llista les taules disponibles en el conjunt de dades de connectors especificat.
queryConnectorTable	Consulta una taula exposada pel connector amb les opcions especificades.
retrieveConnectorRow	Recupera una sola fila de la taula de connectors especificada.
updateConnectorRow	Actualitza una fila existent a la taula de connectors especificada.

Mètodes d'acció i funció Dataverse

Utilitza els mètodes d'acció i funció de l'objecte dataApi per invocar APIs personalitzades de Dataverse vinculades a la pàgina.

Mètode	Descripció
executeAction	Invoca una API personalitzada de Dataverse vinculada a la pàgina com a acció.
executeFunction	Invoca una API personalitzada de Dataverse vinculada a la pàgina com a funció.
listBoundActions	Llista les APIs personalitzades de Dataverse (accions i funcions) vinculades a la pàgina.

Mètodes de pàgina

Utilitza els mètodes de pàgina de l'objecte dataApi per controlar la pàgina generativa en si, com ara retornar un valor quan la pàgina s'utilitza com a diàleg.

Mètode	Descripció
setPageOutput	Estableix el valor retornat a l'script que crida quan es tanca un diàleg de pàgina generativa.