Jagamisviis:

Vähese koodiga lisandmoodulite kasutamine ( Dataverse eelvaade)

[See teema on väljalaske-eelne dokumentatsioon ja seda võidakse muuta.]

Microsoft Dataverse pakub võimsat lahendust tõhusama andmearhitektuuri saavutamiseks ja kliendipoolse töökoormuse vähendamiseks vähese koodiga lisandmoodulite abil. Need pistikprogrammid on korduvkasutatavad reaalajas töövood, mis täidavad kindlat käskude Dataverse komplekti, töötavad serveripoolselt ja käivitavad isikupärastatud sündmuseohjurid.

Oluline

  • Kohesed vähese koodiga lisandmoodulid on prioriteetideta ja neid ei pakuta funktsioonina. Kohesed vähese koodiga pistikprogrammid asendatakse funktsioonidega. Lisateave: Funktsioonid ( Microsoft Dataverse eelvaade)
  • See on eelvaate funktsioon.
  • Eelvaatefunktsioonid ei ole mõeldud kasutamiseks tootmises ja nende funktsioonid võivad olla piiratud. Need funktsioonid on saadaval enne ametlikku väljastamist, et kliendid saaksid sellele varakult juurdepääsu ja võiksid tagasisidet anda.

Traditsiooniliselt loodi pistikprogrammid kohandatud klassidena, mis kompileeriti .NET Frameworki koostu, mis seejärel üles laaditi ja registreeriti Dataverse. Kuid vähese koodiga lisandmoodulite kasutuselevõtuga saavad kasutajad luua need sündmuseohjurid minimaalse kodeerimisega või ilma kodeerimiseta ja ilma käsitsi registreerimiseta.

Vähese koodiga lisandmoodulid salvestatakse Dataverse andmebaasi ja neid saab sujuvalt integreerida ja Power Apps Power Automate. Töövoo käitumine määratletakse avaldise keele abil Power Fx ja see saab konnektorite kaudu Dataverse otse äriandmete ja väliste andmeallikatega ühenduse luua Power Platform . Vähese koodiga lisandmoodulite abil saavad tegijad kiiresti luua keerulisi töövooge minimaalsete kodeerimisteadmistega, mille tulemuseks on sujuvam ja tõhusam andmearhitektuur.

Serveripoolse loogika eelised

Serveripoolse äriloogika määratlemine pakub mitmeid eeliseid, sealhulgas:

  • Suurenenud turvalisus. Kuna serveripoolne loogika töötab serveris, võib see aidata vältida volitamata juurdepääsu tundlikele andmetele või protsessidele.
  • Parem jõudlus. Serveris käivitades võib äriloogika vähendada kliendi ja serveri vahel edastatavate andmete hulka, mille tulemuseks on kiirem töötlemisaeg.
  • Järjepidevus ja töökindlus. Serveripoolne loogika tagab, et ärireegleid rakendatakse järjepidevalt kõigis klientides, vähendades vigade või vastuolude ohtu.
  • Lihtsam hooldus ja uuendamine. Äriloogika tsentraliseerimisega serverisse muutub selle hooldamine ja värskendamine lihtsamaks, kuna muudatusi saab teha ühes kohas, selle asemel, et uuendada mitut klienti.
  • Skaleeritavus. Serveripoolset loogikat saab hõlpsamini skaleerida kui kliendipoolset loogikat, võimaldades paremat jõudlust ja suuremate töökoormuste käsitlemist.

Vähese koodiga lisandmoodulid

Vähese koodiga lisandmooduleid toetatakse Dataverse kahte tüüpi.

Tüüp Päästik Toetab parameetreid Toetatud ulatus
Kiir Käsitsi käivitamine Ja Globaalne ja tabel
Automatiseeritud Dataverse Laua üritus No Table

Kõigil vähese koodiga lisandmoodulitel on järgmised ühised omadused.

