Korištenje dodataka Dataverse s niskim kodom (pretpregled)

[Ova tema spada u dokumentaciju predizdanja i podložna je promjenama.]

Microsoft Dataverse nudi moćno rješenje za postizanje učinkovitije arhitekture podataka i smanjenje radnog opterećenja na strani klijenta putem dodataka s niskim kodom. Ovi dodaci su tijekovi rada u stvarnom vremenu za višekratnu upotrebu koji izvršavaju određeni skup naredbi unutar Dataverse, pokreću se na strani poslužitelja i pokreću ih personalizirani rukovatelji događajima.

Važno

• Trenutni dodaci s niskim kodom nemaju prioritet i ne isporučuju se kao značajka. Trenutni dodaci s niskim kodom zamijenjeni su funkcijama. Dodatne informacije: Funkcije u Microsoft Dataverse (pretpregled)
• To je značajka pretpregleda.
• Značajke pretpregleda nisu namijenjene u proizvodne svrhe i mogu imati ograničene funkcije. Te su značajke dostupne prije službenog izdavanja da bi se klijentima omogućio prijevremeni pristup i slanje povratnih informacija.

Tradicionalno, dodaci su stvoreni kao prilagođene klase kompajlirane u .NET Framework sklop, koji su zatim preneseni i registrirani unutar njega Dataverse. Međutim, s uvođenjem dodataka s niskim kodom, korisnici mogu stvoriti ove rukovaoce događajima s minimalnim ili nikakvim potrebnim kodiranjem i bez potrebe za ručnom registracijom.

Dodaci s niskim kodom pohranjeni su u bazi Dataverse podataka i mogu se neprimjetno integrirati u Power Apps i Power Automate. Ponašanje tijeka rada definirano je pomoću jezika Power Fx izraza i može se izravno povezati s poslovnim Dataverse podacima i vanjskim izvorima podataka putem Power Platform poveznika. S dodacima s niskim kodom, proizvođači mogu brzo konstruirati složene tijekove rada uz minimalnu stručnost u kodiranju, što rezultira pojednostavljenijom i učinkovitijom arhitekturom podataka.

Prednosti logike na strani poslužitelja

Definiranje poslovne logike na strani poslužitelja nudi nekoliko prednosti, uključujući:

• Povećana sigurnost. Budući da se logika na strani poslužitelja izvršava na poslužitelju, može pomoći u sprječavanju neovlaštenog pristupa osjetljivim podacima ili procesima.
• Poboljšane performanse. Izvršavanjem na poslužitelju, poslovna logika može smanjiti količinu podataka koje je potrebno prenijeti između klijenta i poslužitelja, što rezultira bržim vremenom obrade.
• Dosljednost i pouzdanost. Logika na strani poslužitelja osigurava dosljednu primjenu poslovnih pravila na svim klijentima, smanjujući rizik od pogrešaka ili nedosljednosti.
• Lakše održavanje i nadogradnje. Centralizacijom poslovne logike na poslužitelju postaje lakše održavati i ažurirati, jer se promjene mogu napraviti na jednom mjestu, umjesto da morate ažurirati više klijenata.
• Skalabilnost. Logika na strani poslužitelja može se lakše skalirati od logike na strani klijenta, što omogućuje bolje performanse i rukovanje većim radnim opterećenjima.

Dodaci s niskim kodom

Podržane su dvije vrste dodataka s niskim kodom Dataverse:

Tip	Okidač	Podržava parametre	Podržani opseg
Trenutno	Ručno pokretanje	Jest	Globalno i tablica
Automatizirano	Dataverse stolni događaj	No	Table

Svi dodaci s niskim kodom imaju sljedeća zajednička svojstva:

