Del via

Bruk lavkodebaserte programtillegg i Dataverse (forhåndsversjon)

  • Artikkel

[Dette emnet inneholder dokumentasjon for forhåndsversjonen, og kan bli endret.]

Microsoft Dataverse tilbyr en kraftig løsning for å oppnå mer effektiv dataarkitektur og redusere arbeidsbelastningen på klientsiden via plugin-moduler med lav kode. Disse plugin-modulene er arbeidsflyter som kan brukes på nytt i sanntid, og som kjører et bestemt sett kommandoer i Dataverse, som kjøres på serversiden og utløses av tilpassede hendelsesbehandlinger.

Viktig

  • Dette er forhåndsversjonsfunksjon.
  • Forhåndsversjonsfunksjonene er ikke ment for produksjonsbruk og kan ha begrenset funksjonalitet. Disse funksjonene er tilgjengelige før en offisiell utgivelse, slik at kunder kan få tidlig tilgang og gi tilbakemeldinger.

Plugin-moduler ble vanligvis opprettet som egendefinerte klasser kompilert i en .NET Framework-samling, som deretter ble lastet opp og registrert i Dataverse. Med introduksjonen av plugin-moduler med lav kode kan brukere imidlertid opprette disse hendelsesbehandlingene med minimal eller ingen koding, og uten behov for manuell registrering.

Plugin-moduler med lav kode lagres i en Dataverse-database og kan sømløst integreres i Power Apps og Power Automate. Funksjonaliteten til arbeidsflyten defineres ved hjelp av Power Fx-uttrykksspråket og kan koble direkte til Dataverse-forretningsdata og eksterne datakilder via Power Platform-koblinger. Med plugin-moduler med lav kode kan oppretter raskt konstruere komplekse arbeidsflyter med minimal ekspertise på koding, noe som resulterer i en mer strømlinjeformet og effektiv dataarkitektur.

Fordeler ved logikk på serversiden

Definere forretningslogikk på serversiden har flere fordeler, blant annet følgende:

  • Økt sikkerhet. Siden logikk på serversiden kjøres på serveren, kan den bidra til å hindre uautorisert tilgang til sensitive data eller prosesser.
  • Forbedret ytelse. Hvis forretningslogikken utføres på serveren, kan den redusere datamengden som må overføres mellom klienten og serveren, noe som fører til raskere behandlingstid.
  • Konsekvens og pålitelighet. Logikk på serversiden sikrer at forretningsregler konsekvent brukes på alle klienter og reduserer risikoen for feil eller inkonsekvenser.
  • Enklere vedlikehold og oppgraderinger. Ved å sentralisere forretningslogikken på serveren blir det enklere å vedlikeholde og oppdatere, siden endringer kan gjøres på ett sted i stedet for å måtte oppdatere flere klienter.
  • Skalerbarhet. Logikk på serversiden kan skaleres enklere enn logikk på klientsiden, noe som gir bedre ytelse og håndtering av større arbeidsbelastninger.

Lavkodebaserte programtillegg i

Det finnes to typer lavkodebaserte programtillegg som støttes i Dataverse:

Type Utløser Støtter parametre Støttet omfang
Direkte Kjøres manuelt Ja Global og tabell
Automatisert Dataverse-tabellhendelse Nei Table

Alle plugin-moduler med lav kode har følgende fellesegenskaper:

Egenskap Description
Display name Det lesbare navnet på plugin-modulen. Kan ikke endres når det er opprettet.
Name Det interne navnet på plugin-modulen. Den brukes av plattformen til å identifisere komponenten i kode- og databaseoperasjoner. Kan ikke endres når det er opprettet.
Description Brukes til å gi ytterligere kontekst om plugin-modulen (formål, virkemåte eller andre viktige detaljer).
Løsning Brukes til å gruppere komponenter og eksportere til andre miljøer. Finn ut mer om løsninger.
Uttrykk Dette er den egendefinerte funksjonen som kan brukes til å utføre handlinger eller beregninger, definert ved hjelp av uttrykksspråket Power Fx. Power Fx er et formelspråk som brukes i Power Apps-lerretsapper og er utvidet til å brukes i plugin-moduler med lav kode. Se støttede funksjoner hvis du vil ha mer informasjon.

Et umiddelbart lavkodebasert programtillegg er egendefinert kodelogikk som er utløses manuelt av en bruker. Egendefinerte inndata- og utdataparametere kan brukes.

Unike egenskaper:

