Exécuter Power App (préversion)

L’action Exécuter Power App lance une application directement à partir d’un flux de bureau et établit un canal de communication entre les deux. À l’aide de cette intégration, les flux de bureau peuvent appeler en mode natif des expériences Power App, passer des entrées et recevoir des sorties. Cette approche permet une intégration native enrichie pour les scénarios d’automatisation assistés au lieu de s’appuyer sur l’automatisation basée sur l’interface utilisateur.

Cette capacité vous offre les possibilités suivantes :

• Appeler une application directement à partir d’un flux de bureau
• Appelez une application directement à partir d’un flux de bureau.
• Transmettez les entrées du flux de bureau à l’application.
• Capturez les sorties de l’application afin de les réinjecter dans le flux.
• Déclenchez des sous-flux à partir d’événements d’application.

Cela permet des scénarios, tels que :

• Formulaires guidés dynamiques en plusieurs étapes pour l’automatisation assistée
• Expériences modernes basées sur des applications remplaçant les formulaires personnalisés hérités
• Automatisation suivie par les événements, où les actions utilisateur dictent l’exécution du flux
• Applications cloud modernes faisant le lien avec l’automatisation de bureau existante

Conditions requises et disponibilité

• Version minimale de Power Automate pour le bureau : 2.68 ou ultérieure.
• Disponibilité du cloud : Disponible uniquement dans les clouds publics.

Prerequisites

Avant de commencer, vérifiez que vous disposez des éléments suivants :

• Power Automate pour le bureau (PAD) version 2.68 ou ultérieure installée
• Accès à Power Apps dans le même environnement
• Sous-flux de bureau que vous pouvez appeler depuis l’application
• Microsoft Edge RuntimeWebView2 installé (requis pour afficher Power App pendant l’exécution)

Étape 1 : Créer des sous-flux pouvant être appelés dans votre flux de bureau

1. Ouvrez votre flux de bureau dans le concepteur PAD.
2. Créez un ou plusieurs sous-flux locaux .
3. (Facultatif) Pour chaque sous-flux, définissez :
   • Variables d’entrée : valeurs que l’application passe dans le sous-flux de données
   • Variables de sortie : valeurs que le sous-flux retourne à l’application

Étape 2 : Établir la connexion de création à Power Apps Studio

Pour exposer vos sous-flux dans Power Apps Studio (par conséquent, ils apparaissent en tant que fonctions que vous pouvez appeler), ouvrez l’application via le pont de création PAD.

1. Ajoutez l’action Exécuter Power App (préversion) à votre flux de bureau.
2. Dans les propriétés d’action, soit :
   • Sélectionnez une application existante ou
   • Créer une application

1. Sélectionnez Ouvrir l’application.

   Votre navigateur par défaut ouvre une page Power Automate pour bureau qui vous guide tout au long de la connexion à Power Apps Studio.

2. Dans la page du navigateur, sélectionnez Ouvrir le Concepteur.

   Un nouvel onglet de navigateur s’ouvre avec Power Apps Studio avec l’application sélectionnée déjà ouverte.

3. Gardez la page du navigateur de Power Automate for desktop ouverte jusqu'à ce qu'elle indique qu'elle est connectée.

   Si vous fermez la page avant la fin du chargement de l’application, vous empêchez d’établir une connexion entre le flux de bureau et l’application Power.

Étape 3 : Appeler des sous-flux de bureau à partir de l’application Power App

Après avoir établi la connexion du concepteur, Power Apps Studio affiche un objet hôte nommé PowerAutomateDesktop. Cet objet expose vos sous-flux de bureau en tant que fonctions pouvant être appelées.

Modèle d’appel (général)

Pour appeler un sous-flux de bureau à partir de Power Apps :

• Utilisez l’objet PowerAutomateDesktop .
• Appelez le sous-flux par son nom.
• Passez les entrées en tant que paramètres de fonction.
• Accéder aux valeurs de sortie à partir du résultat retourné.

Syntaxe générale :

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

Example

Dans cet exemple :

• Le sous-flux est nommé GetCustomerData.
• Il accepte un paramètre d’entrée unique. Par exemple : varCustomerId.
• Elle retourne une valeur par le biais d’une variable de sortie nommée out_customer_data, qui est stockée dans la variable varResultglobale.

Pour appeler le sous-flux, passez la valeur de varCustomerId et stockez la sortie retournée dans la variable globale varResult :

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

Étape 4 : Retourner des valeurs à Power Apps