Svojstvo	Opis
Zaslonski naziv	Naziv dodatka čitljiv ljudima. Ne može se promijeniti nakon što je stvoren.
Ime/naziv	Interni naziv dodatka. Platforma ga koristi za identifikaciju komponente u kodu i operacijama baze podataka. Ne može se promijeniti nakon što je stvoren.
Opis	Koristi se za pružanje dodatnog konteksta o dodatku (svrha, ponašanje ili drugi važni detalji).
Rješenje	Koristi se za grupiranje komponenti i izvoz u druga okruženja. Saznajte više o rješenjima.
Expression	Ovo je prilagođena funkcija koja se može koristiti za izvođenje radnji ili izračuna, definiranih pomoću jezika izraza Power Fx . Power Fx je jezik formule koji se koristi u aplikacijama Power Apps radnog područja i proširen je za korištenje u dodacima s niskim kodom. Pogledajte podržane funkcije za više detalja.

Trenutni dodaci

Trenutni dodatak s niskim kodom prilagođena je logika koda koju korisnik ručno pokreće. Mogu se koristiti prilagođeni ulazni i izlazni parametri.

Jedinstvena svojstva:

Svojstvo	Opis
Opseg	Koristi se za povezivanje dodatka s određenom tablicom. Može se postaviti na tablicu (prikazanu kao entitet) ili globalnu, pri čemu opseg tablice (entiteta) znači da se dodatak pokreće s kontekstom određenog zapisa tablice, a globalni opseg znači da operacija nije povezana s tablicom (saznajte više).
Parametri	Parametri vam omogućuju prosljeđivanje informacija između dodatka i konteksta koji ga pokreće, što olakšava dizajniranje poslovne logike koja se može ponovno koristiti u različitim situacijama. Ulazni parametri koriste se za pružanje podataka dodatku i omogućuju vam da kontrolirate kako se funkcija ponaša prosljeđivanjem različitih vrijednosti koje navedete u formuli Power Fx . Izlazni parametri omogućuju vam dohvaćanje rezultata funkcije ili metode za daljnju upotrebu u vašem programu. Podržane vrste podataka: Booleov String Float Decimal DatumVrijeme Integer

Dodatne informacije o integraciji iz aplikacije radnog područja ili u tijeku u oblaku Power Automate : Integracija dodatka s niskim kodom

Automatizirani dodaci

Automatizirani dodatak s niskim kodom prilagođeni je kod koji se izvršava tijekom obrade određenog podatkovnog događaja.

Jedinstvena svojstva:

Svojstvo	Opis
Podatkovni događaj ('Pokrenite ovaj dodatak kada je redak')	Određuje koji podatkovni događaj pokreće dodatak. Za pozivanje dodatka može se odabrati bilo koji od sljedećih događaja: Izrada Update Izbriši
Faza ('Kada bi ovo trebalo pokrenuti')	Možete dizajnirati hoće li se dodatak pokrenuti prije ili nakon dovršetka podatkovnog događaja, što omogućuje fleksibilnost pristupa i izmjene vrijednosti u ključnim fazama događaja. Prije operacije. Odaberite ovu mogućnost ako želite pokrenuti logiku dodatka nakon provjere valjanosti obrasca, ali prije umetanja ili promjene vrijednosti Dataverse. Poslije operacije. Odaberite ovu mogućnost da biste pokrenuli logiku dodatka nakon umetanja ili promjene vrijednosti Dataverse.

Dozvole dodataka

Vrijeme dizajna

Proizvođači koji imaju članstvo Power Platform u sigurnosnoj ulozi osobe za prilagodbu sustava ili administratora sustava u okruženju mogu pristupiti svim dodacima u tom okruženju. Prilagođene sigurnosne uloge mogu se koristiti za ograničavanje pristupa dodacima s niskim kodom.

Vrijeme izvođenja

Kada se plugin pozove, on pristupa podacima tablice uključenim u definiciju dodatka (tablice koje su dio formule ili ako je tablica povezana s postavkama automatiziranog dodatka) u kontekstu korisnika koji ga je pozvao.

