Sdílet prostřednictvím

Používání modulů plug-in s minimálním psaním kódu v Dataverse (Preview)

  • Článek

[Toto téma představuje předběžnou dokumentaci a může se změnit.]

Microsoft Dataverse nabízí výkonné řešení pro dosažení efektivnější datové architektury a snížení zátěže na straně klienta prostřednictvím zásuvných modulů s nízkým obsahem kódu. Tyto zásuvné moduly jsou opakovaně použitelné pracovní postupy v reálném čase, které provádějí specifickou sadu příkazů v rámci Dataverse, běží na straně serveru a spouštějí personalizované obslužné rutiny událostí.

Důležité

  • Toto je funkce Preview.
  • Funkce Preview nejsou určené pro normální používání a mohou mít omezené fungování. Jsou to funkce, které jsou poskytnuté před svým oficiálním vydáním, aby si je zákazníci mohli co nejdříve vyzkoušet a mohli nám napsat své názory.

Zásuvné moduly byly tradičně vytvářeny jako vlastní třídy zkompilované do sestavení .NET Framework, které byly poté nahrány a zaregistrovány v rámci Dataverse. Se zavedením zásuvných modulů s nízkým obsahem kódu však mohou uživatelé vytvářet tyto obslužné rutiny událostí s minimálním nebo žádným požadovaným kódováním a bez nutnosti ruční registrace.

Pluginy s nízkým kódem jsou uloženy v databázi Dataverse je bez problémů integrovat do Power Apps a Power Automate. Chování pracovního postupu je definováno pomocí výrazového jazyka Power Fx a lze jej přímo propojit s obchodními daty Dataverse a externími datovými zdroji prostřednictvím konektorů Power Platform. Díky zásuvným modulům s nízkým obsahem kódu mohou tvůrci rychle vytvářet složité pracovní postupy s minimálními znalostmi v oblasti kódování, což vede k efektivnější datové architektuře.

Výhody logiky na straně serveru

Definování obchodní logiky na straně serveru nabízí několik výhod, včetně:

  • Zvýšeného zabezpečení. Protože se logika na straně serveru spouští na serveru, může pomoci zabránit neoprávněnému přístupu k citlivým datům nebo procesům.
  • Zlepšení výkonu. Spuštěním na serveru může obchodní logika snížit množství dat, která je třeba přenést mezi klientem a serverem, což má za následek rychlejší zpracování.
  • Konzistence a spolehlivost. Logika na straně serveru zajišťuje konzistentní uplatňování obchodních pravidel napříč všemi klienty, čímž se snižuje riziko chyb nebo nekonzistencí.
  • Jednodušší údržba a upgrady. Díky centralizaci obchodní logiky na serveru je její údržba a aktualizace snazší, protože změny lze provádět na jednom místě a nemusíte aktualizovat více klientů.
  • Škálovatelnost. Logiku na straně serveru lze škálovat snadněji než logiku na straně klienta, což umožňuje lepší výkon a manipulaci s většími pracovními zátěžemi.

Moduly plugin s minimálním psaním kódu

Existují dva typy modulů plug-in s minimálním psaním kódu podporovaných v Dataverse:

Type Trigger Podporuje parametry Podporovaný rozsah
Okamžitý Spustit ručně Ano Globální a tabulka
Automatizováno Událost tabulky Dataverse Ne Table

Všechny plug-iny s minimálním psaním kódu mají následující společné vlastnosti:

Vlastnost Description
Display name Srozumitelný název modulu plug-in. Tuto hodnotu nelze měnit, jakmile je vytvořena.
Name Interní název modulu plug-in. Platforma jej používá k identifikaci komponenty v kódových a databázových operacích. Tuto hodnotu nelze měnit, jakmile je vytvořena.
Description Používá se k poskytnutí dalšího kontextu o zásuvném modulu (účel, chování nebo jiné důležité podrobnosti).
Řešení Používá se k seskupování komponent a exportu do jiných prostředí. Další informace o řešení.
Výraz Toto je vlastní funkce, kterou lze použít k provádění akcí nebo výpočtů definovaných pomocí jazyka výrazů Power Fx. Power Fx je jazyk vzorců používaný v Power Apps canvas aplikacích a byl rozšířen pro použití v zásuvných modulech s minimálním psaním kódu. Další podrobnosti naleznete v části podporované funkce.

