生成页的 dataApi 参考

使用自然语言生成页面时,AI 会在 TypeScript 中创建 React 页面。 生成的页面通过选择正确的组件并确定最佳布局以及相应的业务逻辑来涵盖前端用户体验。

可以查看 和编辑生成的代码以优化输出。 数据操作使用公开 dataApi 分组到以下类别的公共方法的对象:

类别 Description
Dataverse 表方法 创建、检索、更新和删除 Dataverse 表行和查询选择列。
连接器方法 使用绑定到页面的 Power Platform 连接器公开的数据。
Dataverse 操作方法 调用绑定到页面的 Dataverse 自定义 API 作为操作或函数。
页面方法 控制生成页本身,例如在将页面用作对话时返回值。

连接器方法和操作和函数方法是协定的 dataApi 可选成员。 某些主机不实现它们,因此在调用方法之前,请始终检查方法是否存在(例如 if (dataApi.executeAction) { ... })。 存在的方法并不意味着页面具有绑定到它的连接器或 Dataverse 自定义 API,或者为当前用户启用或允许自定义 API。 显式处理不可用的功能和自定义 API 失败,而不是假设成功。

Dataverse 表方法

使用对象的 Dataverse 表方法 dataApi 创建、检索、更新和删除 Dataverse 表行,以及查询选择列。

方法 Description
createRow 在指定的表中创建新行。
deleteRow 从指定的表中删除行。
getChoices 检索指定选择列名称的选项。
queryTable 使用指定选项查询表。
retrieveRow 从具有指定选项的指定表中检索行。
updateRow 更新指定表中的现有行。

连接器方法

使用对象的连接器方法 dataApi 处理绑定到页面的 Power Platform 连接器公开的数据。

方法 Description
createConnectorRow 在指定的连接器表中创建新行。
deleteConnectorRow 从指定的连接器表中删除行。
executeConnectorOperation 调用 REST(操作键)连接器公开的命名操作,例如Office 365 用户。
getConnectorSwagger 检索连接器的 Swagger (OpenAPI) 定义。
getConnectorTableSchema 检索连接器公开的表(也称为实体或列表)的架构。
listConnectorDatasets 列出可用于连接器的数据集。
listConnectorOperations 列出 REST(操作键)连接器公开的操作。
listConnectorTables 列出指定连接器数据集中可用的表。
queryConnectorTable 使用指定选项查询连接器公开的表。
retrieveConnectorRow 从指定的连接器表中检索单个行。
updateConnectorRow 更新指定连接器表中的现有行。

Dataverse 操作和函数方法

使用对象的操作和函数方法 dataApi 调用绑定到页面的 Dataverse 自定义 API 。

方法 Description
executeAction 以操作的形式调用绑定到页面的 Dataverse 自定义 API。
executeFunction 以函数的形式调用绑定到页面的 Dataverse 自定义 API。
listBoundActions 列出绑定到页面的 Dataverse 自定义 API(操作和函数)。

页面方法

使用对象的页面方法 dataApi 控制生成页本身,例如,当页面用作对话时返回值。

方法 Description
setPageOutput 设置生成页面对话框关闭时返回到调用脚本的值。