Veze

Pomoću sigurnosnih uloga pristup poveznika unutar dodataka može se ograničiti na određeni skup korisnika unutar vaše tvrtke ili ustanove. Navedite koje uloge imaju privilegije za stvaranje, čitanje, ažuriranje ili brisanje.

Preduvjeti za stvaranje dodatka s niskim kodom

• Članstvo administratora sustava ili osobe za prilagodbu sustava u sigurnosnoj ulozi u Power Platform okruženju.
• Pristup aplikaciji akceleratora Dataverse .

Savjet

Sva nova okruženja imaju aplikaciju akceleratora Dataverse koja se automatski instalira od 1. listopada 2023. Ako ste već imali Dataverse instaliran ubrzivač, možete ga Dataverse ručno ažurirati.

Ažurirajte ubrzivač Dataverse

1. Slijedite upute za prikaz licenciranih aplikacija u vašem okruženju.
2. Ako Dataverse je ubrzivač već instaliran i dostupno je ažuriranje, to je naznačeno u tablici pokraj stavke.
3. Odaberite Dataverse Ubrzivač, a zatim odaberiteAžuriraj na naredbenoj traci.

Savjet

Omogućite automatska ažuriranja aplikacija za izdavača Microsoft – Power CAT za automatsko primanje ažuriranja kada su dostupna (nije potrebno za nova okruženja stvorena nakon 1. listopada 2023.).

Napomena

Ako ste prethodno instalirali neobavezno rješenje dodataka s niskim kodom za poveznike , ono će se automatski izbrisati kada ažurirate nakon 29. lipnja 2023. Mogućnosti će biti dostupne u glavnom rješenju.

Izrada trenutnog dodatka s niskim kodom

1. Reproducirajte aplikaciju akceleratora Dataverse .
2. Odaberite karticu Stvori instant dodatak.
3. Navedite zaslonski naziv.
4. Po želji definirajte parametre:
   • Odaberite Novi ulazni parametar ili Novi izlazni parametar, zatim unesite oznaku i vrstu podataka.
   • Po potrebi dodajte više ulaznih i izlaznih parametara.
5. Unesite Power Fx izraz u uređivač izraza .
   • Referencirajte ulazne parametre u formuli prema nazivu natpisa.
   • Izlazni parametri moraju se navesti unutar vitičastih zagrada, kao što su { Out: "Return value" }.
   • Referentne Dataverse tablice pomoću funkcija prikupljanja podataka, kao što su Filter() i LookUp().
   • Ako je opseg postavljen na entitet, koristite ThisRecord za pristup vrijednostima stupaca u retku tablice povezanom s izvođenjem dodatka, kao što su ThisRecord.'Account Name'.

   Savjet

   Obratite pažnju na intellisense u okviru Izraz . Podcrtano crveno je nevažeće. Valovito žuta znači da na vašu logiku mogu utjecati ograničenja delegiranja. Izbjegnite probleme s delegiranjem pomoću funkcija koje se mogu delegirati.

6. Po želji proširite Napredne mogućnosti da biste izmijenili rješenje, opseg ili opis.
7. Odaberite Spremi.
8. Testirajte svoj trenutni dodatak s niskim kodom.

Primjer: Izračunajte zbroj dva cijela broja.

• Stvorite dva ulazna parametra X i Y (oba tipa cijeli broj) i jedan izlazni parametar Z (niz vrsta).
• Koristite sljedeću formulu: {Z: X + Y }

Izrada automatiziranog dodatka s niskim kodom

1. Reproducirajte aplikaciju akceleratora Dataverse .
2. Odaberite karticu Stvori automatski dodatak.
3. Navedite sljedeće vrijednosti:
   • Naziv: Unesite naziv dodatka, kao što je Provjera valjanosti unosa.
   • Tablica: Odaberite tablicu s kojom želite povezati dodatak, kao što je Račun.
   • Pokrenite ovo pravilo dodatka kada je redak. Navedite podatkovni događaj koji poziva dodatak.
