Dela via

Använda plugin-program med låg kod i Dataverse (förhandsversion)

  • Artikel

[Det här avsnittet utgör förhandsdokumentation och kan komma att ändras.]

Microsoft Dataverse erbjuder en kraftfull lösning för att uppnå effektivare dataarkitektur och minska arbetsbelastningen på klientsidan genom plugin-program med låg kod. Dessa plugin-program är återanvändbara, realtidsarbetsflöden som utför en specifik uppsättning kommandon inom Dataverse, körs på serversidan och utlöses av personliga händelsehanterare.

Viktigt

  • Detta är en förhandsversion.
  • Förhandsversionsfunktioner ska inte användas i produktion och funktionerna kan vara begränsade. funktionerna är tillgängliga före den officiella publiceringen så att kunderna kan få tillgång tidigare och ge oss feedback.

Traditionellt skapades plugin-program som anpassade klasser som sammanställdes till en .NET Framework-enhet, som sedan överfördes och registrerades i Dataverse. Med introduktionen av plugin-program med låg kod kan användare emellertid skapa dessa händelsehanterare med minimal eller ingen kodning som krävs och utan att det krävs manuell registrering.

Plugin-program med låg kod lagras i en Dataverse-databas och kan sömlöst integreras med Power Apps och Power Automate. Arbetsflödets funktion definieras med Power Fx-uttrycksspråket och kan direkt ansluta med Dataverse affärsdata och externa datakällor via Power Platform-anslutningsprogram. Med plugin-program med låg kod kan beslutsfattare snabbt skapa komplexa arbetsflöden med minimal kodexpertis, vilket resulterar i en mer rationaliserad och effektiv dataarkitektur.

Fördelar med serverlogik

Det finns flera fördelar med att definiera affärslogik på serversidan, till exempel:

  • Ökad säkerhet. Eftersom serverlogiken körs på servern kan den hjälpa till att förhindra obehörig åtkomst till känsliga data eller processer.
  • Förbättrad prestanda. Genom att köra på servern kan affärslogik minska mängden data som behöver överföras mellan klienten och servern, vilket resulterar i snabbare bearbetningstider.
  • Konsekvens och tillförlitlighet. Serverlogik säkerställer att affärsregler tillämpas konsekvent på alla klienter, vilket minskar risken för fel eller inkonsekvenser.
  • Enklare underhåll och uppgraderingar. Genom att centralisera affärslogiken på servern blir det lättare att underhålla och uppdatera eftersom det går att göra ändringar på samma plats i stället för att behöva uppdatera flera klienter.
  • Skalbarhet. Serverlogik kan skalas enklare än klientlogik, vilket möjliggör bättre prestanda och hantering av större arbetsbelastningen.

Plugin-program med låg kod

Det finns två typer av plugin-program som stöds i Dataverse:

Type Utlösare Stöder parametrar Omfång som stöds
Direkt Kör manuellt Ja Global och tabell
Automatiserade Dataverse tabellhändelse Nej Register

Alla plugin-program med låg kod har följande vanliga egenskaper:

Property Description
Display name Det mänskliga läsbara namnet på plugin-programmet. Kan inte ändras när det har skapats.
Name Plugin-programmets interna namn. Den används av plattformen för att identifiera komponenten i kod- och databasåtgärder. Kan inte ändras när det har skapats.
Description Används för att ge ytterligare sammanhang om plugin-programmet (syfte, beteende eller annan viktig information).
Lösning Används för att gruppera komponenter och exportera till andra miljöer. Läs mer om lösningar.
Uttryck Det här är den anpassade funktion som kan användas för att utföra åtgärder eller beräkningar och som definieras med uttrycksspråket Power Fx. Power Fx är ett formelspråk som används i Power Apps arbetsyteappar och har utökats för att användas i plugin-program med lågkod. Se funktioner som stöds för mer information.

Ett snabbt plugin-program med anpassad kodlogik som utlöses manuellt av en användare. Anpassade indata- och utdataparametrar kan användas.

Unika egenskaper:

