Uruchom aplikację Power App

Akcja Uruchom aplikację Power App uruchamia aplikację bezpośrednio z poziomu przepływu pulpitu i nawiązuje kanał komunikacji między nimi. Dzięki tej integracji przepływy pulpitu mogą bezpośrednio wywoływać środowiska Power App, przekazywać dane wejściowe i odbierać dane wyjściowe. Takie podejście umożliwia zaawansowaną integrację natywną w scenariuszach automatyzacji asystowanej, zamiast polegać na automatyzacji opartej na interfejsie użytkownika.

Dzięki tej możliwości można wykonywać następujące czynności:

  • Wywoływanie aplikacji bezpośrednio z przepływu pulpitu
  • Wywołaj aplikację bezpośrednio z przepływu pulpitu.
  • Przekaż dane wejściowe z przepływu pulpitu do aplikacji.
  • Przechwyć dane wyjściowe z aplikacji z powrotem do przepływu.
  • Wyzwalaj podprzepływy za pomocą zdarzeń aplikacji.

Umożliwia to scenariusze, takie jak:

  • Wieloetapowe, dynamiczne formularze na potrzeby automatyzacji nadzorowanej
  • Nowoczesne środowiska oparte na aplikacjach zastępujące starsze formularze niestandardowe
  • Asystowana automatyzacja sterowana zdarzeniami, w której działania użytkownika sterują wykonaniem przepływu
  • Nowoczesne aplikacje chmurowe łączące się ze starszymi systemami automatyzacji komputerów stacjonarnych

Wymagania i dostępność

  • Minimalna wersja programu Power Automate for desktop: 2.68 lub nowsza.
  • Dostępność chmury: Dostępne tylko w chmurach publicznych.

Prerequisites

Przed rozpoczęciem upewnij się, że masz następujące elementy:

  • Zainstalowany program Power Automate dla komputerów stacjonarnych (PAD) w wersji 2.68 lub nowszej
  • Dostęp do Power Apps w tym samym środowisku
  • Podprzepływy pulpitu, które można uruchamiać z aplikacji
  • Zainstalowano środowisko uruchomieniowe Microsoft Edge WebView2 Runtime (wymagane do wyświetlania aplikacji Power App podczas działania)

Ważna

  • Utwórz lokalne podprzepływy i w razie potrzeby zdefiniuj zmienne wejściowe i wyjściowe w zakresie podprzepływu.
  • Nazwy podprzepływów muszą zaczynać się od litery, zawierać wyłącznie znaki alfabetu łacińskiego i nie mogą zawierać spacji. Przepływy podrzędne, które nie spełniają tych reguł nazewnictwa, nie są udostępniane w usłudze Power Apps Studio i nie są dostępne do ich wywołania.

Krok 1. Utwórz wywoływalne podprzepływy w przepływie pulpitu

  1. Otwórz przepływ pulpitu w projektancie PAD.
  2. Utwórz co najmniej jeden podpływ lokalny .
  3. (Opcjonalnie) Dla każdego podprzepływu zdefiniuj:
    • Zmienne wejściowe: wartości, które aplikacja przekazuje do podpływu
    • Zmienne wyjściowe: wartości zwracane do aplikacji przez podprzepływ

Note

Można również tworzyć podflowe, które nie wymagają danych wejściowych ani wyjściowych. Aplikacja może wywoływać te podflowe, aby wykonywać logikę bez przekazywania lub zwracania danych. Niech każdy podprzepływ koncentruje się na jednej operacji (na przykład wyszukiwaniu danych, walidacji danych wejściowych lub zapisywaniu do systemu).

Krok 2. Ustanawianie połączenia tworzenia z programem Power Apps Studio

Aby udostępnić podprzepływy w Power Apps Studio (tak aby były dostępne jako funkcje, które można wywoływać), otwórz aplikację za pośrednictwem mostka tworzenia PAD.

  1. Dodaj akcję Run Power App do przepływu pulpitu.
  2. We właściwościach akcji wykonaj jedną z następujących czynności:
    • Wybierz istniejącą aplikację lub
    • Utwórz nową aplikację

Note