Atribuut Kirjeldus
Kuvatav nimi Lisandmooduli inimloetav nimi. Ei saa pärast loomist muuta.
Nimetus Lisandmooduli sisemine nimi. Platvorm kasutab seda komponendi tuvastamiseks koodi- ja andmebaasitoimingutes. Ei saa pärast loomist muuta.
Kirjeldus Kasutatakse lisandmooduli kohta täiendava konteksti pakkumiseks (eesmärk, käitumine või muud olulised üksikasjad).
Lahendus Kasutatakse komponentide rühmitamiseks ja teistesse keskkondadesse eksportimiseks. Lisateave lahenduste kohta.
Avaldis See on kohandatud funktsioon, mida saab kasutada toimingute või arvutuste tegemiseks, mis on määratletud avaldise keele abil Power Fx . Power Fx on lõuendirakendustes Power Apps kasutatav valemikeel ja seda on laiendatud vähese koodiga lisandmoodulites. Lisateabe saamiseks vaadake toetatudfunktsioone.

Kohene vähese koodiga lisandmoodul on kohandatud koodiloogika, mille kasutaja käivitab käsitsi. Kasutada saab kohandatud sisend- ja väljundparameetreid.

Unikaalsed omadused:

Atribuut Kirjeldus
Scope Kasutatakse lisandmooduli seostamiseks kindla tabeliga. Selle saab määrata kas tabelile (kuvatakse olemina) või globaalsele, kus tabeli (olemi) ulatus tähendab, et lisandmoodul käivitatakse konkreetse tabelikirje kontekstis ja globaalne ulatus tähendab, et toiming pole tabeliga seostatud (lisateave).
Parameetrid Parameetrid võimaldavad teil edastada teavet pistikprogrammi ja seda käitava konteksti vahel, muutes lihtsamaks äriloogika kujundamise, mida saab erinevates olukordades uuesti kasutada.

Sisendparameetreid kasutatakse lisandmoodulile andmete edastamiseks ja need võimaldavad teil kontrollida, kuidas funktsioon käitub, edastades valemis määratud Power Fx erinevaid väärtusi.

Väljundparameetrid võimaldavad teil funktsiooni või meetodi tulemusi oma programmis edasiseks kasutamiseks hankida.

Toetatud andmetüübid:
  • loogiline
  • String
  • Float
  • Klahv Decimal
  • DateTime
  • Integer

Lisateave selle kohta, kuidas integreerida lõuendirakendusest või Power Automate pilvevoost: Vähese koodiga lisandmooduli integreerimine

Pistikprogrammide õigused

Projekteerimise aeg

Tegijad, kellel on keskkonnas süsteemikohandaja või süsteemiadministraatori turberolli liikmelisus, Power Platform pääsevad juurde kõigile selle keskkonna lisandmoodulitele. Kohandatud turberolle saab kasutada vähese koodiga lisandmoodulitele juurdepääsu piiramiseks.

Tööaeg

Lisandmooduli käivitamisel pääseb see juurde lisandmooduli definitsiooniga seotud tabeliandmetele (tabelid, mis on valemi osaks või kui tabel on seotud automaatse lisandmooduli sätetega) selle käivitanud kasutaja kontekstis.

Ühendused

Turberollide abilsaab lisandmoodulite konnektori juurdepääsu piirata teie organisatsiooni kindla kasutajate rühmaga. Määrake, millistel rollidel on loomise, lugemise, värskendamise või kustutamise õigused.

Vähese koodiga lisandmooduli loomise eeltingimused

  • Süsteemiadministraatori Power Platform või süsteemikohandaja turberolli liikmelisus keskkonnas.
  • Juurdepääs kiirendirakendusele Dataverse .

Jootraha

Kõikidesse uutesse keskkondadesse on Dataverse kiirendirakendus automaatselt installitud alates 1. oktoobrist 2023. Kui kiirendi on Dataverse juba installitud, saate kiirendit Dataverse käsitsi värskendada.

