當你 用自然語言產生頁面時，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 |
更新指定連接器資料表中現有的一列。 |
資料宇宙的動作與功能方法
使用物件的 dataApi 動作與函式方法來呼叫綁定在頁面上的 Dataverse 自訂 API 。
| 方法 | Description |
|---|---|
executeAction |
以動作呼叫綁定在頁面上的 Dataverse 自訂 API。 |
executeFunction |
以函式方式呼叫綁定在頁面上的 Dataverse 自訂 API。 |
listBoundActions |
列出綁定在頁面上的 Dataverse 自訂 API（動作與函式）。 |
頁法
利用物件的 dataApi 頁面方法來控制生成頁面本身，例如當頁面被用作對話框時回傳一個值。
| 方法 | Description |
|---|---|
setPageOutput |
設定當生成頁面對話結束時，回傳給呼叫腳本的值。 |