Делите путем

Користи додатне компоненте ниског кода Dataverse (преглед)

  • Чланак

[Ова тема представља прелиминарну документацију и може се променити.]

Microsoft Dataverse нуди моћно решење за постизање ефикасније архитектуре података и смањење обима посла на страни клијента путем додатних компоненти ниског кода. Ове додатне компоненте су токови посла у реалном времену који извршавају одређени скуп команди унутар Dataverse, покрећу сервер на страни и активирају их персонализовани руковаоци догађајима.

Важно

  • Ово је функција прегледа.
  • Функције прегледа нису намењене за коришћење у производњи и могу да имају ограничене функционалности. Ове функције су доступне пре званичног објављивања како би клијенти могли раније да им приступе и пруже повратне информације.

Традиционално, додатне компоненте су креиране као прилагођене класе преведене у.НЕТ Фрамеwорк склоп, који су потом отпремљени и регистровани у оквиру Dataverse. Међутим, са увођењем додатних компоненти ниског кода, корисници могу да креирају ове руковаоце догађајима са минималним или никаквим кодирањем и без потребе за ручном регистрацијом.

Додатне компоненте ниског кода складиште се у бази података Dataverse и могу се беспрекорно интегрисати у Power Apps и Power Automate. Понашање тока посла је дефинисано помоћу језика израза Power Fx и може се директно повезати са пословним Dataverse подацима и спољним изворима података путем Power Platform линија спајања. Помоћу додатних компоненти ниског кода, произвођачи могу брзо да конструишу сложене токове посла са минималном експертизом кодирања, што резултира ефикаснијом и ефикаснијом архитектуром података.

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

Дефинисање пословне логике на страни сервера нуди неколико погодности, укључујући:

  • Повећана безбедност. Пошто се логика на страни сервера извршава на серверу, то може помоћи у спречавању неовлашћеног приступа осетљивим подацима или процесима.
  • Побољшане перформансе. Извршавањем на серверу, пословна логика може да смањи количину података које је потребно пренети између клијента и сервера, што резултира бржим временом обраде.
  • Доследност и поузданост. Логика на страни сервера обезбеђује да се пословна правила доследно примењују на свим клијентима, смањујући ризик од грешака или недоследности.
  • Лакше одржавање и надоградња. Централизацијом пословне логике на серверу постаје лакше одржавати и ажурирати, јер се промене могу извршити на једном месту, а не ажурирати више клијената.
  • Скалабилност. Логика на страни сервера може да се подеси лакше од логике на страни клијента, што омогућава боље перформансе и руковање већим обимом посла.

Додатне компоненте ниског кода

Подржана су два типа додатних компоненти ниског кода Dataverse:

Тип Окидач Подржава параметре Подржани опсег
Тренутни Ручно покретање Да Глобално и табела
Аутоматизовани Dataverse догађај табеле No Table

Све додатне компоненте ниског кода имају следећа заједничка својства:

Својство Опис
Име за приказ Људско читљиво име додатне компоненте. Није могло да се промени када се једном креира.
Именуј Интерно име додатне компоненте. Платформа га користи за идентификацију компоненте у операцијама кода и базе података. Није могло да се промени када се једном креира.
Опис Користи се за пружање додатног контекста о додатној компоненти (намени, понашању или другим важним детаљима).
Решење Користи се за груписање компоненти и извоз у друга окружења. Сазнајте више о решењима.
Expression Ово је прилагођена функција која се може користити за извршавање радњи или израчунавања, дефинисаних помоћу језика Power Fx израза. Power Fx је језик формуле који се користи у Power Apps апликацијама подлоге за цртање и проширен је тако да се користи у додатним компонентама ниског кода. Више детаља потражите у подржаним функцијама.

Тренутна додатна компонента ниског кода је прилагођена логика кода коју корисник ручно покреће. Могу се користити прилагођени улазни и излазни параметри.

Јединствена својства:

Својство Опис
Scope Користи се за повезивање додатне компоненте са одређеном табелом. Може се поставити на табелу (приказану као ентитет) или глобални, где опсег табеле (ентитета) значи да је додатна компонента активирана са контекстом одређеног записа табеле, а глобални опсег значи да операција није повезана са табелом (сазнајте више).
Параметри Параметри вам омогућавају да проследите информације између додатне компоненте и контекста који је покреће, што олакшава дизајнирање пословне логике која се може поново користити у различитим ситуацијама.

Улазни параметри се користе за обезбеђивање података додатној компоненти и омогућавају вам да контролишете како се функција понаша прослеђивањем различитих вредности које сте навели у формули Power Fx .

Излазни параметри вам омогућавају да преузмете резултате функције или метода за даљу употребу у програму.

Подржани типови података:
  • Логичка вредност
  • String
  • Број у покретном зарезу
  • Decimal
  • Датум/време
  • Integer