4. Unesite Power Fx izraz u uređivač izraza .
   • Referentne Dataverse tablice pomoću funkcija prikupljanja podataka, kao što su Filter() i LookUp().
   • Koristi se ThisRecord za pristup vrijednostima stupaca u retku tablice povezanom s pokretanjem dodatka, kao što su ThisRecord.'Account Name'.
5. Po želji proširite Napredne mogućnosti da biste izmijenili fazu (kada bi se to trebalo pokrenuti) i rješenje u kojem je dodatak spremljen.
6. Odaberite Spremi.
7. Testirajte svoj automatizirani dodatak s niskim kodom.

Upotreba Power Platform konektora u dodacima s niskim kodom

Power Platform konektori se mogu koristiti u dodacima s niskim kodom za jednostavnu integraciju podataka i funkcionalnosti iz sustava izvan sustava Dataverse, kao što su SQL Server, Salesforce i SharePoint, bez potrebe za složenim kodiranjem ili prilagođenim razvojem.

Preduvjeti za korištenje konektora u dodacima s niskim kodom

• Preduvjeti za stvaranje dodatka s niskim kodom
• Referenca veze s aktivnom vezom.

Korištenje radnji poveznika u dodacima s niskim kodom

Poveznike i prilagođene poveznike možete jednostavno koristiti unutar dodatka s niskim kodom u formuli Power Fx .

1. Stvorite vezu s poveznikom koji želite koristiti.
2. Dodajte referencu veze na vezu u Dataverse okruženju.
3. U uređivač izraza dodatka Power Fx s niskim kodom upišite naziv reference veze (interni naziv s prefiksom i podvlakom, naprimjer new_connectorName, a ne zaslonski naziv).
4. Intellisense prikazuje dostupne akcije. Odaberite željenu akciju, a zatim unesite potrebne parametre.

Prije upotrebe poveznika u dodatku s niskim kodom, pregledajte dokumentaciju poveznika kako biste bili sigurni da ispravno prosljeđujete ulazne i izlazne parametre.

Više informacija: primjer

Napomena

• Trenutno nisu podržane sve akcije poveznika.
• Nemojte koristiti Dataverse priključak za povezivanje s Dataverse tablicama iz izraza dodatka. Umjesto toga, koristite nativne Power Fx funkcije za interakciju sa zbirkama: Filter, Search, LookUp,Patch,Collect...iSet, gdje se stupci tretiraju kao globalne varijable.

Testiranje dodatka s niskim kodom

Testirajte trenutne dodatke

1. Na početnom zaslonu odaberite trenutni dodatak s popisa, a zatim odaberite Testiraj na naredbenoj traci. Do ovog zaslona možete doći i iz trenutnog uređivača dodataka na naredbenoj traci nakon što je spreman.

2. Navedite vrijednosti za sve ulazne parametre koji su definirani u dodatku s niskim kodom, a zatim odaberite Pokreni.

Promatrajte odgovor.

Savjet

Koristite izlazne parametre da biste provjerili očekivano ponašanje i rezultate. U suprotnom, vidite samo uspjeh ili neuspjeh prilikom testiranja.

Testiranje automatiziranih dodataka

Testirajte automatizirane dodatke pozivanjem podatkovnog događaja. Promatrajte je li dodatak uspješno pokrenut provjerom očekivanih promjena koje su definirane u formuli.

Savjet

Tijekom pretpregleda možete pozvati povezani podatkovni događaj pomoću uređivača tablica u Power Apps:

1. Prijavite se Power Apps, idite na Tablice i odaberite tablicu dodataka .
2. Na naredbenoj traci odaberite Uredi.
3. Stvorite, ažurirajte ili izbrišite retke izravno iz ovog prikaza. Alternativno, otvorite redak u zadanom obrascu odabirom retka, a zatim odaberite Uredi redak pomoću obrasca na naredbenoj traci.

