посилання dataApi для генеративних сторінок

Коли ви створюєте сторінку природною мовою, ШІ створює сторінку React в TypeScript. Згенерована сторінка охоплює інтерфейс користувача, вибираючи потрібні компоненти та визначаючи найкращий макет і відповідну бізнес-логіку.

Ви можете переглянути та відредагувати створений код, щоб уточнити результати. Операції даних використовують dataApi об'єкт, який надає загальнодоступні методи, згруповані за цими категоріями:

Категорія	Опис
Dataverse table methods	Створюйте, отримуйте, оновлюйте та видаляйте рядки таблиці Dataverse і стовпці вибору запиту.
Методи з'єднувача	Робота з даними, пов'язаними зі сторінкою з'єднувачем Power Platform.
Dataverse operation methods	Викликати настроювані API Dataverse, прив'язані до сторінки як дії або функції.
Способи сторінки	Керуйте самою генеративною сторінкою, наприклад поверненням значення, коли сторінка використовується як діалогове вікно.

Методи з'єднувача, дії та функції необов'язкові учасники договору dataApi . Деякі хости не впроваджують їх, тому завжди перевіряйте наявність методу (наприклад), if (dataApi.executeAction) { ... }перш ніж викликати його. Наявний метод не означає, що сторінка прив'язана до неї з'єднувач або настроюваний API Dataverse, або що настроюваний API увімкнуто або дозволено для поточного користувача. Отримуйте явну обробку недоступних функціональних можливостей і настроюваних помилок API, а не припускаючи успіху.

Dataverse table methods

Використовуйте методи dataApi таблиці Dataverse об'єкта, щоб створювати, отримувати, оновлювати та видаляти рядки таблиці Dataverse і стовпці вибору запиту.

Метод	Опис
createRow	Створення нового рядка у вказаній таблиці.
deleteRow	Видалення рядка з указаної таблиці.
getChoices	Отримує варіанти для вказаного імені стовпця вибору.
queryTable	Запитує таблицю з указаними параметрами.
retrieveRow	Отримує рядок із вказаної таблиці з указаними параметрами.
updateRow	Оновлення наявного рядка у вказаній таблиці.

Методи з'єднувача

Використовуйте методи з'єднувача dataApi об'єкта для роботи з даними, виставленими з'єднувачем Power Platform, прив'язаним до сторінки.

Метод	Опис
createConnectorRow	Створення нового рядка у вказаній сполучній таблиці.
deleteConnectorRow	Видалення рядка з указаної сполучної таблиці.
executeConnectorOperation	Викликає іменовані операції, відкриті сполучною лінією REST (з ключем операції), наприклад Користувачі Office 365.
getConnectorSwagger	Отримує визначення Swagger (OpenAPI) для сполучної лінії.
getConnectorTableSchema	Отримує схему для таблиці (її також називають сутністю або списком), відкритої сполучною лінією.
listConnectorDatasets	Список наборів даних, доступних для з'єднувача.
listConnectorOperations	Список операцій, відкритих сполучною лінією REST (з ключем операції).
listConnectorTables	Список таблиць, доступних у вказаному наборі даних сполучної лінії.
queryConnectorTable	Запитує таблицю, відкриту сполучною лінією з указаними параметрами.
retrieveConnectorRow	Отримує один рядок із вказаної сполучної таблиці.
updateConnectorRow	Оновлено наявний рядок у вказаній сполучній таблиці.

Dataverse action and function methods

Використовуйте методи dataApi дії та функції об'єкта, щоб викликати настроювані API Dataverse , прив'язані до сторінки.

Метод	Опис
executeAction	Викликає настроюваний API Dataverse, прив'язаний до сторінки як дію.
executeFunction	Викликає настроюваний API Dataverse, прив'язаний до сторінки як функцію.
listBoundActions	Список настроюваних API (дій і функцій) Dataverse, прив'язаних до сторінки.

Способи сторінки

Використовуйте методи dataApi сторінки об'єкта, щоб керувати самою генеративною сторінкою, наприклад повертати значення, коли сторінка використовується як діалогове вікно.

Метод	Опис
setPageOutput	Установлює значення, повернуте сценарію викликів, коли закривається діалогове вікно генеративної сторінки.