Použite nízkokódové doplnky v Dataverse (ukážka)

[Táto téma je predbežnou dokumentáciou a môže sa zmeniť.]

Microsoft Dataverse ponúka výkonné riešenie na dosiahnutie efektívnejšej dátovej architektúry a zníženie pracovnej záťaže na strane klienta prostredníctvom zásuvných modulov s nízkym kódom. Tieto doplnky sú opakovane použiteľné pracovné postupy v reálnom čase, ktoré vykonávajú špecifickú sadu príkazov v rámci Dataverse, bežia na strane servera a spúšťajú sa personalizované obslužné programy udalostí.

Tradične boli zásuvné moduly vytvorené ako vlastné triedy zostavené do zostavy .NET Framework, ktoré boli potom nahrané a zaregistrované v rámci Dataverse. Avšak so zavedením zásuvných modulov s nízkym kódom môžu používatelia vytvárať tieto obslužné programy udalostí s minimálnym alebo žiadnym vyžadovaným kódovaním a bez potreby manuálnej registrácie.

Doplnky s nízkym kódom sú uložené v databáze Dataverse a možno ich bez problémov integrovať do Power Apps a Power Automate. Správanie pracovného toku je definované pomocou Power Fx jazyka výrazov a môže sa priamo spájať s Dataverse obchodnými údajmi a externými zdrojmi údajov prostredníctvom Power Platform konektorov. Vďaka zásuvným modulom s nízkym kódom môžu tvorcovia rýchlo vytvárať zložité pracovné postupy s minimálnou odbornosťou v oblasti kódovania, čo vedie k efektívnejšej a efektívnejšej architektúre údajov.

Výhody logiky na strane servera

Definovanie obchodnej logiky na strane servera ponúka niekoľko výhod vrátane:

• Zvýšená bezpečnosť. Keďže logika na strane servera sa vykonáva na serveri, môže pomôcť zabrániť neoprávnenému prístupu k citlivým údajom alebo procesom.
• Vylepšený výkon. Spustením na serveri môže obchodná logika znížiť množstvo údajov, ktoré je potrebné preniesť medzi klientom a serverom, čo vedie k rýchlejšiemu spracovaniu.
• Dôslednosť a spoľahlivosť. Logika na strane servera zaisťuje konzistentné uplatňovanie obchodných pravidiel na všetkých klientov, čím sa znižuje riziko chýb alebo nezrovnalostí.
• Jednoduchšia údržba a upgrady. Centralizáciou obchodnej logiky na serveri je jej údržba a aktualizácia jednoduchšia, pretože zmeny možno vykonať na jednom mieste a nemusíte aktualizovať viacerých klientov.
• Škálovateľnosť. Logiku na strane servera možno škálovať jednoduchšie ako logiku na strane klienta, čo umožňuje lepší výkon a zvládanie väčšieho pracovného zaťaženia.

Doplnky s nízkym kódom

V Dataverse sú podporované dva typy doplnkov s nízkym kódom:

Všetky doplnky s nízkym kódom majú nasledujúce spoločné vlastnosti:

Povolenia doplnku

Predpoklady na vytvorenie doplnku s nízkym kódom

Aktualizujte akcelerátor Dataverse

1. Postupujte podľa pokynov na zobrazenie licencovaných aplikácií vo vašom prostredí.
2. Ak je Dataverse Accelerator už nainštalovaný a je k dispozícii aktualizácia, je to uvedené v tabuľke vedľa položky.
3. Vyberte Dataverse Accelerator a potom vyberte Aktualizovať na paneli príkazov.

Vytvorte okamžitý doplnok s nízkym kódom

1. Zahrajte si aplikáciu akcelerátora Dataverse .
2. Vyberte kartu Vytvoriť okamžitý doplnok .
3. Zadajte Zobrazovaný názov.
4. Voliteľne definujte parametre:
   • Vyberte Nový vstupný parameter alebo Nový výstupný parameter, potom zadajte označenie a typ údajov.
   • Podľa potreby pridajte ďalšie vstupné a výstupné parametre.
