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 Omfattning 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 till att användas i plugin-program med låg kod. Mer information finns i funktioner som stöds.

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 tabell (entitet) omfattning betyder att plugin-programmet utlöses med kontexten för en specifik tabellpost, och globalt omfång betyder att operationen 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 fungerar genom att skicka in olika värden som du anger i Power Fx-formeln.

Utdataparametrar gör att du kan hämta resultaten av en funktion eller metod för ytterligare användning i programmet.

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

Mer information om integrering från en arbetsyteapp eller i Power Automate molnflöde: Integrera ett plugin-program med låg kod

Behörigheter för plugin-program

Designtid

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örningstid

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

Om du använder säkerhetsroller kan åtkomsten till anslutningsprogrammet i plugin-program begränsas till en viss uppsättning användare inom organisationen. 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 Dataverse Accelerator

  1. Följ anvisningarna för att visa licensierade appar i miljön.
  2. Om Dataverse Accelerator redan är installerat och en uppdatering är tillgänglig visas den i tabellen bredvid objektet.
  3. Välj Dataverse Accelerator och välj Uppdatera i kommandofältet.

Tips!

Aktivera automatiska appuppdateringar för Microsoft – Power CAT utgivare för att automatiskt få uppdateringar när de är tillgängliga (inte nödvändigt för nya miljöer skapade efter 1 oktober 2023).

Obs

Om du tidigare installerade den valfria lågkodslösningen för anslutningsprogram tas den bort automatiskt om du uppdaterar efter 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 kortet Skapa plugin-program direkt. Skapa plugin-program direkt
  3. Tillhandahåll ett visningsnamn.
  4. Definiera alternativt parametrar:
    • Välj Ny indataparameter eller Nya utdataparametern och ange sedan etikett och datatyp.
    • Lägg till fler indata- och utdataparametrar efter behov.
  5. Ange Power Fx-uttryck i redigeraren Uttryck.
    • Referens indataparametrar i formeln efter etikettnamnet.
    • Utdataparametrar måste refereras inne i klammerparenteser, till exempel { Out: "Return value" }.
    • Referens Dataverse-tabeller med datainsamlingsfunktioner som Filter() och LookUp().
    • Om omfattningen är inställd på entitet använder du ThisRecord för att få åtkomst till kolumnvärden i tabellraden som är associerad med plugin-programmet, till exempel ThisRecord.'Account Name'.

    Tips!

    Notera intellisensen i rutan uttryck. Understruken röd är ogiltig. Snirklig gul innebär att logiken kan påverkas av delegeringsbegränsningar. Undvik delegeringsproblem med hjälp av delegerbara funktioner.

  6. Du kan även expandera Avancerade alternativ för att ändra lösningen, omfattning eller beskrivning.
  7. Välj Spara.
  8. Testa det snabba plugin-programmet med låg kod.

Exempel: Beräkna summan av två heltal.

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

Exempel på snabb plugin-program i Dataverse Accelerator-appen

