Kevés kódolást igénylő beépülő modulok használata ( Dataverse előzetes verzió)

[Ez a témakör kiadás előtti dokumentáció, amely a későbbiekben változhat.]

Microsoft Dataverse hatékony megoldást kínál a hatékonyabb adatarchitektúra eléréséhez és az ügyféloldali munkaterhelés csökkentéséhez kevés kódolást igénylő beépülő modulok révén. Ezek a beépülő modulok újrafelhasználható, valós idejű munkafolyamatok, amelyek egy adott parancskészletet hajtanak végre a Dataverse kiszolgálóoldalon, és személyre szabott eseménykezelők indítják el.

Fontos

  • Az azonnali, kevés kódolást igénylő beépülő modulok prioritása megszűnik, és nem szolgáltatásként jelennek meg. Az azonnali kevés kódolást igénylő beépülő modulokat funkciók váltják fel. További információ: Függvények in( Microsoft Dataverse előzetes verzió)
  • Ez egy előnézeti funkció.
  • Az előzetes funkciókat nem célszerű termelési környezetben használni, és előfordulhat, hogy korlátozott funkcionalitással rendelkeznek. Ezek a funkciók a hivatalos kiadás előtt érhetők el, hogy az ügyfelek korán megismerkedhessenek velük, és visszajelzést adhassanak róluk.

Hagyományosan a beépülő modulokat egyéni osztályokként hozták létre, amelyeket egy .NET Framework szerelvénybe fordítottak, majd feltöltötték és regisztrálták Dataverse. A kevés kódolást igénylő beépülő modulok bevezetésével azonban a felhasználók minimális kódolás nélkül vagy kódolás nélkül hozhatják létre ezeket az eseménykezelőket, és manuális regisztráció nélkül.

A kevés kódolást igénylő beépülő modulok egy Dataverse adatbázisban vannak tárolva, és zökkenőmentesen integrálhatók a következőbe Power Apps . Power Automate A munkafolyamat viselkedése a Power Fx kifejezésnyelv használatával van meghatározva, és összekötőkön keresztül Dataverse közvetlenül csatlakozhat az üzleti adatokhoz Power Platform és a külső adatforrásokhoz. A kevés kódolást igénylő beépülő modulokkal a készítők minimális kódolási szakértelemmel gyorsan hozhatnak létre összetett munkafolyamatokat, ami egyszerűbb és hatékonyabb adatarchitektúrát eredményez.

A szerveroldali logika előnyei

A kiszolgálóoldali üzleti logika meghatározása számos előnnyel jár, többek között a következőkkel:

  • Fokozott biztonság. Mivel a kiszolgálóoldali logika a kiszolgálón fut, segíthet megakadályozni a bizalmas adatokhoz vagy folyamatokhoz való jogosulatlan hozzáférést.
  • Jobb teljesítmény. A szerveren történő végrehajtással az üzleti logika csökkentheti az ügyfél és a szerver között továbbítandó adatok mennyiségét, ami gyorsabb feldolgozási időt eredményez.
  • Következetesség és megbízhatóság. A kiszolgálóoldali logika biztosítja, hogy az üzleti szabályok következetesen legyenek alkalmazva az összes ügyfélen, csökkentve a hibák és inkonzisztenciák kockázatát.
  • Egyszerűbb karbantartás és frissítés. Az üzleti logika szerveren történő központosításával könnyebbé válik a karbantartás és a frissítés, mivel a módosítások egy helyen hajthatók végre, ahelyett, hogy több ügyfelet kellene frissíteni.
  • Skálázhatóság. A kiszolgálóoldali logika könnyebben skálázható, mint az ügyféloldali logika, így jobb teljesítményt és nagyobb számítási feladatok kezelését teszi lehetővé.

Kevés kódolást igénylő beépülő modulok

A kevés kódolást igénylő beépülő moduloknak két típusa támogatott Dataverse:

Típus Trigger Támogatja a paramétereket Támogatott hatókör
Azonnali Manuális futtatás Igen Globális és táblázat
Automatizált Dataverse asztali esemény No Tábla

Minden kevés kódolást igénylő beépülő modul a következő közös tulajdonságokkal rendelkezik:

