Deli z drugimi prek

Uporabite vtičnike z malo programske kode v Dataverse (predogledna različica)

  • Članek

[Ta tema je namenjena predizdajni dokumentaciji in se lahko spremeni.]

Microsoft Dataverse ponuja zmogljivo rešitev za doseganje učinkovitejše podatkovne arhitekture in zmanjšanje delovne obremenitve na strani odjemalca prek vtičnikov z malo programske kode. Ti vtičniki so delovni tokovi v realnem času, ki jih je mogoče večkrat uporabiti in izvajajo določen nabor ukazov znotraj Dataverse, izvajajo se na strani strežnika in jih sprožijo prilagojeni obdelovalci dogodkov.

Pomembno

  • To je funkcija predogleda.
  • Poskusne funkcije niso za komercialno uporabo, njihovo delovanje je lahko omejeno. Te funkcije so na voljo še pred uradno izdajo, da lahko stranke predčasno dostopajo do njih in posredujejo povratne informacije.

Tradicionalno so bili vtičniki ustvarjeni kot razredi po meri, prevedeni v sklop .NET Framework, ki so bili nato naloženi in registrirani znotraj Dataverse. Z uvedbo vtičnikov z malo programske kode pa lahko uporabniki ustvarijo te obdelovalce dogodkov z minimalnim kodiranjem ali brez njega in brez potrebe po ročni registraciji.

Vtičniki z malo programske kode so shranjeni v Dataverse zbirki podatkov in jih je mogoče neopazno vključiti v Power Apps and Power Automate. Vedenje poteka dela je definirano z Power Fx izraznim jezikom in se lahko neposredno poveže s Dataverse poslovnimi podatki in zunanjimi viri podatkov prek Power Platform konektorjev. Z vtičniki z malo programske kode lahko izdelovalci hitro sestavijo zapletene poteke dela z minimalnim strokovnim znanjem kodiranja, kar ima za posledico bolj poenostavljeno in učinkovito podatkovno arhitekturo.

Prednosti logike na strani strežnika

Definiranje poslovne logike na strani strežnika nudi številne prednosti, vključno z:

  • Povečana varnost. Ker se logika na strani strežnika izvaja na strežniku, lahko pomaga preprečiti nepooblaščen dostop do občutljivih podatkov ali procesov.
  • Izboljšana zmogljivost. Z izvajanjem na strežniku lahko poslovna logika zmanjša količino podatkov, ki jih je treba prenesti med odjemalcem in strežnikom, kar povzroči hitrejše čase obdelave.
  • Doslednost in zanesljivost. Logika na strani strežnika zagotavlja, da se poslovna pravila dosledno uporabljajo pri vseh odjemalcih, kar zmanjšuje tveganje napak ali nedoslednosti.
  • Lažje vzdrževanje in nadgradnje. S centralizacijo poslovne logike na strežniku postane vzdrževanje in posodabljanje lažje, saj je mogoče spremembe narediti na enem mestu, namesto da bi bilo treba posodabljati več odjemalcev.
  • Razširljivost. Logiko na strani strežnika je mogoče lažje prilagoditi kot logiko na strani odjemalca, kar omogoča boljšo zmogljivost in obvladovanje večjih delovnih obremenitev.

Z malo programske kode vtičniki

V Dataverse sta podprti dve vrsti vtičnikov z malo programske kode:

Vnesi Sprožilnik Podpira parametre Podprt obseg
Takojšnje Ročno teči Da Globalno in namizno
Avtomatizirano Dataverse namizni dogodek No Table

Vsi vtičniki z malo programske kode imajo naslednje skupne lastnosti:

