Power App ausführen (Vorschau)

Die Aktion "Power App ausführen " startet eine App direkt aus einem Desktopfluss und richtet einen Kommunikationskanal zwischen den beiden ein. Mithilfe dieser Integration können Desktopflows Power App-Erfahrungen nativ aufrufen, Eingaben übergeben und Ausgaben empfangen. Dieser Ansatz ermöglicht eine umfassende native Integration für Szenarien der beaufsichtigten Automatisierung, anstatt sich auf UI-basierte Automatisierung zu verlassen.

Mit dieser Funktion können Sie:

• Aufrufen einer App direkt aus einem Desktopablauf
• Rufen Sie eine App direkt aus einem Desktopfluss auf.
• Übergeben Sie Eingabewerte aus dem Desktopflow an die App.
• Erfassen Sie Ausgaben aus der App und führen Sie sie zurück in den Flow.
• Subflows durch App-Ereignisse auslösen.

Dies ermöglicht Szenarien, z. B.:

• Mehrstufige, dynamische geführte Formulare für die beaufsichtigte Automatisierung
• Moderne app-basierte Erfahrungen ersetzen ältere benutzerdefinierte Formulare
• Ereignisgesteuerte beaufsichtigte Automatisierung, bei der Benutzeraktionen die Ausführung des Ablaufs bestimmen
• Moderne Cloudanwendungen überbrücken ältere Desktopautomatisierung

Anforderungen und Verfügbarkeit

• Mindestversion von Power Automate für Desktop: 2.68 oder höher.
• Cloudverfügbarkeit: Nur in öffentlichen Clouds verfügbar.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

• Power Automate für Desktop (PAD) version 2.68 oder höher installiert
• Zugriff auf Power Apps in derselben Umgebung
• Desktop-Subflows, die Sie aus der App aufrufen können
• Microsoft Edge WebView2 Runtime installiert (erforderlich zum Anzeigen der Power App während der Laufzeit)

Schritt 1: Erstellen von aufrufbaren Unterflüssen in Ihrem Desktopablauf

1. Öffnen Sie Ihren Desktopfluss im PAD-Designer.
2. Erstellen Sie einen oder mehrere lokale Unterflüsse.
3. (Optional) Definieren Sie für jeden Unterfluss Folgendes:
   • Eingabevariablen: Werte, die die App an den Unterfluss übergibt
   • Ausgabevariablen: Werte, die der Unterfluss an die App zurückgibt

Schritt 2: Einrichten der Erstellungsverbindung mit Power Apps Studio

Um Ihre Unterflüsse in Power Apps Studio verfügbar zu machen (sodass sie als Funktionen angezeigt werden, die Sie aufrufen können), öffnen Sie die App über die PAD-Erstellungsbrücke.

1. Fügen Sie die Aktion "Power App ausführen( Vorschau)" zu Ihrem Desktopablauf hinzu.
2. Führen Sie in den Aktionseigenschaften eine der folgenden Optionen aus:
   • Auswählen einer vorhandenen App oder
   • Erstellen einer neuen App

1. Wählen Sie "App öffnen" aus.

   Ihr Standardbrowser öffnet eine Power Automate für Desktop Seite, die Sie durch die Verbindung mit Power Apps Studio führt.

2. Wählen Sie auf der Browserseite "Designer öffnen" aus.

   Eine neue Registerkarte im Browser wird mit Power Apps Studio geöffnet, in der die ausgewählte App bereits geöffnet ist.

3. Lassen Sie die Browserseite von Power Automate für Desktop geöffnet, bis angezeigt wird, dass sie verbunden ist.

   Wenn Sie die Seite schließen, bevor das Laden der App abgeschlossen ist, verhindern Sie, dass eine Verbindung zwischen dem Desktopfluss und der Power-App hergestellt wird.

Schritt 3: Subflows aus der Power App aufrufen

Nachdem Sie die Designerverbindung hergestellt haben, zeigt Power Apps Studio ein Hostobjekt mit dem Namen PowerAutomateDesktop an. Dieses Objekt macht Ihre Desktopunterflüsse als aufrufbare Funktionen verfügbar.

Aufrufmuster (allgemein)

So rufen Sie einen Desktop-Subflow aus Power Apps auf:

• Verwenden Sie das PowerAutomateDesktop Objekt.
• Rufen Sie den Unterablauf über seinen Namen auf.
• Übergeben Sie Eingaben als Funktionsparameter.
• Greifen Sie auf Ausgabewerte aus dem zurückgegebenen Ergebnis zu.

Allgemeine Syntax:

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

Example

In diesem Beispiel:

• Der Unterfluss wird benannt GetCustomerData.
• Er akzeptiert einen einzelnen Eingabeparameter. Beispiel: varCustomerId
• Er gibt einen Wert über eine Ausgabevariable mit dem Namen out_customer_datazurück, die in der globalen Variablen varResultgespeichert ist.

Um den Unterfluss aufzurufen, übergeben Sie den Wert von varCustomerId, und speichern Sie die zurückgegebene Ausgabe in der globalen variablen varResult:

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

Schritt 4: Rückgabewerte an Power Apps zurückgeben

• Power Automate für Desktop gibt alle Werte als Zeichenfolgen zurück. Wandeln Sie diese Werte in Power Apps in den entsprechenden Typ um.
• Wenn Sie einen Unterfluss eines Desktopflusses aufrufen, gibt dieser alle Ausgabevariablen als einzelnen Datensatzwert zurück.
• Sie können auf einzelne Ausgabevariablen als Eigenschaften dieses Datensatzes zugreifen.