Skapa ett automatiserat plugin-program med låg kod

  1. Spela upp Dataverse Accelerator-appen.
  2. Välj kortet Skapa ett automatiskt plugin-program. Skapa automatiserade plugin-programkort
  3. Ange följande värden:
    • Namn: Ange ett namn för plugin-programmet, t.ex. validering av indata.
    • Tabell: Välj en tabell som plugin-programmet ska associeras med, till exempel Konto.
    • Kör denna plugin-regel när raden är. Ange den datahändelse som aktiverar plugin-programmet.
  4. Ange Power Fx-uttryck i redigeraren Uttryck.
    • Referens Dataverse-tabeller med datainsamlingsfunktioner som Filter() och LookUp().
    • Använd ThisRecord för att få åtkomst till kolumnvärden i tabellraden som är associerad med plugin-programmet, till exempel ThisRecord.'Account Name'.
  5. Du kan även expandera Avancerade alternativ för att ändra stadiet (när det ska köras) och lösningen där plugin-programmet sparas.
  6. Välj Spara.
  7. Testa det automatiserade plugin-programmet med låg kod.

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 anslutningsprogram och anslutningsprogram inifrån ett plugin-program med låg kod a Power Fx-formel.

  1. Skapa en anslutning till den kontakt du vill använda.
  2. Lägg till en anslutningsreferens till anslutningen i Dataverse-miljön.
  3. I plugin-programmet med låg kod Power Fx uttrycksredigeraren, skriv namnet på anslutningsreferensen (det interna namnet med ett prefix och understreck, som 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 en kontakt i en plug-in med låg kod, se över kontaktens dokumentation för att säkerställa att du skickar in- 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. I stället kan du använda de ursprungliga 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. Från Startskärmen, välj ett direkt plugin-program från listan och välj Testa 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 Testa för plugin-programmet med låg kod

  2. Tillhandahåll värden för alla indataparametrar som definieras i plugin-programmet med låg kod och välj Kör. Välj Kör för att testa plugin-programmet med låg kod

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 Plugin-tabellen.
  2. Välj Redigera i kommandofältet.
  3. Skapa, uppdatera eller ta bort rader direkt från den här vyn. Du kan även öppna en rad i standardformuläret genom att markera en rad och sedan välja Redigera rad med formulär 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. I Dataverse Accelerator-appen:
    1. Välj direkt plugin-program i listan.
    2. Välj Kopiera kodavsnitt i kommandofältet. Anropa ett plugin-program med låg kod
    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 den vänstra navigeringen, under fliken Datakällor, välj + Ny datakälla och sök efter alternativet Miljö från Dataverse anslutningsprogram.
    3. Sätt i följande komponenter i arbetsytan:
    • Lägg till inmatningskontroller som motsvarar varje parameters datatyp, som t.ex. Textinmatning för text eller nummer, växlingen 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-programmet.
  3. Klistra in plugin-formeln som du kopierade till knappens OnSelect egenskap.
  4. Mappa varje indataparameter Value så att de refererar till motsvarande indatakontroller:
    • Om formeln var Environment.new_CalculateSum({ X: Value, Y: Value });, skulle den skrivas om som: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Om formeln var bunden ersätter du Environment med tabellen visningsnamn för att ansluta till plugin-programmet.
  5. Om en utdataparameter har definierats för plugin-programmet med låg kod:
    1. Registrera svaret i en Set() eller UpdateContext() formel: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Visa variabeln i en etikett. Alternativt kan du använda Notify()-formeln 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är dig mer om hur du anropar Dataverse-åtgärder direkt från Power Fx i 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. Markera åtgärden Utför en obevakerad å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 anvisningarna för avsnitten Obunden åtgärd eller Funktion bunden till tabell i Anropa anpassade API:er från Web 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 ett plugin-program med låg kod går du till tipsen nedan om vanliga problem som kan uppstå: Microsoft Dataverse tips om plugin-program med låg kod och kända problem

Kontakta Hjälp + support

För problem med installation av Dataverse Accelerator-lösningen eller plugin-program med låg kod som inte täcks i Microsoft Dataverse tips om plugin-program med låg kod och kända problem, t.ex. mottagna 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åg kod finns i Exempel Dataverse plugin-program med låg kod (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 disambigueringsyntax, t.ex. [@Accounts]som använder fyrkanter och @ symbolen (inte 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. Det finns vissa scenarier där Collect() inte fungerar. Lösningen är att använda Patch() som visas i exemplet med fyllning av kolumn 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 skulle blockera alla plugin-interaktioner med lågkod med eventuella kopplingar, kan administratören 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 anslutningsprogram i lösningar: Kända begränsningar

Se även

Plugin-program för låg kod Power Fx (förhandsversion)

Använd en fördefinierad prompt i ett Dataverse-plugin-program med låg kod i Power Apps

Skapa ett automatiserat plugin-program med lite kod med Power Apps (video)

Skapa omedelbart ett plugin-program med lite kod med Power Apps (video)