Egenskap Description
Scope Brukes til å knytte en plugin-modul til en bestemt tabell. Det kan angis til tabell (vist som enhet) eller globalt, der tabellomfanget (enhet) betyr at plugin-modulen utløses med konteksten for en bestemt tabelloppføring, og globalt omfang betyr at operasjonen ikke er knyttet til en tabell (mer informasjon).
Parametere Parametere gir deg også muligheten til å sende informasjon mellom programtilleggene og konteksten som kjører den, slik at det er enklere å utforme forretningslogikk som kan brukes i ulike situasjoner.

Inndataparametere brukes til å gi data til plugin-modulen, og gjør det mulig å styre hvordan funksjonen fungerer ved å sende inn forskjellige verdier du angir i Power Fx-formelen.

Utdataparametere gjør det mulig å hente resultatene av en funksjon eller metode for videre bruk i programmet.

Datatyper som støttes:
  • Boolean
  • String
  • Float
  • Decimal
  • Date/klokkeslett
  • Integer

Mer informasjon om hvordan du integrerer fra en lerretsapp eller i en Power Automate-skyflyt: Integrere en plugin-modul med lav kode

Tillatelser for programtillegg

Utformingstid

Opprettere som har sikkerhetsrollemedlemskapet systemtilpasser eller systemadministrator i Power Platform-miljøet kan få tilgang til alle plugin-modulser i det miljøet. Egendefinerte sikkerhetsroller kan brukes til å begrense tilgang til plugin-moduler med lav kode.

Kjøretid

Når en plugin-modul startes, får den tilgang til tabelldataene som er involvert i definisjonen av plugin-modulen (tabellene som er en del av formelen, eller hvis tabellen er knyttet til innstillingene for en automatisk plugin-modul) i konteksten til brukeren som startet den.

Tilkoblinger

Ved hjelp av sikkerhetsroller kan tilkoblingstilgangen i plugin-moduler være begrenset til et bestemt sett med brukere i organisasjonen. Angi hvilke roller som har rettigheter til å opprette, lese, oppdatere eller slette.

Forhåndskrav for å opprette et lavkodebasert programtillegg

Obs!

Vi ruller ut et sett med oppdateringer for å aktivere Dataverse-plugin-modulene for lav kode. Disse plugin-modulene med lav kode bruker et brukergrensesnitt bygd på Power Platform funksjon for egendefinerte sider. Som en del av disse oppdateringene implementerer vi i miljøer ved hjelp av kontoer for systemvedlikehold. I noen tilfeller har disse kontoene hatt en uventet bieffekt av å presenteres som en nødkonto. Vi jobber med å korrigere denne virkemåten så raskt som mulig. I mellomtiden kan følgende apper vises i administrasjonssenteret for Power Platform:

  • Dataverse Accelerator-app – <modelldrevet app>, opprettet av en global administratorkonto
  • Dataverse-handlingsside – <lerretsapp> Dette er en egendefinert side som den lavkodebaserte plugin-modulen er bygd på, opprettet med brukernavnet tilknyttet den globale administratorkontoen.
  • Oversiktsside – <lerretsapp> Dette er en egendefinert side som den lavkodebaserte plugin-modulen er bygd på, opprettet med brukernavnet tilknyttet den globale administratorkontoen.
  • Medlemskap i sikkerhetsrollen som systemadministrator eller systemtilpasser i Power Platform-miljøet.
  • Tilgang til Dataverse-akseleratorappen.

Tips

Alle nye miljøer har Dataverse-akseperatorappen installert automatisk fra 1. oktober 2023. Hvis du allerede har installert Dataverse-akseleratoren, kan du oppdatere Dataverse-akseleratoren manuelt.

Oppdater Dataverse-akseleratoren

  1. Følg instruksjonene for å vise lisensierte apper i miljøet.
  2. Hvis Dataverse Accelerator er installert og en oppdatering er tilgjengelig, vises det i tabellen ved siden av elementet.
  3. Velg Dataverse Accelerator og velg deretter Oppdater på kommandolinjen.

Tips

Aktiver automatiske appoppdateringer for Microsoft – Power CAT-utgiveren for å motta oppdateringer automatisk når de er tilgjengelige (ikke nødvendig for nye miljøer opprettet etter 1. oktober 2023).

Obs!

Hvis du tidligere har installert den valgfrie løsningen for lavkodebaserte programtillegg for koblinger, slettes den automatisk hvis du oppdaterer etter 29. juni 2023. Funksjonene vil være tilgjengelige i hovedløsningen.