Property Description
Definitionsområde Används för att associera ett plugin-program med en viss tabell. Den kan ställas in på antingen tabell (visas som entitet) eller global, där tabellomfång (entitet) innebär att plugin-programmet utlöses med kontexten för en specifik tabellpost och globalt omfång innebär att åtgärden inte är associerad med en tabell (läs mer).
Parametrar Parametrar ger dig även möjlighet att skicka information mellan plugin-programmet och det sammanhang som det körs i, så att det blir enklare att designa affärslogik som kan återanvändas i olika situationer.

Indataparametrar används för att tillhandahålla data till plugin-programmet och gör att du kan styra hur funktionen beter sig genom att skicka in olika värden som du anger i formeln Power Fx .

Med utdataparametrar kan du hämta resultaten av en funktion eller metod för vidare användning i ditt program.

Datatyper som stöds:
  • Booleskt
  • String
  • Float
  • Decimal
  • Datum/tid
  • Integer

Mer information om hur du integrerar från en arbetsyteapp eller i ett Power Automate molnflöde: Integrera ett plugin-program med lågkod

Behörigheter för plugin-program

Tid för projektering

Tillverkare som har systemanpassare eller systemadministratörs säkerhetsrollmedlemskap i Power Platform-miljön kan komma åt alla plugin-program i den miljön. Anpassade säkerhetsroller kan användas för att begränsa åtkomsten till plugin-program med låg kod.

Körtid

När ett plugin-program anropas får det åtkomst till tabelldata som är inblandade i plugin-definitionen (tabellerna som är en del av formeln, eller om tabellen är associerad med inställningarna för ett automatiskt plugin-program) för den användare som anropade det.

Anslutningar

Med hjälp av säkerhetsroller kan åtkomsten till anslutningsprogrammet i plugin-program begränsas till en viss uppsättning användare i din organisation. Ange vilka roller som har privilegier att skapa, läsa, uppdatera eller ta bort.

Förutsättningar för att skapa ett plugin-program med låg kod

  • Medlemsskap för säkerhetsrollerna systemadministratör eller systemanpassare i Power Platform miljön.
  • Åtkomst till Dataverse Accelerator-app.

Tips!

Alla nya miljöer har Dataverse Accelerator-appen installerad automatiskt från och med 1 oktober 2023. Om du redan har Dataverse Accelerator installerad kan du uppdatera Dataverse Accelerator manuellt.

Uppdatera acceleratorn Dataverse

  1. Följ instruktionerna för att visa licensierade appar i din miljö.
  2. Om acceleratorn Dataverse redan är installerad och en uppdatering är tillgänglig anges den i tabellen bredvid objektet.
  3. Välj Dataverse Accelerator och sedan VäljUpdate i kommandofältet.

Tips!

Aktivera automatiska appuppdateringar för Microsoft – Power CAT-utgivaren för att automatiskt ta emot uppdateringar när de är tillgängliga (inte nödvändigt för nya miljöer som skapats efter den 1 oktober 2023).

Obs

Om du tidigare har installerat den valfria lösningen Plug-ins för anslutningsprogram med lågkod tas den bort automatiskt när du uppdaterar efter den 29 juni 2023. Funktionerna kommer att vara tillgängliga i huvudlösningen.

Skapa ett snabbt plugin-program med låg kod

  1. Spela upp Dataverse Accelerator-appen.
  2. Välj den Skapa direkt plug-in-kort . Skapa direkt plug-in kort
  3. Ange ett visningsnamn.
  4. Du kan också definiera parametrar:
    • VäljNy indataparameter eller Ny utdataparameter och ange sedan etiketten och datatypen.
    • Lägg till fler indata- och utdataparametrar efter behov.
  5. Power Fx Ange uttrycket i uttrycksredigeraren .
    • Referens indataparametrar i formeln efter etikettnamnet.
    • Utdataparametrar måste refereras inom klammerparenteser, till { Out: "Return value" } exempel.
    • Referera till Dataverse tabeller med hjälp av datainsamlingsfunktioner, till exempel Filter() och LookUp().
    • Om omfånget är inställt på entitet använder du ThisRecord för att komma åt kolumnvärden i tabellraden som är associerad med plugin-programmet, till ThisRecord.'Account Name' exempel.

    Tips!

    Anteckna intellisense i rutan Uttryck . Understruken röd är ogiltig. Snirklig gul innebär att logiken kan påverkas av delegeringsbegränsningar. Undvik delegeringsproblem genom att använda delegerbara funktioner.

  6. Du kan också expandera Avancerade alternativ för att ändra lösningen , omfånget ellerbeskrivningen .
  7. Välj Spara.
  8. Testa plugin-programmet för direktåtkomst med lågkod.