Tulajdonság Description
Megjelenítendő név A beépülő modul ember által olvasható neve. A létrehozás után nem módosítható.
Name A beépülő modul belső neve. A platform az összetevő azonosítására használja a kód- és adatbázisműveletekben. A létrehozás után nem módosítható.
Description A beépülő modul további kontextusának (cél, viselkedés vagy egyéb fontos részletek) biztosítására szolgál.
Megoldás Összetevők csoportosítására és más környezetekbe történő exportálására szolgál. További információ a megoldásokról.
Expression Ez az egyéni függvény, amely műveletek vagy számítások végrehajtására használható, a kifejezés nyelvével Power Fx definiálva. Power Fx a vászonalapú alkalmazásokban Power Apps használt képletnyelv, és kiterjesztették a kevés kódolást igénylő beépülő modulokban való használatra. További részletekért tekintse meg atámogatott függvényeket.

Az azonnali kevés kódolást igénylő beépülő modul egy egyéni kódlogika, amelyet a felhasználó manuálisan aktivál. Egyéni bemeneti és kimeneti paraméterek használhatók.

Egyedi tulajdonságok:

Tulajdonság Description
Scope Beépülő modul adott táblához való társítására szolgál. Beállítható tábla (entitásként jelenik meg) vagy globális, ahol a tábla (entitás) hatóköre azt jelenti, hogy a beépülő modul egy adott táblarekord kontextusával aktiválódik, a globális hatókör pedig azt jelenti, hogy a művelet nincs táblához társítva (további információ).
Paraméterek A paraméterek lehetővé teszik az információk átadását a beépülő modul és az azt futtató környezet között, így könnyebben megtervezheti a különböző helyzetekben újra felhasználható üzleti logikát.

A bemeneti paraméterek arra szolgálnak, hogy adatokat biztosítsanak a beépülő modulnak, és lehetővé teszik a függvény viselkedésének szabályozását a Power Fx képletben megadott különböző értékek átadásával.

A kimeneti paraméterek lehetővé teszik egy függvény vagy metódus eredményeinek lekérését a programban való további felhasználás céljából.

Támogatott adattípusok:
  • logikai
  • Sztring
  • Float
  • Tizedesjegy
  • Dátum/idő
  • Egész szám

További információ a vászonalapú alkalmazásból vagy Power Automate felhőfolyamatból való integrációról: Kevés kódolást igénylő beépülő modul integrálása

Beépülő modulok engedélyei

Tervezési idő

Azok a készítők, akik rendszertestreszabó vagy rendszergazdai biztonsági szerepkörrel rendelkeznek a környezetben, Power Platform hozzáférhetnek az adott környezet összes beépülő moduljához. Az egyéni biztonsági szerepkörök a kevés kódolást igénylő beépülő modulokhoz való hozzáférés korlátozására használhatók.

Futási idő

A beépülő modul meghívásakor hozzáfér a beépülő modul definíciójában szereplő táblaadatokhoz (a képlet részét képező táblákhoz, vagy ha a tábla egy automatikus beépülő modul beállításaihoz van társítva) az azt meghívó felhasználó környezetében.

Kapcsolatok

A biztonsági szerepkörök használatával a beépülő modulokon belüli összekötő-hozzáférés a szervezeten belüli felhasználók egy adott csoportjára korlátozható. Adja meg, hogy mely szerepkörök rendelkeznek létrehozási, olvasási, frissítési vagy törlési jogosultsággal.

Kevés kódolást igénylő beépülő modul létrehozásának előfeltételei

  • Rendszergazdai Power Platform vagy rendszertestreszabó biztonsági szerepkör tagsága a környezetben.
  • Hozzáférés a gyorsító alkalmazáshoz Dataverse .

Tipp.

2023. október 1-jétől minden új környezetben automatikusan telepítve van a gyorsító alkalmazás. Dataverse Ha már telepítette a Dataverse gyorssegédet, manuálisan is frissítheti a Dataverse gyorssegédet.

A gyorssegéd frissítése Dataverse

  1. Kövesse az utasításokat a licencelt alkalmazások megtekintéséhez a környezetében.
  2. Ha a Dataverse gyorssegéd már telepítve van, és elérhető frissítés, az elem melletti táblázatban látható.
  3. Válassza a Dataverse Gyorssegéd, majd a Frissítés lehetőséget a parancssávon.

