Referência dataApi para páginas generativas

Quando geras uma página usando linguagem natural, a IA cria uma página React em TypeScript. A página gerada cobre tanto a experiência do utilizador front-end, selecionando os componentes certos e determinando o melhor layout, como a lógica de negócio correspondente.

Pode visualizar e editar o código gerado para refinar a saída. As operações de dados utilizam um dataApi objeto que expõe métodos públicos agrupados nestas categorias:

Categoria	Description
Métodos de tabela Dataverse	Criar, recuperar, atualizar e eliminar linhas de tabelas do Dataverse e colunas de escolha de consulta.
Métodos de ligação	Trabalhar com dados expostos por um conector Power Platform vinculado à página.
Métodos de operação do Dataverse	Invocar APIs personalizadas do Dataverse vinculadas à página como ações ou funções.
Métodos de paginação	Controla a própria página generativa, como devolver um valor quando a página é usada como diálogo.

Os métodos conector e métodos de ação e função são membros opcionais do dataApi contrato. Alguns hosts não os implementam, por isso verifica sempre se existe um método (por exemplo, if (dataApi.executeAction) { ... }) antes de o chamar. O facto de um método estar presente não significa que a página tenha um conector ou uma API personalizada do Dataverse associada, ou que a API personalizada esteja ativada ou permitida para o utilizador atual. Tratar de funcionalidades indisponíveis e falhas de APIs personalizadas de forma explícita, em vez de assumir sucesso.

Métodos de tabela Dataverse

Use os métodos de tabela Dataverse do dataApi objeto para criar, recuperar, atualizar e eliminar linhas de tabela Dataverse e colunas de escolha de consulta.

Método	Description
createRow	Cria uma nova linha na tabela especificada.
deleteRow	Apaga uma linha da tabela especificada.
getChoices	Recupera as opções para o nome da coluna de escolha especificada.
queryTable	Consulta uma tabela com as opções especificadas.
retrieveRow	Recupera uma linha da tabela especificada com as opções especificadas.
updateRow	Atualiza uma linha existente na tabela especificada.

Métodos de ligação

Use os métodos de conector do dataApi objeto para trabalhar com dados expostos por um conector Power Platform vinculado à página.

Método	Description
createConnectorRow	Cria uma nova linha na tabela de conectores especificada.
deleteConnectorRow	Apaga uma linha da tabela de conectores especificada.
executeConnectorOperation	Invoca uma operação nomeada exposta por um conector REST (operation-keyed), como o Utilizadores do Office 365.
getConnectorSwagger	Recupera a definição Swagger (OpenAPI) para o conector.
getConnectorTableSchema	Recupera o esquema de uma tabela (também chamada de entidade ou lista) exposta pelo conector.
listConnectorDatasets	Lista os conjuntos de dados disponíveis para o conector.
listConnectorOperations	Lista as operações expostas por um conector REST (operation-keyed).
listConnectorTables	Lista as tabelas disponíveis no conjunto de dados de ligação especificado.
queryConnectorTable	Consulta uma tabela exposta pelo conector com as opções especificadas.
retrieveConnectorRow	Recupera uma única linha da tabela de conectores especificada.
updateConnectorRow	Atualiza uma linha existente na tabela de conectores especificada.

Métodos de ação e função do Dataverse

Use os métodos de ação e função do dataApi objeto para invocar APIs personalizadas do Dataverse vinculadas à página.

Método	Description
executeAction	Invoca uma API personalizada do Dataverse vinculada à página como uma ação.
executeFunction	Invoca uma API personalizada do Dataverse vinculada à página como uma função.
listBoundActions	Lista as APIs personalizadas do Dataverse (ações e funções) vinculadas à página.

Métodos de paginação

Use os métodos de página do dataApi objeto para controlar a própria página gerativa, como devolver um valor quando a página é usada como diálogo.

Método	Description
setPageOutput	Define o valor devolvido ao script de chamada quando um diálogo de página generativa fecha.