Uporabite vtičnike z nizko kodo v Dataverse (predogled)

[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 nizko kodo. 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

• Takojšnji vtičniki z nizko kodo so brez prednosti in niso dostavljeni kot funkcija. Takojšnji vtičniki z nizko kodo so nadomeščeni s funkcijami. Več informacij: Funkcije v Microsoft Dataverse (predogled)
• 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 nizko kodo pa lahko uporabniki ustvarijo te obdelovalce dogodkov z minimalnim kodiranjem ali brez njega in brez potrebe po ročni registraciji.

Vtičniki z nizko kodo so shranjeni v Dataverse zbirki podatkov in jih je mogoče neopazno vključiti v Power Apps in 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 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.

Vtičniki z nizko kodo

V Dataverse sta podprti dve vrsti vtičnikov z nizko kodo:

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 nizko kodo 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. 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 platnih aplikacijah in je bil razširjen za uporabo v vtičnikih z nizko kodo. Glejte podprte funkcije za več podrobnosti.

Takojšnji vtičniki

Takojšnji vtičnik z nizko kodo 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čen String Float Decimal Datum/ura Integer

Več informacij o integraciji iz aplikacije Canvas ali v Power Automate toku v oblaku: Integrirajte vtičnik z nizko kodo

Avtomatizirani vtičniki

Samodejni vtičnik z nizko kodo je koda po meri, ki se izvede med obdelavo določenega podatkovnega dogodka.

Edinstvene lastnosti:

Lastnost	Description
Podatkovni dogodek ('Zaženi ta vtičnik, ko je vrstica')	Podaja, kateri podatkovni dogodek sproži vtičnik. Za priklic vtičnika lahko izberete katerega koli od naslednjih dogodkov: Create Posodabljanje Izbris
Faza ('Kdaj naj se to zažene')	Nastavite lahko, ali se vtičnik izvaja pred ali po zaključku podatkovnega dogodka, kar omogoča prilagodljivost za dostop in spreminjanje vrednosti v ključnih fazah dogodka. Predoperacija. Izberite to možnost, če želite zagnati logiko vtičnika po preverjanju obrazca, vendar preden so vrednosti vstavljene ali spremenjene Dataverse. Po operaciji. Izberite to možnost, če želite zagnati logiko vtičnika, potem ko so bile vrednosti vstavljene ali spremenjene Dataverse.

Dovoljenja za vtičnike

Čas oblikovanja

Izdelovalci, ki imajo v Power Platform okolju članstvo v varnostni vlogi prilagajanja sistema ali skrbnika sistema, lahko dostopajo do vseh vtičnikov v tem okolju. Varnostne vloge po meri lahko uporabite za omejitev dostopa do vtičnikov z nizko kodo.

Čas delovanja

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

Povezave

Z uporabo varnostnih vlog je mogoče dostop do povezovalnika znotraj vtičnikov omejiti na določeno skupino uporabnikov v vaši organizaciji. Določite, katere vloge imajo privilegije za ustvarjanje, branje, posodabljanje ali brisanje.

Predpogoji za ustvarjanje vtičnika z nizko kodo

• Članstvo varnostne vloge skrbnika sistema ali prilagajanja sistema v Power Platform okolju.
• Dostop do Dataverse aplikacije pospeševalnika.

Nasvet

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

Posodobite Dataverse pospeševalnik

1. Sledite navodilom za ogled licenčnih aplikacij v vašem okolju.
2. Če je Dataverse Pospeševalec že nameščen in je na voljo posodobitev, je to navedeno v tabeli poleg elementa.
3. Izberite Dataverse Pospeševalnikin nato izberite Posodobi v ukazni vrstici.

Nasvet

Omogočite samodejne posodobitve aplikacij za izdajatelja Microsoft - Power CAT za samodejno prejemanje posodobitev, ko so na voljo (ni potrebno za nova okolja, ustvarjena po 1. oktobru 2023).

opomba,

Če ste predhodno namestili izbirno rešitev Low-Code Plug-ins for Connectors , bo samodejno izbrisana, ko posodobite po 29. juniju 2023. Zmogljivosti bodo na voljo v glavni rešitvi.

Ustvarite takojšnji vtičnik z nizko kodo

1. Predvajajte aplikacijo Dataverse accelerator.
2. Izberite kartico Ustvari takojšnji vtičnik .
3. Navedite Prikazno ime.
4. Po želji določite parametre:
   • Izberite Nov vhodni parameter ali Nov izhodni parameter, nato vnesite oznako in vrsto podatkov.
   • Po potrebi dodajte več vhodnih in izhodnih parametrov.
5. Vnesite Power Fx izraz v Expression urejevalnik.
   • Sklicevanje na vhodne parametre v formuli z imenom oznake.
   • Na izhodne parametre se je treba sklicevati znotraj zavitih oklepajev, kot je { 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 stolpcev v vrstici tabele, ki je povezana z izvajanjem vtičnika, na primer 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 , da spremenite rešitev, obseg ali opis.
7. Izberite možnost Shrani.
8. Preizkusite svoj takojšnji vtičnik z nizko kodo.

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 }

Ustvarite samodejni vtičnik z nizko kodo

1. Predvajajte aplikacijo Dataverse accelerator.
2. Izberite kartico Ustvari samodejni vtičnik .
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 Expression 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 kjer je shranjen vtičnik.
6. Izberite možnost Shrani.
7. Preizkusite svoj samodejni vtičnik z nizko kodo.

Uporabite Power Platform konektorje v vtičnikih z nizko kodo

Power Platform konektorje je mogoče uporabiti v vtičnikih z nizko kodo za preprosto integracijo podatkov in funkcionalnosti iz sistemov zunaj Dataverse, kot so SQL Server, Salesforce in SharePoint, brez potrebe po zapletenem kodiranju ali razvoju po meri.

Predpogoji za uporabo konektorjev v vtičnikih z nizko kodo

• Predpogoji za ustvarjanje vtičnika z nizko kodo
• Referenca povezave z aktivno povezavo.

Uporaba dejanj povezovalnika v vtičnikih z nizko kodo

Z lahkoto lahko uporabite konektorje in konektorje po meri z Power Fx formulo vtičnika z nizko kodo.

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

Preden uporabite konektor v vtičniku z nizko kodo, preglejte dokumentacijo konektorja , da se prepričate, da pravilno posredujete vhodne in izhodne parametre.

Več informacij: primer

opomba,

• Trenutno niso podprta vsa dejanja povezovalnika.
• Ne uporabljajte Dataverse konektorja za povezavo s 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 obravnavajo stolpci kot globalne spremenljivke.

Preizkusite vtičnik z nizko kodo

Preizkusite takojšnje vtičnike

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

2. Podajte vrednosti za vse vhodne parametre, ki so definirani v vtičniku z nizko kodo, in nato izberite Zaženi.

Opazujte odziv.

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 predogledom lahko prikličete povezani podatkovni dogodek z urejevalnikom tabel v Power Apps:

1. Prijavite se v 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 nizko kodo

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 delček 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 + Nov vir podatkovin poiščite možnost Okolje 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 vrednost.
   • Če je obseg vtičnika vezan na tabelo, dodajte kombinirano polje, ki je povezano z isto tabelo, da lahko izberete vnos.
   • Dodajte gumb za klic vtičnika.
3. Prilepite formulo vtičnika, ki ste jo kopirali, v lastnost OnSelect gumba.
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 prikaznim imenom tabele za dostop do vtičnika.
5. Če je izhodni parameter definiran za vtičnik z nizko kodo:
   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 nizko kodo.

Izvedite več o tem, kako lahko prikličete Dataverse dejanja neposredno iz Power Fx v aplikacijah za platno.

Prikličite takojšnji vtičnik iz Power Automate toka v oblaku

1. V toku oblaka 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 Klicanje API-jev po meri iz dokumentacije spletnega API-ja (odvisno od ustreznega obsega vtičnika).

Iskanje pomoči za vtičnike z nizko kodo

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

Vzpostavljanje stika s pomočjo in podporo

Za težave z Dataverse namestitvijo rešitve Accelerator ali vtičniki z nizko kodo, ki niso zajeti v Microsoft Dataverse nasvetih za vtičnike z nizko kodo, in znanih težavah, kot so prejete nedokumentirane 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

Primeri vtičnikov z nizko kodo, ki jih lahko ustvarite

Za nekaj primerov, kako ustvariti vtičnik z nizko kodo, pojdite na Primer Dataverse vtičnike z nizko kodo (predogled)

Omejitve

• Predmet jezika okolja je treba prebrati za dostop do novih vtičnikov znotraj obstoječih aplikacij platna. Za vse vtičnike, ustvarjene po tem, ko ste dodali vir podatkov tabele okolja 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 uporabo oglatih oklepajev in @ simbola (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 nizko kodo 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čnikov z nizko kodo 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 nizko kodo, kot sledi:

  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 odziva konektorja v izhodne vrednosti.

Vtičniki z nizko kodo, ki imajo omejitev priključkov po meri

Če imate vtičnike z nizko kodo s povezovalniki po meri, je treba najprej uvoziti priključke po meri, preden navedete povezave ali tokove.

Č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

Vtičniki z nizko kodo Power Fx (predogled)

Uporabite vnaprej pripravljen poziv v Dataverse vtičniku z nizko kodo Power Apps

Ustvarite samodejni vtičnik z nizko kodo z Power Apps (video)

Ustvarite takojšen vtičnik z nizko kodo z Power Apps (video)