Използване на плъгини Dataverse с нисък код (предварителен преглед)

[Тази тема е предварителна версия на документацията и подлежи на промяна.]

Microsoft Dataverse предлага мощно решение за постигане на по-ефективна архитектура на данните и намаляване на натоварването от страна на клиента чрез плъгини с нисък код. Тези добавки са работни потоци в реално време за многократна употреба, които изпълняват определен набор от команди в Dataverse рамките им, изпълняват се от страна на сървъра и се задействат от персонализирани манипулатори на събития.

Традиционно плъгините се създават като персонализирани класове, компилирани в .NET Framework асембъл, които след това се качват и регистрират в него Dataverse. Въпреки това, с въвеждането на плъгини с нисък код, потребителите могат да създават тези манипулатори на събития с минимално или никакво кодиране и без необходимост от ръчна регистрация.

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

Предимства на логиката от страна на сървъра

Дефинирането на бизнес логика от страна на сървъра предлага няколко предимства, включително:

• Повишена сигурност. Тъй като логиката от страна на сървъра се изпълнява на сървъра, тя може да помогне за предотвратяване на неоторизиран достъп до чувствителни данни или процеси.
• Подобрена производителност. Чрез изпълнение на сървъра, бизнес логиката може да намали количеството данни, които трябва да бъдат прехвърлени между клиента и сървъра, което води до по-бързо време за обработка.
• Последователност и надеждност. Логиката от страна на сървъра гарантира, че бизнес правилата се прилагат последователно за всички клиенти, намалявайки риска от грешки или несъответствия.
• По-лесна поддръжка и надстройки. Чрез централизиране на бизнес логиката на сървъра става по-лесно да се поддържа и актуализира, тъй като промените могат да се правят на едно място, вместо да се налага да се актуализират множество клиенти.
• Мащабируемост. Логиката от страна на сървъра може да се мащабира по-лесно от логиката от страна на клиента, което позволява по-добра производителност и обработка на по-големи работни натоварвания.

Плъгини с нисък код

Има два типа добавки с нисък код, поддържани в Dataverse:

Всички добавки с нисък код имат следните общи свойства:

Разрешения за добавки

Предпоставки за създаване на плъгин с нисък код

Актуализирайте 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 конекторите могат да се използват в плъгини с нисък код за лесно интегриране на данни и функционалност от системи извън Dataverse тях, като SQL Server, Salesforce, и SharePoint без необходимост от сложно кодиране или персонализирана разработка.

Предпоставки за използване на конектори в плъгини с нисък код

Използване на действия на конектора в приставки с нисък код

Можете лесно да използвате конектори и персонализирани конектори от формула за добавка Power Fx с нисък код.

1. Създайте връзка към конектора, който искате да използвате.
2. Добавете препратка Dataverse към връзката в средата.
3. В редактора на изрази на добавката Power Fx с нисък код въведете името на препратката към връзката (вътрешното име с префикс и долна черта, например new_connectorName, а не показваното име).
4. Intellisense ви показва наличните действия. Изберете желаното действие и след това въведете необходимите параметри.

Преди да използвате конектор в добавка с нисък код, прегледайте документацията на конектора, за да се уверите, че предавате правилно входните и изходните параметри.

Повече информация: пример

Тестване на плъгин с нисък код

Тествайте незабавни плъгини

1. От началния екран изберете незабавен плъгин от списъка, след което изберете Тест в командната лента. Можете също да стигнете до този екран от редактора на незабавни добавки в командната лента, след като бъде запазен.

2. Предоставете стойности за всички входни параметри, които са дефинирани в добавката с нисък код, и след това изберете Изпълни.

Наблюдавайте отговора.

Тествайте автоматизирани плъгини

Тествайте автоматизирани добавки, като извикате събитието с данни. Наблюдавайте дали добавката се изпълнява успешно, като проверите очакваните промени, които са дефинирани във формулата.

Интегриране на плъгин с нисък код

Извикване на незабавна добавка от приложение за платно или персонализирана страница

1. В Dataverse приложението Accelerator :
   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 приложения за платно.