5. Zadajte Power Fx výraz v editore Výraz .
   • Vstupné parametre vo vzorci uveďte podľa názvu štítka.
   • Výstupné parametre musia byť uvedené v zložených zátvorkách, ako napríklad { Out: "Return value" }.
   • Referenčné Dataverse tabuľky využívajúce funkcie zhromažďovania údajov, ako napríklad Filter() a LookUp().
   • Ak je rozsah nastavený na entitu, použite ThisRecord na prístup k hodnotám stĺpcov v riadku tabuľky spojenom so spustením doplnku, ako napr ThisRecord.'Account Name'.

   Prepitné

   Všimnite si inteligenciu v poli Výraz . Červená podčiarknutá je neplatná. Kľukatá žltá znamená, že vaša logika môže byť ovplyvnená obmedzeniami delegovania. Vyhnite sa problémom s delegovaním pomocou delegovateľných funkcií.

6. Voliteľne rozbaľte Rozšírené možnosti a upravte riešenie, rozsah alebo popis.
7. Vyberte položku Uložiť.
8. Otestujte svoj okamžitý nízkokódový doplnok.

Príklad: Vypočítajte súčet dvoch celých čísel.

• Vytvorte dva vstupné parametre X a Y (oba typu integer) a jeden výstupný parameter Z (typ reťazca).
• Použite nasledujúci vzorec: {Z: X + Y }

Vytvorte automatizovaný doplnok s nízkym kódom

1. Zahrajte si aplikáciu akcelerátora Dataverse .
2. Vyberte kartu Vytvoriť automatický doplnok .
3. Zadajte nasledujúce hodnoty:
   • Názov: Zadajte názov doplnku, napríklad Overenie vstupu.
   • Tabuľka: Vyberte tabuľku, ku ktorej chcete priradiť doplnok, napríklad Účet.
   • Spustite toto pravidlo doplnku, keď je riadok. Zadajte dátovú udalosť, ktorá vyvolá doplnok.
4. Zadajte Power Fx výraz v editore Výraz .
   • Referenčné Dataverse tabuľky využívajúce funkcie zhromažďovania údajov, ako napríklad Filter() a LookUp().
   • Použite ThisRecord na prístup k hodnotám stĺpcov v riadku tabuľky spojenom so spustením doplnku, ako napríklad ThisRecord.'Account Name'.
5. Voliteľne rozbaľte Rozšírené možnosti a upravte fázu (keď sa má spustiť) a riešenie kde je doplnok uložený.
6. Vyberte položku Uložiť.
7. Otestujte svoj automatizovaný nízkokódový doplnok.

Použite Power Platform konektory v doplnkoch s nízkym kódom

Power Platform konektory možno použiť v zásuvných moduloch s nízkym kódom na jednoduchú integráciu údajov a funkcií zo systémov mimo Dataverse, ako sú SQL Server, Salesforce a SharePoint, bez potreby zložitého kódovania alebo vlastného vývoja.

Predpoklady na používanie konektorov v zásuvných moduloch s nízkym kódom

Používanie akcií konektora v doplnkoch s nízkym kódom

Môžete jednoducho použiť konektory a vlastné konektory v rámci doplnku s nízkym kódom a Power Fx vzorca.

1. Vytvorte pripojenie ku konektoru, ktorý chcete použiť.
2. Pridajte odkaz na pripojenie k pripojeniu v prostredí Dataverse .
3. V editore výrazov doplnku s nízkym kódom Power Fx zadajte názov odkazu na pripojenie (interný názov s predponou a podčiarkovníkom, napríklad new_connectorName, nie zobrazovaný názov).
4. Intellisense vám ukáže dostupné akcie. Vyberte požadovanú akciu a potom zadajte požadované parametre.

Pred použitím konektora v doplnku s nízkym kódom si prečítajte dokumentáciu konektora , aby ste sa uistili, že vstupné a výstupné parametre odovzdávate správne.

Viac informácií: príklad

Otestujte doplnok s nízkym kódom

Otestujte okamžité doplnky

1. Na Domovskej obrazovke vyberte okamžitý doplnok zo zoznamu a potom na paneli príkazov vyberte Test . Na túto obrazovku sa môžete dostať aj z okamžitého editora doplnkov na paneli príkazov po jej uložení.