Lastnost Description
Prikazno ime Človeku berljivo ime vtičnika. Ko je ustvarjen, ga ni mogoče spremeniti.
Imenu Notranje ime vtičnika. Platforma ga uporablja za identifikacijo komponente v kodi in operacijah baze podatkov. Ko je ustvarjen, ga ni mogoče spremeniti.
Description Uporablja se za zagotovitev dodatnega konteksta o vtičniku (namen, vedenje ali druge pomembne podrobnosti).
Rešitev Uporablja se za združevanje komponent in izvoz v druga okolja. Izvedite več o rešitvah.
Expression To je funkcija po meri, ki jo je mogoče uporabiti za izvajanje dejanj ali izračunov, definiranih z Power Fx izraznim jezikom. Power Fx je jezik formule, ki se uporablja v Power Apps aplikacijah za platno in je bil razširjen za uporabo v vtičnikih z malo programske kode. Glejte podprte funkcije za več podrobnosti.

Takojšnji vtičnik z malo programske kode je logika kode po meri, ki jo ročno sproži uporabnik. Uporabite lahko vhodne in izhodne parametre po meri.

Edinstvene lastnosti:

Lastnost Description
Scope Uporablja se za povezavo vtičnika z določeno tabelo. Nastavite ga lahko na tabelo (prikazano kot entiteta) ali globalno, pri čemer obseg tabele (entitete) pomeni, da se vtičnik sproži s kontekstom določenega zapisa tabele, globalni obseg pa pomeni, da operacija ni povezana s tabelo (več o tem).
Parametri Parametri vam omogočajo posredovanje informacij med vtičnikom in kontekstom, ki ga izvaja, kar olajša oblikovanje poslovne logike, ki jo je mogoče ponovno uporabiti v različnih situacijah.

Vhodni parametri se uporabljajo za zagotavljanje podatkov vtičniku in vam omogočajo, da nadzirate, kako se funkcija obnaša s posredovanjem različnih vrednosti, ki jih določite v Power Fx formuli.

Izhodni parametri omogočajo, da pridobite rezultate funkcije ali metode za nadaljnjo uporabo v vašem programu.

Podprti tipi podatkov:
  • Logično
  • String
  • Float
  • Decimal
  • Datum/ura
  • Integer

Več informacij o integraciji iz aplikacije Canvas ali v Power Automate tok za oblak: Integrirajte vtičnik z malo programske kode

Dovoljenja za vtičnike

Čas oblikovanja

Izdelovalci, ki imajo prilagojevalec sistema ali sistemski skrbnik varnostna vloga članstvo v okolju, Power Platform lahko dostopajo do vseh vtičnikov v tem okolju. Varnostne vloge po meri lahko uporabite za omejitev dostopa do vtičnikov z malo programske kode.

Čas delovanja

Ko prikličete vtičnik, dostopa do podatkov tabele, ki so vključeni v definicijo vtičnika (tabele, ki so del formule, ali če je tabela povezana z nastavitvami avtomatiziranega vtičnika) v kontekstu uporabnika, ki ga je priklical.

Povezave

Z varnostnimi vlogami je dostop povezovalnika v vtičnikih mogoče omejiti na določen nabor uporabnikov v organizaciji. Določite, katere vloge imajo pravice za ustvarjanje, branje, posodabljanje ali brisanje.

Pogoji za ustvarjanje vtičnika z malo programske kode

Opomba

Uvajamo nabor posodobitev, ki omogočajo Dataverse vtičnike z malo programske kode. Ti vtičniki z malo programske kode uporabljajo uporabniški vmesnik, ki temelji na funkciji Power Platform strani po meri. Kot del teh posodobitev uvajamo v okolja z računi za vzdrževanje sistema. V nekaterih okoliščinah so imeli ti računi nepričakovan stranski učinek, saj so bili predstavljeni kot poročilo o razbitem steklu. Prizadevamo si, da bi to vedenje čim prej popravili. Medtem se lahko v skrbniškem središču Power Platform prikažejo te aplikacije:

  • Dataverse Aplikacija pospeševalnika – < aplikacija>, ki temelji na modelu, ki jo je ustvaril globalni skrbniški račun
  • Dataverse Stran z dejanji - < aplikacija> delovnega območja To je stran po meri, na kateri je zgrajen vtičnik z malo programske kode, ustvarjen z uporabniškim imenom, povezanim z računom globalnega skrbnika.
  • Stran s pregledom - < aplikacija> delovnega območja To je stran po meri, na kateri je zgrajen vtičnik z malo programske kode, ustvarjen z uporabniškim imenom, povezanim z računom globalnega skrbnika.
  • Sistemski skrbnik ali prilagojevalec sistema varnostna vloga članstvo Power Platform v okolju.
  • Dostop do Dataverse aplikacije pospeševalnika.

