Low-code Dataverse-invoegtoepassingen gebruiken (preview)
[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]
Microsoft Dataverse is een krachtige oplossing waarmee u een efficiëntere data-architectuur kunt realiseren en de werkdruk aan clientzijde kunt beperken via invoegtoepassingen met weinig code. Deze invoegtoepassingen zijn herbruikbare, realtime werkstromen die een specifieke reeks opdrachten binnen Dataverse, aan serverzijde, uitvoeren en worden geactiveerd door gepersonaliseerde gebeurtenis-handlers.
Belangrijk
- Dit is een preview-functie.
- Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar vóór een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.
Van oudsher werden invoegtoepassingen gemaakt als aangepaste klassen die werden gecompileerd in een .NET Framework-assembly, die vervolgens werden geüpload en geregistreerd binnen Dataverse. Met de introductie van invoegtoepassingen met weinig code kunnen gebruikers deze gebeurtenis-handlers nu echter maken met weinig tot geen code en zonder de noodzaak van handmatige registratie.
Invoegtoepassingen met weinig code worden opgeslagen in een Dataverse-database en kunnen naadloos worden geïntegreerd in Power Apps en Power Automate. Het gedrag van de werkstroom wordt gedefinieerd met behulp van de Power Fx-expressietaal en kan via Power Platform-connectoren rechtstreeks verbinding maken met Dataverse-bedrijfsgegevens en externe gegevensbronnen. Met invoegtoepassingen met weinig code kunnen makers snel complexe werkstromen samenstellen met minimale ervaring met code, wat resulteert in een meer gestroomlijnde en efficiënte data-architectuur.
Het definiëren van bedrijfslogica aan serverzijde biedt verschillende voordelen, waaronder:
- Verbeterde beveiliging. Omdat de logica aan serverzijde op de server wordt uitgevoerd, kan dit ongeautoriseerde toegang tot gevoelige gegevens of processen helpen voorkomen.
- Verbeterde prestaties. Door de bedrijfslogica op de server uit te voeren, kan de hoeveelheid gegevens die tussen de client en de server moet worden overgedragen worden beperkt, wat resulteert in snellere verwerkingstijden.
- Consistentie en betrouwbaarheid. Logica aan serverzijde zorgt ervoor dat bedrijfsregels consistent worden toegepast op alle clients, waardoor het risico op fouten of inconsistenties wordt verkleind.
- Eenvoudiger onderhoud en upgrades. Door de bedrijfslogica op de server te centraliseren, wordt het eenvoudiger om deze te onderhouden en bij te werken, omdat wijzigingen op één plek kunnen worden aangebracht in plaats van dat u meerdere clients moet bijwerken.
- Schaalbaarheid. Logica aan serverzijde kan eenvoudiger worden geschaald dan logica aan clientzijde, waardoor betere prestaties en verwerking van grotere workloads mogelijk zijn.
Er zijn twee typen invoegtoepassingen met weinig code die worden ondersteund in Dataverse:
Type | Activator | Ondersteunde parameters | Ondersteunde scope |
---|---|---|---|
Direct | Handmatig uitgevoerd | Ja | Algemeen en tabel |
Geautomatiseerd | Dataverse-tabelgebeurtenis | Nee | Table |
Alle invoegtoepassingen met weinig code hebben de volgende gemeenschappelijke eigenschappen:
Eigenschappen | Omschrijving |
---|---|
Display name | De door personen leesbare naam van de invoegtoepassing. Kan na aanmaken niet worden gewijzigd. |
Meting | De interne naam van de invoegtoepassing. Wordt door het platform gebruikt om het onderdeel in code- en databasebewerkingen te identificeren. Kan na aanmaken niet worden gewijzigd. |
Omschrijving | Wordt gebruikt om extra context over de invoegtoepassing te bieden (doel, gedrag of andere belangrijke details). |
Oplossing | Wordt gebruikt om onderdelen te groeperen en naar andere omgevingen te exporteren. Meer informatie over oplossingen. |
Expressie | Dit is de aangepaste functie die kan worden gebruikt om acties of berekeningen uit te voeren, gedefinieerd met behulp van de Power Fx-expressietaal. Power Fx is een formuletaal die wordt gebruikt in Power Apps canvas-apps en is uitgebreid om te worden gebruikt in weinig code-plug-ins. Zie ondersteunde functies voor meer informatie. |
Een instant invoegtoepassing met weinig code is aangepaste codelogica die handmatig wordt geactiveerd door een gebruiker. Er kunnen aangepaste invoer- en uitvoerparameters worden gebruikt.
Unieke eigenschappen:
Eigenschappen | Omschrijving |
---|---|
Scope | Wordt gebruikt om een invoegtoepassing aan een specifieke tabel te koppelen. U kunt dit instellen op tabelbereik (weergegeven als entiteit) of globaal bereik, waarbij tabelbereik (entiteitsbereik) betekent dat de plug-in wordt geactiveerd met de context van een specifieke tabelrecord, en globaal bereik betekent dat de bewerking niet aan een tabel is gekoppeld (meer informatie). |
Parameters | Met parameters kunt u informatie doorgeven tussen de invoegtoepassing en de context waarin deze wordt uitgevoerd, waardoor het makkelijker is om bedrijfslogica te ontwerpen die in verschillende situaties kan worden hergebruikt. Invoerparameters worden gebruikt om gegevens aan de plug-in te verstrekken en stellen u in staat om te bepalen hoe de functie zich gedraagt door verschillende waarden door te geven die u opgeeft in de Power Fx formule. Met uitvoerparameters kunt u de resultaten van een functie of methode ophalen voor verder gebruik in uw programma. Ondersteunde gegevenstypen:
|
Meer informatie over hoe u kunt integreren vanuit een canvas-app of in een Power Automate cloudstroom: Integreer een weinig code-plug-in
Ontwerptijd
Makers met de beveiligingsrol systeemaanpasser of systeembeheerder in de Power Platform-omgeving hebben toegang tot alle invoegtoepassingen in die omgeving. Aangepaste beveiligingsrollen kunnen worden gebruikt om de toegang tot invoegtoepassingen met weinig code te beperken.
Looptijd
Wanneer een invoegtoepassing wordt aangeroepen, heeft deze toegang tot de tabelgegevens die betrokken zijn bij de definitie van de invoegtoepassing (de tabellen die deel uitmaken van de formule, of dat de tabel is gekoppeld aan de instellingen van een geautomatiseerde invoegtoepassing) in de context van de gebruiker die deze heeft aangeroepen.
Verbindingen
Met behulp van beveiligingsrollen kunt u de connectortoegang binnen plug-ins beperken tot een specifieke groep gebruikers binnen uw organisatie. Geef op welke rollen bevoegdheden hebben voor maken, lezen, bijwerken of verwijderen.
- Lidmaatschap voor de beveiligingsrol van systeembeheerder of systeemaanpasser in de Power Platform-omgeving.
- Toegang tot de Dataverse Accelerator-app.
Tip
Op alle nieuwe omgevingen is de Dataverse Accelerator-app vanaf 1 oktober 2023 automatisch geïnstalleerd. Als u de Dataverse Accelerator al had geïnstalleerd, kunt u de Dataverse Accelerator handmatig updaten.
Werk de Dataverse accelerator bij
- Volgen de instructies om gelicentieerde apps te bekijken in uw omgeving.
- Als de Dataverse Accelerator al is geïnstalleerd en er een update beschikbaar is, wordt dit aangegeven in de tabel naast het item.
- Selecteer Dataverse Accelerator en selecteer vervolgens Bijwerken op de opdrachtbalk.
Tip
Schakel automatische app-updates in voor de Microsoft - Power CAT uitgever om automatisch updates te ontvangen wanneer deze beschikbaar zijn (niet nodig voor nieuwe omgevingen die na 1 oktober 2023 zijn gemaakt).
Notitie
Als u eerder de optionele oplossing weinig code Plug-ins voor Connectors hebt geïnstalleerd, wordt deze automatisch verwijderd wanneer u na 29 juni 2023 een update uitvoert. De mogelijkheden zijn beschikbaar in de hoofdoplossing.
- Speel de Dataverse Accelerator-app af.
- Selecteer de Directe plug-in maken kaart.
- Geef een weergavenaam op.
- Definieer optioneel parameters:
- Selecteer Nieuwe invoerparameter of Nieuwe uitvoerparameter en voer vervolgens het label en het gegevenstype in.
- Voeg indien nodig meer in- en uitvoerparameters toe.
- Voer de Power Fx expressie in de Expressie editor in.
- Verwijs naar invoerparameters in de formule met de labelnaam.
- Uitvoerparameters moeten tussen accolades worden vermeld, bijvoorbeeld
{ Out: "Return value" }
. - Referentietabellen Dataverse met behulp van gegevensverzamelingsfuncties, zoals Filter() en LookUp().
- Als het bereik is ingesteld op entiteit, gebruikt u
ThisRecord
om toegang te krijgen tot kolomwaarden in de tabelrij die is gekoppeld aan de plug-in-uitvoering, zoalsThisRecord.'Account Name'
.
Tip
Let op de intellisense in het Expression -vak. Rood onderstreept is ongeldig. Kronkelig geel betekent dat uw logica mogelijk wordt beïnvloed door delegeringsbeperkingen. Voorkom delegatieproblemen door gebruik te maken van delegeerbare functies .
- U kunt eventueel de Geavanceerde opties uitvouwen om de oplossing, scope of beschrijving te wijzigen.
- Selecteer Opslaan.
- Test uw directe weinig code plug-in.
Voorbeeld: Bereken de som van twee gehele getallen.
- Maak twee invoerparameters,
X
enY
(beide van het type integer), en één uitvoerparameter,Z
(type string). - Gebruik de volgende formule:
{Z: X + Y }
- Speel de Dataverse Accelerator-app af.
- Selecteer de Geautomatiseerde plug-in maken kaart.
- Geef de volgende waarden op:
- Naam: Voer een naam in voor de plug-in, bijvoorbeeld Invoervalidatie.
- Tabel: Kies een tabel waaraan u de plug-in wilt koppelen, bijvoorbeeld Account.
- Voer deze plug-inregel uit wanneer de rij is. Geef de gegevensgebeurtenis op waarmee de invoegtoepassing wordt aangeroepen.
- Voer de Power Fx expressie in de Expressie editor in.
- Referentietabellen Dataverse met behulp van gegevensverzamelingsfuncties, zoals Filter() en LookUp().
- Gebruik
ThisRecord
om toegang te krijgen tot kolomwaarden in de tabelrij die is gekoppeld aan de plug-in-uitvoering, zoalsThisRecord.'Account Name'
.
- U kunt eventueel Geavanceerde opties uitvouwen om de fase (wanneer dit moet worden uitgevoerd) en de oplossing waar de plug-in wordt opgeslagen, aan te passen.
- Selecteer Opslaan.
- Test uw geautomatiseerde weinig code plug-in.
Power Platform-connectoren kunnen worden gebruikt in invoegtoepassingen met weinig code om eenvoudig gegevens en functionaliteit te integreren van systemen buiten Dataverse, zoals SQL Server, Salesforce en SharePoint, zonder dat er ingewikkelde code of aangepaste ontwikkeling nodig is.
- Vereisten voor het maken van een weinig code plug-in
- verbindingsverwijzing met een actieve verbinding.
U kunt eenvoudig connectoren en aangepaste connectoren gebruiken vanuit een weinig code plug-in Power Fx formule.
- Maak een verbinding naar de connector die u wilt gebruiken.
- Voeg een verbindingsverwijzing toe aan de verbinding in de Dataverse omgeving.
- Typ in de expressie-editor van de plug-in weinig code Power Fx de naam van verbindingsverwijzing (de interne naam met een voorvoegsel en onderstrepingsteken, zoals
new_connectorName
, niet weergavenaam). - IntelliSense toont u de beschikbare acties. Selecteer de gewenste actie en voer vervolgens de vereiste parameters in.
Voordat u een connector in een weinig code-plug-in gebruikt, moet u de documentatie van de connector raadplegen om er zeker van te zijn dat u de invoer- en uitvoerparameters correct doorgeeft.
Meer informatie: voorbeeld
Notitie
- Niet alle connectoracties worden in dit stadium ondersteund.
- Gebruik de Dataverse-connector niet om verbinding te maken met Dataverse-tabellen vanuit een invoegtoepassingsexpressie. Gebruik in plaats daarvan de native Power Fx functies om te communiceren met verzamelingen: Filter, Search, LookUp, Patch, Collect en Set, waarbij kolommen worden behandeld als globale variabelen.
Selecteer op het startscherm een directe plug-in uit de lijst en selecteer vervolgens Test in de opdrachtbalk. U kunt dit scherm ook bereiken vanuit de editor voor de invoegtoepassing in de opdrachtbalk nadat deze is opgeslagen.
Geef waarden op voor alle invoerparameters die zijn gedefinieerd in de plug-in weinig code en selecteer vervolgens Uitvoeren.
Bekijk de respons.
Tip
Gebruik uitvoerparameters om verwacht gedrag en resultaten gemakkelijker te kunnen valideren. Anders ziet u enkel geslaagd of mislukt bij het testen.
Test geautomatiseerde invoegtoepassingen door de gegevensgebeurtenis aan te roepen. Bekijk of de invoegtoepassing met succes is uitgevoerd door verwachte wijzigingen te valideren die in de formule zijn gedefinieerd.
Tip
Tijdens de preview kunt u de bijbehorende gegevensgebeurtenis aanroepen met behulp van de tabeleditor in Power Apps:
- Meld u aan bij Power Apps, ga naar Tabellen en selecteer de Plug-in tabel.
- Selecteer Bewerken op de opdrachtbalk.
- Rijen maken, bijwerken of verwijderen, rechtstreeks vanuit deze weergave. U kunt ook een rij in het standaardformulier openen door een rij te selecteren en vervolgens Rij bewerken met behulp van formulier te selecteren op de opdrachtbalk.
- In de Dataverse Accelerator app:
- Selecteer de instant invoegtoepassing in de lijst.
- Selecteer Code fragment kopiëren op de opdrachtbalk.
- Plak de gekopieerde formule en sla deze op in een teksteditor of notitieblok (ergens waar u gemakkelijk naar kunt verwijzen).
- In Power Apps:
- Maak of bewerk een canvas-app (of aangepaste pagina) in de Power Apps Studio.
- Selecteer in de linkernavigatie onder het tabblad Gegevensbronnen de optie + Nieuw gegevensbron en zoek naar de optie omgeving in de Dataverse connector.
- Plaats de volgende onderdelen in het canvas:
- Voeg invoerbesturingselementen toe die overeenkomen met het gegevenstype van elke parameter, zoals Tekstinvoer voor tekst of getallen, schakelaar voor Booleaanse waarden.
- Als het bereik van de invoegtoepassing aan een tabel is gekoppeld, voegt u een combobox toe die aan dezelfde tabel is gekoppeld, zodat u de invoer kunt kiezen.
- Voeg een knop toe om de plug-in aan te roepen.
- Plak de gekopieerde plug-informule in de eigenschap
OnSelect
van de knop. - Wijs elke invoerparameter toe
Value
om te verwijzen naar de bijbehorende invoerbesturingselementen:- Als de formule
Environment.new_CalculateSum({ X: Value, Y: Value });
was, zou deze als volgt herschreven kunnen worden:Environment.new_CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text });
- Als de formule gebonden is, vervangt u
Environment
door de tabel weergavenaam om toegang te krijgen tot de plug-in.
- Als de formule
- Als er een uitvoerparameter is gedefinieerd voor de plug-in weinig code:
- Leg de respons vast in een
Set()
ofUpdateContext()
formule:Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );
. Geef de variabele weer in een label. U kunt ook de formuleNotify()
gebruiken om gegevens in een melding weer te geven.
- Leg de respons vast in een
- Speel de app af en selecteer de opdracht op de opdrachtbalk om de invoegtoepassing met weinig code uit te voeren.
Lees meer over hoe u acties rechtstreeks vanuit canvas-apps kunt aanroepen. Dataverse Power Fx
- Voeg in een cloudstroom een nieuwe actie toe via de Microsoft Dataverse-connector.
- Selecteer de actie Een niet-gebonden actie uitvoeren of Een gebonden actie uitvoeren.
- Selecteer uw invoegtoepassing (deze heeft de unieke naam met een voorvoegsel).
- Geef waarden op voor alle invoerparameters (indien aanwezig).
Volgen de stappen voor Niet-gebonden actie of aan tabel gebonden functiesecties in de Aanroepen van aangepaste API's vanuit de Web API-documentatie (afhankelijk van de juiste scope van de plug-in).
Als u problemen ondervindt bij het maken of uitvoeren van uw weinig code-plug-in, raadpleegt u deze tips voor veelvoorkomende problemen die kunnen optreden: Microsoft Dataverse weinig code plug-intips en bekende problemen
Voor problemen met de Dataverse installatie van de Accelerator-oplossing of weinig code-plug-ins die niet worden behandeld in Microsoft Dataverse weinig code-plug-intips en bekende problemen, zoals ontvangen niet-gedocumenteerde fouten, gebruikt u de Help + ondersteuningservaring en neemt u de volgende informatie op:
- Probleemtype- Dataverse-web-API en SDK
- Probleemsubtype- Accelerator-kit voor Dataverse
Voor een paar voorbeelden van hoe je een weinig code plug-in maakt, ga je naar Voorbeeld Dataverse weinig code plug-ins (preview)
Het omgevingstaalobject moet worden gelezen om toegang te krijgen tot nieuwe invoegtoepassingen binnen bestaande canvas-apps. Voor invoegtoepassingen die zijn gemaakt nadat u de gegevensbron voor de omgevingstabel aan een bestaande canvas-app hebt toegevoegd, moet u het Power Fx-omgevingstaalobject verwijderen en opnieuw toevoegen. Daarna ziet u de bijgewerkte lijst van alle invoegtoepassingen met weinig code als acties.
IntelliSense vereist expliciete notatie in geautomatiseerde invoegtoepassingen als u in de formule naar tabellen wilt verwijzen. Gebruik de volgende doorverwijssyntaxis, bijvoorbeeld
[@Accounts]
, met vierkante haken en het symbool@
(nietAccounts
).Geneste ondersteuning. Invoegtoepassingen kunnen alleen first-party acties aanroepen die door Microsoft zijn gepubliceerd vanuit Power Fx-expressies.
Sommige
Collect
scenario's vereisenPatch
. Er zijn enkele scenario's waarinCollect()
dit niet werkt. De tijdelijke oplossing is omPatch()
te gebruiken zoals getoond in het onderstaande voorbeeld van de kolom 'Invullen betreffende'. Als u een geautomatiseerde invoegtoepassing maakt, voegt u @ toe aan elke tabel waarnaar wordt verwezen in de Power Fx-formule.Patch(Faxes, Collect(Faxes, { Subject : "Sub1" } ), { Regarding : First(Accounts) } )
Wanneer invoegtoepassingen met weinig code met connectoren communiceren DLP wordt gebruikt, kan de beheerder het maken van verbindingen met behulp van DLP blokkeren. Bestaande verbindingsverwijzingen in de Dataverse-omgeving blijven echter functioneren. Als de beheerder alle weinig code plug-ininteracties met connectoren wil blokkeren, kan hij de organisatie-instelling uitschakelen
Allowconnectorsonpowerfxactions
. Deze instelling is standaard ingeschakeld en kan worden uitgeschakeld via de gebruikelijke SDK-methoden (WebAPI, SDK, PowerShell, enzovoort). U kunt dit als volgt uitschakelen met een instant invoegtoepassing met weinig code:Patch(Organizations, First(Organizations), { 'Enable connectors on power fx actions.': 'Enable connectors on power fx actions. (Organizations)'.No })
Invoegtoepassingen die connectoren gebruiken, kunnen alleen resultaten uit specifieke velden weergeven. Hierdoor moet u specifieke primitieve waarden uit de connectorrespons toewijzen aan uitvoerwaarden.
Als u invoegtoepassingen met weinig code met aangepaste connectoren hebt, moeten de aangepaste connectoren eerst worden geïmporteerd, vóór verbindingsverwijzingen of stromen.
Als uw omgeving de aangepaste connector niet in een oplossing bevat, importeert u een afzonderlijke oplossing die alleen de aangepaste connector bevat. Voer deze import uit voordat u de daadwerkelijke oplossing importeert. U moet dit eerst doen, omdat Azure de aangepaste connector moet registreren, voordat de andere oplossingsonderdelen geïmporteerd kunnen worden.
Als u een oplossing importeert die aangepaste connectoren en stromen bevat, kan Azure de aangepaste connector niet registreren terwijl uw verbindingsverwijzingen of stromen worden geregistreerd. Dit geldt ook voor verbindingsreferenties voor de aangepaste connector die niet eerder in een afzonderlijke oplossing zijn geïmporteerd. Als Azure uw aangepaste connector niet heeft geregistreerd, mislukt het importeren of kunt u het importeren niet starten.
Meer informatie: Aangepaste connectoren maken in oplossingen: bekende beperkingen
weinig code plug-ins Power Fx (preview)
gebruik een vooraf gebouwde prompt in een Dataverse weinig code plug-in in Power Apps