2. Zadajte hodnoty pre všetky vstupné parametre, ktoré sú definované v nízkokódovom doplnku, a potom vyberte Spustiť.

Sledujte odozvu.

Testujte automatické doplnky

Otestujte automatické doplnky vyvolaním dátovej udalosti. Overením očakávaných zmien, ktoré boli definované vo vzorci, skontrolujte, či doplnok úspešne bežal.

Integrujte doplnok s nízkym kódom

Vyvolajte okamžitý doplnok z aplikácie na plátne alebo vlastnej stránky

1. V aplikácii Dataverse Accelerator :
   1. V zozname vyberte okamžitý doplnok.
   2. Na paneli príkazov vyberte možnosť Kopírovať útržok kódu .
   3. Prilepte a uložte skopírovaný vzorec do textového editora alebo poznámkového bloku (niekam, kam sa môžete ľahko vrátiť).
2. V Power Apps:
   1. Vytvorte alebo upravte aplikáciu na plátne (alebo vlastnú stránku) v štúdiu Power Apps .
   2. V ľavom navigačnom paneli na karte Zdroje údajov vyberte možnosť + Nový zdroj údajov a vyhľadajte možnosť Prostredie v ponuke konektora Dataverse.
   3. Do plátna vložte nasledujúce komponenty:
   • Pridajte ovládacie prvky vstupu, ktoré zodpovedajú typu údajov každého parametra, ako napríklad Vstup textu pre text alebo čísla, prepínač pre boolovský kód.
   • Ak je rozsah doplnku viazaný na tabuľku, pridajte pole so zoznamom, ktoré je priradené k rovnakej tabuľke, aby ste si mohli vybrať vstup.
   • Pridajte tlačidlo na zavolanie doplnku.
3. Prilepte vzorec doplnku, ktorý ste skopírovali, do vlastnosti OnSelect tlačidla.
4. Mapujte každý vstupný parameter Value tak, aby odkazoval na príslušné ovládacie prvky vstupu:
   • Ak bol vzorec Environment.new_CalculateSum({ X: Value, Y: Value });, mohol by sa prepísať takto: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
   • Ak bol vzorec viazaný, nahraďte Environment zobrazovaným názvom tabuľky, aby ste získali prístup k doplnku.
5. Ak je pre doplnok s nízkym kódom definovaný výstupný parameter:
   1. Zachyťte odpoveď vo vzorci Set() alebo UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Zobrazte premennú v označení. Prípadne použite Notify() vzorec na zobrazenie údajov v upozornení.
6. Spustite aplikáciu a vyberte príkaz na paneli príkazov na spustenie doplnku s nízkym kódom.

Prečítajte si viac o tom, ako môžete vyvolať Dataverse akcie priamo z Power Fx v aplikáciách plátna.

Vyvolajte okamžitý doplnok z Power Automate cloudového toku

1. V cloudovom toku pridajte novú akciu z konektora Microsoft Dataverse .
2. Vyberte akciu s názvom Vykonať neviazanú akciu alebo Vykonať viazanú akciu.
3. Vyberte svoj doplnok (má jedinečný názov s predponou).
4. Zadajte hodnoty pre všetky vstupné parametre (ak existujú).

Vyvolajte okamžitý doplnok z Dataverse Web API

Postupujte podľa krokov pre Neviazaná akcia alebo Funkcia viazaná na tabuľku v sekciách Vyvolanie vlastných rozhraní API z dokumentácie webového rozhrania API (v závislosti od rozsahu doplnku).

Získanie pomoci s doplnkami s nízkym kódom

Ak narazíte na problémy pri vytváraní alebo spúšťaní doplnku s nízkym kódom, prejdite na tieto tipy, kde nájdete bežné problémy, ktoré sa môžu vyskytnúť: Microsoft Dataverse tipy pre doplnky s nízkym kódom a známe problémy

Kontaktovanie pomoci + podpory

V prípade problémov s Dataverse inštaláciou riešenia Accelerator alebo doplnkami s nízkym kódom, ktoré nie sú zahrnuté v Microsoft Dataverse tipoch pre doplnky s nízkym kódom a známymi problémami, ako sú napríklad prijaté nezdokumentované chyby, použite Pomocník + podpora :

