Menjalankan alur desktop melalui URL atau pintasan desktop

  • Artikel

Power Automate, selain memicu alur melalui konsol, perancang alur, dan alur cloud, memungkinkan Anda menjalankan alur desktop menggunakan URL eksekusi dan pintasan desktop.

Anda dapat menggunakan URL untuk memicu alur desktop melalui berbagai sumber, seperti browser, aplikasi Windows Run, prompt perintah,dan Penjadwal Tugas Windows. Atau, Anda dapat membuat pintasan desktop dan menjalankan alur desktop Anda langsung melaluinya.

Jika alur yang dipicu memerlukan variabel input, konsol akan meminta Anda memasukkan nilai yang sesuai.

Secara default, Power Automate selalu meminta Anda untuk mengonfirmasi pemicu alur desktop melalui URL atau pintasan desktop. Untuk menonaktifkan fungsi ini, navigasikan ke pengaturan konsol dan nonaktifkan dialog konfirmasi tampilan saat memanggil alur secara eksternal atau ubah entri registri Windows yangsesuai.

Peringatan

Menonaktifkan dialog konfirmasi menimbulkan ancaman keamanan karena Anda dapat menjalankan tanpa pemberitahuan alur yang dipertanyakan yang dibagikan oleh aktor jahat.

Cuplikan layar dialog Tampilkan konfirmasi saat memanggil opsi alur secara eksternal di pengaturan konsol.

Prasyarat

  • Power Automate Untuk desktop perlu diinstal pada mesin.
  • Pengguna harus masuk.
  • Pengguna memerlukan langganan uji coba atau organisasi berbayar atau lingkungan bayar sesuai pemakaian.

Membuat pintasan desktop

Untuk membuat pintasan untuk alur desktop, klik kanan namanya di konsol dan pilih Buat pintasan desktop. Semua pintasan dibuat secara otomatis di folder desktop Anda, tetapi Anda dapat memindahkannya ke folder mana pun di mesin Anda.

Cuplikan layar opsi Buat pintasan desktop.

Membuat URL eksekusi

Penting

Jika alur sudah berjalan, alur tidak akan berjalan lagi saat URL dipanggil.

Untuk membuat URL yang memicu alur desktop, gunakan salah satu format berikut:

"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]"

Catatan

Anda dapat menemukan URL eksekusi yang dibuat secara otomatis yang terdiri dari ID lingkungan dan alur di bagian properti alur desktop. Anda dapat menemukan informasi selengkapnya tentang properti alur di Properti alur desktop.

Dua format pertama tidak menentukan lingkungan tertentu, sehingga Power Automate secara otomatis menggunakan lingkungan konsol yang saat ini dipilih. Perintah akan diabaikan jika ID alur atau nama alur tidak ditentukan.

Jika konsol diatur ke lingkungan lain selain yang ditentukan dalam URL, lingkungan konsol akan berubah secara otomatis.

Menemukan ID lingkungan dan alur desktop

Untuk menemukan ID lingkungan, navigasikan ke Power Automate portal dan pilih lingkungan yang diinginkan. Kemudian, navigasikan ke tab Alur saya dan salin ID lingkungan dari baris alamat.

Cuplikan layar ID lingkungan di baris alamat.

Untuk menemukan ID alur desktop, luncurkan Power Automate konsol, pilih atau klik kanan alur yang sesuai, dan pilih Properti.

Cuplikan layar detail alur desktop.

Menambahkan variabel input alur ke URL yang dijalankan

Terlepas dari parameter input wajib, Anda dapat menambahkan inputArguments parameter ke URL yang dijalankan untuk mengonfigurasi input aliran.

inputArguments Jika parameter berisi semua variabel input alur, konsol Power Automate tidak meminta input pengguna selama alur dijalankan.

URL yang inputArguments berisi parameter harus memiliki struktur berikut. Parameter dapat ditambahkan ke salah satu URL yang disebutkan sebelumnya.

Penting

Semua karakter khusus dalam string JSON harus di-escape. Misalnya, semua tanda kutip ganda harus dipisahkan dari garis miring terbalik.

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

Misalnya, URL run di bawah ini memanggil alur desktop dengan input teks, numerik, dan boolean:

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

Catatan

  • Hanya tipe data Teks, Numerik, dan Boolean yang didukung.
  • Nilai Boolean peka huruf besar/kecil, dan nilainya bisa true atau false.
  • Jika ada input aliran tambahan yang tidak disertakan dalam inputArguments parameter, maka selama menjalankan aliran konsol Power Automate meminta input pengguna.
  • Sumber yang memanggil URL eksekusi mungkin memiliki batas karakter maksimum yang diizinkan, yang akan menyebabkan alur gagal jika batas tersebut terlampaui.

Penting

  • Untuk memicu URL eksekusi melalui browser web, lepaskaninputArguments nilai string JSON parameter dan gunakan pengkodean URL untuk mengonversi karakter ke dalam format ASCII yang valid.
  • Untuk melepaskan karakter tanda kutip ganda, hapus garis miring terbalik. Misalnya, inputArguments = "NewInput": "Halo", "NewInput2": 123,{ "NewInput3": true}

Simpan log untuk alur desktop yang dijalankan melalui URL

Terlepas dari parameter input wajib, Anda dapat menambahkan runId parameter ke URL eksekusi untuk menentukan GUID unik untuk log alur desktop.

Power Automate menggunakan GUID ini untuk membuat folder dan menyimpan log di dalamnya. Log disimpan di:C: \Users\[Username]\AppData\Local\Microsoft\Desktop\Console\Scripts\[Flow ID]\Runs\Power Automate [Run ID]

Catatan

GUID adalah nilai 128-bit yang terdiri dari satu grup 8 digit heksadesimal, tiga grup masing-masing 4 digit, dan satu grup 12 digit, misalnya: e6f82a20-47f7-4dd8-a97f-63df36797d0f.

URL yang runId berisi parameter input harus memiliki struktur berikut. Parameter dapat ditambahkan ke salah satu URL yang disebutkan sebelumnya.

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

Gunakan URL yang dijalankan di command prompt

Untuk memicu alur menggunakan prompt perintah, gunakan perintah dengan sintaks berikut (berlaku untuk penginstalan MSI):

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

Catatan

Anda dapat mengganti bagian kedua perintah dengan salah satu format URL yang disajikan sebelumnya.

Alur pemicu secara otomatis dengan Penjadwal Tugas

Untuk memicu alur menggunakan aplikasi Penjadwal Tugas Windows:

  1. Buat tugas baru, navigasikan ke tab Tindakan dari dialog Buat Tugas , dan tambahkan tindakan baru.

  2. Isi nilai berikut di bidang Program/skrip .

    • Untuk instalasi MSI:
    C:\Program Files (x86)\Power Automate Desktop\PAD.Console.Host.exe
    • Untuk penginstalan Microsoft Store:
    C:\WINDOWS\system32\WindowsPowerShell\v1.0\powershell.exe

  3. Isi nilai berikut di bidang Tambahkan argumen .

    • Untuk instalasi MSI:
    ms-powerautomate:/console/flow/run?workflowName=[workflowName]
    • Untuk penginstalan Microsoft Store:
    -Command "Start-Process \"ms-powerautomate:/console/flow/run?workflowName=[workflowName]""

    Catatan

    Anda dapat mengganti argumen yang diberikan dengan salah satu format URL yang disajikan sebelumnya.