Више информација о интегрисању из апликације подлоге за цртање или у ток Power Automate облака:Интегрисати додатну компоненту ниског кода

Дозволе за додатне компоненте

Време дизајнирања

Произвођачи који имају алатку за прилагођавање система или администратора система < ДИЦТ__безбедносна улога > сецуритy роле </ДИЦТ__безбедносна улога > чланству у Power Platform окружењу могу да приступе свим додатним компонентама у том окружењу. Прилагођене безбедносне улоге могу да се користе за ограничавање приступа додатним компонентама ниског кода.

Време трчања

Када је додатна компонента позвана, она приступа подацима табеле укљученим у дефиницију додатне компоненте (табеле које су део формуле или ако је табела повезана са поставкама аутоматизоване додатне компоненте) у контексту корисника који ју је позвао.

Везе

Коришћењем безбедносних улога, приступ конектору унутар додатних компоненти може се ограничити на одређени скуп корисника унутар ваше организације. Наведите које улоге су креирале, читале, ажурирале или избрисале привилегије.

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

Напомена

Избацујемо скуп исправки да бисмо омогућили додатне компоненте Dataverse ниског кода. Ове додатне компоненте ниског кода користе кориснички интерфејс уграђен на функцији Power Platform прилагођених страница. Као део ових исправки примењујемо их у окружењима користећи налоге за одржавање система. У неким околностима ови рачуни су имали неочекивани нежељени ефекат представљања као разбијајући стаклени рачун. Радимо на томе да исправимо ово понашање што је пре могуће. У међувремену, следеће апликације могу да се појаве у Power Platform центру за администрацију:

  • Dataverse Апликација "Акцелератор" – < апликација вођена моделима >, креирана помоћу глобалног админ налога
  • Dataverse Радње паге - < цанвас апп > Ово је Прилагођена страница на којој је направљена додатна компонента ниског кода, креирана са корисничким именом повезаним са глобалним администратором налога.
  • Преглед странице -подлога < за цртање > Ово је прилагођена страница на којој је направљена додатна компонента ниског кода, креирана са корисничким именом повезаним са глобалним администратором налога.
  • Администратор система или програм за прилагођавање < ДИЦТ__безбедносна улога > сецуритy роле </ДИЦТ__безбедносна улога > чланство у окружењу Power Platform .
  • Приступ апликацији за Dataverse акцелератор.

Савет

Сва нова окружења имају аутоматски инсталирану Dataverse апликацију акцелератора од 1. октобра 2023. године. Ако сте већ инсталирали акцелератор Dataverse , можете ручно ажурирати акцелератор Dataverse .

Ажурирање акцелератора Dataverse

  1. Следите упутства да бисте приказали лиценциране апликације у окружењу.
  2. Ако је Dataverse акцелератор већ инсталиран и исправка доступна, она је назначена у табели поред ставке.
  3. Изаберите Dataverse акцелератор, а затим на командној траци изаберите ставку Ажурирај.

Савет

Омогућите аутоматско ажурирање апликација за Мицрософт - Поwер ЦАТ издавача да аутоматски прима исправке када су доступне (није неопходно за нова окружења креирана после 1. октобра 2023. године).

Напомена

Ако сте претходно инсталирали опционалне ниско-кодне додатне компоненте за цоннецторс решење, она ће бити аутоматски избрисана када ажурирате након 29. Могућности ће бити доступне у главном решењу.

Креирање тренутне додатне компоненте ниског кода

  1. Репродукујте апликацију Dataverse акцелератора.
  2. Изаберите картицу Креирање тренутне додатне компоненте . Креирање инстант додатне картице
  3. Обезбедите < ДИЦТ__име за приказ > Дисплаy наме</ДИЦТ__име за приказ >.
  4. Опционално, дефинишите параметре:
    • Изаберите нови улазни параметар или нови излазни параметар, а затим унесите ознаку и тип података.
    • По потреби додајте још улазних и излазних параметара.
  5. Унесите израз Power Fx у уређивач израза .
    • Референцирај улазне параметре у формули по имену ознаке.
    • На излазне параметре мора да се упућује унутар коврџавих заграда, као што је { Out: "Return value" }.
    • Референтне Dataverse табеле које користе функције прикупљања података, као што су Филтер() и ЛоокУп().
    • Ако је опсег подешен на ентитет, користите га за приступ ThisRecord вредностима колона у реду табеле повезаном са покретањем додатне компоненте, као што је ThisRecord.'Account Name'.

    Савет

    Занемарујте интелисенсе у пољу За израз. Подвучена црвена боја је неважећа. Шприца жута значи да на вашу логику могу утицати ограничења делегације. Избегавајте проблеме са делегирањем помоћу функција које се могу избрисати.

  6. Опционално развијте опције "Више опција" да бисте изменили решење ·, опсег или опис.
  7. Изаберите Сачувај.
  8. Тестирајте тренутну додатну компоненту ниског кода.