Integrirajte dodatak s niskim kodom

Pozivanje trenutnog dodatka iz aplikacije radnog područja ili prilagođene stranice

1. U aplikaciji Dataverse Accelerator :
   1. Odaberite trenutni dodatak na popisu.
   2. Odaberite Kopiraj isječak koda na naredbenoj traci.
   3. Zalijepite i spremite kopiranu formulu u uređivač teksta ili bilježnicu (negdje na koje se lako možete vratiti).
2. U Power Apps:
   1. Stvorite ili uredite aplikaciju radnog područja (ili prilagođenu stranicu) u studiju Power Apps .
   2. U lijevoj navigaciji na kartici Izvori podataka odaberite + Novi izvor podataka i potražite mogućnost Okruženje iz poveznika Dataverse .
   3. Umetnite sljedeće komponente u platno:
   • Dodajte kontrole unosa koje odgovaraju vrsti podataka svakog parametra, kao što su Unos teksta za tekst ili brojeve, prekidač za logičnu vrijednost.
   • Ako je opseg dodatka vezan za tablicu, dodajte kombinirani okvir koji je povezan s istom tablicom da biste mogli odabrati ulaz.
   • Dodajte gumb za pozivanje dodatka.
3. Zalijepite formulu dodatka koju ste kopirali u svojstvo gumba OnSelect .
4. Mapirajte svaki ulazni parametar Value tako da upućuje na odgovarajuće ulazne kontrole:
   • Ako je formula bila Environment.new_CalculateSum({ X: Value, Y: Value });, mogla bi se prepisati kao: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Ako je formula bila vezana, zamijenite Environment je zaslonskim nazivom tablice da biste pristupili dodatku.
5. Ako je za dodatak s niskim kodom definiran izlazni parametar:
   1. Zabilježite odgovor u formuli Set() ili UpdateContext()Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );:. Prikažite varijablu u naljepnici. Alternativno, upotrijebite formulu Notify() za prikaz podataka u obavijesti.
6. Reproducirajte aplikaciju i odaberite naredbu na naredbenoj traci za pokretanje dodatka s niskim kodom.

Saznajte više o tome kako možete pozvati Dataverse akcije izravno iz Power Fx aplikacija radnog područja.

Pozivanje trenutnog dodatka iz tijeka u oblaku Power Automate

1. U tijeku u oblaku dodajte novu akciju iz poveznika Microsoft Dataverse .
2. Odaberite akciju pod nazivom Izvedi nevezanu radnju ili Izvedi vezanu akciju.
3. Odaberite svoj dodatak (ima jedinstveni naziv s prefiksom).
4. Navedite vrijednosti za sve ulazne parametre (ako postoje).

Pozivanje trenutnog dodatka iz web-API-ja Dataverse

Slijedite korake za odjeljke Nevezana akcija ili Funkcija vezana za tablicu u odjeljku Pozivanje prilagođenih API-ja iz dokumentacije web-API-ja (ovisno o odgovarajućem opsegu dodatka).

Dobivanje pomoći za dodatke s niskim kodom

Ako naiđete na probleme s izradom ili pokretanjem dodatka s niskim kodom, pročitajte ove savjete za uobičajene probleme koji se mogu pojaviti: Microsoft Dataverse savjeti za dodatke s niskim kodom i poznati problemi

Kontaktiranje pomoći + podrške

Za probleme s instalacijom Dataverse rješenja ubrzivača ili dodataka s malo koda koji nisu obuhvaćeni savjetima Microsoft Dataverse za dodatke s malo koda i poznate probleme, kao što su primljene nedokumentirane pogreške, koristite iskustvo pomoći + podrške i uključite sljedeće informacije:

• Vrsta problema - Dataverse Web API i SDK
• Podtip problema- Komplet akceleratora za Dataverse

