Microsoft Dataverse [DEPRECATED]
Предоставляет доступ к базе данных среды в Microsoft Dataverse.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate |
| Логические приложения | Стандарт | Все регионы Logic Apps |
| Power Apps | - | Недоступно |
| Power Automate | Премия | Все регионы Power Automate |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL |
Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://powerapps.microsoft.com/common-data-service/ |
Замечание
Соединитель Microsoft Dataverse (устаревшая версия) будет поддерживаться корпорацией Майкрософт, пока соединитель Microsoft Dataverse не поддерживает Logic Apps.
Чтобы использовать этот соединитель в Power Apps, узнайте больше об использовании этого соединителя в Power Apps..
Известные проблемы и ограничения
- Существуют случаи, когда триггеры CDS не работают в рабочей среде с административным режимом, для которых задано значение "включено". При возникновении этой проблемы решением будет отключить режим администрирования в Центре администрирования Power Platform.
- Если режим администрирования включен для используемой среды (песочницы или рабочей среды), поток Power Automate с триггером изменения записи не будет запускаться при изменении записи. Дополнительные сведения о настройке режима администрирования см. на этой странице.
- Если вы используете триггер "Когда запись выбрана" в потоке и имеет шаг "Если условие" сразу после этого вы получите ошибку, если атрибут в условии имеет значение NULL. Появится сообщение об ошибке "'Недопустимый тип". Ожидаемая строка, но имеет значение NULL.". Рекомендуемое решение заключается в вставке действия "Получить строку" между действием "Когда запись выбрана" и шагом "If Condition". Используя выходные данные действия "Получить строку" в вашем состоянии, вы сможете избежать этой ошибки.
Сопоставления типов данных Power Apps
| Power Apps (Приложения Power) | Microsoft Dataverse (устаревшая версия) |
|---|---|
| Выбор | Выбор, Да/Нет |
| DateTime | Дата, дата и время, только дата |
| Изображение | Изображение |
| Number | Число с плавающей запятой, валюта, десятичное число, длительность, язык, часовой пояс, целое число |
| Текст | Электронная почта, многострочного текста, телефон, текст, область текста, символ тикера, URL-адрес |
| Гид | Уникальный идентификатор |
Делегированные функции и операции Power Apps для Dataverse
Эти операции Power Apps для заданного типа данных могут быть делегированы Dataverse для обработки (а не локальной обработки в Power Apps).
| Item | Число [1] | Текст [2] | Выбор | DateTime [3] | Гид |
|---|---|---|---|---|---|
| Filter | Да | Да | Да | Да | Да |
| Сортировать | Да | Да | нет | Да | - |
| SortByColumns | Да | Да | нет | Да | - |
| Lookup | Да | Да | Да | Да | Да |
| =, <> | Да | Да | Да | Да | Да |
| <, =, >, ><= | Да | Да | нет | Да | - |
| И /или/нет | Да | Да | Да | Да | Да |
| StartsWith | - | Да | - | - | - |
| IsBlank | Да [4] | Да [4] | Нет [4] | Да [4] | Да |
| Sum, Min, Max, Avg | Да [5] | - | - | нет | - |
- Числовые выражения с арифметическими выражениями (например, Filter(table, field + 10 100 > ) не являются делегированными. Язык и часовой пояс не являются делегированными.
- Не поддерживает Trim[Ends] или Len. Поддерживает другие функции, такие как слева, середина, правый, верхний, нижний, замена, замена и т. д.
- DateTime обычно является деегатируемым, за исключением функций DateTime Now() и Today().
- Поддерживает сравнения. Например, Filter(TableName, MyCol = Blank()).
- Агрегатные функции ограничены коллекцией из 50 000 строк. При необходимости используйте функцию фильтра, чтобы выбрать 50 000 строк из большего набора перед использованием статистической функции.
Замечание
Варианты выбора, guid и агрегатные функции для Dataverse поддерживаются только в новой версии соединителя. В зависимости от используемой версии Power Apps включите этот соединитель с помощью параметра предварительной версии:
-
Реляционные данные, варианты и другие новые функции для Dataverse
или этот экспериментальный переключатель: -
Использование соединителя Dataverse
Чтобы найти эти переключатели, откройте меню "Файл" и выберите ">Дополнительные параметры приложения".
Подробное описание соединителя
Дополнительные сведения о соединителе см. в подробном разделе.
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| Проверка подлинности сертификата клиента | Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX | Все регионы | Доступный для общего пользования |
| Oauth | Oauth | Все регионы | Доступный для общего пользования |
| Сервисный принципал | Предоставление учетных данных идентификатора Microsoft Entra с помощью идентификатора клиента и секрета | Все регионы | Доступный для общего пользования |
| По умолчанию [не рекомендуется] | Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости. | Все регионы | Недоступен для совместного использования |
Проверка подлинности сертификата клиента
Идентификатор проверки подлинности: CertOauth
Применимо: все регионы
Предоставление учетных данных идентификатора Microsoft Entra с помощью сертификата и пароля PFX
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Tenant | струна | True | |
| Идентификатор клиента | струна | Идентификатор клиента для приложения Идентификатора Microsoft Entra | True |
| Секрет сертификата клиента | клиентский сертификат | Секрет сертификата клиента, разрешенный этим приложением | True |
Oauth
Идентификатор проверки подлинности: Oauth
Применимо: все регионы
Oauth
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
Служебный принципал
Идентификатор проверки подлинности: ServicePrincipalOauth
Применимо: все регионы
Предоставление учетных данных идентификатора Microsoft Entra с помощью идентификатора клиента и секрета
Это совместное подключение. Если приложение power app предоставлено другому пользователю, подключение также предоставляется совместно. Дополнительные сведения см. в обзоре соединителей для приложений на основе холста — Power Apps | Документация Майкрософт
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| Идентификатор клиента | струна | Идентификатор клиента (или приложения) приложения Microsoft Entra ID. | True |
| Секрет клиента | securestring | Секрет клиента приложения Идентификатора Microsoft Entra. | True |
| Tenant | струна | Идентификатор клиента для приложения Идентификатора Microsoft Entra. | True |
По умолчанию [не рекомендуется]
Применимо: все регионы
Этот параметр предназначен только для старых подключений без явного типа проверки подлинности и предоставляется только для обратной совместимости.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 1000 | 60 секунд |
Действия
| Возвращает строку из таблицы [DEPRECATED] |
Возвращает строку из таблицы |
| Вывод списка строк (устаревших версий) [DEPRECATED] |
Эта операция получает строки для таблицы |
| Вывод списка строк [DEPRECATED] |
Эта операция получает строки для таблицы |
| Добавление новой строки (устаревшая версия) [DEPRECATED] |
Эта операция добавляет новую строку таблицы |
| Добавление новой строки [DEPRECATED] |
Эта операция добавляет новую строку таблицы |
| Обновление строки (устаревшей версии) [DEPRECATED] |
Эта операция обновляет существующую строку для таблицы |
| Обновление строки [DEPRECATED] |
Эта операция обновляет существующую строку для таблицы |
| Получение строки (устаревшая версия) [DEPRECATED] |
Эта операция извлекает указанную строку для таблицы. |
| Удаление строки (устаревшей версии) [DEPRECATED] |
Эта операция удаляет строку из коллекции таблиц |
Возвращает строку из таблицы [DEPRECATED]
Возвращает строку из таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Идентификатор элемента
|
id | True | string |
Идентификатор строки |
Возвращаемое значение
Вывод списка строк (устаревших версий) [DEPRECATED]
Эта операция получает строки для таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Преобразование агрегирования
|
$apply | string |
Последовательность преобразований агрегирования OData |
|
|
Запрос фильтра
|
$filter | string |
Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Заказ по
|
$orderby | string |
Запрос oDATA orderBy для указания порядка записей. |
|
|
Первое число
|
$top | integer |
Общее количество записей для получения (по умолчанию = все). |
|
|
Запрос на расширение
|
$expand | string |
Связанные записи для включения с запрошенными записями (по умолчанию = нет) |
Возвращаемое значение
Вывод списка строк [DEPRECATED]
Эта операция получает строки для таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Запрос фильтра
|
$filter | string |
Запрос фильтра ODATA для ограничения возвращаемых записей (например, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Заказ по
|
$orderby | string |
Запрос oDATA orderBy для указания порядка записей. |
|
|
Первое число
|
$top | integer |
Общее количество записей для получения (по умолчанию = все). |
|
|
Запрос на расширение
|
$expand | string |
Связанные записи для включения с запрошенными записями (по умолчанию = нет) |
Возвращаемое значение
Добавление новой строки (устаревшая версия) [DEPRECATED]
Эта операция добавляет новую строку таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Элемент-строка
|
item | True | dynamic |
Создаваемая строка |
Возвращаемое значение
Добавление новой строки [DEPRECATED]
Эта операция добавляет новую строку таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Элемент-строка
|
item | True | dynamic |
Создаваемая строка |
Возвращаемое значение
Обновление строки (устаревшей версии) [DEPRECATED]
Эта операция обновляет существующую строку для таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Идентификатор строки
|
id | True | string |
Идентификатор строки |
|
Элемент-строка
|
item | True | dynamic |
Обновляемая строка |
Возвращаемое значение
Обновление строки [DEPRECATED]
Эта операция обновляет существующую строку для таблицы
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Идентификатор строки
|
id | True | string |
Идентификатор строки |
|
Элемент-строка
|
item | True | dynamic |
Обновляемая строка |
Возвращаемое значение
Получение строки (устаревшая версия) [DEPRECATED]
Эта операция извлекает указанную строку для таблицы.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Идентификатор элемента
|
id | True | string |
Идентификатор строки |
Возвращаемое значение
Удаление строки (устаревшей версии) [DEPRECATED]
Эта операция удаляет строку из коллекции таблиц
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
|
Идентификатор элемента
|
id | True | string |
Идентификатор строки |
Триггеры
| При выборе строки |
Активируйте поток при выборе строки из меню "Поток" в строке команд. (Доступно только для Power Automate.) |
| При добавлении строки (только администратор) [не рекомендуется] |
Активирует поток при добавлении строки в Dataverse |
| При добавлении строки (только администратор) [не рекомендуется] |
Активирует поток при добавлении строки в Dataverse |
| При добавлении строки [DEPRECATED] |
Активирует поток при добавлении строки в Dataverse. |
| При изменении строки (только администратора) [не рекомендуется] |
Активирует поток при изменении строки в Dataverse |
| При изменении строки (только администратора) [не рекомендуется] |
Активирует поток при изменении строки в Dataverse |
| При изменении строки [DEPRECATED] |
Активирует поток при изменении строки в Dataverse. |
| При удалении строки (только администратор) [DEPRECATED] |
Активирует поток при удалении строки в Dataverse |
| При удалении строки [DEPRECATED] |
Активирует поток при удалении строки в Dataverse. |
При выборе строки
Активируйте поток при выборе строки из меню "Поток" в строке команд. (Доступно только для Power Automate.)
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
operationId
|
operationId | True | string | |
|
host
|
host | object | ||
|
parameters
|
parameters | True | object | |
|
schema
|
schema | True | object | |
|
headersSchema
|
headersSchema | object |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Строк
|
body.rows | array of object | |
|
items
|
body.rows | object | |
|
Идентификатор пользователя
|
headers.x-ms-user-id-encoded | guid |
Уникальный идентификатор пользователя, активировавшего поток в AAD. |
|
Электронная почта пользователя
|
headers.x-ms-user-email-encoded | byte |
Адрес электронной почты пользователя, активировавшего поток. |
|
Имя пользователя
|
headers.x-ms-user-name-encoded | byte |
Отображаемое имя пользователя, активировавшего поток. |
|
Отметка времени
|
headers.x-ms-user-timestamp | string |
Время активации потока. |
При добавлении строки (только администратор) [не рекомендуется]
Активирует поток при добавлении строки в Dataverse
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
Возвращаемое значение
При добавлении строки (только администратор) [не рекомендуется]
Активирует поток при добавлении строки в Dataverse
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
Возвращаемое значение
При добавлении строки [DEPRECATED]
Активирует поток при добавлении строки в Dataverse.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выберите среду. |
|
Имя таблицы
|
table | True | string |
Выберите таблицу. |
|
Scope
|
scope | True | string |
Размах. |
Возвращаемое значение
При изменении строки (только администратора) [не рекомендуется]
Активирует поток при изменении строки в Dataverse
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
Возвращаемое значение
При изменении строки (только администратора) [не рекомендуется]
Активирует поток при изменении строки в Dataverse
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
Возвращаемое значение
При изменении строки [DEPRECATED]
Активирует поток при изменении строки в Dataverse.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выберите среду. |
|
Имя таблицы
|
table | True | string |
Выберите таблицу. |
|
Scope
|
scope | True | string |
Размах. |
|
Фильтры столбцов
|
AttributeFilters | array of string |
Фильтры столбцов |
Возвращаемое значение
При удалении строки (только администратор) [DEPRECATED]
Активирует поток при удалении строки в Dataverse
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выбор среды |
|
Имя таблицы
|
table | True | string |
Выбор таблицы |
Возвращаемое значение
При удалении строки [DEPRECATED]
Активирует поток при удалении строки в Dataverse.
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Окружающая среда
|
dataset | True | string |
Выберите среду. |
|
Имя таблицы
|
table | True | string |
Выберите таблицу. |
|
Scope
|
scope | True | string |
Размах. |