Okamžitý modul plug-in s minimálním psaním kódu je logika vlastního kódu, kterou spouští uživatel. Lze použít vlastní vstupní a výstupní parametry.

Jedinečné vlastnosti:

Vlastnost Description
Obor Používá se k přiřazení zásuvného modulu ke konkrétní tabulce. Lze jej nastavit buď na tabulku (zobrazenou jako entita), nebo na globální, kde rozsah tabulky (entity) znamená, že se plugin spouští v kontextu konkrétního záznamu tabulky, a globální rozsah znamená, že operace není spojena s tabulkou. (další informace).
Parametry Parametry vám umožňují předávat informace mezi modulem plug-in a kontextem, který ho spouští, takže je jednodušší navrhnout obchodní logiku, kterou lze znovu použít v různých situacích.

Vstupní parametry se používají k poskytování dat modulu plug-in a umožňují vám řídit, jak se funkce chová, předáním různých hodnot, které zadáte ve vzorci Power Fx .

Výstupní parametry umožňují získat výsledky funkce nebo metody pro další použití ve vašem programu.

Podporované datové typy:
  • Logické
  • Řetězcové
  • Float
  • Desetinné
  • DateTime
  • Integer

Další informace o integraci z aplikace na plátně nebo v Power Automate cloudový tok: Integrujte plugin s minimálním psaním kódu

Oprávnění modulu plug-in

Čas návrhu

Tvůrci, kteří mají členství role zabezpečení úpravce systéme nebo správce systému v prostředí Power Platform, mohou přistupovat všechny moduly plug-in v daném prostředí. Vlastní role zabezpečení lze použít k omezení přístupu k zásuvným modulům s nízkým kódem.

Doba běhu

Když je modul plug-in vyvolán, přistupuje k datům tabulky zahrnutým v definici modulu plug-in (tabulky, které jsou součástí vzorce nebo pokud je tabulka přidružena k nastavení automatizovaného modulu plug-in) v kontextu uživatele, který jej vyvolal.

Spojení

Pomocí rolí zabezpečení lze přístup ke konektorům v rámci plug-inů omezit na konkrétní skupinu uživatelů ve vaší organizaci. Určete, které role mají oprávnění k vytváření, čtení, aktualizaci nebo odstraňování.

Předpoklady pro vytvoření modulů plug-in s minimálním psaním kódu

  • Role zabezpečení správce systému nebo úpravce systému v prostředí Power Platform.
  • Přístup k aplikaci akcelerátor Dataverse.

Tip

Všechna nová prostředí mají od 1. října 2023 automaticky nainstalovanou aplikaci akcelerátor Dataverse. Pokud jste již měli nainstalovaný akcelerátor Dataverse, můžete akcelerátor Dataverse aktualizovat ručně.

Aktualizujte akcelerátor Dataverse

  1. Postupujte podle pokynů k zobrazení licencovaných aplikací ve vašem prostředí.
  2. Pokud je Dataverse Accelerator již nainstalován a je k dispozici aktualizace, je to uvedeno v tabulce vedle položky.
  3. Vyberte Dataverse Akcelerátor a poté na příkazovém řádku vyberte Aktualizovat .

Tip

Povolte automatické aktualizace aplikací pro vydavatele Microsoft - Power CAT , aby automaticky dostával aktualizace, když jsou k dispozici (není nutné pro nové prostředí vytvořená po 1. říjnu 2023).

Poznámka:

Pokud jste dříve nainstalovali volitelné řešení s minimálním psaním kódu Plug-ins for Connectors , bude po aktualizaci po 29. červnu 2023 automaticky odstraněno. Funkce budou dostupné v hlavním řešení.

