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

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

За замовчуванням програма підключається до поточного середовища для таблиць Dataverse. Якщо програму перемістити в інше середовище, з’єднувач підключатиметься до даних у новому середовищі. Ця поведінка добре працює для програми, яка використовує одне середовище, або програми, яка дотримується процесу керування життєвим циклом програми (ALM) для переходу від розробки до тестування, а потім до виробництва.

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

Якщо ви виберете Змінити середовище, ви можете вказати інше середовище для отримання даних з нього замість поточного середовища або на додаток до нього.

Ім'я вибраного середовища відобразиться у списку таблиць.

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

Коли ви виберете Змінити середовище, вам буде запропоновано список середовищ. Хоча ви можете бачити середовище у списку, ролі безпеки в цьому середовищі визначають, що ви можете робити в цьому середовищі. Наприклад, якщо у вас немає прав на читання, ви не зможете бачити таблиці та записи в середовищі.

Нотатка

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

Зіставлення типу даних Power Apps

З’єднувач Microsoft Dataverse є більш надійним, ніж з’єднувач Dynamics 365 і майже рівноцінний йому за функціональними можливостями. У наведеній нижче таблиці перелічені типи даних Power Apps і їх зіставлення з типами даних у Dataverse.

Power Apps	Microsoft Dataverse
Вибір	Вибір, так/ні
DateTime	Дата й час, дата й час, лише дата
Image	Image
Число	Число з плаваючою комою, десяткове число, тривалість, мова, часовий пояс, ціле число
Text	електронна пошта, багаторядковий текст, телефон, текст, текстова область, текстовий символ, URL-адреса
GUID	Унікальний ідентифікатор

Делеговані функції та операції Power Apps для Dataverse

Ці Power Apps операції для даного типу даних можуть бути делеговані Dataverse для обробки (а не обробка локально всередині Power Apps).

Пункт	Число [1]	Текст [2]	Вибір	DateTime [3]	Guid
<, <=, >, >=	Так	Так	No	Так	-
=, <>	Так	Так	Так	Так	Так
І/або/ні	Так	Так	Так	Так	Так
CountRows [4] [5], Countif [6]	Так	Так	Так	Так	Так
Фільтр	Так	Так	Так	Так	Так
Перший [7]	Так	Так	Так	Так	Так
В (членство) [8]	Так	Так	Так	Так	Так
Вхід (підрядок)	-	Так	-	-	-
ІсБланк [9]	Так	Так	No	Так	Так
Підстановка	Так	Так	Так	Так	Так
Введіть пошуковий запит	No	Так	No	No	-
Сортувати	Так	Так	Так	Так	-
SortByColumns	Так	Так	Так	Так	-
StartsWith	-	Так	-	-	-
Сума, Мін, Макс, Середній [6]	Так	-	-	No	-

1. Числові з арифметичними виразами (наприклад, Filter(table, field + 10 > 100) ) не піддаються делегуванню. Мова та часовий пояс не є делегованими. Приведення в стовпець на номер не підтримується. Якщо значення відображається як число в, Power Apps але внутрішнє джерело даних не є простим числом, наприклад валютою, то воно не делегується.
2. Не підтримує Trim[Ends] і Len. Підтримує інші функції, такі як Лівий, Середній, Правий, Верхній, Нижній, Замінити, Замінити тощо. Крім того, для делегування не підтримується таке приведення, як Текст (стовпець).
3. DateTime делегується, за винятком функцій DateTime Now() і Today().
4. CountRows у Dataverse використовує кешоване значення. Для некешованих значень, де кількість записів має бути меншою за 50 000 записів, використовуйте CountIf(table, True).
5. Для CountRows слід переконатися, що користувачі мають відповідні дозволи на отримання загальної суми для таблиці.
6. Агрегатні функції обмежуються колекцією рядків 50 000. Якщо потрібно, скористайтеся функцією «Фільтр», щоб вибрати 50 000. Агрегатні функції не підтримуються в поданнях.
7. FirstN не підтримується.
8. In підпадає під обмеження запиту Dataverse в 15 таблиць.
9. Підтримує порівняння. Наприклад, Filter(TableName, MyCol = Blank()).

