Uruchamianie przepływów pulpitu za pomocą adresu URL lub skrótów pulpitu

Power Automate, oprócz wyzwalania przepływów za pośrednictwem konsoli, projektanta przepływu i przepływów w chmurze, umożliwia uruchamianie przepływów na pulpicie przy użyciu uruchamianych adresów URL i skrótów na pulpicie.

Można użyć adresów URL do wyzwalania przepływów pulpitu przez wiele różnych źródeł, takich jak przeglądarki, aplikacja Windows Run, wiersz polecenia i harmonogram zadań systemu Windows. Alternatywnie możesz utworzyć skróty na pulpicie i bezpośrednio przez nie uruchamiać przepływy pulpitu.

Jeśli wyzwalany przepływ wymaga zmiennych wejściowych, konsola poprosi o wypełnienie odpowiednich wartości.

Domyślnie Power Automate zawsze wyświetla monit o potwierdzenie wyzwolenia przepływu na pulpicie za pomocą adresu URL lub skrótu na pulpicie. Aby wyłączyć tę funkcję, przejdź do ustawień konsoli i wyłącz Wyświetl okno dialogowe potwierdzenia podczas zewnętrznego wywoływania przepływów lub zmodyfikuj odpowiedni wpis rejestru systemu Windows.

Ostrzeżenie

Wyłączenie okna dialogowego potwierdzenia stanowi zagrożenie dla bezpieczeństwa, ponieważ możesz bez uprzedzenia uruchomić wątpliwy przepływ udostępniony przez hakera.

Wymagania wstępne

• Na komputerze musi być zainstalowany Power Automate na urządzenia stacjonarne.
• Użytkownik musi być zalogowany.
• Użytkownik musi mieć plan Power Automate Premium lub dostęp do środowiska płatności za rzeczywiste użycie.

Utwórz skrót na pulpicie

Aby utworzyć skrót do przepływu pulpitu, kliknij prawym przyciskiem myszy jego nazwę w konsoli i wybierz polecenie Utwórz skrót stacjonarny. Wszystkie skróty są automatycznie tworzone w folderze na pulpicie, ale możesz je przenieść do dowolnego folderu na swoim komputerze.

Utwórz adres URL uruchomienia

Ważne

Jeśli przepływ jest już uruchomiony, nie zostanie ponownie uruchomiony po wywołaniu adresu URL.

Aby wygenerować adres URL, który wyzwala przepływ na pulpicie, użyj jednego z następujących formatów:

"ms-powerautomate:/console/flow/run?workflowName=[workflowName]"

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]"

"ms-powerautomate:/console/flow/run?environmentId=[environmentId]&workflowId=[workflowId]"

"ms-powerautomate:/console/flow/run?environmentId=[environmentId]&workflowName=[workflowIName]"

Uwaga

Automatycznie utworzony adres URL uruchamiania umożliwia znalezienie identyfikatorów środowiska i przepływu w sekcji właściwości przepływu pulpitu. Więcej informacji o właściwościach przepływu można znaleźć w temacie Właściwości przepływu pulpitu.

Dwa pierwsze formaty nie definiują określonego środowiska, więc Power Automate automatycznie używa aktualnie wybranego środowiska konsoli. Polecenie zostanie pominięte, jeśli nie zostanie określony identyfikator przepływu lub nazwa przepływu.

Jeśli konsola jest ustawiona na inne środowisko niż określone w adresie URL, środowisko konsoli zmieni się automatycznie.

Znajdź identyfikatory przepływu środowiska i pulpitu

Aby znaleźć identyfikator środowiska, przejdź do Power Automate portal i wybierz żądane środowisko. Następnie przejdź na kartę Moje przepływy i skopiuj identyfikator środowiska z wiersza adresu.

Aby znaleźć identyfikator przepływu pulpitu, uruchom konsolę Power Automate, wybierz lub kliknij prawym przyciskiem myszy odpowiedni przepływ i wybierz polecenie Właściwości.

Dodawanie parametrów opcjonalnych do adresu URL uruchamiania

Oprócz obowiązkowych parametrów wejściowych do adresu URL uruchomienia można dodać parametry opcjonalne.

Dodaj zmienne wejściowe przepływu do uruchomionego adresu URL

Dodaj parametr inputArguments do adresu URL uruchomienia, aby skonfigurować dane wejściowe przepływu.

Jeśli parametr inputArguments zawiera wszystkie zmienne wejściowe przepływu, konsola Power Automate nie żąda od użytkownika wprowadzenia danych podczas przebiegu przepływu.

Adres URL zawierający parametr inputArguments powinien mieć następującą strukturę. Parametr można dodać do dowolnego z wcześniej wymienionych adresów URL.

Ważne