Vytvořte okamžitý plug-in s minimálním psaním kódu

  1. Spusťte aplikaci akcelerátor Dataverse.
  2. Vyberte možnost Vytvořit okamžitý zásuvný modul karta. Vytvořte okamžitý plug-in karta
  3. Zadejte zobrazované jméno.
  4. Volitelně definujte parametry:
    • Vyberte Nový vstupní parametr nebo Nový výstupní parametr, poté zadejte označení a datový typ.
    • Podle potřeby přidejte další vstupní a výstupní parametry.
  5. V editoru Power Fx Výraz zadejte výraz .
    • Vstupní parametry ve vzorci odkazujte podle názvu štítku.
    • Výstupní parametry musí být odkazovány uvnitř složených závorek, například { Out: "Return value" }.
    • Odkazujte na Dataverse tabulky pomocí funkcí sběru dat, jako jsou Filter() a LookUp().
    • Pokud je rozsah nastaven na entitu, použijte ThisRecord pro přístup k hodnotám sloupců v řádku tabulky spojeném se spuštěním modulu plug-in, jako je ThisRecord.'Account Name'.

    Tip

    Všimněte si inteligence v poli Výraz . Červená podtržená je neplatná. Zvlněná žlutá znamená, že vaše logika může být ovlivněna omezeními delegování. Vyhněte se problémům s delegováním pomocí delegovatelných funkcí.

  6. Volitelně rozbalte Pokročilé možnosti a upravte řešení, rozsah nebo popis.
  7. Zvolte Uložit.
  8. Otestujte svůj okamžitý s minimálním psaním kódu plug-in.

Příklad: Vypočítejte součet dvou celých čísel.

  • Vytvořte dva vstupní parametry X a Y (oba typu integer) a jeden výstupní parametr Z (typový řetězec).
  • Použijte následující vzorec: {Z: X + Y }

Okamžitý příklad zásuvného modulu v Dataverse aplikaci Accelerator

Vytvořte automatický plug-in s minimálním psaním kódu

  1. Spusťte aplikaci akcelerátor Dataverse.
  2. Vyberte Vytvořit automatický zásuvný modul karta. Vytvořte automatický plug-in karta
  3. Zadejte následující hodnoty:
    • Název: Zadejte název zásuvného modulu, například Ověření vstupu.
    • Tabulka: Vyberte tabulku, ke které chcete plugin přiřadit, například Účet.
    • Spusťte toto pravidlo zásuvného modulu, když je řádek. Zadejte datovou událost, která vyvolá modul plug-in.
  4. V editoru Power Fx Výraz zadejte výraz .
    • Odkazujte na Dataverse tabulky pomocí funkcí sběru dat, jako jsou Filter() a LookUp().
    • Použijte ThisRecord pro přístup k hodnotám sloupců v řádku tabulky spojeném se spuštěním modulu plug-in, například ThisRecord.'Account Name'.
  5. Volitelně rozbalte položku Pokročilé možnosti a upravte fáze (kdy by se to mělo spustit) a řešení kde je zásuvný modul uložen.
  6. Zvolte Uložit.
  7. Otestujte svůj automatický s minimálním psaním kódu plug-in.

Používání konektorů Power Platform s moduly plug-in s minimálním psaním kódu

Konektory Power Platform lze použít v zásuvných modulech s nízkým kódem pro snadnou integraci dat a funkcí ze systémů mimo Dataverse, jako je SQL Server, Salesforce a SharePoint, bez nutnosti složitého kódování nebo zakázkového vývoje.

Předpoklady pro použití konektorů v zásuvných modulech s nízkým kódem

Používání akcí konektorů v modulech plug-in s minimálním psaním kódu

Můžete snadno používat konektory a vlastní konektory z s minimálním psaním kódu plug-inu a Power Fx vzorec.

  1. Vytvořit propojení do konektoru, který chcete použít.
  2. Přidejte informace o připojení k připojení v Dataverse prostředí.
  3. V s minimálním psaním kódu plug-in Power Fx editoru výrazů zadejte název informace o připojení (interní název s předponou a podtržítkem, např. new_connectorName, nikoli zobrazované jméno).
  4. Intellisense vám ukáže dostupné akce. Vyberte požadovanou akci a poté zadejte požadované parametry.

Před použitím konektoru v s minimálním psaním kódu plug-inu si prostudujte dokumentaci konektoru , abyste se ujistili, že vstupní a výstupní parametry předáváte správně.

Další informace: příklad

Poznámka:

  • V současnosti nejsou podporovány všechny akce konektorů.
  • Nepoužívejte konektor Dataverse k připojení k tabulkám Dataverse z výrazu modulu plug-in. Místo toho použijte k interakci s kolekcemi nativní funkce Power Fx : Filtrovat, Hledat, Vyhledat, Oprava, Collect a Set, kde jsou sloupce považovány za globální proměnné.

Otestujte modul plug-in s nízkým kódem