Exempel: Beräkna summan av två heltal.

  • Skapa två indataparametrar, X och Y (båda av typen heltal) och en utdataparameter, Z (typsträng).
  • Använd följande formel: {Z: X + Y }

Exempel på omedelbar insticksfil i Dataverse Accelerator-appen

Skapa ett automatiserat plugin-program med låg kod

  1. Spela upp Dataverse Accelerator-appen.
  2. Välj den Skapa ett automatiserat plug-in-kort . Skapa ett automatiserat plug-in-kort
  3. Ange följande värden:
    • Namn: Ange ett namn för plugin-programmet, till exempel Validering av indata.
    • Tabell: Välj en tabell som plugin-programmet ska kopplas till, till exempel Konto.
    • Kör den här plugin-regeln när raden är. Ange den datahändelse som aktiverar plugin-programmet.
  4. Power Fx Ange uttrycket i uttrycksredigeraren .
    • Referera till Dataverse tabeller med hjälp av datainsamlingsfunktioner, till exempel Filter() och LookUp().
    • Används ThisRecord för att komma åt kolumnvärden i den tabellrad som är associerad med plugin-programmet, t.ex ThisRecord.'Account Name'.
  5. Du kan också expandera Avancerade alternativ för att ändra fasen (när detta ska köras) och lösningen där plugin-programmet sparas.
  6. Välj Spara.
  7. Testa plugin-programmet för automatisk lågkod.

Använda Power Platform anslutningsprogram plugin-program med lågkod

Power Platform-anslutningsprogram kan användas i plugin-program med låg kod för att enkelt integrera data och funktionalitet från system utanför Dataverse, som SQL Server, Salesforce och SharePoint, utan behov av komplex kodning eller anpassad utveckling.

Krav för att använda anslutningsprogram i plugin-program med låg kod

Använda anslutningsåtgärder i plugin-program med låg kod

Du kan enkelt använda kopplingar och anpassade kopplingar från en lågkod plugin-fil i en Power Fx formel.

  1. Skapa en anslutning till den kontakt du vill använda.
  2. Lägg till en anslutningsreferens till anslutningen i miljön Dataverse .
  3. I uttrycksredigeraren för plugin-programmet Power Fx lågkod skriver du namnet på anslutningsreferensen (det interna namnet med ett prefix och understreck, t.ex new_connectorName. inte visningsnamnet).
  4. Intellisens visar de tillgängliga åtgärderna. Välj önskad åtgärd och ange sedan parametrarna som krävs.

Innan du använder ett anslutningsprogram i ett plugin-program med lågkod kod bör du läsa dokumentationen för anslutningsprogrammet för att se till att du skickar indata- och utdataparametrarna korrekt.

Mer information: exempel

Obs

  • Inte alla anslutningsåtgärder stöds för närvarande.
  • Använd inte Dataverse anslutningsprogram för att ansluta till Dataverse-tabeller från ett plugin-uttryck. Använd i stället de inbyggda Power Fx funktionerna för att interagera med samlingar: Filter, Search, LookUp, Patch, Collect och Set, där kolumner behandlas som globala variabler.

Testa ett plugin-program med låg kod