Пример : Израчунавање збира два цео број.

  • Креирајте два улазна параметра X и Y (оба типа цео број) и један излазни параметар( Z ниска типа).
  • Користите следећу формулу: {Z: X + Y }

Пример инстант додатне компоненте у апликацији Акцелератор Dataverse

Креирање аутоматизоване додатне компоненте ниског кода

  1. Репродукујте апликацију Dataverse акцелератора.
  2. Изаберите ставку Креирај аутоматизовану додатну картицу . Креирање аутоматизоване картице додатне компоненте
  3. Наведите следеће вредности:
    • Име : Унесите име за додатну компоненту, као што је провера ваљаности уноса.
    • Табела : Одаберите табелу у коју желите да повежете додатну компоненту, као што је "Налог ".
    • Покрените ово правило додатне компоненте када је ред у реду. Наведите догађај података који позива додатну компоненту.
  4. Унесите израз Power Fx у уређивач израза .
    • Референтне Dataverse табеле које користе функције прикупљања података, као што су Филтер() и ЛоокУп().
    • Користи ThisRecord се за приступ вредностима колона у реду табеле повезаном са покретањем додатне компоненте, као што је ThisRecord.'Account Name'.
  5. Опционално, развијте опције "Више опција " да бисте изменили  фазу(када би ово требало покренути) · и решење у којем је додатна компонента сачувана.
  6. Изаберите  Сачувај.
  7. Тестирајте аутоматизовану додатну компоненту ниског кода.

Коришћење Power Platform линија спајања у додатним компонентама ниског кода

Power Platform линије спајања се могу користити у додатним компонентама ниског кода да би се лако интегрисали подаци и функционалност из система изван, као што су СQЛ Сервер, Салесфорце и, Dataverse без потребе SharePoint за сложеним кодирањем или прилагођеним развојем.

Предуслови за коришћење линија спајања у додатним компонентама ниског кода

Коришћење радњи спајања у додатним компонентама ниског кода

Линије спајања и прилагођене линије спајања можете лако да користите из формуле додатне компоненте ниског кода Power Fx .

  1. Креирајте везу са линијом спајања коју желите да користите.
  2. Додајте референцу на везу у окружењу Dataverse .
  3. У уређивач израза Power Fx додатне компоненте ниског кода упишите име референце на везу (унутрашње име са префиксом и подвлака, као, new_connectorName а не < ДИЦТ__име за приказ > дисплаy наме </ДИЦТ__име за приказ >).
  4. Интеллисенсе вам приказује доступне радње. Изаберите жељену радњу, а затим унесите потребне параметре.

Пре коришћења линије спајања у додатној компоненти ниског кода, прегледајте документацију линије спајања ... да бисте се уверили да исправно прослеђивате улазне и излазне параметре.

Више информација: пример

Напомена

  • Тренутно нису подржане све радње спајања.
  • Немојте користити линију Dataverse спајања за повезивање са Dataverse табелама из израза додатне компоненте. Уместо тога, користите изворне Power Fx функције за интеракцију са колекцијама: Филтер,Претрага,Проналажење,Закрпа,Прикупљање ... и Скуп, где се колоне третирају као глобалне променљиве.

Тестирање додатне компоненте ниског кода

Тестирање тренутних додатних компоненти

  1. На почетном екрану изаберите тренутну додатну компоненту са листе, а затим на командној траци изаберите ставку Тестирај. До овог екрана можете доћи и из уређивача тренутних додатних компоненти на командној траци након што је сачуван. Изаберите тест за додатну компоненту ниског кода

  2. Наведите вредности за све улазне параметре који су дефинисани у додатној компоненти ниског кода, а затим изаберите Покрени. Изаберите опцију &quot;Покрени&quot; да бисте тестирали додатну компоненту ниског кода

Посматрајте одговор.

Савет

Користите излазне параметре да бисте проверили очекивано понашање и резултате. У супротном, приликом тестирања видите само успех или неуспех.

Тестирање аутоматизованих додатних компоненти

Тестирајте аутоматизоване додатне компоненте позивајући се на догађај са подацима. Посматрајте да ли је додатна компонента успешно ишчезла проверавањем очекиваних промена које су дефинисане у формули.

Савет

Током прегледа можете да позовете повезани догађај са подацима помоћу уређивача табеле у Power Apps:

  1. пријавите се Power Apps, идите у табеле · и изаберите табелу додатних компоненти .
  2. На командној траци изаберите Уреди.
  3. Креирајте, ажурирајте или избришите редове директно из овог приказа. Друга могућност је да отворите ред у подразумеваном обрасцу тако што ћете изабрати ред, а затим на командној траци изабрати ставку Уреди ред користећи образац.