Otestujte okamžité zásuvné moduly

  1. Na domovské obrazovce vyberte okamžitý zásuvný modul ze seznamu a poté na příkazovém řádku vyberte Test . Na tuto obrazovku se můžete také dostat z okamžitého editoru zásuvných modulů na panelu příkazů po jejím uložení. Vyberte Test pro plug-in s minimálním psaním kódu

  2. Zadejte hodnoty pro všechny vstupní parametry, které jsou definovány v modulu plug-in s minimálním psaním kódu, a poté vyberte Spustit. Vyberte Spustit a otestujte plug-in s minimálním psaním kódu

Sledujte odpověď:

Tip

Použijte výstupní parametry k ověření očekávaného chování a výsledků. Jinak při testování vidíte jen úspěch nebo neúspěch.

Testujte automatické zásuvné moduly

Otestujte automatické zásuvné moduly vyvoláním datové události. Ověřením očekávaných změn, které byly definovány ve vzorci, sledujte, zda modul plug-in úspěšně běžel.

Tip

Během náhledu můžete vyvolat související datovou událost pomocí editoru tabulky v Power Apps:

  1. Přihlaste se do Power Apps, přejděte na Tabulky a vyberte tabulku Plug-in .
  2. Na panelu příkazů vyberte Upravit.
  3. Vytvořte, aktualizujte nebo odstraňte řádky přímo z tohoto zobrazení. Případně otevřete řádek ve výchozím formuláři výběrem řádku a poté vyberte Upravit řádek pomocí formuláře na panelu příkazů.

Integrujte modul plug-in s nízkým kódem

Vyvolejte okamžitý modul plug-in z aplikace plátna nebo vlastní stránky

  1. V aplikaci Dataverse Accelerator :
    1. Vyberte okamžitý modul plug-in v seznamu.
    2. Vyberte Kopírovat kód fragment na příkazovém řádku. Vyvolejte instanci plug-inu s minimálním psaním kódu
    3. Vložte a uložte zkopírovaný vzorec do textového editoru nebo poznámkového bloku (někam, kam se můžete snadno vrátit).
  2. V Power Apps:
    1. Vytvořte nebo upravte aplikaci na plátně (nebo vlastní stránku) v Power Apps studio.
    2. V levé navigaci na kartě Zdroje dat vyberte + Nový zdroj dat a vyhledejte Prostředí volba z konektoru Dataverse .
    3. Do plátna vložte následující součásti:
    • Přidejte ovládací prvky vstupu, které odpovídají datovému typu každého parametru, například Vstup textu pro text nebo čísla, přepínač pro logický.
    • Pokud je rozsah modulu plug-in vázán na tabulku, přidejte pole se seznamem, které je přidruženo ke stejné tabulce, abyste mohli vybrat vstup.
    • Přidáním tlačítka zavoláte zásuvný modul.
  3. Vložte vzorec zásuvného modulu, který jste zkopírovali, do vlastnosti OnSelect tlačítka.
  4. Mapujte každý vstupní parametr Value tak, aby odkazoval na odpovídající ovládací prvky vstupu:
    • Pokud by vzorec byl Environment.new_CalculateSum({ X: Value, Y: Value });, mohl by být přepsán jako: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Pokud byl vzorec svázán, nahraďte Environment tabulkou zobrazované jméno pro přístup k zásuvnému modulu.
  5. Pokud je pro plug-in s minimálním psaním kódu definován výstupní parametr:
    1. Zachyťte odpověď ve vzorci Set() nebo UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Zobrazit proměnnou v popisku. Alternativně použijte k zobrazení dat v oznámení vzorec Notify() .
  6. Spusťte aplikaci a výběrem příkazu na příkazovém řádku spusťte modul plug-in s minimálním psaním kódu.

Přečtěte si další informace o tom, jak můžete volat Dataverse akce přímo z Power Fx v aplikacích plátna.

Vyvolejte okamžitý modul plug-in z cloudového toku Power Automate

  1. V cloudovém toku přidejte novou akci z konektoru Microsoft Dataverse.
  2. Vyberte akci s názvem Provést nesvázanou akci nebo Provést svázanou akci.
  3. Vyberte svůj modul plug-in (má jedinečný název s předponou).
  4. Zadejte hodnoty pro všechny vstupní parametry (pokud existují).

Vyvolejte okamžitý zásuvný modul z webového rozhraní API Dataverse

Postupujte podle kroků pro Nevázaná akce nebo Funkce vázaná na tabulku části Vyvolání vlastní rozhraní API z dokumentace webového rozhraní API (v závislosti na příslušném rozsahu zásuvného modulu).

