Використання low-code плагінів (Dataverse попередній перегляд)

[Цей розділ є документацією для попередньої версії, і його буде змінено.]

Microsoft Dataverse пропонує потужне рішення для досягнення більш ефективної архітектури даних і зменшення навантаження на стороні клієнта за допомогою low-code плагінів. Ці плагіни є багаторазово використовуваними робочими процесами в реальному часі, які виконують певний набір команд всередині Dataverse, запускаються на стороні сервера та запускаються персоналізованими обробниками подій.

Важливо

• Це функція попереднього перегляду.
• Підготовчі функції призначені для невиробничого використання і можуть бути обмежені. Ці функції доступні до офіційного випуску, щоб клієнти могли ознайомитися з ними заздалегідь і залишити відгуки.

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

Low-code плагіни зберігаються в Dataverse базі даних і можуть бути легко інтегровані в Power Apps and Power Automate. Поведінка робочого процесу визначається за допомогою Power Fx мови виразів і може безпосередньо зв’язуватися з Dataverse бізнес-даними та зовнішніми джерелами даних через Power Platform конектори. За допомогою плагінів з низьким кодом виробники можуть швидко створювати складні робочі процеси з мінімальним досвідом кодування, що призводить до більш оптимізованої та ефективної архітектури даних.

Переваги серверної логіки

Визначення бізнес-логіки на стороні сервера має кілька переваг, зокрема:

• Підвищена безпека. Оскільки логіка на стороні сервера виконується на сервері, це може допомогти запобігти несанкціонованому доступу до конфіденційних даних або процесів.
• Покращена продуктивність. Виконуючи на сервері, бізнес-логіка може зменшити обсяг даних, які потрібно передавати між клієнтом і сервером, що призводить до швидшого часу обробки.
• Послідовність і надійність. Логіка на стороні сервера гарантує, що бізнес-правила послідовно застосовуються до всіх клієнтів, зменшуючи ризик помилок або невідповідностей.
• Простіше обслуговування та модернізація. Завдяки централізації бізнес-логіки на сервері стає простіше підтримувати та оновлювати, оскільки зміни можна вносити в одному місці, а не оновлювати кілька клієнтів.
• Масштабованість. Логіку на стороні сервера можна масштабувати легше, ніж логіку на стороні клієнта, що забезпечує кращу продуктивність і обробку великих робочих навантажень.

Low-code плагіни

Існує два типи low-code плагінів, які підтримуються в: Dataverse

Ввести	Тригер	Підтримує параметри	Область підтриманої області
Миттєві	Запуск вручну	Так	Глобальні і табличні
Автоматизовані	Dataverse Застільна подія	No	Table

Всі low-code плагіни мають такі загальні властивості:

Властивість	Опис
Коротке ім’я.	Зрозуміле людині ім’я плагіна. Не можна змінити після створення.
Ім'я	Внутрішнє ім’я плагіна. Він використовується платформою для ідентифікації компонента в операціях з кодом і базою даних. Не можна змінити після створення.
Опис	Використовується для надання додаткового контексту про плагін (призначення, поведінку або інші важливі деталі).
Рішення	Використовується для групування складників та експорту до інших середовищ. Докладніше про рішення.
Expression	Це користувацька функція, яку можна використовувати для виконання дій або обчислень, визначених за допомогою мови виразів Power Fx . Power Fx — це мова формул, яка використовується в Power Apps програмах Canvas і була розширена для використання в плагінах з низьким кодом. Перегляньте підтримувані функції для отримання додаткової інформації.

Миттєві плагіни

Миттєвий low-code плагін — це користувацька логіка коду, яка запускається користувачем вручну. Можна використовувати користувацькі параметри введення та виведення.

Унікальні властивості:

Властивість	Опис
Scope	Використовується для зв’язування плагіна з певною таблицею. Він може бути встановлений як таблиця (відображається як сутність), так і глобальна, де область видимості таблиці (сутності) означає, що плагін запускається з контекстом певного запису таблиці, а глобальна область видимості означає, що операція не пов’язана з таблицею (докладніше).
Параметри	Параметри дозволяють передавати інформацію між плагіном і контекстом, який його запускає, що полегшує розробку бізнес-логіки, яку можна повторно використовувати в різних ситуаціях. Вхідні параметри використовуються для надання даних плагіну та дозволяють керувати поведінкою функції, передаючи різні значення, які ви вказуєте у формулі Power Fx . Вихідні параметри дозволяють отримати результати функції або методу для подальшого використання у вашій програмі. Підтримувані типи даних: Boolean String Float Десяткове число DateTime Ціле число