• Typ problému- Dataverse Webové rozhranie API a SDK
• Problém Subtype- Kit akcelerátora pre Dataverse

Príklady doplnkov s nízkym kódom, ktoré môžete vytvoriť

Niekoľko príkladov, ako vytvoriť doplnok s nízkym kódom, nájdete v časti Príklad Dataverse doplnky s nízkym kódom (ukážka)

Obmedzenia

• Na prístup k novým zásuvným modulom v rámci existujúcich aplikácií plátna je potrebné prečítať objekt jazyka prostredia. V prípade akýchkoľvek doplnkov vytvorených po pridaní zdroja údajov tabuľky prostredia do existujúcej aplikácie plátna musíte odstrániť a prečítať objekt jazyka prostredia Power Fx . Potom uvidíte aktualizovaný zoznam doplnkov ako akcie.

• Intellisense vyžaduje explicitný zápis v automatických zásuvných moduloch, ak chcete odkazovať na ľubovoľné tabuľky vo vzorci. Použite nasledujúcu syntax disambiguácie, napríklad [@Accounts], pomocou hranatých zátvoriek a symbolu @ (nie Accounts).

• Vnorená podpora. Doplnky môžu z Power Fx výrazov volať iba akcie prvej strany publikované spoločnosťou Microsoft.

• Niektoré Collect scenáre vyžadujú Patch. Existujú scenáre, v ktorých Collect() nefunguje. Riešením je použiť Patch() ako je uvedené v príklade vypĺňania stĺpca nižšie. Ak vytvárate automatický doplnok, pred každú tabuľku, na ktorú sa odkazuje vo vzorci Power Fx , pridajte znak @.

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

• Keď zásuvné moduly s nízkym kódom interagujú s konektormi a používa sa DLP, správca môže zablokovať vytváranie pripojení pomocou DLP. Existujúce odkazy na pripojenie v prostredí Dataverse však naďalej fungujú. V prípade, že správca potrebuje zablokovať všetky interakcie doplnkov s nízkym kódom s akýmikoľvek konektormi, môže zakázať nastavenie organizácie Allowconnectorsonpowerfxactions. Toto nastavenie je predvolene povolené a možno ho zakázať bežnými metódami súpravy SDK (WebAPI, SDK, PowerShell atď.). Môžete to zakázať pomocou okamžitého doplnku s nízkym kódom takto:

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

• Doplnky, ktoré používajú konektory, môžu vydávať výsledky iba zo špecifických polí. Kvôli tomu je potrebné mapovať konkrétne primitívne hodnoty z odozvy konektora na výstupné hodnoty.

Doplnky s nízkym kódom, ktoré majú obmedzenie vlastných konektorov

Ak máte nízkokódové doplnky s vlastnými konektormi, vlastné konektory sa musia najskôr importovať a až potom odkazy na pripojenie alebo toky.

Ak vaše prostredie neobsahuje vlastný konektor v riešení, importujte samostatné riešenie, ktoré obsahuje iba vlastný konektor. Tento import vykonajte pred importovaním skutočného riešenia. Musíte to urobiť ako prvé, pretože Azure musí zaregistrovať vlastný konektor pred importovaním ostatných komponentov riešenia.

Ak importujete riešenie, ktoré obsahuje vlastné konektory a toky, Azure nedokáže zaregistrovať vlastný konektor počas registrácie vašich odkazov na pripojenie alebo tokov. To platí aj pre odkazy na pripojenie pre vlastný konektor, ktorý predtým nebol importovaný v samostatnom riešení. Ak Azure nezaregistroval váš vlastný konektor, import zlyhá alebo import nemôžete spustiť.

Ďalšie informácie: Vytvorte si vlastné konektory v riešeniach: Známe obmedzenia

Pozrite si tiež

Doplnky s nízkym kódom Power Fx (ukážka)

Použite vopred zostavenú výzvu v Dataverse doplnku s nízkym kódom Power Apps

Vytvorte si automatizovaný nízkokódový doplnok s Power Apps (video)

Vytvorte okamžitý nízkokódový doplnok s Power Apps (video)