Tipp.

Engedélyezze az automatikus alkalmazásfrissítéseket a Microsoft – Power CAT közzétevője számára, hogy automatikusan megkapja a frissítéseket, amikor elérhetők (2023. október 1. után létrehozott új környezetek esetén nem szükséges).

Feljegyzés

Ha korábban telepítette az opcionális kevés kódolást igénylő beépülő modulokat az összekötőkhöz megoldást, az automatikusan törlődik, amikor 2023. június 29. után frissít. A képességek a fő megoldásban lesznek elérhetők.

Azonnali kevés kódolást igénylő beépülő modul létrehozása

  1. Játssza le a gyorsító alkalmazást Dataverse .
  2. Válassza az Azonnali bővítmény létrehozása kártyát . Azonnali plug-in kártya létrehozása
  3. Adja meg a megjelenítendő nevet.
  4. Opcionálisan paramétereket is definiálhat:
    • Válassza az Új bemeneti paraméter vagy az Új kimeneti paraméter lehetőséget, majd adja meg a címkét és az adattípust.
    • Szükség szerint adjon hozzá további bemeneti és kimeneti paramétereket.
  5. Írja be a kifejezést Power Fx a Kifejezésszerkesztőbe .
    • Hivatkozzon a képlet bemeneti paramétereire a címke nevével.
    • A kimeneti paraméterekre a kapcsos zárójeleken belül kell hivatkozni, például { Out: "Return value" }:
    • Táblázatok hivatkozása Dataverse adatgyűjtési függvényekkel, például Filter() és LookUp().
    • Ha a hatókör entitásra van állítva, használja a beépülő ThisRecord modul futtatásához társított táblasor oszlopértékeinek eléréséhez, például ThisRecord.'Account Name':

    Tipp.

    Figyelje meg az intellisense-t a Kifejezés mezőben. Az aláhúzott piros érvénytelen. A kacskaringós sárga azt jelenti, hogy a logikát delegálási korlátozások befolyásolhatják. Kerülje el a delegálási problémákat delegálható függvények használatával.

  6. Ha szükséges, bontsa ki a Speciális beállítások elemet a megoldás, a hatókör vagy aleírás módosításához.
  7. Válassza a Mentés parancsot.
  8. Tesztelje az azonnali, kevés kódolást igénylő beépülő modult.

Példa: Számítsa ki két egész szám összegét.

  • Hozzon létre két bemeneti paramétert,and X ( Y mindkettő egész típusú) és egy kimeneti paramétert, Z (karakterlánc) típust.
  • Használja a következő képletet: {Z: X + Y }

Példa azonnali beépülő modulra a gyorssegéd alkalmazásban Dataverse

Automatikus kevés kódolást igénylő beépülő modul létrehozása

  1. Játssza le a gyorsító alkalmazást Dataverse .
  2. Válassza az Automatikus beépülő modul létrehozása kártyát. Automatikus plug-in kártya létrehozása
  3. Adja meg a következő értékeket:
    • Név: Adja meg a beépülő modul nevét, például Bemeneti ellenőrzés.
    • Táblázat: Válasszon ki egy táblát, amelyhez a bővítményt társítani szeretné, például a Fiókot.
    • Futtassa ezt a beépülő modul szabályát, amikor a sor igen. Adja meg a beépülő modult meghívó adateseményt.
  4. Írja be a kifejezést Power Fx a Kifejezésszerkesztőbe .
    • Táblázatok hivatkozása Dataverse adatgyűjtési függvényekkel, például Filter() és LookUp().
    • A beépülő modul futtatásához társított táblasor oszlopértékeinek elérésére használható ThisRecord , például ThisRecord.'Account Name':
  5. Ha szükséges, bontsa ki a Speciális beállítások elemet a szakasz (mikor kell futnia) és a beépülő modul mentésére szolgáló megoldás módosításához .
  6. Válassza a Mentés parancsot.
  7. Tesztelje az automatikus, kevés kódolást igénylő beépülő modult.

