referencia de dataApi para páginas generativas

Al generar una página mediante lenguaje natural, la inteligencia artificial crea una página react en TypeScript. La página generada cubre la experiencia del usuario front-end seleccionando los componentes adecuados y determinando el mejor diseño y la lógica de negocios correspondiente.

Puede ver y editar el código generado para refinar la salida. Las operaciones de datos usan un dataApi objeto que expone métodos públicos agrupados en estas categorías:

Category Description
Métodos de tabla de Dataverse Cree, recupere, actualice y elimine las filas de tabla de Dataverse y las columnas de elección de consulta.
Métodos del conector Trabajar con datos expuestos por un conector de Power Platform enlazado a la página.
Métodos de operación de Dataverse Invoque las API personalizadas de Dataverse enlazadas a la página como acciones o funciones.
Métodos page Controlar la propia página generativa, como devolver un valor cuando la página se usa como un cuadro de diálogo.

Los métodos de conector y los métodos de acción y función son miembros opcionales del dataApi contrato. Algunos hosts no los implementan, así que compruebe siempre que existe un método (por ejemplo, if (dataApi.executeAction) { ... }) antes de llamarlo. Un método que está presente no significa que la página tenga un conector o una API personalizada de Dataverse enlazada a ella, o que la API personalizada esté habilitada o permitida para el usuario actual. Controle la funcionalidad no disponible y los errores de API personalizados explícitamente en lugar de asumir el éxito.

Métodos de tabla de Dataverse

Use los métodos de tabla de Dataverse del dataApi objeto para crear, recuperar, actualizar y eliminar filas de tabla de Dataverse y columnas de elección de consulta.

Método Description
createRow Crea una nueva fila en la tabla especificada.
deleteRow Elimina una fila de la tabla especificada.
getChoices Recupera las opciones para el nombre de columna de elección especificado.
queryTable Consulta una tabla con las opciones especificadas.
retrieveRow Recupera una fila de la tabla especificada con las opciones especificadas.
updateRow Actualiza una fila existente en la tabla especificada.

Métodos del conector

Use los métodos de conector del dataApi objeto para trabajar con los datos expuestos por un conector de Power Platform enlazado a la página.

Método Description
createConnectorRow Crea una nueva fila en la tabla de conectores especificada.
deleteConnectorRow Elimina una fila de la tabla de conectores especificada.
executeConnectorOperation Invoca una operación con nombre expuesta por un conector REST (con clave de operación), como Usuarios de Office 365.
getConnectorSwagger Recupera la definición de Swagger (OpenAPI) para el conector.
getConnectorTableSchema Recupera el esquema de una tabla (también denominada entidad o lista) expuesta por el conector.
listConnectorDatasets Enumera los conjuntos de datos disponibles para el conector.
listConnectorOperations Enumera las operaciones expuestas por un conector REST (con claves de operación).
listConnectorTables Enumera las tablas disponibles en el conjunto de datos del conector especificado.
queryConnectorTable Consulta una tabla expuesta por el conector con las opciones especificadas.
retrieveConnectorRow Recupera una sola fila de la tabla de conectores especificada.
updateConnectorRow Actualiza una fila existente en la tabla de conectores especificada.

Métodos de acción y función de Dataverse

Use los métodos de acción y función del dataApi objeto para invocar las API personalizadas de Dataverse enlazadas a la página.

Método Description
executeAction Invoca una API personalizada de Dataverse enlazada a la página como una acción.
executeFunction Invoca una API personalizada de Dataverse enlazada a la página como una función.
listBoundActions Enumera las API personalizadas de Dataverse (acciones y funciones) enlazadas a la página.

Métodos page

Utilice los métodos de página del dataApi objeto para controlar la propia página generativa, como devolver un valor cuando la página se usa como un cuadro de diálogo.

Método Description
setPageOutput Establece el valor devuelto al script de llamada cuando se cierra un cuadro de diálogo de página generativa.
  • Se actualizó por última vez el