Kiirendi värskendamine Dataverse

  1. Järgige juhiseid, et vaadata litsentsitud rakendusi oma keskkonnas.
  2. Kui Dataverse kiirendi on juba installitud ja värskendus on saadaval, on see näidatud üksuse kõrval olevas tabelis.
  3. Valige Dataverse Kiirendi ja seejärel käsuribal Värskenda .

Jootraha

Lubage Microsofti – Power CAT-i väljaandja jaoks automaatsed rakendusevärskendused , et need saaksid värskendusi automaatselt, kui need on saadaval (pole vajalik pärast 1. oktoobrit 2023 loodud uute keskkondade puhul).

Märkus.

Kui olete varem installinud valikulise konnektorite vähese koodiga lisandmoodulite lahenduse, kustutatakse see automaatselt, kui värskendate pärast 29. juunit 2023. Võimalused on saadaval põhilahenduses.

Kiire vähese koodiga lisandmooduli loomine

  1. Esitage kiirendirakendus. Dataverse
  2. Valige kaart Loo kohene lisandmoodul. Looge kohene pistikprogramm
  3. Sisestage kuvatav nimi.
  4. Soovi korral määratlege parameetrid:
    • Valige Uus sisendparameeter või Uus väljundparameeter, seejärel sisestage silt ja andmetüüp.
    • Lisage vajadusel rohkem sisend- ja väljundparameetreid.
  5. Sisestage avaldis Power Fx avaldise redaktorisse.
    • Viidata valemi sisendparameetritele sildi nime järgi.
    • Väljundparameetritele tuleb viidata lokkis sulgudes, näiteks { Out: "Return value" }.
    • Viitetabelid Dataverse , mis kasutavad andmekogumisfunktsioone (nt Filter() ja LookUp().
    • Kui ulatus on seatud olemile, kasutage seda ThisRecord lisandmooduli käitamisega seotud tabelirea veeruväärtustele juurdepääsuks, näiteks ThisRecord.'Account Name'.

    Jootraha

    Pange tähele väljal Avaldis olevat intellisense’i . Allajoonitud punane on kehtetu. Laineline kollane tähendab, et delegeerimispiirangud võivad teie loogikat mõjutada. Vältige delegeerimisprobleeme, kasutades delegeeritavaid funktsioone.

  6. Soovi korral laiendage valikut Täpsemad suvandid , et muuta lahendust , ulatust võikirjeldust .
  7. Valige käsk Salvesta.
  8. Testige oma kohest vähese koodiga lisandmoodulit.

Näide: arvutage kahe täisarvu summa.

  • Looge kaks sisendparameetrit X ja ( Y mõlemad täisarvu tüüpi) ja üks väljundparameeter, Z (tüüpstring).
  • Kasutage järgmist valemit: {Z: X + Y }

Kiirlisandmooduli näide kiirendi rakenduses Dataverse

Automaatse vähese koodiga lisandmooduli loomine

  1. Esitage kiirendirakendus. Dataverse
  2. Valige kaart Loo automaatne lisandmoodul. Automaatse lisandmooduli kaardi loomine
  3. Esitage järgmised väärtused.
    • Nimi: sisestage lisandmooduli nimi, näiteks Sisendi valideerimine.
    • Tabel: valige tabel, millega pistikprogramm seostada, näiteks Konto.
    • Käivitage see lisandmooduli reegel, kui rida on olemas. Määrake andmesündmus, mis käivitab lisandmooduli.
  4. Sisestage avaldis Power Fx avaldise redaktorisse.
    • Viitetabelid Dataverse , mis kasutavad andmekogumisfunktsioone (nt Filter() ja LookUp().
    • Kasutage ThisRecord lisandmooduli käitamisega seotud tabelirea veeruväärtustele juurdepääsemiseks, näiteks ThisRecord.'Account Name'.
  5. Soovi korral laiendage valikut Täpsemad suvandid , et muuta etappi (millal see peaks töötama) ja lahendust , kuhu lisandmoodul on salvestatud.
  6. Valige käsk Salvesta.
  7. Testige oma automaatset vähese koodiga lisandmoodulit.

Konnektorite kasutamine Power Platform vähese koodiga lisandmoodulites

Power Platform Konnektoreid saab kasutada vähese koodiga lisandmoodulites, et hõlpsasti integreerida andmeid ja funktsioone väljaspool asuvatest Dataverse süsteemidest, nagu SQL Server, Salesforce, ja SharePoint ilma keeruka kodeerimise või kohandatud arenduseta.

Konnektorite kasutamise eeltingimused vähese koodiga lisandmoodulites

Konnektoritoimingute kasutamine vähese koodiga lisandmoodulites

Konnektoreid ja kohandatud konnektoreid saate hõlpsalt kasutada vähese koodiga lisandmooduli Power Fx valemis.

  1. Looge ühendus konnektoriga, mida soovite kasutada.
  2. Lisage keskkonnas olevale ühendusele ühenduse viide Dataverse .
  3. Tippige vähese koodiga lisandmooduli Power Fx avaldiseredaktoris ühenduse viite nimi (sisemine nimi koos eesliite ja allkriipsuga, nt new_connectorName mitte kuvatav nimi).
  4. Intellisense näitab saadaolevaid toiminguid. Valige soovitud toiming ja sisestage vajalikud parameetrid.

Enne konnektori kasutamist vähese koodiga lisandmoodulis vaadake üle konnektori dokumentatsioon , et veenduda, et edastate sisend- ja väljundparameetrid õigesti.

Lisateave: näide

Märkus.

  • Kõiki konnektori toiminguid praegu ei toetata.
  • Ärge kasutage Dataverse konnektorit lisandmooduli avaldise kaudu tabelitega ühenduse loomiseks Dataverse . Selle asemel kasutage kogumitega suhtlemiseks natiivseid Power Fx funktsioone: Filter, Search, LookUp, Patch, Collect ja Set, kus veerge käsitletakse globaalsete muutujatena.

Vähese koodiga lisandmooduli testimine

Kiirlisandmoodulite testimine

  1. Valige avakuval loendist kiirpistikprogramm ja seejärel valige käsuribal Testi. Sellele ekraanile pääsete ka käsuriba kiirlisandmooduli redaktori kaudu pärast selle salvestamist. Valige vähese koodiga lisandmooduli jaoks Test

  2. Esitage vähese koodiga lisandmoodulis määratletud sisendparameetrite väärtused ja seejärel valige Käivita. Valige Käivita, et testida vähese koodiga lisandmoodulit

Jälgige vastust.

Jootraha

Kasutage väljundparameetreid eeldatava käitumise ja tulemuste valideerimiseks. Vastasel juhul näete testimisel ainult edu või ebaõnnestumist.

Automatiseeritud pistikprogrammide testimine

Testige automaatseid lisandmooduleid, käivitades andmesündmuse. Jälgige, kas lisandmoodul töötas edukalt, valideerides valemis määratletud oodatud muudatused.

Jootraha

Eelvaate ajal saate seotud andmesündmuse käivitada tabeliredaktori Power Apps abil:

  1. Logige sisse, Power Apps minge jaotisse Tabelid ja valige lisandmooduli tabel.
  2. Valige käsuribal käsk Redigeeri.
  3. Looge, värskendage või kustutage ridu otse sellest vaatest. Teise võimalusena avage rida vaikevormil, valides rea ja seejärel valige käsuribal Redigeeri rida vormi abil.

Vähese koodiga lisandmooduli integreerimine

Kiirlisandmooduli käivitamine lõuendirakendusest või kohandatud lehelt

  1. Kiirendi Dataverse rakenduses tehke järgmist.
    1. Valige loendist kiirpistikprogramm.
    2. Valige käsuribal Kopeeri koodilõik. Vähese koodiga lisandmooduli eksemplari käivitamine
    3. Kleepige ja salvestage kopeeritud valem tekstiredaktorisse või märkmikusse (kuhugi, kuhu saate hõlpsasti tagasi pöörduda).
  2. In: Power Apps
    1. Looge või redigeerige lõuendirakendust Power Apps (või kohandatud lehte) stuudios.
    2. Valige vasakpoolsel navigeerimispaanil vahekaardil Andmeallikad + Uus andmeallikas ja otsige konnektorist suvandit Keskkond . Dataverse
    3. Sisestage lõuendile järgmised komponendid:
    • Lisage sisendjuhtelemendid, mis vastavad iga parameetri andmetüübile (nt teksti või arvude tekstisisestus), kahendväärtuse lüliti .
    • Kui lisandmooduli ulatus on seotud tabeliga, lisage sama tabeliga seotud liitboks, et saaksite sisendi valida.
    • Lisage nupp pistikprogrammi kutsumiseks.
  3. Kleepige kopeeritud lisandmooduli valem nupu OnSelect atribuuti.
  4. Vastendage iga sisendparameeter, Value et viidata vastavatele sisendjuhtelementidele:
    • Kui valem oleks Environment.new_CalculateSum({ X: Value, Y: Value });, võiks selle ümber kirjutada järgmiselt: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Kui valem oli seotud, asendage Environment lisandmoodulile juurdepääsuks tabeli kuvatav nimi.
  5. Kui vähese koodiga lisandmooduli jaoks on määratletud väljundparameeter:
    1. Vastuse jäädvustamine valemis või Set()UpdateContext() valemis:. Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) ); Muutuja kuvamine sildil. Teise võimalusena võite kasutada Notify() valemit andmete kuvamiseks teatises.
  6. Esitage rakendus ja valige käsuribal käsk, et käivitada vähese koodiga lisandmoodul.