Интегрисање додатне компоненте ниског кода

Позивање тренутне додатне компоненте из апликације подлоге за цртање или прилагођене странице

  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 је < ДИЦТ__име за приказ > дисплаy наме </ДИЦТ__име за приказ > да бисте приступили додатној компоненти.
  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 Wеб АПИ-ја

Следите кораке за радњу "Неповезано" или функцију повезане са одељцима табеле у прилагођеним АПИ-јевима позивања из Документације Wеб АПИ-ја (у зависности од одговарајућег опсега додатне компоненте).

Добијање помоћи за ниско-кодне додатне компоненте

Ако наиђете на проблеме приликом креирања или покретања додатне компоненте ниског кода, идите на ове савете за уобичајене проблеме до којих може доћи: Microsoft Dataverse савети за ниско-кодне додатне компоненте и познати проблеми

Контактирање помоћи + подршка

За проблеме са инсталацијом Dataverse решења акцелератора или додатним компонентама ниског кода које нису обухваћене Microsoft Dataverse саветима о додатним компонентама ниског кода и познатим проблемима, као што су примљене недокументоване грешке, користите помоћ + искуство подршке и укључите следеће информације:

  • Тип проблема-Wеб Dataverse АПИ и СДК
  • Подтип проблема- акцелератор за Dataverse

Пример додатних компоненти ниског кода које можете креирати

За неколико примера креирања додатне компоненте ниског кода погледајте пример додатних Dataverse компоненти ниског кода (преглед)

Ограничења

  • Објекат језика окружења треба поново додати да би се приступила новим додатним компонентама унутар постојећих апликација подлоге за цртање. За све додатне компоненте креиране након што додате < ДИЦТ__извор података > дата соурце </ДИЦТ__извор података > табеле окружења постојећој апликацији подлоге за цртање, морате да уклоните и прочитате објекат Power Fx језика окружења. Затим ћете ажурирану листу додатних компоненти видети као радње.

  • Интеллисенсе захтева експлицитно зачеће у аутоматизованим додатним компонентама ако желите да упутите табеле у формули. Користите следећу синтаксу дисамбигације као што је [@Accounts] коришћење квадратних заграда и @ симбола (не Accounts).

  • Угнежђена подршка. Додатне компоненте могу да позову само радње првог лица које мицрософт објављује из Power Fx израза.

  • Неки Collect сценарији захтевају Patch. Постоје неки сценарији где Collect() не функционише. Заобилазно решење треба да се користи као Patch() што је приказано у доленаведеном примеру колоне. Ако креирате аутоматизовану додатну компоненту, унапред је потребно @ за сваку табелу на коју се упућује у формули Power Fx .

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

  • Када додатне компоненте ниског кода имају интеракцију са конекторима и када је ДЛП упослен, администратор може да блокира креирање веза помоћу ДЛП-а. Међутим, постојеће референце на везу у окружењу Dataverse и даље функционишу. У случају да администратор треба да блокира све интеракције додатне компоненте ниског кода са било којом линијом спајања, оне могу да онемогуће поставку организације Allowconnectorsonpowerfxactions. Ова поставка је подразумевано омогућена и може се онемогућити уобичајеним СДК методама (WебАПИ, СДК, ПоwерСхелл и тако даље). Ово можете онемогућити помоћу тренутне додатне компоненте ниског кода на следећи начин:

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

  • Додатне компоненте које користе линије спајања могу да имају само излазне резултате из одређених поља. Због тога је потребно да мапирате одређене примитивне вредности из одговора линије спајања на излазне вредности.

Додатне компоненте ниског кода које имају ограничење прилагођених линија спајања

Ако имате додатне компоненте ниског кода са прилагођеним линијама спајања, прилагођене линије спајања прво морају да се увезу пре референци на везу или токова.

Ако ваше окружење не садржи прилагођену линију спајања у решењу, увезите засебно решење које укључује само прилагођену линију спајања. Урадите овај увоз пре него што увезете стварно решење. Ово прво морате да урадите јер Азуре мора да региструје прилагођену линију спајања да би остале компоненте решења могла да се увезе.

Ако увезете решење које садржи прилагођене линије спајања и токове, Азуре неће моћи да региструје прилагођену линију спајања док региструје референце или токове везе. Ово се односи и на референце на везу за прилагођену линију спајања која претходно није увезена у засебно решење. Ако Азуре није регистровао прилагођену линију спајања, увоз неће успети или нећете моћи да покренете увоз.

Више информација:Креирање прилагођених конектора у решењима: Позната ограничења

Погледајте и

Додатне компоненте ниског кода Power Fx (преглед)

Коришћење унапред изграђеног одзива у додатној Dataverse компоненти ниског кода Power Apps