Žemo kodo priedų Dataverse naudojimas (peržiūra)
[Ši tema yra negalutinio leidimo dokumentacija ir gali keistis.]
Microsoft Dataverse siūlo galingą sprendimą, kaip pasiekti efektyvesnę duomenų architektūrą ir sumažinti kliento darbo krūvį naudojant žemo kodo papildinius. Šie papildiniai yra daugkartinio naudojimo, realaus laiko darbo eigos, kurios vykdo tam tikrą komandų Dataverse rinkinį, veikia serverio pusėje ir kurias suaktyvina suasmeninti įvykių tvarkytojai.
Svarbu
- Momentiniai žemo kodo papildiniai yra nuvertinami ir nėra pristatomi kaip funkcija. Momentiniai žemo kodo papildiniai pakeičiami funkcijomis. Daugiau informacijos: Funkcijos ( Microsoft Dataverse peržiūra)
- Tai yra peržiūros versijos funkcija.
- Peržiūros funkcijos nėra skirtos naudoti gamybai ir gali būti apribotas jų funkcionalumas. Šias funkcijas galima naudoti prieš oficialų išleidimą, kad klientai galėtų gauti ankstyvą prieigą ir pateikti atsiliepimų.
Tradiciškai papildiniai buvo kuriami kaip pasirinktinės klasės, sukompiliuotos į .NET Framework rinkinį, kuris vėliau buvo įkeltas ir užregistruotas Dataverse. Tačiau įdiegę žemo kodo papildinius, vartotojai gali sukurti šiuos įvykių tvarkytojus su minimaliu kodavimu arba be jo ir nereikalaujant rankinio registravimo.
Žemo kodo papildiniai yra saugomi Dataverse duomenų bazėje ir gali būti sklandžiai integruoti į Power Apps ir Power Automate. Darbo eigos veikimas apibrėžiamas naudojant Power Fx išraiškos kalbą ir gali tiesiogiai susisiekti su Dataverse verslo duomenimis ir išoriniais duomenų šaltiniais per Power Platform jungtis. Naudodami mažai kodo reikalaujančius papildinius, kūrėjai gali greitai kurti sudėtingas darbo eigas su minimaliomis kodavimo žiniomis, todėl duomenų architektūra yra paprastesnė ir efektyvesnė.
Serverio logikos pranašumai
Serverio verslo logikos apibrėžimas suteikia keletą privalumų, įskaitant:
- Padidintas saugumas. Kadangi serverio logika vykdoma serveryje, ji gali padėti išvengti neteisėtos prieigos prie slaptų duomenų ar procesų.
- Pagerintas našumas. Vykdant serveryje, verslo logika gali sumažinti duomenų, kuriuos reikia perkelti tarp kliento ir serverio, kiekį, todėl apdorojimo laikas bus greitesnis.
- Nuoseklumas ir patikimumas. Serverio logika užtikrina, kad veiklos taisyklės būtų nuosekliai taikomos visiems klientams, sumažinant klaidų ar neatitikimų riziką.
- Lengvesnė priežiūra ir atnaujinimai. Centralizavus verslo logiką serveryje, tampa lengviau prižiūrėti ir atnaujinti, nes pakeitimus galima atlikti vienoje vietoje, o ne atnaujinti kelis klientus.
- Mastelio keitimas. Serverio logiką galima keisti lengviau nei kliento logiką, todėl galima geriau veikti ir valdyti didesnius darbo krūvius.
Žemo kodo papildiniai
Palaikomi Dataverse dviejų tipų žemo kodo papildiniai:
Tipas | Paleidiklis | Palaiko parametrus | Palaikoma aprėptis |
---|---|---|---|
Momentiniai | Paleisti rankiniu būdu | Taip | Visuotinis ir stalas |
Automatizuoti | Dataverse stalo įvykis | No | Table |
Visi žemo kodo papildiniai turi šias bendras savybes:
Ypatybė | Aprašą |
---|---|
Rodomas vardas | Žmogui suprantamas papildinio pavadinimas. Sukūrus negalima pakeisti. |
Pavadinimą | Vidinis papildinio pavadinimas. Platforma jį naudoja kodo ir duomenų bazės operacijų komponentui identifikuoti. Sukūrus negalima pakeisti. |
Aprašą | Naudojamas papildomam kontekstui apie priedą (tikslui, veikimui ar kitai svarbiai informacijai pateikti). |
Sprendimas | Naudojamas komponentams grupuoti ir eksportuoti į kitas aplinkas. Sužinokite daugiau apie sprendimus. |
Išraiška | Tai pasirinktinė funkcija, kurią galima naudoti veiksmams arba skaičiavimams atlikti, apibrėžta naudojant Power Fx išraiškos kalbą. Power Fx yra formulės kalba, naudojama Power Apps drobės programose ir buvo išplėsta, kad būtų naudojama žemo kodo papildiniuose. Daugiau informacijos rasitepalaikomose funkcijose. |
Momentinis mažo kodo papildinys yra pasirinktinė kodo logika, kurią rankiniu būdu suaktyvina vartotojas. Galima naudoti pasirinktinius įvesties ir išvesties parametrus.
Unikalios savybės:
Ypatybė | Aprašą |
---|---|
Scope | Naudojamas priedui susieti su konkrečia lentele. Jis gali būti nustatytas kaip lentelė (rodoma kaip objektas) arba visuotinė, kur lentelės (objekto) aprėptis reiškia, kad priedas suaktyvinamas konkretaus lentelės įrašo kontekste, o visuotinė aprėptis reiškia, kad operacija nesusieta su lentele (sužinokite daugiau). |
Parametrai | Parametrai leidžia perduoti informaciją tarp papildinio ir jį vykdančio konteksto, todėl lengviau kurti verslo logiką, kurią galima pakartotinai naudoti įvairiose situacijose. Įvesties parametrai naudojami duomenims į papildinį teikti ir leidžia valdyti, kaip funkcija veikia perduodama skirtingas formulėje Power Fx nurodytas reikšmes. Išvesties parametrai leidžia nuskaityti funkcijos ar metodo rezultatus tolesniam naudojimui programoje. Palaikomi duomenų tipai:
|
Daugiau informacijos apie tai, kaip integruoti iš drobės programos arba Power Automate debesies sraute: Integruokite žemo kodo priedą
Priedų teisės
Projektavimo laikas
Kūrėjai, turintys sistemos pritaikymo specialisto arba sistemos administratoriaus saugos vaidmens narystę aplinkoje, Power Platform gali pasiekti visus tos aplinkos priedus. Pasirinktinius saugos vaidmenis galima naudoti norint apriboti prieigą prie žemo kodo priedų.
Vykdymo laikas
Kai iškviečiamas papildinys, jis pasiekia lentelės duomenis, susijusius su priedo aprašu (lentelėmis, kurios yra formulės dalis, arba jei lentelė susieta su automatinio papildinio nustatymais) vartotojo, kuris jį iškvietė, kontekste.
Ryšius
Naudojant saugos vaidmenis, priedų jungties prieiga gali būti apribota iki konkretaus jūsų organizacijos vartotojų rinkinio. Nurodykite, kurie vaidmenys turi kūrimo, skaitymo, naujinimo arba naikinimo teises.
Būtinos sąlygos norint sukurti žemo kodo priedą
- Sistemos administratoriaus arba sistemos pritaikymo specialisto saugos vaidmens narystė Power Platform aplinkoje.
- Prieiga prie Dataverse akceleratoriaus programėlės.
Arbatpinigiai
Visose naujose aplinkose akceleratoriaus programa automatiškai Dataverse įdiegta nuo 2023 m. spalio 1 d. Jei akceleratorius jau buvo Dataverse įdiegtas, akceleratorių galite atnaujinti Dataverse rankiniu būdu.
Atnaujinkite Dataverse akceleratorių
- Vadovaudamiesi instrukcijomis peržiūrėkite licencijuotas programas savo aplinkoje.
- Dataverse Jei spartintuvas jau įdiegtas ir yra naujinimas, jis nurodomas lentelėje šalia elemento.
- Pasirinkite Dataverse Spartintuvas, tada komandų juostoje pasirinkite Naujinti .
Arbatpinigiai
Įgalinkite automatinius programų naujinimus , skirtus "Microsoft" – "Power CAT" leidėjui, kad jie automatiškai gautų naujinimus, kai jie pasiekiami (nebūtina naujoms aplinkoms, sukurtoms po 2023 m. spalio 1 d.).
Pastaba.
Jei anksčiau įdiegėte pasirenkamą mažo kodo jungčių papildinių sprendimą, jis bus automatiškai panaikintas, kai atnaujinsite po 29 m. birželio 2023 d. Galimybės bus prieinamos pagrindiniame sprendime.
Akimirksniu sukurkite mažai kodo reikalaujantį priedą
- Paleiskite spartintuvo Dataverse programą.
-
Pasirinkite Sukurti momentinę papildinio kortelę.
- Pateikite rodomą vardą.
- Pasirinktinai apibrėžkite parametrus:
- Pasirinkite Naujas įvesties parametras arba Naujas išvesties parametras, tada įveskite etiketę ir duomenų tipą.
- Jei reikia, pridėkite daugiau įvesties ir išvesties parametrų.
- Įveskite Power Fx išraišką reiškinio rengyklėje .
- Nurodykite įvesties parametrus formulėje pagal etiketės pavadinimą.
- Išvesties parametrai turi būti nurodyti garbanotų skliaustų viduje, pvz.
{ Out: "Return value" }
- Nuorodų Dataverse lentelės, kuriose naudojamos duomenų rinkimo funkcijos, pvz., Filter() ir LookUp().
- Jei aprėptis nustatyta kaip objektas, naudokite
ThisRecord
norėdami pasiekti stulpelių reikšmes lentelės eilutėje, susietoje su priedo paleidimu, pvz.,ThisRecord.'Account Name'
Arbatpinigiai
Atkreipkite dėmesį į inteligentiją lauke Išraiška . Pabraukta raudona spalva negalioja. Vingiuota geltona reiškia, kad jūsų logikai gali turėti įtakos delegavimo apribojimai. Išvenkite delegavimo problemų naudodami perduodamas funkcijas.
- Pasirinktinai išplėskite išplėstines parinktis , kad modifikuotumėte sprendimą , aprėptį arbaaprašą .
- Pasirinkite Įrašyti.
- Išbandykite momentinį žemo kodo papildinį.
Pavyzdys: apskaičiuokite dviejų sveikųjų skaičių sumą.
- Sukurkite du įvesties parametrus
X
irY
(abu sveikojo skaičiaus tipai)Z
ir vieną išvesties parametrą (tipo eilutę). - Naudokite šią formulę:
{Z: X + Y }
Automatinio žemo kodo priedo kūrimas
- Paleiskite spartintuvo Dataverse programą.
-
Pasirinkite Sukurti automatinę priedo kortelę.
- Pateikite šias reikšmes:
- Pavadinimas: įveskite priedo pavadinimą, pvz., Įvesties tikrinimas.
- Lentelė: pasirinkite lentelę, su kuria norite susieti priedą, pvz., Paskyra.
- Vykdykite šią priedo taisyklę, kai eilutė yra. Nurodykite duomenų įvykį, kuris iškviečia priedą.
- Įveskite Power Fx išraišką reiškinio rengyklėje .
- Nuorodų Dataverse lentelės, kuriose naudojamos duomenų rinkimo funkcijos, pvz., Filter() ir LookUp().
- Naudokite
ThisRecord
norėdami pasiekti stulpelių reikšmes lentelės eilutėje, susietoje su priedo paleidimu, pvz.ThisRecord.'Account Name'
- Pasirinktinai išplėskite Išplėstinės parinktys , kad pakeistumėte etapą (kai jis turėtų būti paleistas) ir sprendimą , kuriame papildinys yra išsaugotas.
- Pasirinkite Įrašyti.
- Išbandykite automatinį žemo kodo papildinį.
Jungčių naudojimas Power Platform žemo kodo papildiniuose
Power Platform jungtys gali būti naudojamos žemo kodo papildiniuose, kad būtų galima lengvai integruoti duomenis ir funkcijas iš sistemų, esančių už jos ribų Dataverse, pvz., "SQL Server", "Salesforce", ir SharePoint nereikalaujant sudėtingo kodavimo ar pasirinktinio kūrimo.
Būtinosios sąlygos norint naudoti jungtis mažai kodo reikalaujančiuose papildiniuose
- Būtinos sąlygos norint sukurti žemo kodo priedą
- Ryšio nuoroda su aktyviu ryšiu.
Jungties veiksmų naudojimas mažai kodo reikalaujančiuose prieduose
Galite lengvai naudoti jungtis ir pasirinktines jungtis iš mažo kodo priedo formulėje . Power Fx
- Sukurkite ryšį su jungtimi, kurią norite naudoti.
- Įtraukite ryšio nuorodą į ryšį Dataverse aplinkoje.
- Žemo kodo priedo Power Fx išraiškos rengyklėje įveskite ryšio nuorodos pavadinimą (vidinis pavadinimas su priešdėliu ir pabraukimu, pvz.,
new_connectorName
ne rodomas pavadinimas). - "Intellisense" rodo galimus veiksmus. Pasirinkite norimą veiksmą ir įveskite reikiamus parametrus.
Prieš naudodami jungtį mažo kodo priede, peržiūrėkite jungties dokumentaciją , kad įsitikintumėte, jog teisingai perduodate įvesties ir išvesties parametrus.
Daugiau informacijos: pavyzdys
Pastaba.
- Šiuo metu palaikomi ne visi jungties veiksmai.
- Nenaudokite Dataverse jungties norėdami prisijungti prie Dataverse lentelių iš priedo išraiškos. Vietoj to naudokite savąsias Power Fx funkcijas, kad galėtumėte sąveikauti su rinkiniais: Filtruoti, Ieškoti, Peržvelgti, Pataisyti, Rinkti ir Nustatyti, kur stulpeliai laikomi visuotiniais kintamaisiais.
Žemo kodo priedo tikrinimas
Išbandykite momentinius papildinius
Pagrindiniame ekrane iš sąrašo pasirinkite momentinį papildinį, tada komandų juostoje pasirinkite Testuoti . Taip pat galite patekti į šį ekraną iš momentinio papildinio rengyklės komandų juostoje, kai jis bus išsaugotas.
Pateikite visų įvesties parametrų, apibrėžtų žemo kodo priede, reikšmes, tada pasirinkite Vykdyti.
Stebėkite atsakymą.
Arbatpinigiai
Naudokite išvesties parametrus, kad padėtumėte patikrinti numatomą elgseną ir rezultatus. Priešingu atveju sėkmę ar nesėkmę matote tik bandydami.
Automatinių papildinių testavimas
Patikrinkite automatinius priedus iškviesdami duomenų įvykį. Stebėkite, ar papildinys sėkmingai veikė, tikrindami numatomus pakeitimus, kurie buvo apibrėžti formulėje.
Arbatpinigiai
Peržiūros metu galite iškviesti susietą duomenų įvykį naudodami lentelės rengyklę Power Apps:
- Prisijunkite Power Apps, eikite į Lentelės ir pasirinkite priedo lentelę.
- Komandų juostoje pasirinkite Redaguoti.
- Kurkite, naujinkite arba naikinkite eilutes tiesiai iš šio rodinio. Arba atidarykite eilutę numatytoje formoje pasirinkdami eilutę, tada komandų juostoje pasirinkite Redaguoti eilutę naudojant formą .
Žemo kodo priedo integravimas
Momentinio priedo iškvietimas iš drobės programos arba pasirinktinio puslapio
- Programėlėje Dataverse "Accelerator" :
- Sąraše pasirinkite momentinį priedą.
- pasirinkti Kopijuoti kodo fragmentą komandų juostoje.
- Įklijuokite ir išsaugokite nukopijuotą formulę teksto rengyklėje arba užrašų knygelėje (kur galite lengvai grįžti).
- Į Power Apps:
- Sukurkite arba redaguokite drobės programą (arba pasirinktinį puslapį) Power Apps studijoje.
- Kairiojoje naršymo srityje, skirtuke Duomenų šaltiniai , pasirinkite + Naujas duomenų šaltinis ir jungtyje ieškokite parinkties Aplinka Dataverse .
- Į drobę įterpkite šiuos komponentus:
- Pridėkite įvesties valdiklius, atitinkančius kiekvieno parametro duomenų tipą, pvz., teksto įvestis tekstui arba skaičiams, perjunkite bulio logiką.
- Jei priedo aprėptis susieta su lentele, įtraukite pasirinktinio įvedimo laukelį, susietą su ta pačia lentele, kad galėtumėte pasirinkti įvestį.
- Pridėkite mygtuką , kad iškviestumėte priedą.
- Įklijuokite nukopijuotą priedo formulę į mygtuko
OnSelect
ypatybę. - Susiekite kiekvieną įvesties parametrą
Value
, kad nurodytumėte atitinkamus įvesties valdiklius:- Jei formulė buvo
Environment.new_CalculateSum({ X: Value, Y: Value });
, ją galima perrašyti taip:Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
- Jei formulė buvo susieta, pakeiskite
Environment
lentelės rodomu pavadinimu, kad pasiektumėte priedą.
- Jei formulė buvo
- Jei nustatytas mažo kodo priedo išvesties parametras:
- Užfiksuokite atsakymą a
Set()
arbaUpdateContext()
formulėje:Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );
... Rodyti kintamąjį etiketėje. Arba naudokite formulę,Notify()
kad pranešime būtų rodomi duomenys.
- Užfiksuokite atsakymą a
- Paleiskite programą ir komandų juostoje pasirinkite komandą, kad paleistumėte žemo kodo papildinį.
Sužinokite daugiau, kaip galite skambinti Dataverse veiksmais tiesiai iš Power Fx drobės programų.
Momentinio priedo iškvietimas iš Power Automate debesies srauto
- Debesies sraute pridėkite naują veiksmą iš Microsoft Dataverse jungties.
- Pasirinkite veiksmą, pavadintą Atlikti nesusietąjį veiksmą arba Atlikti susietąjį veiksmą.
- Pasirinkite papildinį (jis turi unikalų pavadinimą su priešdėliu).
- Pateikite visų įvesties parametrų (jei tokių yra) reikšmes.
Momentinio priedo iškvietimas iš Dataverse žiniatinklio API
Atlikite veiksmus Nesusietas veiksmas arba Funkcija, susieta su lentele , esančiuose skyriuose Pasirinktinių API iškvietimas iš žiniatinklio API dokumentacijos (atsižvelgiant į atitinkamą priedo aprėptį).
Kaip gauti pagalbos dėl mažai kodo reikalaujančių priedų
Jei kyla problemų kuriant arba paleidžiant žemo kodo priedą, peržiūrėkite šiuos patarimus, kaip išspręsti dažniausiai pasitaikančias problemas: Microsoft Dataverse žemo kodo priedų patarimai ir žinomos problemos
Susisiekimas su pagalba + palaikymo komanda
Jei kyla problemų dėl spartintuvo Dataverse sprendimo diegimo arba žemo kodo priedų, neįtrauktų į žemo kodo priedų patarimus, Microsoft Dataverse ir žinomų problemų, pvz., gautų nedokumentuotų klaidų, naudokite žinyno + palaikymo patirtį ir įtraukite šią informaciją:
- Problemos tipo žiniatinklio Dataverse API ir SDK
- Problemos potipis- greitintuvo rinkinys, skirtas Dataverse
Mažo kodo priedų, kuriuos galite sukurti, pavyzdžiai
Norėdami gauti keletą pavyzdžių, kaip sukurti žemo kodo priedą, eikite į Žemo kodo priedų pavyzdys Dataverse (peržiūra)
Apribojimai
Aplinkos kalbos objektą reikia perskaityti, kad būtų galima pasiekti naujus papildinius esamose drobės programose. Jei naudojate visus priedus, sukurtus įtraukus aplinkos lentelės duomenų šaltinį į esamą drobės programą, turite pašalinti ir perskaityti Power Fx aplinkos kalbos objektą. Tada matote atnaujintą papildinių sąrašą kaip veiksmus.
"Intellisense" reikalauja aiškaus žymėjimo automatiniuose papildiniuose, jei norite nurodyti bet kurias formulės lenteles. Naudokite šią maskavimo sintaksę, pvz.,
[@Accounts]
laužtiniuose skliaustuose ir simbolį@
(neAccounts
).Įdėtasis palaikymas. Papildiniai iš išraiškų gali iškviesti tik "Microsoft" Power Fx publikuotus pirmosios šalies veiksmus.
Kai kurie
Collect
scenarijai reikalaujaPatch
. Yra keletas scenarijų, kaiCollect()
neveikia. Sprendimo būdas yra naudotiPatch()
, kaip parodyta toliau pateiktame stulpelio užpildymas pavyzdyje. Jei kuriate automatinį priedą, prie kiekvienos formulėje Power Fx nurodytos lentelės pridėkite @.Patch(Faxes, Collect(Faxes, { Subject : "Sub1" } ), { Regarding : First(Accounts) } )
Kai žemo kodo papildiniai sąveikauja su jungtimis ir naudojamas DLP, administratorius gali blokuoti ryšių kūrimą naudodamas DLP. Tačiau esamos ryšio nuorodos Dataverse aplinkoje ir toliau veikia. Jei administratoriui reikia blokuoti visas žemo kodo papildinio sąveikas su bet kokiomis jungtimis, jis gali išjungti organizacijos parametrą
Allowconnectorsonpowerfxactions
. Šis nustatymas įjungtas pagal numatytuosius nustatymus ir gali būti išjungtas įprastais SDK metodais (WebAPI, SDK, PowerShell ir pan.). Tai galite išjungti naudodami žemo kodo momentinį papildinį taip:Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
Papildiniai, naudojantys jungtis, gali išvesti rezultatus tik iš konkrečių laukų. Dėl šios priežasties turite susieti konkrečias primityvias vertes nuo jungties atsako iki išvesties verčių.
Žemo kodo papildiniai, turintys pasirinktinių jungčių apribojimą
Jei turite žemo kodo papildinius su pasirinktinėmis jungtimis, prieš prijungiant nuorodas ar srautus, pirmiausia reikia importuoti pasirinktines jungtis.
Jei jūsų aplinkoje nėra pasirinktinės jungties sprendime, importuokite atskirą sprendimą, kuriame yra tik pasirinktinė jungtis. Atlikite šį importavimą prieš importuodami faktinį sprendimą. Pirmiausia turite tai padaryti, nes "Azure" turi užregistruoti pasirinktinę jungtį, kad būtų galima importuoti kitus sprendimo komponentus.
Jei importuojate sprendimą, kuriame yra pasirinktinių jungčių ir srautų, "Azure" negalės užregistruoti pasirinktinės jungties, kol registruos jūsų ryšio nuorodas arba srautus. Tai taip pat taikoma pasirinktinės jungties, kuri anksčiau nebuvo importuota kaip atskiras sprendimas, ryšio nuorodoms. Jei "Azure" neužregistravo jūsų pasirinktinės jungties, importuoti nepavyksta arba negalite pradėti importavimo.
Daugiau informacijos: Pasirinktinių jungčių kūrimas sprendimuose: Žinomi apribojimai
Taip pat žr.
Žemo kodo priedai Power Fx (peržiūra)
Iš anksto sukurto raginimo Dataverse naudojimas mažo kodo papildinyje Power Apps
Automatinio žemo kodo priedo kūrimas naudojant Power Apps (vaizdo įrašas)
Akimirksniu sukurkite žemo kodo priedą su Power Apps (vaizdo įrašas)