Викликайте Dataverse дії безпосередньо в Power Fx

Як частина Power Fx мови, автори тепер можуть безпосередньо викликати Dataverse дію у формулі. Підтримуються як неприв’язані, так і зв’язані дії. Автори можуть додавати мовний Power Fx Environment об’єкт до свого додатка та отримувати доступ до Dataverse дій.

Автори можуть працювати з нетипізованими полями об’єктів як для входів, так і для виходів. На стороні введення, наприклад, екземпляр, багато Dataverse дій вимагають нетипізованого об’єкта як аргументу. Автори тепер можуть передавати ці аргументи, використовуючи ParseJSON для перетворення Power Fx запису в нетипізований об’єкт. На стороні виводу, для дій, які повертають невведені об’єкти, ви можете просто dot ввести властивості повернутих об’єктів. Вам потрібно приводити конкретні значення для використання в конкретних контекстах для використання, наприклад, на Power Apps етикетці.

Без цієї функції автори зазвичай використовували Power Automate прямий виклик Dataverse . Однак виклик Dataverse безпосередньо з Power Fx телефону забезпечує значні переваги в продуктивності (і простоту використання), і йому слід віддавати перевагу для прямого читання та оновлення транзакцій. Якщо у вас є додаток, який використовується Power Automate для виклику Dataverse дій, ви бачите банер із пропозицією використовувати цей підхід прямої дії.

Робота з невведеними полями не обмежується Dataverse. Він працює для всіх типів конекторів і забезпечує базову підтримку динамічної схеми ad hoc.

Нотатка

1. Ми не повністю підтримуємо дії DV у Power Fx командуванні (специфічно для будь-яких викликів дій з параметрами).
2. Ми не підтримуємо прямі посилання на Сутність або колекції Сутностей.
3. Для параметрів типу об’єкта, які є вкладеними (глибиною 2 або більше рівнів), атрибути другого рівня розглядаються обов’язковими в PowerApps.

Увімкніть доступ до Microsoft Dataverse дій

Для нових програм ця функція вмикається автоматично. Для додатків, створених раніше, потрібно включити доступ до Dataverse дій.

Для старіших програм відкрийте програму полотна для редагування та перейдіть до розділу Налаштування>Майбутні функції>Зупинено та активуйте Dataverse дії.

Power Fx Додайте об’єкт Мова середовища до свого додатка

Щоб використовувати Dataverse дії у формулах Power Fx , виберіть Додати дані та знайдіть Середовище та додайте його до своєї програми.

Це додає Power Fx Environment об’єкт language до вашої програми.

Доступ до Dataverse дій

Power Fx Environment Коли об’єкт додано до вашої програми, ви можете отримати доступ до Dataverse дій, додавши Environment їх до формули, а потім поставивши крапки в діях.

Неприв’язані дії знаходяться на рівні рівноваги Dataverse до таблиць і потребують області приріднення об’єкта мови Environment . Доступні всі дії у вашому оточенні – як на рівні системи, так і на користувацькому рівні. Доступні як зв’язані, так і неприв’язані дії. Було прибрано 2-рівневий ліміт на дзвінки.

Щоб отримати додаткові відомості про використання Dataverse дій у формулах, перегляньте статтю Робота з нетипізованими та динамічними об’єктами.

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

Щоб передати аргументи типу сутності для Dataverse дій, почніть із встановлення значення аргументу типу сутності на змінну. Крім того, переконайтеся, що всі відсутні значення, такі як *activityId , заповнені. Це особливо важливо для суб’єктів, які не мають визначених типів у свавіллі.

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

Перейменування, оновлення та дії в інших середовищах

Ви можете перейменувати середовище, вибравши три крапки та вибравши «Перейменувати». Якщо ви додали нову Dataverse дію Dataverse і вам потрібно Power Apps її побачити, ви можете вибрати «Оновити». І, якщо вам потрібно використовувати дію в іншому середовищі, вам спочатку потрібно змінити середовище, а потім, опинившись там, знайдіть «Середовище», виберіть і додайте його до своєї програми.