Извикване на незабавна добавка от облачен Power Automate поток

1. В облачен поток добавете ново действие от конектора Microsoft Dataverse .
2. Изберете действието, наречено Извършване на необвързано действие или Извършване на обвързано действие.
3. Изберете вашия плъгин (той има уникалното име с префикс).
4. Посочете стойности за всички входни параметри (ако има такива).

Извикване на незабавна добавка от Dataverse уеб API

Следвайте стъпките за секции Необвързано действие или Функция, обвързана с таблица в Извикване на персонализирани API от документацията на уеб API (в зависимост от подходящия обхват на добавката).

Получаване на помощ за приставките с нисък код

Ако срещнете проблеми при създаването или стартирането на приставката с нисък код, прегледайте тези съвети за често срещани проблеми, които могат да възникнат: Microsoft Dataverse съвети за приставки с нисък код и известни проблеми

Свързване с Помощ + поддръжка

За проблеми с инсталирането на Dataverse решението за ускорител или добавки с нисък код, които не са обхванати от Microsoft Dataverse съветите за добавки с нисък код, и известни проблеми, като например получени недокументирани грешки, използвайте поддръжката на Помощ + и включете следната информация:

• Тип проблем - Dataverse Web API и SDK
• Подтип на задачата- Комплект ускорител за Dataverse

Примерни плъгини с нисък код, които можете да създадете

За няколко примера как да създадете добавка с нисък код отидете на Примерни Dataverse приставки с нисък код (предварителен преглед)

Ограничения

• Обектът на езика на средата трябва да бъде добавен отново за достъп до нови добавки в съществуващите приложения за платно. За всички добавки, създадени, след като сте добавили източника на данни на таблицата на средата към съществуващо приложение за платно, трябва да премахнете и добавите отново обекта на езика Power Fx на средата. След това ще видите актуализирания списък с добавки като действия.

• Intellisense изисква изрична нотация в автоматизирани добавки, ако искате да препратите към някоя от таблиците във формулата. Използвайте следния синтаксис за пояснения, като например [@Accounts] използване на квадратни скоби и символа @ (не Accounts).

• Вложена опора. Добавките могат да извикват само собствени действия, публикувани от Microsoft от изрази на Power Fx.

• Някои Collect сценарии изискват Patch. Има някои сценарии, при които Collect() не работи. Заобиколното решение е да се използва Patch() , както е показано в примера за попълване на колоната по отношение по-долу. Ако създавате автоматична добавка, добавете @ към всяка таблица, посочена във формулата Power Fx .

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

• Когато приставките с нисък код взаимодействат с конектори и се използва 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 })
  

• Добавките, които използват конектори, могат да извеждат резултати само от определени полета. Поради това трябва да съпоставите конкретни примитивни стойности от отговора на конектора към изходните стойности.

Плъгини с нисък код, които имат ограничение на персонализирани конектори

Ако имате добавки с нисък код с персонализирани конектори, персонализираните конектори трябва да бъдат импортирани първо, преди препратки към връзки или потоци.

Ако вашата среда не съдържа персонализирания конектор в решение, импортирайте отделно решение, което включва само персонализирания конектор. Направете това импортиране, преди да импортирате действителното решение. Първо трябва да направите това, защото Azure трябва да регистрира персонализирания конектор, преди другите компоненти на решението да могат да бъдат импортирани.

Ако импортирате решение, което съдържа персонализирани конектори и потоци, Azure не може да регистрира персонализирания конектор, докато регистрира вашите препратки или потоци на връзката. Това важи и за препратки към връзки за персонализирания конектор, който преди това не е бил импортиран в отделно решение. Ако Azure не е регистрирал вашия персонализиран конектор, импортирането е неуспешно или не можете да стартирате импортирането.

Повече информация: Създаване на персонализирани конектори в решения: Известни ограничения

Вижте също

Плъгини Power Fx с нисък код (преглед)

Използване на предварително изградена подкана в Dataverse добавка с нисък код Power Apps

Създайте автоматизиран плъгин с нисък код с Power Apps (видео)

Създайте незабавен плъгин Power Apps с нисък код с(видео)