Testa direkta plugin-program

  1. På hemskärmen välj du en direkt insticksfil i listan och sedan Välj Test i kommandofältet. Du kan också gå till den här skärmen från direkt plugin-redigerare i kommandofältet efter att den har sparats. Välj Test för plugin-programmet lågkod

  2. Ange värden för alla indataparametrar som har definierats i plugin-programmet för lågkod och välj sedan VäljKör . Välj Kör för att testa plugin-programmet med lågkod

Observera svaret.

Tips!

Använd utdataparametrar för att verifiera förväntat beteende och resultat. I annat fall visas endast ett resultat eller fel vid testning.

Testa automatiserade plugin-program

Testa automatiserade plugin-program genom att anropa datahändelsen. Observera om plugin-programmet har körts genom att verifiera förväntade ändringar som definierats i formeln.

Tips!

Under förhandsversionen kan du anropa den associerade datahändelsen med hjälp av tabellredigeraren i Power Apps:

  1. Logga in Power Apps, gå till Tabeller och välj tabellen Plug-in .
  2. Välj Redigera i kommandofältet.
  3. Skapa, uppdatera eller ta bort rader direkt från den här vyn. Du kan också öppna en rad i standardformuläret genom att markera en rad och sedan väljRedigera rad med hjälp av formuläret i kommandofältet.

Integrera ett plugin-program med låg kod

Anropa ett plugin-program direkt från en app eller en anpassad sida

  1. Gör så här i Accelerator-appen Dataverse :
    1. Välj direkt plugin-program i listan.
    2. Välj kodavsnitt för att kopiera kod i kommandofältet. Anropa ett plugin-program med lågkod för instanser
    3. Klistra in och spara den kopierade formeln till en textredigerare eller anteckningsblock (refererar enkelt till).
  2. I Power Apps:
    1. Skapa eller redigera en app (eller en anpassad sida) i Power Apps studio.
    2. I det vänstra navigeringsfältet, under fliken Datakällor , välj + Ny datakälla och söker efter alternativet Miljö från Dataverse anslutningsprogrammet.
    3. Sätt i följande komponenter i arbetsytan:
    • Lägg till indatakontroller som motsvarar varje parameters datatyp, till exempel Textinmatning för text eller tal, växla för boolesk.
    • Om plugin-programmets omfattning är bunden till en tabell lägger du till en kombinationsruta som är associerad med samma tabell så att du kan välja indata.
    • Lägg till en knapp för att anropa plugin-filen.
  3. Klistra in plugin-formeln som du kopierade i knappens OnSelect egenskap.
  4. Mappa varje indataparameter Value för att referera till motsvarande indatakontroller:
    • Om formeln var det Environment.new_CalculateSum({ X: Value, Y: Value }); skulle den kunna skrivas om som: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Om formeln var bunden ersätter Environment du med tabellens visningsnamn för att komma åt plugin-programmet.
  5. Om en utdataparameter har definierats för plugin-programmet för lågkod:
    1. Samla in svaret i en Set() eller-formel UpdateContext() : Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Visa variabeln i en etikett. Du kan också använda formeln Notify() för att visa data i ett meddelande.
  6. Spela appen och välj kommandot i kommandofältet för att köra plugin-programmet med låg kod.

Läs mer om hur du kan anropa Dataverse åtgärder direkt från Power Fx arbetsyteappar.

Starta ett snabbt plugin-program från ett Power Automate molnflöde

  1. I ett molnflöde lägger du till en ny åtgärd från Microsoft Dataverse anslutningsprogram.
  2. Välj åtgärden som kallas Utför en obunden åtgärd eller Utför en bunden åtgärd.
  3. Välj plugin-programmet (det har det unika namnet med ett prefix).
  4. Tillhandahåll värden för alla indataparametrar (om det finns några).

Starta ett snabb plugin-program från Dataverse webb-API

Följ stegen för avsnitten Obunden åtgärd eller Funktion som är bunden till tabell i Anropa anpassade API:er från webb-API-dokumentationen (beroende på lämplig omfattning av plugin-programmet).

Få hjälp med plugin-program med låg kod