Vaadake lisateavet selle kohta, kuidas saate toiminguid otse Dataverse lõuendirakendustest Power Fx kutsuda.

Kiirlisandmooduli Power Automate käivitamine pilvevoost

  1. Lisage pilvevoos konnektorist uus toiming Microsoft Dataverse .
  2. Valige toiming nimega Köitmata toimingu tegemine või Seotud toimingu tegemine.
  3. Valige oma pistikprogramm (sellel on kordumatu nimi koos eesliitega).
  4. Esitage kõigi sisendparameetrite väärtused (kui neid on).

Käivitage veebi API-st kohene lisandmoodul Dataverse

Järgige jaotiste Sidumata toiming või Tabeliga seotud funktsioon juhiseid veebi-API dokumentatsiooni kohandatud API-de käivitamisel (olenevalt lisandmooduli sobivast ulatusest).

Abi saamine vähese koodiga lisandmoodulitega

Kui teil tekib vähese koodiga lisandmooduli loomisel või käitamisel probleeme, lugege neid näpunäiteid levinud probleemide kohta: Microsoft Dataverse vähese koodiga lisandmoodulite näpunäited ja teadaolevad probleemid

Abi + toega ühenduse võtmine

Kiirendilahenduse installimisega seotud Dataverse probleemide või vähese koodiga lisandmoodulite puhul, mida vähese Microsoft Dataverse koodiga lisandmoodulite näpunäited ja teadaolevad probleemid (nt saadud dokumenteerimata tõrked) kasutage, kasutage spikker + tugiteenust ja lisage järgmine teave.

  • Probleemi tüüp - Dataverse veebi API ja SDK
  • Probleemi alamtüüp - kiirendikomplekt Dataverse