Більше інформації про те, як інтегруватися з програми на полотні або в хмарному Power Automate потоці: Інтеграція плагіна з низьким кодом

Автоматизовані плагіни

Автоматизований low-code плагін — це спеціальний код, який виконується під час обробки певної події даних.

Унікальні властивості:

Властивість	Опис
Подія даних ("Запустити цей плагін, коли є рядок")	Визначає, яка подія даних ініціює плагін. Для виклику плагіна можна вибрати будь-яку з наведених нижче подій: Створення Update Delete
Етап («Коли це має запустити»)	Ви можете налаштувати, чи запускатиметься плагін до або після завершення події даних, що дає змогу гнучко отримувати доступ до значень і змінювати їх на ключових етапах події. Попередня експлуатація. Виберіть цей параметр, якщо ви хочете запустити логіку плагіна після перевірки форми, але до того, як значення будуть вставлені або змінені Dataverse. Після операції. Виберіть цей параметр, щоб запустити логіку плагіна після того, як значення буде вставлено або змінено Dataverse.

Дозволи плагінів

Час проектування

Виробники, які мають настроювач системи або системного адміністратора роль безпеки членство в Power Platform середовищі, можуть отримати доступ до всіх плагінів у цьому середовищі. Користувацькі ролі безпеки можна використовувати для обмеження доступу до low-code плагінів.

Тривалість роботи

Під час виклику додатка він отримує доступ до даних таблиці, які беруть участь у визначенні додатка (таблиць, які є частиною формули, або якщо таблиця пов’язана з настройками автоматизованого додатка), у контексті користувача, який його викликав.

З’єднання

Використовуючи ролі безпеки, доступ до з’єднувачів у компонентах plug-in може бути обмежений певним набором користувачів у вашій організації. Укажіть, які ролі мають права створення, читання, оновлення або видалення.

Передумови для створення low-code плагіна

Примітка

Ми випускаємо набір оновлень, щоб увімкнути плагіни Dataverse з низьким кодом. Ці low-code плагіни використовують інтерфейс користувача, побудований на функції Power Platform користувацьких сторінок. У рамках цих оновлень ми розгортаємо в середовищах, використовуючи облікові записи обслуговування системи. За деяких обставин ці розповіді мали несподіваний побічний ефект, представляючи їх як розбитий скла. Ми працюємо над тим, щоб якнайшвидше виправити цю поведінку. Тим часом у Power Platform центрі адміністрування можуть з’явитися такі програми:

• Dataverse Додаток-корисник – < додаток> на основі моделі, створений глобальним обліковим записом адміністратора.
• Dataverse Сторінка дій - < canvas app> Це спеціальна сторінка, на якій вбудований плагін low-code, створений з іменем користувача, пов’язаним із глобальним обліковим записом адміністратора.
• Оглядова сторінка - < програма> canvas Це користувацька сторінка, на якій вбудований плагін з низьким кодом, створений за допомогою імені користувача, пов’язаного з глобальним обліковим записом адміністратора.

• Системний адміністратор або настроювач системи роль безпеки членство в Power Platform середовищі.
• Доступ до програми-акселератора Dataverse .

Порада

З 1 жовтня 2023 року в усіх нових середовищах автоматично встановлюється програма-прискорювач. Dataverse Якщо корисну можливість уже інстальовано Dataverse , її можна оновити Dataverse вручну.

Оновіть Dataverse корисну можливість

1. Дотримуйтесь інструкцій, щоб переглянути ліцензовані програми у вашому середовищі.
2. Dataverse Якщо корисну можливість уже інстальовано й доступне оновлення, воно відображається в таблиці поруч із елементом.
3. Виберіть Dataverse пункт Корисна можливість, а потім на панелі команд виберіть пункт Оновити .

Порада

Увімкніть автоматичне оновлення програм для видавця Microsoft - Power CAT, щоб автоматично отримувати оновлення, коли вони доступні (не обов’язково для нових середовищ, створених після 1 жовтня 2023 року).