Om du stöter på problem när du skapar eller kör plugin-programmet för lågkod kan du läsa de här tipsen om vanliga problem som kan uppstå: Microsoft Dataverse Tips och kända problem med plugin-program med lågkod

Kontakta Hjälp + support

Om du har problem med installationen av acceleratorlösningen eller plugin-program med Dataverse lågkod som inte ingår i Microsoft Dataverse tipsen om plugin-program med lågkod och kända problem, till exempel odokumenterade fel, använder du Hjälp + support och inkluderar följande information:

  • Problemtyp – Dataverse Webb-API och SDK
  • Problem Undertyp – Accelerator-paket för Dataverse

Exempel på plugin-program med låg kod som du kan skapa

Några exempel på hur du skapar ett plugin-program med lågkod finns i Exempel Dataverse på plugin-program med lågkod (förhandsversion)

Begränsningar

  • Miljöspråkobjektet måste läsas in för att få åtkomst till nya plugin-program i befintliga arbetsyteappar. För alla plugin-program som skapas efter att du har lagt till miljötabellen datakälla till en befintlig arbetsyteapp måste du ta bort och lägga till Power Fx-miljöns språkobjekt igen. Sedan visas den uppdaterade listan över plugin-program med låg kod som åtgärder.

  • För Intellisense krävs explicit notation i automatiserade plugin-program om du vill hänvisa till tabeller i formeln. Använd följande disambigueringssyntax, till exempel [@Accounts] med hakparenteser och symbolen @ (not Accounts).

  • Kapslat stöd. Plugin-program kan bara anropa åtgärder från första part som publicerats av Microsoft från Power Fx-uttryck.

  • Vissa Collect scenarier kräver Patch. Dit finns några scenarier där Collect() det inte fungerar. Lösningen är att använda Patch() som du ser i exemplet med att fylla i ämneskolumnen nedan. Om du skapar ett automatiskt plugin-program förbereder du @till varje tabell som Power Fx-formeln refererar till.

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

  • När plugin-program med låg kod interagerar med kontakter och DLP används, kan administratören blockera skapandet av anslutningar med DLP. Befintliga anslutningsreferenser i Dataverse-miljön fortsätter dock att fungera. Om administratören behöver blockera alla interaktioner med plugin-program med lågkod med anslutningsappar kan de inaktivera organisationsinställningen Allowconnectorsonpowerfxactions. Den här inställningen aktiveras som standard och kan inaktiveras med vanliga SDK-metoder (WebAPI, SDK, PowerShell och så vidare). Du kan inaktivera det här med ett snabb plugin-program med låg kod enligt följande:

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

  • Plugin-program som använder anslutningsprogram kan endast utdata från specifika fält. Därför måste du mappa specifika värden från anslutningsprogramsvaret till utdatavärden.

Plugin-program med låg kod som har begränsningar för anpassade anslutningsprogram

Om du har plugin-program med lite kod med anpassade anslutningsprogram måste de anpassade anslutningsprogrammen importeras först, innan anslutningsreferenser eller flöden.

Om miljön inte innehåller den anpassade kopplingen i en lösning importerar du en separat lösning som endast innehåller det anpassade anslutningsprogrammet. Gör denna import innan du importerar den faktiska lösningen. Du måste göra detta först eftersom Azure måste registrera det anpassade anslutningsprogrammet innan de andra lösningskomponenterna kan importeras.

Om du importerar en lösning som innehåller anpassade anslutningsprogram och flöden kommer Azure inte att kunna registrera det anpassade anslutningsprogrammet när den registrerar dina anslutningsreferenser eller -flöden. Detta gäller även anslutningsreferenser för den anpassade kopplingen som inte tidigare importerats i en separat lösning. Om Azure inte har registrerat din anpassade anslutningsprogram kommer importen att misslyckas eller så kommer du inte att kunna starta importen.

Mer information: Skapa anpassade anslutningsappar i lösningar: Kända begränsningar

Se även

Plugin-program Power Fx med lågkod (förhandsversion)

Använda en fördefinierad uppmaning i ett Dataverse plugin-program med lågkod Power Apps