Vähese koodiga lisandmoodulite näited, mida saate luua

Mõned näited vähese koodiga lisandmooduli loomise kohta leiate teemast Vähese koodiga lisandmoodulite näited Dataverse (eelvaade)

Piirangud

  • Keskkonna keeleobjekt tuleb uuesti lisada, et pääseda juurde uutele lisandmoodulitele olemasolevates lõuendirakendustes. Kõigi lisandmoodulite puhul, mis on loodud pärast keskkonnatabeli andmeallika lisamist olemasolevale lõuendirakendusele, peate keskkonna keeleobjekti eemaldama ja uuesti lisama Power Fx . Seejärel näete toimingutena lisandmoodulite värskendatud loendit.

  • Intellisense nõuab automaatsetes lisandmoodulites selgesõnalist tähistust, kui soovite valemis viidata mõnele tabelile. Kasutage järgmist täpsustussüntaksit, näiteks [@Accounts] nurksulgude ja sümboli @ (not) Accounts kasutamist.

  • Pesastatud tugi. Lisandmoodulid saavad avaldistest Power Fx kutsuda ainult Microsofti avaldatud esimese osapoole toiminguid.

  • Mõned Collect stsenaariumid nõuavad Patch. On stsenaariume, kus Collect() see ei tööta. Lahendus on kasutada Patch() nii, nagu on näidatud allolevas veeru täitmisega seotud näites. Kui loote automaatse lisandmooduli, lisage @ igale valemis viidatud Power Fx tabelile.

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

  • Kui vähese koodiga lisandmoodulid suhtlevad konnektoritega ja kasutatakse DLP-d, saab administraator blokeerida ühenduste loomise DLP abil. Keskkonnas olevad olemasolevad ühenduse viited Dataverse toimivad siiski edasi. Kui administraatoril on vaja blokeerida kõik vähese koodiga lisandmoodulite interaktsioonid mis tahes konnektoritega, saab ta organisatsiooni sätte Allowconnectorsonpowerfxactions keelata. See säte on vaikimisi lubatud ja selle saab keelata tavaliste SDK meetoditega (WebAPI, SDK, PowerShell jne). Saate selle keelata vähese koodiga kiirlisandmooduli abil järgmiselt.

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

  • Konnektoreid kasutavad lisandmoodulid saavad väljastada tulemusi ainult kindlatelt väljadelt. Seetõttu peate kaardistama konkreetsed primitiivsed väärtused konnektori vastusest väljundväärtustega.