Beispiel: Abrufen und Verwenden von Ausgabevariablen in Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

In diesem Beispiel werden alle Ausgabevariablen aus dem Unterfluss in globalVariable gespeichert.

So greifen Sie auf eine bestimmte Ausgabevariable zu. Beispiel: out_var1:

globalVariable.out_var1

Zurückgeben komplexer Werte

Wenn Sie komplexe Werte (benutzerdefinierte Objekte oder Listen) zurückgeben müssen, geben Sie sie als Ausgabevariablen zurück und analysieren sie in Power Apps.

1. Erstellen Sie im Desktopunterlauf ein benutzerdefiniertes Objekt.
2. Gibt das benutzerdefinierte Objekt als Ausgabevariable zurück.
3. Verwenden Sie in Power Apps ParseJSON, um den zurückgegebenen Wert zu analysieren und auf seine Eigenschaften zuzugreifen.

Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

IntelliSense-Unterstützung

Wenn Sie Desktop-Unterflüsse in Power Apps aufrufen, bietet Power Apps Studio IntelliSense, damit Sie verfügbare Funktionen entdecken und verwenden können.

Während der Eingabe in die Bearbeitungsleiste:

• Das PowerAutomateDesktop Objekt zeigt die verfügbaren Unterflussnamen an.
• Eingabeparameter für den ausgewählten Unterfluss werden in der richtigen Reihenfolge angezeigt.
• Ausgabevariablennamen werden nach dem Funktionsaufruf vorgeschlagen.

Diese Unterstützung hilft Ihnen bei:

• Schnelle Suche nach verfügbaren Unterflüssen.
• Die erforderlichen Eingaben verstehen, ohne auf den Desktop-Ablauf zurückzugreifen.
• Wählen Sie gültige Ausgabevariablen aus, ohne ihre Namen zu merken.

Wo Sie einen Unterfluss aufrufen können

Unterflüsse aus aktionfähigen Eigenschaften aufrufen, z. B.:

• OnSelect einer Schaltfläche.
• Die Ereigniseigenschaft eines Steuerelements (z. B. OnChange), wenn dies für Ihr App-Design geeignet ist.

Laufzeitverhalten

Wenn der Desktopflow ausgeführt wird und die Ausführung Power App ausführen erreicht:

1. Die App wird gestartet.
2. Die App richtet automatisch einen Kommunikationskanal ein.

Die Aktion Run Power App wird beendet, wenn der Benutzer das Power Apps Fenster schließt oder den Fluss manuell beendet.

Einschränkungen und Überlegungen

• Sequenzielle Ausführung: Der Prozess verarbeitet Subflowaufrufe nacheinander. Lösen Sie keinen neuen Anruf aus, bevor der vorherige Aufruf abgeschlossen ist.
• Übernahme nach der Veröffentlichung: Nach dem Veröffentlichen von Änderungen an einer App kann es einige Zeit dauern, bis Aktualisierungen angezeigt werden, wenn die App über Power Automate für Desktop erneut gestartet wird.
• Anmeldeaufforderungen: In einigen Szenarien werden Benutzer möglicherweise aufgefordert, sich anzumelden, wenn die App gestartet wird.

Problembehandlung

Das PowerAutomateDesktop-Objekt wird im Power Apps-Designer nicht angezeigt.

• Stellen Sie sicher, dass Sie die Öffnen-App in der PAD-Aktion verwenden. Wählen Sie dann im Browser "Designer öffnen" aus, und warten Sie, bis der Designer die App lädt.
• Lassen Sie die PAD-Browserseite geöffnet, bis sie angibt, dass die Verbindung hergestellt wurde.

Ich kann meinen neuen oder aktualisierten Teilflow in Power Apps Studio nicht sehen.

• Öffnen Sie die App erneut über Power Apps ausführen > App öffnen > Designer öffnen, damit das Schema aktualisiert wird.

Änderungen an der Power App werden nicht angezeigt, wenn sie von Power Automate für Desktop ausgeführt werden

• Stellen Sie sicher, dass Sie Ihre neuesten Änderungen in Power Apps veröffentlichen.
• Warten Sie nach der Veröffentlichung einen kurzen Zeitraum, bevor Sie die App erneut ausführen, da Updates einige Zeit in Anspruch nehmen können, um sich weiterzuverbreiten und verfügbar zu machen, wenn sie von Power Automate für desktop gestartet wird. Wenn Sie nicht warten möchten, können Sie die App neu starten, indem Sie die Power App-Aktion ausführen , um die neueste Version sofort zu laden.

Die App wird während der Laufzeit nicht angezeigt.

Power Apps wird mithilfe von Microsoft Edge WebView2 Runtime gerendert.

• Stellen Sie sicher, dass WebView2 Runtime auf Ihrem System installiert ist. Sie können dies überprüfen, indem Sie:

  • Überprüfen der Liste der installierten Anwendungen in Windows Einstellungen (Apps > Installierte Apps) oder
  • Die Problembehandlung von Power Automate für Desktop ausführen

• Wenn sie nicht installiert ist, laden Sie es aus Microsoft Edge WebView2 herunter, und installieren Sie es.

  Wählen Sie auf der Downloadseite evergreen Bootstrapper aus, und führen Sie das Installationsprogramm aus.