Jeśli tworzysz nową aplikację:

  • Strona mostka aplikacji klasycznej Power Automate zostaje automatycznie otwarta w przeglądarce domyślnej.
  • Zapisz i opublikuj aplikację w projektancie Power Apps.
  • Wróć do akcji i wybierz pozycję Odśwież.
  • Wybierz aplikację z listy rozwijanej.

  1. Wybierz pozycję Otwórz aplikację.

    Domyślna przeglądarka otwiera stronę Power Automate dla komputerów stacjonarnych która przeprowadzi Cię przez proces nawiązywania połączenia z programem Power Apps Studio.

  2. Na stronie przeglądarki wybierz pozycję Otwórz projektanta.

    Nowa karta przeglądarki zostanie otwarta z Power Apps Studio, a wybrana aplikacja będzie już otwarta.

  3. Pozostaw stronę przeglądarki aplikacji Power Automate for desktop otwartą, aż pojawi się informacja, że jest połączona.

    Jeśli zamkniesz stronę, zanim aplikacja zakończy ładowanie, uniemożliwisz nawiązanie połączenia między przepływem pulpitu a aplikacją Power App.

Krok 3. Wywołaj podprzepływy pulpitu z usługi Power App

Po ustanowieniu połączenia projektanta program Power Apps Studio wyświetla obiekt hosta o nazwie PowerAutomateDesktop. Ten obiekt udostępnia podprzepływy pulpitu jako funkcje, które można wywoływać.

Wzorzec wywołania (ogólny)

Aby wywołać klasyczny podprzepływ w usłudze Power Apps:

  • Użyj obiektu PowerAutomateDesktop.
  • Wywołaj podprzepływ według nazwy.
  • Przekazywanie danych wejściowych jako parametrów funkcji.
  • Uzyskaj dostęp do wartości wyjściowych zwróconych wyników.

Składnia ogólna:

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

Example

W tym przykładzie:

  • Podprzepływ ma nazwę GetCustomerData.
  • Akceptuje pojedynczy parametr wejściowy. Na przykład varCustomerId.
  • Zwraca wartość za pomocą zmiennej wyjściowej o nazwie out_customer_data, która jest przechowywana w zmiennej globalnej varResult.

Aby wywołać podpływ, przekaż wartość varCustomerId i zapisz zwrócone dane wyjściowe w zmiennej globalnej varResult:

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

Krok 4. Zwracanie wartości do Power Apps

  • Power Automate dla pulpitu zwraca wszystkie wartości jako ciągi. W Power Apps rzutuj te wartości na odpowiedni typ.
  • Po wywołaniu podprzepływu przepływu pulpitu otrzymasz wszystkie zmienne wyjściowe jako pojedynczą wartość rekordu.
  • Możesz uzyskać dostęp do poszczególnych zmiennych wyjściowych jako właściwości tego rekordu.

Przykład: pobieranie i używanie zmiennych wyjściowych w Power Apps

Set(globalVariable, PowerAutomateDesktop.GetCustomerData(inputVariable))

Ten przykład przechowuje wszystkie zmienne wyjściowe z podprzepływu w globalVariable.

Aby uzyskać dostęp do określonej zmiennej wyjściowej. Na przykład : out_var1

globalVariable.out_var1

Zwracanie wartości złożonych

Jeśli musisz zwrócić złożone wartości (obiekty niestandardowe lub listy), zwróć je jako zmienne wyjściowe i przeanalizuj je w Power Apps.

  1. W podprzepływie pulpitu utwórz obiekt niestandardowy.
  2. Zwróć obiekt niestandardowy jako zmienną wyjściową.
  3. W Power Apps użyj ParseJSON, aby przeanalizować zwróconą wartość i uzyskać dostęp do jej właściwości.
Set(parsedValue, ParseJSON(globalVariable.out_customer_data))

Note

Power Automate dla pulpitu zwraca wszystkie wartości jako ciągi. Przed użyciem tych wartości w aplikacji należy rzutować je do odpowiedniego typu (na przykład użyć Value lub Boolean).

Obsługa funkcji IntelliSense

Podczas wywoływania podprzepływów pulpitu w Power Apps program Power Apps Studio udostępnia funkcję IntelliSense, która ułatwia odkrywanie dostępnych możliwości i korzystanie z nich.

