Delen via

Low-code Dataverse-invoegtoepassingen gebruiken (preview)

  • Artikel

[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.

Voordelen van logica aan serverzijde

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.

-invoegtoepassingen met weinig code

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:
  • Booleaans
  • String
  • Openstaand
  • Decimal
  • Datum en tijd
  • Integer

Meer informatie over hoe u kunt integreren vanuit een canvas-app of in een Power Automate cloudstroom: Integreer een weinig code-plug-in

Machtigingen voor invoegtoepassingen

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.

Vereisten voor het maken van een invoegtoepassing met weinig code

  • Lidmaatschap voor de beveiligingsrol van systeembeheerder of systeemaanpasser in de Power Platform-omgeving.
  • Toegang tot de Dataverse Accelerator-app.

Fooi

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

  1. Volgen de instructies om gelicentieerde apps te bekijken in uw omgeving.
  2. Als de Dataverse Accelerator al is geïnstalleerd en er een update beschikbaar is, wordt dit aangegeven in de tabel naast het item.
  3. Selecteer Dataverse Accelerator en selecteer vervolgens Bijwerken op de opdrachtbalk.

Fooi

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.

Een directe invoegtoepassing met weinig code maken

  1. Speel de Dataverse Accelerator-app af.
  2. Selecteer de Directe plug-in maken kaart. Maak direct een plug-in kaart
  3. Geef een weergavenaam op.
  4. 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.
  5. 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, zoals ThisRecord.'Account Name'.

    Fooi

    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 .

  6. U kunt eventueel de Geavanceerde opties uitvouwen om de oplossing, scope of beschrijving te wijzigen.
  7. Selecteer Opslaan.
  8. Test uw directe weinig code plug-in.

Voorbeeld: Bereken de som van twee gehele getallen.

  • Maak twee invoerparameters, X en Y (beide van het type integer), en één uitvoerparameter, Z (type string).
  • Gebruik de volgende formule: {Z: X + Y }

Voorbeeld van directe plug-in in de Accelerator-app Dataverse

Een geautomatiseerde invoegtoepassing met weinig code maken

  1. Speel de Dataverse Accelerator-app af.
  2. Selecteer de Geautomatiseerde plug-in maken kaart. Maak een geautomatiseerde plug-in kaart
  3. 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.
  4. 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, zoals ThisRecord.'Account Name'.
  5. 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.
  6. Selecteer Opslaan.
  7. Test uw geautomatiseerde weinig code plug-in.

Power Platform-connectoren gebruiken in invoegtoepassingen met weinig code

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 gebruik van connectoren in invoegtoepassingen met weinig code

Connectoracties gebruiken in invoegtoepassingen met weinig code

U kunt eenvoudig connectoren en aangepaste connectoren gebruiken vanuit een weinig code plug-in Power Fx formule.

  1. Maak een verbinding naar de connector die u wilt gebruiken.
  2. Voeg een verbindingsverwijzing toe aan de verbinding in de Dataverse omgeving.
  3. 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).
  4. 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.

Een invoegtoepassing met weinig code testen

Instant invoegtoepassingen testen

  1. 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. Selecteer Test voor de plug-in weinig code

  2. Geef waarden op voor alle invoerparameters die zijn gedefinieerd in de plug-in weinig code en selecteer vervolgens Uitvoeren. Selecteer Uitvoeren om de plug-in weinig code te testen

Bekijk de respons.

Fooi

Gebruik uitvoerparameters om verwacht gedrag en resultaten gemakkelijker te kunnen valideren. Anders ziet u enkel geslaagd of mislukt bij het testen.

Geautomatiseerde invoegtoepassingen 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.

Fooi

Tijdens de preview kunt u de bijbehorende gegevensgebeurtenis aanroepen met behulp van de tabeleditor in Power Apps:

  1. Meld u aan bij Power Apps, ga naar Tabellen en selecteer de Plug-in tabel.
  2. Selecteer Bewerken op de opdrachtbalk.
  3. 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.

Een invoegtoepassing met weinig code integreren

Een directe invoegtoepassing aanroepen vanuit een canvas-app of aangepaste pagina

  1. In de Dataverse Accelerator app:
    1. Selecteer de instant invoegtoepassing in de lijst.
    2. Selecteer Code fragment kopiëren op de opdrachtbalk. Roep een exemplaar aan weinig code plug-in
    3. Plak de gekopieerde formule en sla deze op in een teksteditor of notitieblok (ergens waar u gemakkelijk naar kunt verwijzen).
  2. In Power Apps:
    1. Maak of bewerk een canvas-app (of aangepaste pagina) in de Power Apps Studio.
    2. Selecteer in de linkernavigatie onder het tabblad Gegevensbronnen de optie + Nieuw gegevensbron en zoek naar de optie omgeving in de Dataverse connector.
    3. 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.
  3. Plak de gekopieerde plug-informule in de eigenschap OnSelect van de knop.
  4. 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.
  5. Als er een uitvoerparameter is gedefinieerd voor de plug-in weinig code:
    1. Leg de respons vast in een Set() of UpdateContext() formule: Set( ActionResult, Environments.CalculateSum({ X: TextInput1.Text, Y: TextInput2.Text }) );. Geef de variabele weer in een label. U kunt ook de formule Notify() gebruiken om gegevens in een melding weer te geven.
  6. 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

Een instant invoegtoepassing aanroepen vanuit een Power Automate-cloudstroom

  1. Voeg in een cloudstroom een nieuwe actie toe via de Microsoft Dataverse-connector.
  2. Selecteer de actie Een niet-gebonden actie uitvoeren of Een gebonden actie uitvoeren.
  3. Selecteer uw invoegtoepassing (deze heeft de unieke naam met een voorvoegsel).
  4. Geef waarden op voor alle invoerparameters (indien aanwezig).

Roep een instant invoegtoepassing aan vanuit de Dataverse Web API

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).

Hulp krijgen bij uw invoegtoepassingen met weinig code

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

Contact opnemen met Help en ondersteuning

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

Voorbeelden van invoegtoepassingen met weinig code die u kunt maken

Voor een paar voorbeelden van hoe je een weinig code plug-in maakt, ga je naar Voorbeeld Dataverse weinig code plug-ins (preview)

Beperkingen

  • 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 @ (niet Accounts).

  • Geneste ondersteuning. Invoegtoepassingen kunnen alleen first-party acties aanroepen die door Microsoft zijn gepubliceerd vanuit Power Fx-expressies.

  • Sommige Collect scenario's vereisen Patch. Er zijn enkele scenario's waarin Collect() dit niet werkt. De tijdelijke oplossing is om Patch() 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.

Invoegtoepassingen met weinig code waarvoor een beperking voor aangepaste connectoren geldt

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

Zie ook

weinig code plug-ins Power Fx (preview)

gebruik een vooraf gebouwde prompt in een Dataverse weinig code plug-in in Power Apps