Power App uitvoeren (preview)

Met de actie Power App uitvoeren wordt een app direct vanuit een bureaubladstroom gestart en wordt een communicatiekanaal tussen beide tot stand gebracht. Door deze integratie te gebruiken, kunnen bureaubladstromen systeemeigen Power App-ervaringen aanroepen, invoer doorgeven en uitvoer ontvangen. Deze benadering maakt uitgebreide systeemeigen integratie mogelijk voor automatiseringsscenario's in plaats van te vertrouwen op automatisering op basis van gebruikersinterfaces.

Met deze mogelijkheid kunt u:

• Een app rechtstreeks vanuit een bureaubladstroom aanroepen
• Een app rechtstreeks vanuit een bureaubladstroom aanroepen.
• Geef invoer vanuit de bureaubladstroom door aan de app.
• Neem uitvoer van de app weer op in de stroom.
• Substromen activeren via app-gebeurtenissen.

Dit maakt scenario's mogelijk, zoals:

• Dynamische begeleide meerstapsformulieren voor begeleide automatisering
• Moderne op apps gebaseerde ervaringen waarbij verouderde aangepaste formulieren worden vervangen
• Gebeurtenisgestuurde automatisering, waarbij gebruikersacties stroomuitvoering dicteren
• Moderne cloudtoepassingen die verouderde desktopautomatisering overbruggen

Vereisten en beschikbaarheid

• Minimale versie van Power Automate voor bureaublad: 2.68 of later.
• Beschikbaarheid van de cloud: Alleen beschikbaar in openbare clouds.

Prerequisites

Voordat u begint, moet u ervoor zorgen dat u het volgende hebt:

• Power Automate voor bureaublad (PAD) version 2.68 of hoger geïnstalleerd
• Toegang tot Power Apps in dezelfde omgeving
• Bureaubladsubstromen die u vanuit de app kunt oproepen
• Microsoft Edge WebView2 Runtime geïnstalleerd (vereist om de Power App tijdens runtime weer te geven)

Stap 1: Aanroepbare substromen maken in uw bureaubladstroom

1. Open uw bureaubladstroom in de PAD-ontwerper.
2. Maak een of meer lokale subflows.
3. (Optioneel) Definieer voor elke substroom het volgende:
   • Invoervariabelen: waarden die de app doorgeeft aan de substroom
   • Uitvoervariabelen: waarden die de substroom retourneert naar de app

Stap 2: De creatieverbinding met Power Apps Studio tot stand brengen

Als u uw substromen beschikbaar wilt maken in Power Apps Studio (zodat ze worden weergegeven als functies die u kunt aanroepen), opent u de app via de PAD-creatiebrug.

1. Voeg de actie Power App uitvoeren (Preview) toe aan uw bureaubladstroom.
2. In de actie-eigenschappen, kiest u een van beide opties:
   • Selecteer een bestaande app of
   • Een nieuwe app maken

1. Selecteer App openen.

   De standaardbrowser opent een pagina Power Automate voor desktop waarmee u verbinding maakt met Power Apps Studio.

2. Selecteer Open Designer op de browserpagina.

   Er wordt een nieuw browsertabblad geopend met Power Apps Studio, waarbij de geselecteerde app al is geopend.

3. Houd de browserpagina van Power Automate voor bureaublad geopend totdat wordt weergegeven dat deze verbonden is.

   Als u de pagina sluit voordat de app is geladen, voorkomt u dat er een verbinding tot stand wordt gebracht tussen de bureaubladstroom en de Power-app.

Stap 3: Bureaubladsubstromen aanroepen vanuit de Power App

Nadat u de ontwerpfunctieverbinding tot stand hebt gebracht, toont Power Apps Studio een hostobject met de naam PowerAutomateDesktop. Met dit object worden uw bureaubladsubstromen weergegeven als aanroepbare functies.

Aanroeppatroon (algemeen)

Een bureaubladsubstroom aanroepen vanuit Power Apps:

• Gebruik het PowerAutomateDesktop object.
• Roep de substroom aan via de naam.
• Geef invoer door als functieparameters.
• Uitvoerwaarden van het geretourneerde resultaat openen.

Algemene syntaxis:

PowerAutomateDesktop.SubflowName(input1, input2, ...).OutputVariableName;

Example

In dit voorbeeld:

• De substroom heeft de naam GetCustomerData.
• Er wordt één invoerparameter geaccepteerd. Bijvoorbeeld: varCustomerId.
• Het retourneert een waarde via een uitvoervariabele met de naam out_customer_data, die wordt opgeslagen in de globale variabele varResult.

Als u de substroom wilt aanroepen, geeft u de waarde van varCustomerId door en slaat u de geretourneerde uitvoer op in de globale variabele varResult:

Set(customer_data_result, PowerAutomateDesktop.GetCustomerData(varCustomerId));

Stap 4: Waarden retourneren aan Power Apps

