Bendrinti naudojant

Naudokite bazinės programavimo žinios papildinius Dataverse (peržiūros versija)

  • Straipsnis

[Š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 bazinės programavimo žinios 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

  • 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, sudarytos į .NET Framework rinkinį, kuris vėliau buvo įkeltas ir užregistruotas Dataverse. Tačiau įdiegę bazinės programavimo žinios papildinius, vartotojai gali sukurti šiuos įvykių tvarkytojus su minimaliu kodavimu arba be jo ir nereikalaujant rankinio registravimo.

Bazinės programavimo žinios 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 bazinės programavimo žinios 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ą.
  • Lengvesnis 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.

Bazinės programavimo žinios papildiniai

Palaikomi Dataverse dviejų tipų bazinės programavimo žinios papildiniai:

Tipas Paleidiklis Palaiko parametrus Palaikoma aprėptis
Momentiniai Paleisti rankiniu būdu Taip Visuotinis ir stalas
Automatizuoti Dataverse stalo įvykis No Table

Visi bazinės programavimo žinios 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 ją būtų galima naudoti bazinės programavimo žinios papildiniuose. Daugiau informacijos rasitepalaikomose funkcijose.

Momentinis bazinės programavimo žinios papildinys yra tinkinta kodo logika, kurią vartotojas suaktyvina rankiniu būdu. 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:
  • Bulio logikos
  • String
  • Float
  • Dešimtainis skaičius
  • Data ir laikas
  • Integer

Daugiau informacijos apie tai, kaip integruoti iš drobės programos arba a Power Automate debesies srautas: bazinės programavimo žinios priedo integravimas

Priedų teisės

Projektavimo laikas

Kūrėjai, turintys sistemos tinkintojas arba sistemos administratoriaus saugos vaidmuo narystę aplinkoje, Power Platform gali pasiekti visus tos aplinkos priedus. Pasirinktinius saugos vaidmenis galima naudoti norint apriboti prieigą prie bazinės programavimo žinios 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ūtinosios sąlygos norint sukurti bazinės programavimo žinios papildinį

  • Sistemos administratorius arba sistemos tinkintojas saugos vaidmuo 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ų

  1. Vadovaudamiesi instrukcijomis peržiūrėkite licencijuotas programas savo aplinkoje.
  2. Dataverse Jei spartintuvas jau įdiegtas ir yra naujinimas, jis nurodomas lentelėje šalia elemento.
  3. 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ą bazinės programavimo žinios jungčių papildinių sprendimą, jis bus automatiškai panaikintas, kai atnaujinsite po 29 m. birželio 2023 d. Galimybės bus prieinamos pagrindiniame sprendime.

Momentinio bazinės programavimo žinios priedo kūrimas

  1. Paleiskite spartintuvo Dataverse programą.
  2. Pasirinkite Sukurti momentinį papildinį kortelė. Sukurkite momentinius papildinių kortelė
  3. Pateikite rodomą vardą.
  4. 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ų.
  5. Į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.

  6. Pasirinktinai išplėskite išplėstines parinktis , kad modifikuotumėte sprendimą , aprėptį arbaaprašą .
  7. Pasirinkite Įrašyti.
  8. Išbandykite momentinį bazinės programavimo žinios priedą.

Pavyzdys: apskaičiuokite dviejų sveikųjų skaičių sumą.

  • Sukurkite du įvesties parametrus X ir Y (abu sveikojo skaičiaus tipai) Z ir vieną išvesties parametrą (tipo eilutę).
  • Naudokite šią formulę: {Z: X + Y }

Momentinio įskiepio pavyzdys Dataverse programoje

Automatinio bazinės programavimo žinios priedo kūrimas

  1. Paleiskite spartintuvo Dataverse programą.
  2. Pasirinkite Sukurti automatinį papildinį kortelė. Automatinių papildinių kortelė kūrimas
  3. 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ą.
  4. Į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'
  5. 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.
  6. Pasirinkite Įrašyti.
  7. Išbandykite automatinį bazinės programavimo žinios papildinį.

Jungčių naudojimas Power Platform bazinės programavimo žinios papildiniuose

Power Platform jungtys gali būti naudojamos bazinės programavimo žinios 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 bazinės programavimo žinios papildiniuose

Jungties veiksmų naudojimas bazinės programavimo žinios papildiniuose

Galite lengvai naudoti jungtis ir pasirinktines jungtis iš bazinės programavimo žinios formulės Power Fx priedo.

  1. Sukurkite ryšį su jungtimi, kurią norite naudoti.
  2. Įtraukite ryšio nuoroda į ryšį Dataverse aplinkoje.
  3. Bazinės programavimo žinios priedo Power Fx išraiškos rengyklėje įveskite ryšio nuoroda pavadinimą (vidinį pavadinimą su priešdėliu ir pabraukimu, pvz., new_connectorName ne rodomą pavadinimą).
  4. "Intellisense" rodo galimus veiksmus. Pasirinkite norimą veiksmą ir įveskite reikiamus parametrus.

Prieš naudodami jungtį bazinės programavimo žinios 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.

Bazinės programavimo žinios priedo tikrinimas

Išbandykite momentinius papildinius

  1. 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. Pasirinkite Tikrinti bazinės programavimo žinios priedą

  2. Pateikite visų įvesties parametrų, apibrėžtų bazinės programavimo žinios priede, reikšmes, tada pasirinkite Vykdyti. Pasirinkite Vykdyti bazinės programavimo žinios kad patikrintumėte priedą

Laikykitės atsakymas.

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 versija metu galite iškviesti susietą duomenų įvykį naudodami lentelės rengyklę Power Apps:

  1. prisijunkite Power Apps, eikite į Lentelės ir pasirinkite papildinių lentelę.
  2. Komandų juostoje pasirinkite Redaguoti.
  3. Kurkite, naujinkite arba naikinkite eilutes tiesiai iš šio rodinio. Arba atidarykite eilutę numatytoje formoje pasirinkdami eilutę, tada komandų juostoje pasirinkite Redaguoti eilutę naudojant formą .

Bazinės programavimo žinios priedo integravimas

Momentinio priedo iškvietimas iš drobės programos arba pasirinktinio puslapio

  1. Programėlėje Dataverse "Accelerator" :
    1. Sąraše pasirinkite momentinį priedą.
    2. Pasirinkite Kopijuoti kodo fragmentas komandų juostoje. Egzemplioriaus bazinės programavimo žinios priedo iškvietimas
    3. Įklijuokite ir išsaugokite nukopijuotą formulę teksto rengyklėje arba užrašų knygelėje (kur galite lengvai grįžti).
  2. Į Power Apps:
    1. Sukurkite arba redaguokite drobės programą (arba pasirinktinį puslapį) Power Apps studijoje.
    2. Kairiojoje naršymo srityje, skirtuke Duomenų šaltiniai , pasirinkite + Naujas duomenų šaltinis ir jungtyje ieškokite parinkties Aplinka Dataverse .
    3. Į drobę įterpkite šiuos komponentus:
    • Pridėkite įvesties valdiklius, atitinkančius kiekvieno parametro duomenų tipą, pvz., teksto įvestis tekstui arba skaičiams, perjunkite Bulio logikos.
    • Jei priedo aprėptis susieta su lentele, įtraukite pasirinktinio įvedimo dėžutę, susietą su ta pačia lentele, kad galėtumėte pasirinkti įvestį.
    • Pridėkite mygtuką , kad iškviestumėte priedą.
  3. Įklijuokite nukopijuotą priedo formulę į mygtuko OnSelect ypatybę.
  4. 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ą.
  5. Jei nustatytas bazinės programavimo žinios papildinio išvesties parametras:
    1. Užfiksuokite atsakymas a arba Set() formulėje UpdateContext() : 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.
  6. Paleiskite programą ir komandų juostoje pasirinkite komandą, kad paleistumėte bazinės programavimo žinios papildinį.

Sužinokite daugiau, kaip galite skambinti Dataverse veiksmais tiesiai iš Power Fx drobės programų.

Iškvieskite momentinį priedą iš a Power Automate debesies srautas

  1. Į debesies srautas įtraukite naują veiksmą iš Microsoft Dataverse jungties.
  2. Pasirinkite veiksmą, pavadintą Atlikti nesusietąjį veiksmą arba Atlikti susietąjį veiksmą.
  3. Pasirinkite papildinį (jis turi unikalų pavadinimą su priešdėliu).
  4. 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į).