Opprett et umiddelbart lavkodebasert programtillegg

  1. Spill av Dataverse-akseleratorappen.
  2. Velg kortet for å Opprett umiddelbart programtillegg . Opprett umiddelbart programtillegg-kort
  3. Angi et Visningsnavn.
  4. Definer eventuelt parametere:
    • Velg Ny inndataparameter eller Ny utdataparameter, og angi deretter etiketten og datatypen.
    • Legg til flere inndata- og utdataparametere etter behov.
  5. Skriv inn Power Fx-uttrykket i Uttrykk-redigeringsverktøyet.
    • Parametere for referanseinndata i formelen etter etikettnavnet.
    • Utdataparametere må refereres til i klammeparentesene, for eksempel { Out: "Return value" }.
    • Referer til Dataverse-tabeller ved hjelp av datainnsamlingsfunksjoner, for eksempel Filter() og LookUp().
    • Hvis omfanget er satt til enhet, bruker du ThisRecord for å få tilgang til kolonneverdier i tabellraden som er tilknyttet plugin-modulkjøringen, for eksempel ThisRecord.'Account Name'.

    Tips

    Noter deg intellisens i Uttrykk-boksen. Understreket rødt er ugyldig. Bølgete gul betyr at logikken din kan bli påvirket av delegeringsbegrensninger. Unngå delegeringsproblemer ved å bruke delegerbare funksjoner.

  6. Du kan eventuelt utvide Avanserte alternativer for å endre løsningen , omfanget eller beskrivelsen.
  7. Velg Lagre.
  8. Test umiddelbart programtillegg med lav kode.

Eksempel: Beregne summen av to heltall.

  • Opprett to inndataparametere, X og Y (begge av typen heltall) og én utdataparameter, Z (typestreng).
  • Bruk følgende formel: {Z: X + Y }

Eksempel på plugin-modul i Dataverse Accelerator-appen

Opprett et automatisk lavkodebasert programtillegg

  1. Spill av Dataverse-akseleratorappen.
  2. Velg kortet Opprett automatisert modul. Opprett automatisk plugin-modul-kort
  3. Angi følgende verdier:
    • Navn: Skriv inn et navn på programtillegget, for eksempel Inndatavalidering.
    • Tabell: Velg en tabell som programtillegget skal knyttes til, for eksempel Konto.
    • Kjør denne programtilleggsregelen når raden er. Angi datahendelsen som starter programtillegget.
  4. Skriv inn Power Fx-uttrykket i Uttrykk-redigeringsverktøyet.
    • Referer til Dataverse-tabeller ved hjelp av datainnsamlingsfunksjoner, for eksempel Filter() og LookUp().
    • Bruk ThisRecord for å få tilgang til kolonneverdier i tabellraden som er tilknyttet programtilleggkjøringen, for eksempel ThisRecord.'Account Name'.
  5. Du kan eventuelt utvide Avanserte alternativer for å endre fasen (når dette skal kjøres) og løsningen der programtillegget lagres.
  6. Velg Lagre.
  7. Test det automatiserte programtillegget med lav kode.

Bruk Power Platform-koblinger i programtillegg med lav kode

Power Platform-koblinger kan brukes i programtillegg med lav kode for enkelt å integrere data og funksjonalitet fra systemer utenfor Dataverse, for eksempel SQL Server, Salesforce og SharePoint, uten behov for kompleks koding eller tilpasset utvikling.

Forhåndskrav for bruk av koblinger i programtillegg med lav kode

Bruke koblingshandlinger i programtillegg med lav kode

Du kan enkelt bruke koblinger og egendefinerte koblinger fra et progamtillegg med lav kode i en Power Fx-formel.

  1. Opprett en tilkobling til koblingen du vil bruke.
  2. Legg til en tilkoblingsreferanse i tilkoblingen i Dataverse-miljøet.
  3. I programtillegget Power Fx-redigeringsprogrammet for uttrykk med lav kode skriver du inn navnet på tilkoblingsreferansen (det interne navnet med et prefiks og understrekingstegn, for eksempel new_connectorName, ikke visningsnavn).
  4. Intellisense viser de tilgjengelige handlingene. Velg ønsket handling, og angi deretter de nødvendige parameterne.

Før du bruker en kobling i en plugin-modul med lav kode, ser du gjennom dokumentasjonen for koblingen for å kontrollere at du sender inndata- og utdataparameterne riktig.

Mer informasjon: eksempel