• Power Automate voor bureaublad retourneert alle waarden als tekenreeksen. Cast deze waarden in Power Apps naar het juiste type.
• Wanneer u een substroom van een bureaubladstroom aanroept, worden alle uitvoervariabelen als één recordwaarde geretourneerd.
• U hebt toegang tot afzonderlijke uitvoervariabelen als eigenschappen van die record.

Voorbeeld: Uitvoervariabelen ophalen en gebruiken in Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

In dit voorbeeld worden alle uitvoervariabelen van de substroom opgeslagen.globalVariable

Voor toegang tot een specifieke uitvoervariabele. Bijvoorbeeld: out_var1

globalVariable.out_var1

Complexe waarden retourneren

Als u complexe waarden (aangepaste objecten of lijsten) wilt retourneren, retourneert u deze als uitvoervariabelen en parseert u deze in Power Apps.

1. Maak een aangepast object in de bureaubladsubstroom.
2. Retourneert het aangepaste object als uitvoervariabele.
3. Gebruik in Power Apps ParseJSON om de geretourneerde waarde te parseren en toegang te krijgen tot de eigenschappen ervan.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Ondersteuning voor IntelliSense

Wanneer u bureaubladsubstromen aanroept in Power Apps, biedt Power Apps Studio IntelliSense om u te helpen bij het detecteren en gebruiken van beschikbare mogelijkheden.

Terwijl u in de formulebalk typt:

• In het PowerAutomateDesktop object worden beschikbare substroomnamen weergegeven.
• Invoerparameters voor de geselecteerde substroom worden weergegeven in de juiste volgorde.
• Namen van uitvoervariabelen worden voorgesteld na de functieaanroep.

Deze ondersteuning helpt u bij het volgende:

• Snel beschikbare substromen vinden.
• Inzicht krijgen in de vereiste invoer zonder terug te hoeven grijpen op de desktopflow.
• Selecteer geldige uitvoervariabelen zonder hun namen te onthouden.

Waar u een substroom kunt aanroepen

Substromen aanroepen vanuit eigenschappen waarmee acties kunnen worden uitgevoerd, zoals:

• De OnSelect van een knop.
• De gebeurteniseigenschap van een besturingselement (bijvoorbeeld OnChange) wanneer dit geschikt is voor het ontwerp van uw app.

Runtimegedrag

Wanneer de bureaubladstroom wordt uitgevoerd en de uitvoering Power App uitvoeren bereikt:

1. De app wordt gestart.
2. De app brengt automatisch een communicatiekanaal tot stand.

De actie Power Apps uitvoeren wordt beëindigd wanneer de gebruiker het Power Apps-venster sluit of de flow handmatig stopt.

Beperkingen en overwegingen

• Sequentiële uitvoering: Het proces verwerkt substroomoproepen één voor één. Activeer geen nieuwe aanroep voordat de vorige aanroep is voltooid.
• Doorvoering na publicatie: Nadat wijzigingen aan een app zijn gepubliceerd, kan het enige tijd duren voordat updates zichtbaar worden wanneer u de app opnieuw start vanuit Power Automate for desktop.
• Aanmeldingsprompts: In sommige scenario's wordt gebruikers mogelijk gevraagd zich aan te melden wanneer de app wordt gestart.

Troubleshooting

U kunt het object PowerAutomateDesktop niet zien in de Power Apps ontwerper

• Zorg ervoor dat u de app Openen gebruikt in de actie PAD. Selecteer Vervolgens Open Designer in de browser en wacht totdat de ontwerper de app laadt.
• Houd de padbrowserpagina open totdat wordt aangegeven dat de verbinding tot stand is gebracht.

Ik zie mijn nieuwe of bijgewerkte substroom niet in Power Apps Studio

• Open de app opnieuw via Run Power Apps > App openen > Open Designer zodat het schema wordt vernieuwd.

Wijzigingen in de Power App worden niet weergegeven wanneer ze worden uitgevoerd vanuit Power Automate voor desktop

• Zorg ervoor dat u uw meest recente wijzigingen in Power Apps publiceert.
• Wacht na het publiceren een korte tijd voordat u de app opnieuw uitvoert, omdat het even kan duren voordat updates zijn doorgegeven en beschikbaar zijn wanneer ze vanuit Power Automate voor bureaublad worden gestart. Als u niet wilt wachten, kunt u de app opnieuw starten met de actie Power App uitvoeren om onmiddellijk de nieuwste versie te laden.

De app wordt niet weergegeven tijdens runtime

Power Apps wordt weergegeven met behulp van de Microsoft Edge WebView2 Runtime.

• Zorg ervoor dat deze WebView2 Runtime op uw computer is geïnstalleerd. U kunt dit controleren door:

  • De lijst met geïnstalleerde toepassingen controleren in Windows Instellingen (Apps > Geïnstalleerde apps) of
  • De probleemoplosser voor Power Automate for desktop uitvoeren

• Als deze niet is geïnstalleerd, downloadt en installeert u deze vanuit Microsoft Edge WebView2.

  Selecteer Op de downloadpagina de optie Evergreen Bootstrapper en voer het installatieprogramma uit.