Подключиться к Microsoft Dataverse

Безопасно храните бизнес-данные в Dataverse и создавайте богатые приложения в Power Apps, чтобы пользователи могли управлять данными. Вы также можете интегрировать эти данные в решения, которые включают Power Automate, Power BI и данные из Dynamics 365.

По умолчанию приложение подключается к текущей среде для таблиц Dataverse. Если ваше приложение перемещается в другую среду, соединитель подключается к данным в новой среде. Это поведение хорошо подходит для приложения, которое использует одну среду или следует процессу управления жизненным циклом приложений (ALM) для перехода от разработки, тестирования, а затем в рабочую среду.

При добавлении данных из Dataverse измените среду и выберите одну или несколько таблиц. По умолчанию приложение подключается к данным в текущей среде.

Если выбрать команду "Изменить среду", укажите другую среду для извлечения данных из нее или в дополнение к текущей среде.

Имя выбранной среды отображается под списком таблиц.

Видимость и доступ

При выборе параметра "Изменить среду" отображается список сред. Даже если в списке отображается среда, роли безопасности в среде управляют тем, что можно сделать там. Например, если у вас нет прав на чтение, таблицы и записи в среде не отображаются.

Сопоставления типов данных Power Apps

Соединитель Microsoft Dataverse является более надежным, чем соединитель Dynamics 365 и приближается к четности функций. В следующей таблице перечислены типы данных в Power Apps и их сопоставление с типами данных в Dataverse.

Делегируемые функции и операции Power Apps для Dataverse

Эти операции Power Apps для заданного типа данных можно делегировать в Dataverse для обработки вместо локальной обработки в Power Apps.

Примечания.

1. Числовые выражения с арифметическими выражениями (например, Filter(table, field + 10 > 100)не являются делегированными). Язык и часовой пояс не могут делегироваться. Приведение столбца к числу не поддерживается. Если значение отображается как число в Power Apps, но внутренний источник данных не является простым числом, например валютой, то он не делегирован.
2. Не поддерживает Trim[Ends] или Len. Поддерживает другие функции, такие как Left, Mid, Right, Upper, Lower, Replace и Replace. Кроме того, приведение, например text(column), не поддерживается для делегирования.
3. DateTime можно делегировать, за исключением функций DateTime Now() и Today().
4. CountRows в Dataverse использует кэшированное значение. Для не кэшированных значений, в которых количество записей составляет менее 50 000 записей, используйте CountIf(table, True).
5. Для CountRows убедитесь, что у пользователей есть соответствующие разрешения для получения итоговых значений для таблицы.
6. Все агрегатные функции ограничены коллекцией из 50 000 строк. При необходимости используйте функцию фильтра, чтобы выбрать 50 000 строк. Агрегатные функции не поддерживаются для представлений.
7. Функция FirstN не поддерживается.
8. Оператор In подлежит ограничению 15-табличного запроса Dataverse.
9. Поддерживает сравнения. Например: Filter(TableName, MyCol = Blank()).
10. UpdateIf и RemoveIf работают локально, но имитируют делегирование до 500 или 2000 записей. Они последовательно раскрывают записи за пределы неделегации 500 или 2000 записей. Записи, соответствующие условию If, собираются. Как правило, не более 500 или 2000 записей собираются отдельно, а затем изменяются на выполнение. Однако дополнительные записи можно обновить, если существующий локальный кэш данных велик, так как функция может получить доступ к дополнительным записям для оценки.

Вызов действий Dataverse непосредственно из Power Fx

В рамках языка Power Fx теперь можно напрямую вызвать действие Dataverse в формуле. Поддерживаются как несвязанные, так и связанные действия. Добавьте объект языка Power Fx Environment в приложение для использования действий Dataverse.

Динамические поля можно использовать как для входных, так и для выходных данных. Для входных данных для многих действий Dataverse требуется динамическое значение в качестве аргумента. Передайте эти аргументы с помощью ParseJSON для преобразования записи Power Fx в динамическое значение. Если действие возвращает динамические значения, просто используйте нотацию точек для доступа к свойствам объекта. Приведение определенных значений для использования в Power Apps, например в метке.

Перед этой функцией часто используется Power Automate для прямого вызова Dataverse. Вызов Dataverse из Power Fx дает значительные преимущества производительности и упрощает использование, поэтому используйте этот подход для прямого чтения транзакций и обновлений. Если приложение использует Power Automate для вызова действий Dataverse, вы увидите баннер, предлагающий использовать этот прямой подход к действиям.

Работа с динамическими полями не ограничивается Dataverse. Эта функция работает со всеми типами соединителей и обеспечивает базовую поддержку динамической схемы.

Включение доступа к действиям Microsoft Dataverse

Для новых приложений данная функция включена автоматически. Для созданных ранее приложений включите доступ к действиям Dataverse.

Для старых приложений откройте приложение холста для редактирования. Перейдите к разделу "Параметры предстоящих>функций>" и включите действия Dataverse.

Добавление объекта "Язык среды" Power Fx в приложение

Чтобы использовать действия Dataverse в формулах Power Fx, выберите "Добавить данные", выполните поиск среды и добавьте его в приложение.

На этом шаге в приложение добавляется объект языка PowerFx Environment .

Доступ к действиям Dataverse

После добавления объекта Power Fx Environment в приложение получите доступ к действиям Dataverse, добавив Environment в формулу, а затем используя нотацию точек для действий.

Несвязанные действия с данными находятся на том же уровне, что и таблицы и требуют родительской области объекта языка среды . Доступны все действия в вашей среде — как системные, так и пользовательские. Доступны как несвязанные, так и связанные действия. Ограничение двухуровневого вызова удаляется.

Дополнительные сведения об использовании действий Dataverse в формулах см. в статье "Работа с динамическими значениями".

Передача аргументов типа сущности для связанных и несвязанных действий

Чтобы передать аргументы типа сущности для действий Dataverse, задайте значение аргумента типа сущности переменной. Обязательно заполните отсутствующие значения, такие как *activityId. Этот шаг важен для сущностей, которые не имеют определенных типов в swagger.

Set(MyArgVar, {
  name: First(systemUser).name,
  Id: First(systemUser).Id
  ... })

Переименование, обновление и использование действий в других средах

Чтобы переименовать среду, выберите многоточие и нажмите кнопку "Переименовать". Если вы добавите новое действие Dataverse в Dataverse и хотите, чтобы Power Apps его видел, нажмите кнопку "Обновить". Чтобы использовать действие в другой среде, измените среду, а затем найдите "Среда", выберите ее и добавьте ее в приложение.