Примітка

Якщо ви раніше інсталювали додаткове рішення Low-Code Plug-ins for Connectors, його буде автоматично видалено під час оновлення після 29 червня 2023 року. Можливості будуть доступні в основному рішенні.

Створіть миттєвий low-code плагін

1. Відтворіть програму «Корисна можливість Dataverse ».
2. Виберіть Створити миттєву картку плагіна .
3. Укажіть коротке ім’я.
4. За бажанням визначте параметри:
   • Виберіть Новий вхідний параметр або Новий вихідний параметр, а потім введіть мітку та тип даних.
   • За потреби додайте більше вхідних і вихідних параметрів.
5. Введіть вираз Power Fx у редакторі виразів .
   • Посилання на вхідні параметри у формулі за назвою мітки.
   • На вихідні параметри має бути посилання всередині фігурних дужок, наприклад { Out: "Return value" }.
   • Довідкові Dataverse таблиці за допомогою функцій збору даних, таких як Filter() і LookUp().
   • Якщо для області встановлено значення сутність, використовується ThisRecord для доступу до значень стовпців у рядку таблиці, пов’язаного із запуском плагіна, наприклад ThisRecord.'Account Name'.

   Порада

   Зверніть увагу на intellisense у полі Вираз . Підкреслено червоним кольором неприпустимо. Хвилястий жовтий колір означає, що на вашу логіку можуть вплинути обмеження делегування. Уникайте проблем з делегуванням, використовуючи функції, які можна делегувати.

6. За бажанням розгорніть додаткові параметри, щоб змінити рішення, область або опис.
7. Виберіть Зберегти.
8. Протестуйте плагін із миттєвим низьким кодом.

Приклад: Обчислити суму двох цілих чисел.

• Створити два вхідних параметри,and X Y (обидва з цілим типом), і один вихідний параметр, Z (рядок типу).
• Використовуйте наступну формулу: {Z: X + Y }

Створення автоматизованого low-code плагіна

1. Відтворіть програму «Корисна можливість Dataverse ».
2. Виберіть Створити автоматизовану картку плагіна .
3. Укажіть такі значення:
   • Ім’я: введіть назву плагіна, наприклад Перевірка вводу.
   • Таблиця: виберіть таблицю, з якою буде пов’язано плагін, наприклад Обліковий запис.
   • Запустіть це правило плагіна, коли рядок настане. Укажіть подію data, яка викликає плагін.
4. Введіть вираз Power Fx у редакторі виразів .
   • Довідкові Dataverse таблиці за допомогою функцій збору даних, таких як Filter() і LookUp().
   • Використовується ThisRecord для доступу до значень стовпців у рядку таблиці, пов’язаного із запуском плагіна, наприклад ThisRecord.'Account Name'.
5. За бажанням розгорніть додаткові параметри , щоб змінити етап  (коли це має запуститися) і рішення, де збережено плагін.
6. Виберіть Зберегти.
7. Перевірте свій автоматизований low-code плагін.

Використання Power Platform з’єднувачів у low-code плагінах

Power Platform конектори можна використовувати в low-code плагінах для легкої інтеграції даних і функціональних можливостей із зовнішніх Dataverse систем, таких як SQL Server, Salesforce, і SharePoint без необхідності складного кодування або спеціальної розробки.

Передумови використання конекторів у low-code плагінах

• Передумови для створення low-code плагіна
• Посилання на з’єднання з активним з’єднанням.

Використання дій з’єднувача в low-code плагінах

Ви можете легко використовувати з’єднувачі та спеціальні роз’єми з формули плагіна з низьким кодом Power Fx .

1. Створіть з’єднання з потрібним з’єднувачем.
2. Додайте посилання на з’єднання у Dataverse середовищі.
3. У редакторі виразів плагіна з низьким кодом Power Fx введіть ім’я посилання на з’єднання (внутрішнє ім’я з префіксом і підкресленням, наприклад new_connectorName, не коротке ім’я).
4. Intellisense показує доступні дії. Виберіть потрібну дію, а потім введіть необхідні параметри.

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

Додаткові відомості: приклад

Примітка