Vähese koodiga lisandmoodulid, millel on kohandatud konnektorite piirang

Kui teil on kohandatud konnektoritega vähese koodiga lisandmoodulid, tuleb kohandatud konnektorid esmalt importida, enne ühenduse viiteid või vooge.

Kui teie keskkond ei sisalda lahenduses kohandatud konnektorit, importige eraldi lahendus, mis sisaldab ainult kohandatud konnektorit. Tehke see importimine enne tegeliku lahenduse importimist. Peate seda kõigepealt tegema, kuna Azure peab registreerima kohandatud konnektori enne muude lahenduse komponentide importimist.

Kui impordite lahenduse, mis sisaldab kohandatud konnektoreid ja vooge, ei saa Azure teie ühenduse viiteid või voogusid registreerimise ajal kohandatud konnektorit registreerida. See kehtib ka kohandatud konnektori ühendusviidete kohta, mida pole varem eraldi lahendusse imporditud. Kui Azure ei registreerinud teie kohandatud konnektorit, siis importimine nurjub või te ei saa importi alustada.

Lisateave: Kohandatud konnektorite loomine lahendustes: teadaolevad piirangud

Vaata ka

Vähese koodiga lisandmoodulid Power Fx (eelvaade)

Valmisviiba Dataverse kasutamine vähese koodiga lisandmoodulis Power Apps

Automaatse vähese koodiga lisandmooduli loomine ( Power Apps video)

Looge kohene vähese koodiga pistikprogramm ( Power Apps video)

  • Last updated on