Використовуйте плагіни з низьким кодом ( Dataverse попередній перегляд)

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

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

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

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

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

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

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

Low-code плагіни

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

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

Дозволи на підключення

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

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

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

Створення миттєвого плагіна з низьким вмістом коду

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

   Порада

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

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

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

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

Створення автоматизованого плагіна з низьким вмістом коду

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

Використання Power Platform конекторів у плагінах з низьким кодом

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

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

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

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

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

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

Додаткова інформація: приклад

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

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

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

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

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

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

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

Інтегруйте плагін з низьким вмістом коду

Виклик миттєвого плагіна з програми 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. Якщо для плагіна з низьким кодом визначено вихідний параметр:
   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 або Function bound to table у розділі Виклик користувацьких API з документації веб-API (залежно від відповідного обсягу плагіна).

Отримання допомоги з плагінами з низьким вмістом коду

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

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

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

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

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

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

Обмеження

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

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

• Вкладена підтримка. Компоненти plug-in можуть викликати лише основні дії, опубліковані Microsoft із Power Fx виразів.

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

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

• Коли low-code плагіни взаємодіють з конекторами і використовується DLP, адміністратор може заблокувати створення з'єднань за допомогою DLP. Однак існуючі посилання на Dataverse з'єднання в середовищі продовжують функціонувати. У випадку, якщо адміністратору потрібно заблокувати всі взаємодії плагінів з низьким кодом з будь-якими конекторами, вони можуть відключити налаштування 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 не зареєстрував ваш настроюваний з'єднувач, імпорт не вдасться виконати, або ви не зможете розпочати імпорт.

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

Див. також

Плагіни Power Fx з низьким кодом (попередній перегляд)

Використання готового запиту в плагіні Dataverse з низьким кодом Power Apps

Створення автоматизованого плагіна з низьким вмістом коду за допомогою Power Apps (відео)

Створення миттєвого плагіна з низьким вмістом коду за допомогою Power Apps (відео)