Nasvet

Vsa nova okolja imajo aplikacijo Dataverse pospeševalnika samodejno nameščeno od 1. oktobra 2023. Če ste že imeli Dataverse nameščen pospeševalnik, ga Dataverse lahko ročno posodobite.

Posodabljanje pospeševalnika Dataverse

  1. Sledite navodilom za ogled licenciranih aplikacij v vašem okolju.
  2. Če Dataverse je hitro opravilo že nameščeno in je na voljo posodobitev, je navedena v tabeli poleg elementa.
  3. Izberite Dataverse Hitro opravilo in nato v ukazni vrstici izberite Posodobi .

Nasvet

Omogočite samodejne posodobitve aplikacij za založnika Microsoft – Power CAT, da samodejno prejema posodobitve, ko so na voljo (ni potrebno za nova okolja, ustvarjena po 1. oktobru 2023).

Opomba

Če ste že namestili izbirno rešitev Vtičniki z malo kode za povezovalnike, bo samodejno izbrisana, ko posodobite po 29. juniju 2023. Zmogljivosti bodo na voljo v glavni rešitvi.

Ustvarite takojšnji vtičnik z malo programske kode

  1. Predvajajte aplikacijo Dataverse pospeševalnika.
  2. Izberite kartico Ustvari takojšnji vtičnik . Ustvarjanje takojšnje kartice vtičnika
  3. Navedite prikazno ime.
  4. Po želji določite parametre:
    • Izberite Nov vhodni parameter ali Nov izhodni parameter, nato vnesite oznako in podatkovni tip.
    • Po potrebi dodajte več vhodnih in izhodnih parametrov.
  5. Vnesite Power Fx izraz v Izraz urejevalnik.
    • Sklicevanje na vhodne parametre v formuli z imenom oznake.
    • Izhodni parametri se morajo sklicevati znotraj zavitih oklepajev, kot npr { Out: "Return value" }.
    • Referenčne Dataverse tabele z uporabo funkcij za zbiranje podatkov, kot sta Filter() in LookUp().
    • Če je obseg nastavljen na entiteto, uporabite ThisRecord za dostop do vrednosti stolpca v vrstici tabele, povezane z izvajanjem vtičnika, kot npr ThisRecord.'Account Name'.

    Nasvet

    Upoštevajte intellisense v polju Expression . Podčrtano rdeče ni veljavno. Vijugasta rumena pomeni, da na vašo logiko morda vplivajo omejitve pooblastil. Izognite se težavam z delegiranjem z uporabo prenosljivih funkcij.

  6. Po želji razširite Napredne možnosti za spreminjanje rešitve, obseg ali opis.
  7. Izberite Shrani.
  8. Preizkusite svoj takojšnji vtičnik z malo programske kode.

Primer: Izračunajte vsoto dveh celih števil.

  • Ustvarite dva vhodna parametra, X in Y (oba tipa celo število) in en izhodni parameter, Z (tip niza).
  • Uporabite naslednjo formulo: {Z: X + Y }

Primer takojšnjega vtičnika v aplikaciji Dataverse Accelerator