Obs!

  • Ikke alle koblingshandlinger støttes på dette tidspunktet.
  • Ikke bruk Dataverse-koblingen til å koble til Dataverse-tabeller fra et programtilleggsuttrykk. Bruk i stedet de opprinnelige Power Fx-funksjonene til å samhandle med samlinger: Filter, Search, LookUp, Patch, Collect og Set, der kolonner behandles som globale variabler.

Test et lavkodebasert programtillegg

Teste umiddelbart programtillegg

  1. Fra Hjem-skjermen velger du et umiddelbart programtillegg fra listen, og velg deretter Test på kommandolinjen. Du kan også gå til dette skjermbildet fra det umiddelbare programtillegget på kommandolinjen etter at det er lagret. Velg Test for programtillegg med lav kode

  2. Angi verdier for alle inndataparametere som er definert i det lavkodebaserte programtillegget, og velg deretter Kjør. Velg Kjør for å teste programtillegg med lav kode

Observer responsen.

Tips

Bruk utdataparametere til å validere forventet virkemåte og resultater. Ellers ser du bare en vellykket eller mislykket testing.

Teste automatiske programtillegg

Test automatiske programtillegg ved å starte datahendelsen. Se om programtillegget ble kjørt uten problemer ved å validere forventede endringer som ble definert i formelen.

Tips

I løpet av forhåndsvisningen kan du starte den tilknyttede datahendelsen ved å bruke tabellredigeringsprogrammet i Power Apps:

  1. Logg på Power Apps, gå til Tabeller, og velg tabellen Programtillegg.
  2. Velg Rediger på kommandolinjen.
  3. Opprett, oppdater eller slett rader direkte fra denne visningen. Du kan også åpne en rad i standardskjemaet ved å merke en rad, og deretter velge Rediger rad ved hjelp av skjema på kommandolinjen.

Integrer et lavkodebasert programtillegg

Aktiver et umiddelbart programtillegg fra en lerretsapp eller en egendefinert side

  1. I Dataverse Accelerator-appen:
    1. Velg det umiddelbare programtillegget i listen.
    2. Velg Kopier kodesnutt på kommandolinjen. Starte et umiddelbart programtillegg med lav kode
    3. Lim inn og lagre den kopierte formelen i et tekstredigeringsprogram eller en notisblokk (et sted du enkelt kan referere til).
  2. I Power Apps:
    1. Opprette eller redigere en lerretsapp (eller en egendefinert side) i Power Apps studio.
    2. I den venstre navigasjonen under fanen Datakilder velger du + Ny datakilde, og søker etter Miljø-alternativet fra koblingen Dataverse.
    3. Sett inn følgende komponenter på lerretet:
    • Legg til inndatakontroller som tilsvarer datatypen for hver parameter, for eksempel Tekstinndata for tekst eller tall, aktiver/deaktiver for boolsk.
    • Hvis området for programtillegget er bundet til en tabell, legger du til en kombinasjonsboks som er tilknyttet den samme tabellen, slik at du kan velge inndataene.
    • Legg til en knapp for å kalle opp programtillegget.
  3. Lim inn programtilleggformelen du kopierte i knappens OnSelect-egenskap.
  4. Tilordne hver inndataparameter Value for å referere til de tilsvarende inndatakontrollene:
    • Hvis formelen var Environment.new_CalculateSum({ X: Value, Y: Value });, kan den bli omskrevet til følgende: Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
    • Hvis formelen var bundet, erstatter du Environment med tabellvisningsnavn for å få tilgang til programtillegget.
  5. Hvis en utdataparameter er definert for programtillegget med lav kode:
    1. Registrer svaret i en Set()- eller UpdateContext()-formel: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Vis variabelen i en etikett. Du kan eventuelt bruke Notify()-formelen til å vise data i et varsel.
  6. Spill av appen, og velg kommandoen på kommandolinjen for å kjøre programtillegget med lav kode.

Finn ut mer om hvordan du kan kalle opp Dataverse-handlinger direkte fra Power Fx i lerretsapper.

Aktiver et umiddelbart programtillegg fra en Power Automate-skyflyt

  1. Legg til en ny handling fra Microsoft Dataverse-koblingen i en skyflyt.
  2. Velg handlingen Utfør en ubundet handling eller Utfør en bundet handling.
  3. Velg programtillegget (det har det unike navnet med et prefiks).
  4. Angi verdier for alle inndataparameterne (hvis noen).

Starte et umiddelbart programtillegg fra Dataverse-web-APIen

Følg fremgangsmåten for delene Ubundet handling eller Funksjon bundet til tabell i Aktivere egendefinerte APIer fra Web-API-dokumentasjonen (avhengig av det riktige omfanget av programtillegget).