Su priedais susijusios pagalbos gavimas bazinės programavimo žinios

Jei kyla problemų kuriant arba paleidžiant bazinės programavimo žinios priedą, peržiūrėkite šiuos patarimus, kaip išspręsti dažniausiai pasitaikančias problemas: Microsoft Dataverse bazinės programavimo žinios papildinių patarimai ir žinomos problemos

Susisiekimas su pagalba + palaikymo komanda

Jei kyla problemų dėl spartintuvo Dataverse sprendimo diegimo arba bazinės programavimo žinios papildinių Microsoft Dataverse bazinės programavimo žinios papildinių patarimų 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

Papildinių bazinės programavimo žinios kuriuos galite sukurti, pavyzdys

Norėdami gauti kelis pavyzdžius, kaip sukurti bazinės programavimo žinios priedą, eikite į Pavyzdys Dataverse bazinės programavimo žinios papildiniai (peržiūros versija)

Apribojimai

  • Aplinkos kalbos objektą reikia perskaityti, kad būtų galima pasiekti naujus papildinius esamose drobės programose. Jei naudojate visus papildinius, sukurtus įtraukus aplinkos lentelės duomenų šaltinis į 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į @ (ne Accounts).

  • Įdėtasis palaikymas. Papildiniai iš išraiškų gali iškviesti tik "Microsoft" Power Fx publikuotus pirmosios šalies veiksmus.

  • Kai kurie Collect scenarijai reikalauja Patch. Yra keletas scenarijų, kai Collect() neveikia. Sprendimo būdas yra naudoti Patch() , 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 bazinės programavimo žinios 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 bazinės programavimo žinios papildinio sąveikas su bet kuriomis 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 bazinės programavimo žinios 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 reikšmes iš jungties atsakymas į išvesties reikšmes.

Bazinės programavimo žinios papildiniai, turintys pasirinktinių jungčių apribojimą

Jei turite bazinės programavimo žinios 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.

bazinės programavimo žinios papildiniai Power Fx (peržiūros versija)

Naudokite iš anksto sukurtą raginimą bazinės programavimo žinios Dataverse papildinyje Power Apps