Wszystkie znaki specjalne w ciągu JSON muszą być poprzedzone znakiem ucieczki. Na przykład wszystkie cudzysłowy muszą być poprzedzone ukośnikiem odwrotnym.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&inputArguments={\"[External name 1]\": [Value 1],\"[External name 2]\": [Value 2]}"

Na przykład poniższy uruchamiany adres URL wywołuje przepływ na pulpicie z danymi wejściowymi tekstowymi, numerycznymi i boolowskimi:

"ms-powerautomate:/console/flow/run?&workflowid=dfd0c814-2c30-4cd8-849d-a4b2d2f4f33b&inputArguments={\"NewInput\": \"Hello\", \"NewInput2\": 123, \"NewInput3\": true}"

Uwaga

• Obsługiwane są tylko typy danych tekstowych, numerycznych i logicznych.
• W wartościach logicznych rozróżniana jest wielkość liter i wartość może być true lub false.
• Jeśli istnieją dodatkowe wejścia przepływu, które nie są uwzględnione w parametrze inputArguments, wówczas podczas przebiegu przepływu konsola Power Automate prosi użytkownika o wprowadzenie danych.
• Źródło wywołujące uruchamiany adres URL może mieć limit maksymalnej liczby dozwolonych znaków, co spowoduje niepowodzenie przepływu w przypadku przekroczenia tego limitu.

Ważne

• Aby wyzwolić uruchamianie adresu URL za pośrednictwem przeglądarki internetowej, należy usunąć znaki ucieczki dla wartości ciągu JSON parametru inputArguments i użyć kodowania adresu URL, aby przekonwertować znaki na prawidłowy format ASCII.
• W przypadku podwójnego cudzysłowu oznacza to usunięcie ukośników odwrotnych. Na przykład inputArguments={"NewInput": "Hello", "NewInput2": 123, "NewInput3": true}

Należy zalogować się dyskretnie przy użyciu bieżącego konta systemu Windows

Dodaj parametr autologin do adresu URL uruchomienia, aby zalogować się do Power Automate bez żadnej interakcji z użytkownikiem, przy użyciu bieżącego zalogowanego użytkownika systemu Windows.

Zgodnie z wymaganiami wstępnymi użytkownik musi zostać wylogowany i Power Automate musi działać na komputerze.

Ważne

Jeśli użytkownik jawnie się nie wylogował z Power Automate za pośrednictwem interfejsu użytkownika, Power Automate przestrzega preferencji użytkownika i nie wykonuje automatycznego logowania.

Adres URL zawierający parametr autologin powinien mieć następującą strukturę. Parametr można dodać do dowolnego z wcześniej wymienionych adresów URL.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&autologin=true"

Zapisuj logi dla przepływów pulpitu uruchamianych przez adres URL

Dodaj parametr runId do adresu URL uruchomienia, aby zdefiniować unikatowy identyfikator GUID dzienników przepływu pulpitu.

Usługa Power Automate używa tego identyfikatora GUID do tworzenia folderu i przechowywania w nim dzienników. Dzienniki są przechowywane w folderach: C:\Users\[Username]\AppData\Local\Microsoft\Power Automate Desktop\Console\Scripts\[Flow ID]\Runs\[Run ID]

Uwaga

GUID to 128-bitowa wartość składająca się z jednej grupy 8 cyfr szesnastkowych, trzech grup po 4 cyfry i jednej grupy 12 cyfr, na przykład: e6f82a20-47f7-4dd8-a97f-63df36797d0f.

Adres URL zawierający parametr wejściowy runId powinien mieć następującą strukturę. Parametr można dodać do dowolnego z wcześniej wymienionych adresów URL.

"ms-powerautomate:/console/flow/run?workflowId=[workflowId]&runId=[GUID]"

Używanie adresu URL przebiegu w wierszu polecenia

Aby wyzwolić przepływ przy użyciu wiersza polecenia, użyj polecenia o następującej składni (dotyczy instalacji MSI):

"C:\Program Files (x86)\Power Automate Desktop\PAD.Console.Host.exe" "ms-powerautomate:/console/flow/run?workflowName=[workflowName]"

Uwaga

Drugą część polecenia możesz zastąpić dowolnym z przedstawionych wcześniej formatów URL.

Automatyczne wyzwalanie przepływów za pomocą harmonogramu zadań

Aby wyzwolić przepływ za pomocą aplikacji harmonogramu zadań systemu Windows:

1. Utwórz nowe zadanie, przejdź do karty Akcje okna dialogowego Tworzenie zadania i dodaj nową akcję.

2. Wypełnij odpowiednią wartość w polu Program/skrypt.

   • Dla instalacji MSI:

   C:\Program Files (x86)\Power Automate Desktop\PAD.Console.Host.exe
   

   • Dla instalacji ze sklepu Microsoft Store:

   C:\WINDOWS\system32\WindowsPowerShell\v1.0\powershell.exe
   

3. Wypełnij odpowiednią wartość w polu Dodaj argumenty.

   • Dla instalacji MSI:

   ms-powerautomate:/console/flow/run?workflowName=[workflowName]
   

   • Dla instalacji ze sklepu Microsoft Store:

   -Command "Start-Process \"ms-powerautomate:/console/flow/run?workflowName=[workflowName]""
   

   Uwaga

   Podany argument można zastąpić dowolnymi wcześniej przedstawionymi formatami adresów URL.