Primjeri dodataka s niskim kodom koje možete stvoriti

Nekoliko primjera stvaranja dodatka s malo koda potražite u članku Primjeri Dataverse dodataka s malo koda (pretpregled)

Ograničenja

• Objekt jezika okruženja potrebno je ponovno dodati za pristup novim dodacima unutar postojećih aplikacija radnog područja. Za sve dodatke stvorene nakon što ste dodali izvor podataka tablice okruženja u postojeću aplikaciju radnog područja, morate ukloniti i ponovno dodati objekt jezika Power Fx okruženja. Zatim ćete vidjeti ažurirani popis dodataka kao akcije.

• Intellisense zahtijeva eksplicitnu notaciju u automatiziranim dodacima ako želite upućivati na bilo koju tablicu u formuli. Koristite sljedeću sintaksu za razdvajanje, kao što [@Accounts] je korištenje uglatih zagrada i simbola @ (ne Accounts).

• Ugniježđena podrška. Dodaci mogu pozivati samo akcije prve strane koje je Microsoft objavio iz Power Fx izraza.

• Neki Collect scenariji zahtijevaju Patch. Postoje neki scenariji u kojima Collect() to ne funkcionira. Zaobilazno rješenje treba koristiti Patch() kao što je prikazano u primjeru popunjavanja u vezi sa stupcem u nastavku. Ako stvarate automatizirani dodatak, dodajte @ svakoj tablici na koju se upućuje u formuli Power Fx .

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

• Kada dodaci s niskim kodom stupaju u interakciju s poveznicima i koristi se DLP, administrator može blokirati stvaranje veza pomoću DLP-a. Međutim, postojeće Dataverse reference veze u okruženju i dalje funkcioniraju. U slučaju da administrator treba blokirati sve interakcije dodataka s niskim kodom s bilo kojim poveznicima, može onemogućiti postavku Allowconnectorsonpowerfxactions tvrtke ili ustanove. Ova je postavka omogućena prema zadanim postavkama i može se onemogućiti uobičajenim metodama SDK-a (WebAPI, SDK, PowerShell i tako dalje). To možete onemogućiti pomoću trenutnog dodatka s niskim kodom na sljedeći način:

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

• Dodaci koji koriste poveznike mogu ispisati rezultate samo iz određenih polja. Zbog toga morate mapirati određene primitivne vrijednosti iz odgovora konektora na izlazne vrijednosti.

Dodaci s niskim kodom koji imaju ograničenje prilagođenih konektora

Ako imate dodatke s niskim kodom s prilagođenim poveznicima, prilagođeni poveznici moraju se prvo uvesti, prije referenci ili tijekova veze.

Ako vaše okruženje ne sadrži prilagođeni poveznik u rješenju, uvezite zasebno rješenje koje uključuje samo prilagođeni poveznik. Izvršite taj uvoz prije uvoza stvarnog rješenja. To prvo morate učiniti jer Azure mora registrirati prilagođeni poveznik prije nego što se mogu uvesti druge komponente rješenja.

Ako uvezete rješenje koje sadrži prilagođene poveznike i tijekove, Azure ne može registrirati prilagođeni poveznik dok registrira reference ili tijekove veze. To se odnosi i na reference veze za prilagođeni poveznik koji prethodno nije uvezen u zasebno rješenje. Ako Azure nije registrirao vaš prilagođeni poveznik, uvoz ne uspijeva ili ne možete pokrenuti uvoz.

Dodatne informacije: Stvaranje prilagođenih poveznika u rješenjima: poznata ograničenja

Pogledajte

Dodaci Power Fx s niskim kodom(pretpregled)

Korištenje unaprijed izrađenog upita u dodatku Dataverse s niskim kodom Power Apps

Stvaranje automatiziranog dodatka s niskim kodom s Power Apps (video)

Izradite trenutni dodatak s niskim kodom s Power Apps (video)