• Power Automate pour le bureau retourne toutes les valeurs sous forme de chaînes. Dans Power Apps, convertissez ces valeurs en type approprié.
• Lorsque vous appelez un sous-flux de flux de bureau, il retourne toutes les variables de sortie sous forme de valeur d’enregistrement unique.
• Vous pouvez accéder à des variables de sortie individuelles en tant que propriétés de cet enregistrement.

Exemple : Obtenir et utiliser des variables de sortie dans Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

Cet exemple stocke toutes les variables de sortie du sous-flux dans globalVariable.

Pour accéder à une variable de sortie spécifique. Par exemple, out_var1 :

globalVariable.out_var1

Retourner des valeurs complexes

Si vous devez retourner des valeurs complexes (objets ou listes personnalisés), retournez-les en tant que variables de sortie et analysez-les dans Power Apps.

1. Dans le sous-flux de bureau, générez un objet personnalisé.
2. Retourne l’objet personnalisé en tant que variable de sortie.
3. Dans Power Apps, utilisez ParseJSON pour analyser la valeur retournée et accéder à ses propriétés.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Prise en charge d’IntelliSense

Lorsque vous appelez des sous-flux de bureau dans Power Apps, Power Apps Studio fournit IntelliSense pour vous aider à découvrir et à utiliser les fonctionnalités disponibles.

Lorsque vous tapez dans la barre de formule :

• L’objet PowerAutomateDesktop affiche les noms de sous-flux disponibles.
• Les paramètres d’entrée du sous-flux sélectionné sont affichés dans l’ordre correct.
• Les noms des variables de sortie sont suggérés après l’appel de la fonction.

Ce support vous aide à :

• Recherchez rapidement les sous-flux disponibles.
• Comprendre les entrées requises sans faire référence au flux de bureau.
• Sélectionnez les variables de sortie valides sans mémoriser leurs noms.

Où vous pouvez appeler un sous-flux

Invoquez des sous-flux à partir de propriétés prenant en charge les actions, telles que :

• La propriété OnSelect d’un bouton.
• Propriété d’événement d’un contrôle (par exemple, OnChange) le cas échéant pour la conception de votre application.

Comportement à l’exécution

Lorsque le flux de bureau s’exécute et que l’exécution atteint Exécuter Power App :

1. L’application démarre.
2. L’application établit automatiquement un canal de communication.

L’action Exécuter Power App se termine lorsque l’utilisateur ferme la fenêtre Power Apps ou arrête le flux manuellement.

Limitations et considérations

• Exécution séquentielle : Le processus gère les appels de sous-flux un par un. Ne déclenchez pas d’appel avant la fin de l’appel précédent.
• Propagation de publication : Après avoir publié des modifications apportées à une application, les mises à jour peuvent mettre un certain temps à apparaître quand vous relancez l’application depuis Power Automate pour le bureau.
• Invites de connexion : Dans certains scénarios, les utilisateurs peuvent être invités à se connecter lors du lancement de l’application.

Résolution des problèmes

Vous ne pouvez pas voir l'objet PowerAutomateDesktop dans le concepteur Power Apps

• Veillez à utiliser Ouvrir l’application dans l’action PAD. Ensuite, sélectionnez Ouvrir le Concepteur dans le navigateur et attendez que le concepteur charge l’application.
• Conservez la page du navigateur PAD ouverte jusqu’à ce qu’elle indique que la connexion est établie.

Je ne vois pas mon sous-flux nouveau ou mis à jour dans Power Apps Studio

• Rouvrez l’application via Run Power Apps > Ouvrir l’application > Open Designer afin que le schéma s’actualise.

Les modifications apportées à Power App ne sont pas reflétées lors de l'exécution à partir de Power Automate pour le bureau

• Veillez à publier vos dernières modifications dans Power Apps.
• Après la publication, attendez une courte période avant d’exécuter à nouveau l’application, car les mises à jour peuvent prendre un certain temps pour se propager et devenir disponibles lorsqu’elles sont lancées à partir de Power Automate pour le bureau. Si vous ne souhaitez pas attendre, vous pouvez relancer l’application à l’aide de l’action Exécuter Power App pour charger immédiatement la dernière version.

L’application n’apparaît pas pendant l’exécution

Power Apps s’affiche à l’aide du Microsoft Edge WebView2 Runtime.

• Assurez-vous que WebView2 Runtime est installé sur votre ordinateur. Vous pouvez le vérifier en procédant comme suit :

  • Vérification de la liste des applications installées dans les paramètres de Windows (applications > applications installées) ou
  • Exécution du Power Automate pour l’utilitaire de résolution des problèmes de bureau

• S'il n'est pas installé, téléchargez-le et installez-le à partir de Microsoft Edge WebView2.

  Dans la page de téléchargement, sélectionnez Evergreen Bootstrapper et exécutez le programme d’installation.