Ustvarite samodejni vtičnik z malo programske kode

  1. Predvajajte aplikacijo Dataverse pospeševalnika.
  2. Izberite Ustvari samodejni vtičnik kartica. Ustvari samodejni vtičnik kartica
  3. Podajte naslednje vrednosti:
    • Ime: Vnesite ime za vtičnik, na primer Preverjanje vnosa.
    • Tabela: Izberite tabelo, s katero želite povezati vtičnik, na primer Račun.
    • Zaženite to pravilo vtičnika, ko je vrstica. Podajte podatkovni dogodek, ki prikliče vtičnik.
  4. Vnesite Power Fx izraz v Izraz urejevalnik.
    • Referenčne Dataverse tabele z uporabo funkcij za zbiranje podatkov, kot sta Filter() in LookUp().
    • Uporabite ThisRecord za dostop do vrednosti stolpca v vrstici tabele, ki je povezana z izvajanjem vtičnika, na primer ThisRecord.'Account Name'.
  5. Po želji razširite Napredne možnosti , da spremenite stopnjo (kdaj naj se to izvaja) in rešitev kje je shranjen vtičnik.
  6. Izberite  Shrani.
  7. Preizkusite svoj samodejni z malo programske kode vtičnik.

Uporabite Power Platform konektorje v z malo programske kode vtičnikih

Power Platform konektorje je mogoče uporabiti v vtičnikih z malo programske kode za enostavno integracijo podatkov in funkcionalnosti iz sistemov zunaj Dataverse, kot so SQL Server, Salesforce in SharePoint, brez potrebe po kompleksnem kodiranju ali razvoj po meri.

Predpogoji za uporabo konektorjev v z malo programske kode vtičnikih

Uporaba dejanj povezovalnika v vtičnikih z malo programske kode

Z lahkoto lahko uporabite konektorje in konektorje po meri v vtičniku z malo programske kode a Power Fx formula.

  1. Ustvarite povezavo s priključkom, ki ga želite uporabiti.
  2. Dodajte sklic na povezavo povezavi v Dataverse okolju.
  3. V urejevalnik izrazov vtičnika z malo programske kode Power Fx vnesite ime sklic na povezavo (notranje ime s predpono in podčrtajem, na primer new_connectorName, ne prikazno ime).
  4. Intellisense vam pokaže razpoložljiva dejanja. Izberite želeno dejanje in nato vnesite zahtevane parametre.

Preden uporabite konektor v vtičniku z malo programske kode, preglejte dokumentacijo konektorja da zagotovite, da pravilno posredujete vhodne in izhodne parametre.

Več informacij: primer

Opomba

  • Trenutno niso podprta vsa dejanja povezovalnika.
  • Ne uporabljajte konektorja Dataverse za povezavo z Dataverse tabelami iz izraza vtičnika. Namesto tega uporabite izvorne Power Fx funkcije za interakcijo z zbirkami: Filter, Search, LookUp, Patch, Collect in Set, kjer se stolpci obravnavajo kot globalne spremenljivke.

Preizkusite vtičnik z malo programske kode

Preizkusite takojšnje vtičnike

  1. Na začetnem zaslonu izberite takojšnji vtičnik s seznama, nato izberite Preskusi v ukazni vrstici. Do tega zaslona lahko pridete tudi iz takojšnjega urejevalnika vtičnikov v ukazni vrstici, potem ko je shranjen. Izberite Preizkus za vtičnik z malo programske kode

  2. Podajte vrednosti za vse vhodne parametre, ki so definirani v vtičniku z malo programske kode, in nato izberite Zaženi. Izberite Zaženi, da preizkusite vtičnik z malo programske kode

Upoštevajte odgovor.

Nasvet

Uporabite izhodne parametre za pomoč pri preverjanju pričakovanega vedenja in rezultatov. V nasprotnem primeru vidite le uspeh ali neuspeh pri testiranju.

Preizkusite avtomatizirane vtičnike

Preizkusite avtomatizirane vtičnike s priklicem podatkovnega dogodka. Opazujte, ali je vtičnik uspešno deloval, tako da preverite pričakovane spremembe, ki so bile definirane v formuli.

Nasvet