• Наразі підтримуються не всі дії з’єднувача.
• Не використовуйте Dataverse з’єднувач для підключення до Dataverse таблиць за допомогою вставного виразу. Замість цього використовуйте власні Power Fx функції для взаємодії з колекціями: Filter, Search, LookUp, Patch, Collect і Set, де стовпці розглядаються як глобальні змінні.

Тестування low-code плагіна

Тестуйте плагіни миттєвого друку

1. На головному екрані виберіть миттєвий плагін зі списку, а потім виберіть «Перевірити » на панелі команд. Ви також можете перейти на цей екран за допомогою редактора плагінів миттєвого друку на панелі команд після його збереження.

2. Укажіть значення для всіх вхідних параметрів, визначених у плагіні low-code, а потім натисніть кнопку Виконати.

Спостерігайте за реакцією.

Порада

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

Тестування автоматизованих плагінів

Перевірте автоматичні плагіни, викликавши подію data. Подивіться, чи успішно працює плагін, перевіривши очікувані зміни, визначені у формулі.

Порада

Під час попереднього перегляду ви можете викликати пов’язану подію даних за допомогою редактора таблиць у: Power Apps

1. Power Apps авторизуйтесь, перейдіть до розділу Таблиці та виберіть таблицю Плагін.
2. Виберіть Редагувати на панелі команд.
3. Створюйте, оновлюйте або видаляйте рядки безпосередньо з цього подання. Крім того, можна відкрити рядок у формі за промовчанням, вибравши рядок, а потім вибрати на панелі команд пункт Редагувати рядок за допомогою форми .

Інтегруйте low-code плагін

Виклик миттєвого плагіна з програми Canvas або спеціальної сторінки

1. Dataverse У програмі «Корисна можливість »:
   1. Виберіть миттєвий плагін у списку.
   2. Виберіть Копіювати фрагмент коду на панелі команд.
   3. Вставте та збережіть скопійовану формулу в текстовому редакторі або блокноті (кудись, куди ви можете легко повернутися).
2. У: Power Apps
   1. Створіть або відредагуйте програму для роботи з полотном (або власну сторінку) у Power Apps студії.
   2. На навігаційній панелі ліворуч на вкладці «Джерела даних» виберіть + Новий джерело даних і знайдіть параметр «Середовище » в сполучному вузлі. Dataverse
   3. Вставте в полотно наступні компоненти:
   • Додайте елементи керування вводу, які відповідають типу даних кожного параметра, наприклад Введення тексту для тексту або чисел, перемикач для булевого значення.
   • Якщо область плагіна прив’язана до таблиці, додайте спадний список, пов’язаний із тією самою таблицею, щоб можна було вибрати вхідні дані.
   • Додайте кнопку для виклику плагіна.
3. Вставте скопійовану формулу плагіна у властивість кнопки OnSelect .
4. Зіставте кожен вхідний параметр Value з посиланням на відповідні елементи керування входом:
   • Якби формула була Environment.new_CalculateSum({ X: Value, Y: Value });, її можна було б переписати так: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Якщо формула була зв’язана, замініть Environment її коротким ім’ям таблиці, щоб отримати доступ до модуля.
5. Якщо для low-code плагіна визначено вихідний параметр:
   1. Зафіксуйте відповідь у формулі Set() або UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Відобразити змінну в мітці. Крім того, можна скористатися формулою Notify() для відображення даних у сповіщенні.
6. Запустіть програму та виберіть команду на панелі команд, щоб запустити плагін із низьким кодом.

Докладніше про те, як викликати Dataverse дії безпосередньо в Power Fx програмах Canvas.

Виклик миттєвого плагіна з хмарного Power Automate потоку

1. У хмарному потоці додайте нову дію з конектора Microsoft Dataverse .
2. Виберіть дію під назвою Виконати необмежену дію або Виконати зв’язану дію.
3. Виберіть плагін (він має унікальну назву з префіксом).
4. Укажіть значення для всіх вхідних параметрів (якщо такі є).

Виклик миттєвого плагіна з Dataverse веб-API

Дотримуйтесь інструкцій для розділів Unbound action або Function bound to table у розділі Виклик користувацьких API з документації веб-API (залежно від відповідного обсягу плагіна).

Отримання довідки з low-code плагінів