Összekötők használata Power Platform kevés kódolást igénylő beépülő modulokban

Power Platform Az összekötők kevés kódolást igénylő beépülő modulokban használhatók a külső rendszerekből Dataverse, például az SQL Serverből és a Salesforce-ból származó adatok és funkciók egyszerű integrálásához, anélkül SharePoint, hogy bonyolult kódolásra vagy egyéni fejlesztésre lenne szükség.

Az összekötők kevés kódolást igénylő beépülő modulokban való használatának előfeltételei

Összekötőműveletek használata kevés kódolást igénylő beépülő modulokban

Egyszerűen használhat összekötőket és egyéni összekötőket egy kevés kódolást igénylő beépülő modulból Power Fx .

  1. Hozzon létre egy kapcsolatot a használni kívánt összekötővel.
  2. Adjon hozzá egy kapcsolati hivatkozást a Dataverse környezetben lévő kapcsolathoz.
  3. A kevés kódolást igénylő beépülő modul Power Fx kifejezésszerkesztőjébe írja be a kapcsolati hivatkozás nevét (a belső nevet előtaggal és aláhúzásjellel, például new_connectorName nem a megjelenítendő névvel).
  4. Az IntelliSense megjeleníti az elérhető műveleteket. Válassza ki a kívánt műveletet, majd adja meg a szükséges paramétereket.

Mielőtt összekötőt használna egy kevés kódolást igénylő beépülő modulban, tekintse át az összekötő dokumentációját , és győződjön meg arról, hogy megfelelően adja át a bemeneti és kimeneti paramétereket.

További információ: példa

Feljegyzés

  • Jelenleg nem minden összekötőművelet támogatott.
  • Ne használja az Dataverse összekötőt beépülő modul kifejezésből táblákhoz Dataverse való csatlakozáshoz. Ehelyett használja a natív Power Fx függvényeket a gyűjteményekkel való interakcióhoz: Filter, Search, LookUp, Patch,CollectésSet, ahol az oszlopokat globális változókként kezeli a rendszer.

Kevés kódolást igénylő beépülő modul tesztelése

Azonnali bővítmények tesztelése

  1. A kezdőképernyőn válasszon ki egy azonnali beépülő modult a listából, majd válassza a Teszt lehetőséget a parancssávon. Ezt a képernyőt a parancssáv azonnali bővítményszerkesztőjéből is elérheti a mentés után. Válassza a Tesztelés lehetőséget a kevés kódolást igénylő beépülő modulhoz

  2. Adja meg a kevés kódolást igénylő beépülő modulban definiált bemeneti paraméterek értékeit, majd válassza a Futtatás lehetőséget. Válassza a Futtatás lehetőséget a kevés kódolást igénylő beépülő modul teszteléséhez

Figyelje meg a választ.

Tipp.

A kimeneti paraméterek használatával ellenőrizheti a várt viselkedést és eredményeket. Ellenkező esetben csak a tesztelés során látja a sikert vagy a sikertelenséget.

Automatikus beépülő modulok tesztelése

Tesztelje az automatikus beépülő modulokat az adatesemény meghívásával. Figyelje meg, hogy a beépülő modul sikeresen futott-e a képletben definiált várt módosítások ellenőrzésével.

Tipp.

Az előzetes verzió során a társított adateseményt a táblaszerkesztővel Power Apps hívhatja meg a következőben:

  1. Jelentkezzen be Power Apps, lépjen a Táblázatok menüpontra , és válassza ki a Beépülő modul táblázatot .
  2. Válassza a parancssávon a Szerkesztés parancsot.
  3. Sorok létrehozása, frissítése vagy törlése közvetlenül ebből a nézetből. Másik lehetőségként nyisson meg egy sort az alapértelmezett űrlapon egy sor kiválasztásával, majd válassza a Sor szerkesztése űrlap használatával lehetőséget a parancssávon.

Kevés kódolást igénylő beépülő modul integrálása