Med predogledna različica lahko prikličete povezani podatkovni dogodek z urejevalnikom tabel v Power Apps:

  1. Prijavite se Power Apps, pojdite na Tabele in izberite Tabelo z vtičniki .
  2. V ukazni vrstici izberite Uredi.
  3. Ustvarite, posodobite ali izbrišite vrstice neposredno iz tega pogleda. Druga možnost je, da odprete vrstico v privzetem obrazcu tako, da izberete vrstico, nato pa v ukazni vrstici izberete Uredi vrstico z obrazcem .

Integrirajte vtičnik z malo programske kode

Prikličite takojšnji vtičnik iz aplikacije Canvas ali strani po meri

  1. V aplikaciji Dataverse Accelerator :
    1. Na seznamu izberite takojšnji vtičnik.
    2. V ukazni vrstici izberite Kopiraj izrezek kode . Prikličite primerek vtičnika z malo programske kode
    3. Prilepite in shranite kopirano formulo v urejevalnik besedila ali beležnico (nekam, kamor se lahko preprosto vrnete).
  2. V Power Apps:
    1. Ustvarite ali uredite aplikacijo za platno (ali stran po meri) v Power Apps studiu.
    2. V levem podoknu za krmarjenje pod zavihkom Viri podatkov izberite + Novo vir podatkov in poiščite Okolje možnost iz Dataverse konektorja.
    3. V platno vstavite naslednje komponente:
    • Dodajte kontrolnike vnosa, ki ustrezajo vrsti podatkov vsakega parametra, kot je Vnos besedila za besedilo ali številke, preklop za logično.
    • Če je obseg vtičnika vezan na tabelo, dodajte kombinirano polje, ki je povezano z isto tabelo, tako da lahko izberete vnos.
    • Dodajte gumb za klic vtičnika.
  3. Prilepite formulo vtičnika, ki ste jo kopirali, v lastnost gumba OnSelect .
  4. Preslikaj vsak vhodni parameter Value za sklicevanje na ustrezne vhodne kontrolnike:
    • Če bi bila formula Environment.new_CalculateSum({ X: Value, Y: Value });, bi jo lahko prepisali kot: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Če je bila formula vezana, zamenjajte Environment s tabelo prikazno ime za dostop do vtičnika.
  5. Če je za vtičnik z malo programske kode definiran izhodni parameter:
    1. Zajemite odgovor v Set() ali UpdateContext() formulo: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Prikažite spremenljivko v oznaki. Druga možnost je, da uporabite Notify() formulo za prikaz podatkov v obvestilu.
  6. Predvajajte aplikacijo in v ukazni vrstici izberite ukaz za zagon vtičnika z malo programske kode.

Izvedite več o tem, kako lahko pokličete Dataverse dejanja neposredno iz Power Fx v aplikacijah platna.

Prikličite takojšnji vtičnik iz Power Automate tok za oblak

  1. V tok za oblak dodajte novo dejanje iz Microsoft Dataverse konektorja.
  2. Izberite dejanje z imenom Izvedi nevezano dejanje ali Izvedi vezano dejanje.
  3. Izberite svoj vtičnik (ima edinstveno ime s predpono).
  4. Podajte vrednosti za vse vhodne parametre (če obstajajo).

Prikličite takojšnji vtičnik iz Dataverse spletnega API-ja

Sledite korakom za razdelke Nevezano dejanje ali Funkcija, vezana na tabelo v Klicanju API-ji po meri iz dokumentacije spletnega API-ja (odvisno od ustreznega obsega vtičnika).

Iskanje pomoči za vtičnike z malo programske kode

Če naletite na težave pri ustvarjanju ali izvajanju vtičnika z malo programske kode, si oglejte te nasvete za pogoste težave, do katerih lahko pride: Microsoft Dataverse z malo programske kode namigi za vtičnike in znane težave

Vzpostavljanje stika s pomočjo in podporo