Získání pomoci s moduly plug-in s minimálním psaním kódu

Pokud narazíte na problémy s vytvářením nebo spouštěním plug-inu s minimálním psaním kódu, přejděte na tyto tipy pro běžné problémy, které mohou nastat: Microsoft Dataverse s minimálním psaním kódu tipy pro plug-iny a známé problémy

Kontaktování Nápovědy a podpory

Pro problémy s instalací řešení Dataverse Accelerator nebo s minimálním psaním kódu plug-iny, které nejsou zahrnuty v Microsoft Dataverse s minimálním psaním kódu tipech pro plug-iny a známé problémy, jako jsou nezdokumentované chyby, použijte Nápovědu + podporu a uveďte následující informace:

  • Typ problému- Dataverse Webové rozhraní API a SDK
  • Problém Subtype- Accelerator kit pro Dataverse

Příklady modulů plug-in s minimálním psaním kódu, které můžete vytvořit

Několik příkladů, jak vytvořit plugin s minimálním psaním kódu, najdete na Příklad Dataverse s minimálním psaním kódu pluginy (Preview)

Omezení

  • Pro přístup k novým modulům plug-in v rámci existujících aplikací plátna je třeba načíst objekt jazyka prostředí. U všech modulů plug-in vytvořených poté, co jste přidali zdroj dat tabulky prostředí do existující aplikace plátna, musíte odstranit a přečíst objekt jazyka prostředí Power Fx. Poté uvidíte aktualizovaný seznam modulů plug-in jako akce.

  • Intellisense vyžaduje explicitní zápis v automatických zásuvných modulech, pokud chcete odkazovat na jakékoli tabulky ve vzorci. Použijte následující syntaxi zjednoznačnění, jako je [@Accounts], pomocí hranatých závorek a symbolu @ (nikoli Accounts).

  • Vnořená podpora. Moduly plug-in mohou volat pouze akce první strany publikované společností Microsoft z výrazů Power Fx .

  • Některé Collect scénáře vyžadují Patch. Existují některé scénáře, kdy Collect() nefunguje. Řešením je použít Patch() , jak je uvedeno v příkladu vyplnění sloupce níže. Pokud vytváříte automatický modul plug-in, přidejte před každou tabulku odkazovanou ve vzorci Power Fx znak @.

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

  • Když plug-iny s nízkým kódem interagují s konektory a je použito DLP, může správce blokovat vytváření připojení pomocí DLP. Existující odkazy na připojení v prostředí Dataverse však nadále fungují. V případě, že administrátor potřebuje zablokovat všechny interakce s minimálním psaním kódu plug-inů s libovolnými konektory, může zakázat nastavení organizace Allowconnectorsonpowerfxactions. Toto nastavení je ve výchozím nastavení povoleno a lze jej zakázat obvyklými metodami sady SDK (WebAPI, SDK, PowerShell atd.). Můžete to zakázat pomocí okamžitého plug-inu s nízkým kódem takto:

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

  • Zásuvné moduly, které používají konektory, mohou vydávat pouze výsledky z konkrétních polí. Kvůli tomu je potřeba namapovat konkrétní primitivní hodnoty z odezvy konektoru na výstupní hodnoty.

Moduly plug-in s minimem kódu, které mají omezení vlastních konektorů

Pokud používáte moduly plug-in s minimem kódu s vlastními konektory, musíte nejprve importovat vlastní konektory před informacemi o připojení nebo toky.

Pokud vaše prostředí neobsahuje vlastní konektor v řešení, importujte samostatné řešení, které obsahuje pouze vlastní konektor. Tento import proveďte před importem samotného řešení. Musíte to provést jako první věc, protože Azure musí registrovat vlastní konektor, než mohou být importovány ostatní součásti řešení.

Pokud importujete řešení obsahující vlastní konektory a toky, Azure nemůže registrovat vlastní konektor, zatímco registruje informace o připojení nebo toky. To platí také pro odkazy na připojení pro vlastní konektor, který dříve nebyl importován v samostatném řešení. Pokud Azure nezaregistroval váš vlastní konektor, import se nezdaří nebo nebudete moci import spustit.

Další informace: Vytváření vlastních konektorů v řešeních: Známá omezení

Viz také

s minimálním psaním kódu plug-iny Power Fx (Preview)

Použijte předem sestavenou výzvu v zásuvném modulu Dataverse s minimálním psaním kódu Power Apps