Azonnali beépülő modul meghívása vászonalapú alkalmazásból vagy egyéni oldalról

  1. A Gyorsító Dataverse alkalmazásban :
    1. Válassza ki az azonnali bővítményt a listából.
    2. Válassza a Kódrészlet másolása lehetőséget a parancssávon. Kevés kódolást igénylő beépülő modul meghívása
    3. Illessze be és mentse el a másolt képletet egy szövegszerkesztőbe vagy jegyzettömbbe (valahova, amelyre könnyen visszahivatkozhat).
  2. In: Power Apps
    1. Hozzon létre vagy szerkesszen egy vászonalapú alkalmazást (vagy egyéni oldalt) a Power Apps studióban.
    2. A bal oldali navigációs sávon, az Adatforrások lapon válassza az + Új adatforrás lehetőséget, és keresse meg a Környezet lehetőséget az Dataverse összekötőn.
    3. Szúrja be a következő összetevőket a vászonra:
    • Adja hozzá az egyes paraméterek adattípusának megfelelő bemeneti vezérlőket, például szövegbevitelt szöveghez vagy számhoz, logikai értékre váltást .
    • Ha a beépülő modul hatóköre egy táblához van kötve, adjon hozzá egy kombinált listát, amely ugyanahhoz a táblához van társítva, hogy kiválaszthatja a bemenetet.
    • Adjon hozzá egy gombot a bővítmény hívásához.
  3. Illessze be a másolt beépülő modul képletét a gomb OnSelect tulajdonságába.
  4. Az egyes bemeneti paraméterek Value leképezése a megfelelő bemeneti vezérlőkre való hivatkozáshoz:
    • Ha a képlet az volt Environment.new_CalculateSum({ X: Value, Y: Value });, akkor a következőképpen lehetne átírni: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Ha a képlet kötött volt, cserélje le Environment a táblázat megjelenítendő nevére a bővítmény eléréséhez.
  5. Ha a kevés kódolást igénylő beépülő modulhoz kimeneti paraméter van definiálva:
    1. A válasz rögzítése a Set() vagy képletben UpdateContext() :. Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) ); A változó megjelenítése egy címkében. Másik lehetőségként használhatja a képletet Notify() az adatok értesítésben való megjelenítéséhez.
  6. Játssza le az alkalmazást, és válassza ki a parancsot a parancssávon a kevés kódolást igénylő beépülő modul futtatásához.

További információ arról, hogyan hívhat meg Dataverse műveleteket közvetlenül Power Fx a vászonalapú alkalmazásokból.

Azonnali beépülő modul meghívása felhőfolyamatból Power Automate

  1. Felhőfolyamatban adjon hozzá egy új műveletet az Microsoft Dataverse összekötőből.
  2. Válassza ki a Kötetlen művelet végrehajtása vagy a Kötött művelet végrehajtása nevű műveletet.
  3. Válassza ki a beépülő modult (egyedi névvel és előtaggal rendelkezik).
  4. Adja meg az összes bemeneti paraméter értékét (ha van ilyen).

Azonnali beépülő modul meghívása a Dataverse webes API-ból

Kövesse a Web API dokumentációjának Egyéni API-k meghívása című szakaszának Kötetlen művelet vagy Tábláhozkötött függvény szakaszának lépéseit (a beépülő modul megfelelő hatókörétől függően).

Segítség kérése a kevés kódolást igénylő beépülő modulokhoz

Ha problémákba ütközik a kevés kódolást igénylő beépülő modul létrehozása vagy futtatása során, tekintse meg az alábbi tippeket a gyakori problémákhoz: Microsoft Dataverse kevés kódolást igénylő beépülő modulokkal kapcsolatos tippek és ismert problémák

Kapcsolatfelvétel a Súgó + támogatás segítségével

A gyorsító megoldás telepítésével Dataverse kapcsolatos problémák vagy kevés kódolást igénylő beépülő modulok esetében, amelyek nem szerepelnek a Microsoft Dataverse kevés kódolást igénylő beépülő modulok tippjeiben és ismert problémákban, például nem dokumentált hibákban, használja a Súgó + támogatás felületet , és adja meg a következő információkat:

  • Probléma típusa - Dataverse Web API és SDK
  • Probléma altípusa - Gyorsító készlet Dataverse

Példák kevés kódolást igénylő beépülő modulokra, amelyeket létrehozhat

A kevés kódolást igénylő beépülő modulok létrehozására vonatkozó példákért tekintse meg a Példák kevés kódolást igénylő beépülő modulokra (előzetes verzió) című témakörben Dataverse