Якщо у вас виникли проблеми зі створенням або запуском плагіна з низьким кодом, перегляньте ці поради, щоб дізнатися про поширені проблеми, які можуть виникнути: Microsoft Dataverse Low-code плагіни поради та відомі проблеми

Звернення до служби підтримки Help +

Якщо у вас виникли проблеми зі встановленням Dataverse рішення Accelerator або плагіни з низьким кодом, про які не йдеться в Microsoft Dataverse порадах щодо плагінів із низьким кодом, а також у відомих проблемах, як-от отримані незадокументовані помилки, скористайтеся службою підтримки Help+, указавши таку інформацію:

• Тип проблеми-веб-API Dataverse та SDK
• Підтип проблеми - Комплект прискорювачів для Dataverse

Приклади плагінів з низьким кодом, які можна створити

Щоб переглянути кілька прикладів того, як створити low-code плагін, перейдіть до розділу Приклади Dataverse low-code плагінів (попередній перегляд)

Обмеження

• Об’єкт мови середовища потрібно повторно додати, щоб отримати доступ до нових плагінів у наявних програмах полотна. Для будь-яких плагінів, створених після додавання таблиці середовища джерело даних до наявної програми полотна, потрібно видалити та повторно додати Power Fx об’єкт мови середовища. Після цього ви побачите оновлений список плагінів як дії.

• Intellisense вимагає явних позначень в автоматизованих плагінах, якщо ви хочете посилатися на будь-які таблиці у формулі. Використовуйте наступний синтаксис неоднозначності, наприклад [@Accounts], використовуйте квадратні дужки та @ символ (не Accounts).

• Вкладена підтримка. Плагіни можуть викликати лише основні дії, опубліковані корпорацією Майкрософт, із Power Fx виразів.

• Деякі Collect сценарії вимагають Patch. Є деякі сценарії, коли Collect() це не працює. Щоб обійти цю проблему, слід використовувати Patch() , як показано у наведеному нижче прикладі заповнення стовпчика. Якщо ви створюєте автоматичний плагін, додайте символ @ до кожної таблиці, на яку посилається формула Power Fx .

  Patch(Faxes,
      Collect(Faxes, { Subject : "Sub1" } ),
      { Regarding : First(Accounts) }
  )
  

• Коли low-code плагіни взаємодіють з конекторами і використовується DLP, адміністратор може заблокувати створення з’єднань за допомогою DLP. Однак існуючі посилання на з’єднання в Dataverse середовищі продовжують функціонувати. Якщо адміністратору потрібно заблокувати всі low-code взаємодії плагінів з будь-якими конекторами, він може вимкнути налаштування Allowconnectorsonpowerfxactions організації. Цей параметр увімкнено за замовчуванням і може бути вимкнено звичайними методами SDK (WebAPI, SDK, PowerShell тощо). Ви можете вимкнути цю функцію за допомогою плагіна миттєвого запуску з низьким кодом наступним чином:

  Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
  

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

Low-code плагіни, які мають обмеження користувацьких конекторів

Якщо у вас є low-code плагіни з кастомними з’єднувачами, їх потрібно імпортувати спочатку, а не посилання на з’єднання або потоки.

Якщо ваше середовище не містить настроюваного з’єднувача в рішенні, імпортуйте окреме рішення, яке містить лише користувацький з’єднувач. Виконайте цей імпорт перед імпортом фактичного рішення. Спочатку це потрібно зробити, оскільки Azure має зареєструвати настроюваний з’єднувач, перш ніж можна буде імпортувати інші компоненти рішення.

Якщо ви імпортуєте рішення, яке містить спеціальні з’єднувачі та потоки, Azure не зможе зареєструвати спеціальний з’єднувач під час реєстрації посилань або потоків підключення. Це також стосується посилань на підключення для спеціального з’єднувача, який раніше не імпортувався в окремому рішенні. Якщо Azure не зареєстрував ваш настроюваний з’єднувач, імпорт не вдасться, або ви не зможете розпочати імпорт.

Додаткові відомості: Створення власних з’єднувачів у рішеннях: відомі обмеження

Див. також

Low-code плагіни Power Fx (попередній перегляд)

Використання готового запиту в Dataverse low-code плагіні Power Apps