Podczas wpisywania na pasku formuły:

  • Obiekt PowerAutomateDesktop pokazuje dostępne nazwy podprzepływów.
  • Parametry wejściowe wybranego podprzepływu są wyświetlane w prawidłowej kolejności.
  • Nazwy zmiennych wyjściowych są sugerowane po wywołaniu funkcji.

To wsparcie pomoże Ci:

  • Szybko znajdź dostępne podprzepływy.
  • Poznaj wymagane dane wejściowe bez odwoływania się z powrotem do przepływu pulpitu.
  • Wybierz prawidłowe zmienne wyjściowe bez zapamiętywania ich nazw.

Gdzie można wywołać podprzepływ

Wywołaj podprzepływy z właściwości obsługujących działania, takich jak:

  • Element OnSelect przycisku.
  • Właściwość zdarzenia kontrolki (na przykład OnChange), jeśli jest to odpowiednie w projekcie aplikacji.

Zachowanie środowiska uruchomieniowego

Gdy przepływ pulpitu jest uruchamiany i wykonywanie dojdzie do pozycji Uruchom aplikację Power App:

  1. Aplikacja zostanie uruchomiona.
  2. Aplikacja automatycznie ustanawia kanał komunikacyjny.

Akcja Run Power App kończy się, gdy użytkownik zamknie okno Power Apps lub zatrzyma przepływ ręcznie.

Ograniczenia i zagadnienia

  • Wykonywanie sekwencyjne: proces obsługuje wywołania podprzepływu po jednym. Nie inicjuj nowego wywołania, zanim poprzednie się nie zakończy.
  • Propagacja po opublikowaniu: Po opublikowaniu zmian w aplikacji aktualizacje mogą pojawić się dopiero po pewnym czasie przy ponownym uruchomieniu aplikacji z programu Power Automate Desktop.
  • Monity logowania: W niektórych scenariuszach użytkownicy mogą być monitowani o zalogowanie się po uruchomieniu aplikacji.

Troubleshooting

W projektancie Power Apps nie widać obiektu PowerAutomateDesktop

  • Upewnij się, że używasz funkcji Otwórz aplikację w akcji PAD. Następnie wybierz pozycję Otwórz projektanta w przeglądarce i zaczekaj na załadowanie aplikacji przez projektanta.
  • Zachowaj otwartą stronę przeglądarki PAD, dopóki nie zostanie nawiązane połączenie.

Nie widzę nowego lub zaktualizowanego podprzepływu w usłudze Power Apps Studio

  • Otwórz ponownie aplikację za pośrednictwem Uruchom Power Apps > Otwórz aplikację > Open Designer aby odświeżyć schemat.

Zmiany w aplikacji Power Apps nie są uwzględniane przy uruchamianiu z poziomu Power Automate for desktop

  • Upewnij się, że publikujesz najnowsze zmiany w Power Apps.
  • Po opublikowaniu poczekaj krótki czas przed ponownym uruchomieniem aplikacji, ponieważ propagacja aktualizacji może zająć trochę czasu i stać się dostępna po uruchomieniu z Power Automate dla komputerów stacjonarnych. Jeśli nie chcesz czekać, możesz ponownie uruchomić aplikację, używając akcji Uruchom aplikację Power App , aby natychmiast załadować najnowszą wersję.

Aplikacja nie pojawia się w czasie działania

Aplikacja Power Apps jest renderowana przy użyciu przeglądarki Microsoft Edge WebView2 Runtime.

  • Upewnij się, że WebView2 Runtime na maszynie jest zainstalowana. Możesz to sprawdzić, wykonując następujące czynności:

    • Sprawdzanie listy zainstalowanych aplikacji w ustawieniach Windows (Aplikacje > Zainstalowane aplikacje) lub
    • Uruchamianie narzędzia do rozwiązywania problemów z aplikacją klasyczną Power Automate

  • Jeśli nie jest zainstalowany, pobierz go i zainstaluj z Microsoft Edge WebView2.

    Na stronie pobierania wybierz pozycję Evergreen Bootstrapper i uruchom instalatora.

  • Ostatnia aktualizacja o