Få hjelp med lavkodebaserte programtillegg

Hvis du får problemer med å opprette eller kjøre lavkodebasert programtillegg, kan du gå til disse tipsene for vanlige problemer som kan oppstå: Tips og kjente problemer for lavkodebaserte programtillegg i Microsoft Dataverse

Kontakt hjelp og kundestøtte

For problemer med løsningsinstallasjon av Dataverse Accelerator eller lavkodebaserte programtillegg som ikke dekkes i Tips og kjente problemer med lavkodebaserte programtillegg i Microsoft Dataverse, for eksempel udokumenterte feil som er mottatt, kan du bruke opplevelsen Hjelp og kundestøtte og inkludere følgende informasjon:

  • Problemtype – Dataverse-nett-API og SDK
  • Problemundertype – Accelerator-settet for Dataverse

Eksempel på lavkodebaserte programtillegg du kan opprette

Hvis du vil ha noen få eksempler på hvordan du oppretter et programtillegg for lavkode, går du til Eksempel på Dataverse-programtillegg for lav kode (forhåndsversjon)

Begrensninger

  • Miljøspråkobjektet må leses for å få tilgang til nye programtillegg i eksisterende lerretsapper. For alle programtillegg som er opprettet etter at du har lagt til datakilden for miljøtabellen i en eksisterende lerretsapp, må du fjerne og lese Power Fx-miljøspråkobjektet. Deretter ser du den oppdaterte listen over programtillegghandlinger.

  • Intellisense krever eksplisitt notasjon i automatiske programtillegg hvis du vil referere til tabeller i formelen. Bruk for eksempel følgende tvetydighetssyntaks [@Accounts], og bruk hakeparenteser og @-symbolet (ikke Accounts).

  • Nestet støtte. Programtillegg kan kun kalle opp førstepartshandlinger publisert av Microsoft fra Power Fx-uttrykk.

  • Enkelte Collect-scenarioer krever Patch. Det finnes noen scenarioer der Collect() ikke fungerer. Du løser problemet ved å bruke Patch() slik det er vist i eksemplet på utfylling av kolonner nedenfor. Hvis du oppretter et automatisert programtillegg, må du legge til @ først i hver tabell det refereres til i Power Fx-formelen.

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

  • Når programtillegg med lav kode samhandler koblinger, og DLP brukes, kan administratoren blokkere oppretting av tilkoblinger ved hjelp av DLP. Eksisterende tilkoblingsreferanser i Dataverse-miljøet vil imidlertid fortsatt fungere. Hvis administratoren må blokkere alle samhandlinger med programtillegg med noen koblinger, kan de deaktivere organisasjonsinnstillingen Allowconnectorsonpowerfxactions. Denne innstillingen er aktivert som standard og kan deaktiveres av vanlige SDK-metoder (WebAPI, SDK, PowerShell og så videre). Du kan deaktivere dette ved å bruke et programtillegg med lav kode som følger:

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

  • Programtillegg som bruker koblinger, kan bare sende resultater fra bestemte felt. På grunn av dette må du tilordne bestemte primitive verdier fra tilkoblingssvaret til utdataverdier.

Programtillegg med lav kode som har begrensninger for tilpassede koblinger

Hvis du har lavkodebaserte plugin-moduler med tilpassede koblinger, må de tilpassede koblingene importeres først, før tilkoblingsreferanser eller flyter.

Hvis miljøet ditt ikke inneholder den tilpassede koblingen i en løsning, importerer du en separat løsning som bare inkluderer den tilpassede koblingen. Gjør denne importen før du importerer selve løsningen. Du må gjøre dette først, fordi Azure må registrere den tilpassede koblingen før de andre løsningskomponentene kan importeres.

Hvis du importerer en løsning som inneholder tilpassede koblinger og flyter, kan ikke Azure registrere den tilpassede koblingen mens den registrerer tilkoblingsreferansene eller -flytene dine. Dette gjelder også tilkoblingsreferanser for den tilpassede koblingen som ikke tidligere ble importert i en egen løsning. Hvis Azure ikke registrerte den tilpassede koblingen, mislykkes importen, eller du kan ikke starte importen.

Mer informasjon: Lag tilpassede koblinger i løsninger: Kjente begrensninger

Se også

Lavkodebaserte programtillegg i Power Fx (forhåndsversjon)

Bruk et forhåndsbygd spørring i et lavkodebasert Dataverse-programtillegg i Power Apps