Za težave z Dataverse namestitvijo rešitve Accelerator ali z malo programske kode vtičniki, ki niso zajeti v Microsoft Dataverse z malo programske kode nasvetih za vtičnike in znanih težavah, kot so nedokumentirane prejete napake, uporabite Pomoč + izkušnjo podpore in vključite naslednje informacije:

  • Vrsta težave- Dataverse Spletni API in SDK
  • Podvrsta problema - Komplet za pospeševanje Dataverse

Primer z malo programske kode vtičnikov, ki jih lahko ustvarite

Za nekaj primerov, kako ustvariti vtičnik z malo programske kode, pojdite na Primer Dataverse z malo programske kode vtičnike (predogledna različica)

Omejitve

  • Predmet jezika okolja je treba prebrati za dostop do novih vtičnikov znotraj obstoječih aplikacij platna. Za vse vtičnike, ustvarjene po dodajanju tabele okolja vir podatkov v obstoječo aplikacijo platna, morate odstraniti in prebrati Power Fx jezikovni objekt okolja. Nato vidite posodobljen seznam vtičnikov kot dejanja.

  • Intellisense zahteva izrecno notacijo v samodejnih vtičnikih, če se želite sklicevati na katero koli tabelo v formuli. Uporabite naslednjo sintakso razdvoumljanja, kot je [@Accounts], z oglatimi oklepaji in @ simbolom (ne Accounts).

  • Ugnezdena podpora. Vtičniki lahko iz Power Fx izrazov kličejo samo lastna dejanja, ki jih je objavil Microsoft.

  • Nekateri Collect scenariji zahtevajo Patch. V nekaterih primerih Collect() ne deluje. Rešitev je uporaba Patch() kot je prikazano v spodnjem primeru zapolnjevanja zadevnega stolpca. Če ustvarjate samodejni vtičnik, pred vsako tabelo, navedeno v Power Fx formuli, dodajte @.

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

  • Ko vtičniki z malo programske kode komunicirajo s konektorji in je uporabljen DLP, lahko skrbnik blokira ustvarjanje povezav z uporabo DLP. Vendar obstoječe reference povezav v Dataverse okolju še naprej delujejo. Če mora skrbnik blokirati vse interakcije vtičnika z malo programske kode s katerim koli konektorjem, lahko onemogoči nastavitev organizacije Allowconnectorsonpowerfxactions. Ta nastavitev je privzeto omogočena in jo je mogoče onemogočiti z običajnimi metodami SDK (WebAPI, SDK, PowerShell itd.). To lahko onemogočite s takojšnjim vtičnikom z malo programske kode na naslednji način:

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

  • Vtičniki, ki uporabljajo konektorje, lahko izpišejo samo rezultate iz določenih polj. Zaradi tega morate preslikati specifične osnovne vrednosti iz konektorja odgovor v izhodne vrednosti.

Z malo programske kode vtičniki, ki imajo omejitev priključkov po meri

Če imate z malo programske kode vtičnike s povezovalniki po meri, je treba najprej uvoziti priključke po meri, preden se sklicujejo na povezave ali tokovi.

Če vaše okolje v rešitvi ne vsebuje priključka po meri, uvozite ločeno rešitev, ki vključuje samo priključek po meri. Izvedite ta uvoz, preden uvozite dejansko rešitev. To morate storiti najprej, ker mora Azure registrirati priključek po meri, preden lahko uvozite druge komponente rešitve.

Če uvozite rešitev, ki vsebuje spojnike in tokove po meri, Azure ne more registrirati povezovalnika po meri, medtem ko registrira vaše reference ali tokove povezave. To velja tudi za reference povezave za priključek po meri, ki prej ni bil uvožen v ločeni rešitvi. Če Azure ni registriral vašega priključka po meri, uvoz ne uspe ali pa uvoza ne morete začeti.

Več informacij: Ustvarjanje povezovalnikov po meri v rešitvah: znane omejitve

Glejte tudi

z malo programske kode vtičniki Power Fx (predogledna različica)

Uporabite vnaprej pripravljen poziv v vtičniku Dataverse z malo programske kode Power Apps