Korlátozások

  • A környezet nyelvi objektumát újra hozzá kell adni az új beépülő modulok eléréséhez a meglévő vászonalapú alkalmazásokban. A környezeti tábla adatforrásának egy meglévő vászonalapú alkalmazáshoz való hozzáadása után létrehozott beépülő modulok esetében el kell távolítania, majd újra hozzá kell adnia a környezeti nyelvi objektumot Power Fx . Ezután a beépülő modulok frissített listája műveletként jelenik meg.

  • Az IntelliSense explicit jelölést igényel az automatikus beépülő modulokban, ha a képlet bármely táblájára hivatkozni szeretne. Használja a következő egyértelműsítő szintaxist, például [@Accounts] szögletes zárójeleket és a (nem @ ) szimbólumot Accounts.

  • Beágyazott támogatás. A beépülő modulok csak a Microsoft által közzétett belső műveleteket hívhatják meg kifejezésekből Power Fx .

  • Egyes Collect forgatókönyvek megkövetelik Patch. Vannak olyan forgatókönyvek, amikor Collect() nem működik. A megkerülő megoldás az alábbi oszloppéldában látható módon használható Patch() . Ha automatikus beépülő modult hoz létre, a képletben hivatkozott Power Fx összes táblázat elé írja a @ karaktert.

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

  • Ha kevés kódolást igénylő beépülő modulok kommunikálnak az összekötőkkel, és DLP-t alkalmaznak, a rendszergazda letilthatja a kapcsolatok DLP-vel történő létrehozását. A környezetben meglévő kapcsolati hivatkozások Dataverse azonban továbbra is működnek. Ha a rendszergazdának le kell tiltania az összes kevés kódolást igénylő beépülő modul interakcióját bármely összekötővel, letilthatja a szervezeti beállítást Allowconnectorsonpowerfxactions. Ez a beállítás alapértelmezés szerint engedélyezve van, és a szokásos SDK-metódusokkal (WebAPI, SDK, PowerShell stb.) letiltható. Ezt egy kevés kódolást igénylő azonnali beépülő modullal tilthatja le az alábbiak szerint:

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

  • Az összekötőket használó beépülő modulok csak adott mezőkből tudnak eredményeket kiadni. Emiatt adott primitív értékeket kell leképeznie az összekötő válaszából a kimeneti értékekre.

Kevés kódolást igénylő beépülő modulok, amelyek egyéni összekötők korlátozásával rendelkeznek

Ha kevés kódolást igénylő beépülő modulokkal rendelkezik egyéni összekötőkkel, először az egyéni összekötőket kell importálni a kapcsolati hivatkozások vagy folyamatok előtt.

Ha a környezet nem tartalmazza az egyéni összekötőt egy megoldásban, importáljon egy külön megoldást, amely csak az egyéni összekötőt tartalmazza. Ezt az importálást a tényleges megoldás importálása előtt végezze el. Ezt először meg kell tennie, mert az Azure-nak regisztrálnia kell az egyéni összekötőt a többi megoldás-összetevő importálása előtt.

Ha egyéni összekötőket és folyamatokat tartalmazó megoldást importál, az Azure nem tudja regisztrálni az egyéni összekötőt a kapcsolati hivatkozások vagy folyamatok regisztrálása közben. Ez vonatkozik az egyéni összekötő kapcsolati hivatkozásaira is, amelyeket korábban nem importáltak külön megoldásba. Ha az Azure nem regisztrálta az egyéni összekötőt, az importálás sikertelen lesz, vagy nem tudja elindítani az importálást.

További információ: Egyéni összekötők létrehozása megoldásokban: Ismert korlátozások

Kapcsolódó információk

Kevés kódolást igénylő beépülő modulok Power Fx (előzetes verzió)

Használjon előre beépített promptot egy Dataverse alacsony kódú beépülő modulban Power Apps

Hozzon létre egy automatikus alacsony kódú beépülő modult a(z) Power Apps (videó) segítségével

Azonnali alacsony kódú beépülő modul létrehozása a(z) Power Apps (videó) segítségével

  • Last updated on