Mengelola variabel dan panel variabel

Panel variabel memperlihatkan variabel input dan output yang diteruskan ke dan dari Power Automate alur desktop. Ini juga menampilkan semua variabel yang digunakan dalam aliran desktop saat ini di bawah variabel Aliran.

Melalui panel ini, Anda dapat mencari variabel, mengganti namanya, menemukan penggunaannya, menandainya sebagai sensitif, menyematkannya, dan memfilternya berdasarkan jenis. Pemfilteran memungkinkan Anda memilih apakah akan menerapkannya ke variabel yang disematkan atau tidak.

Penampil nilai variabel

Ketika aliran berjalan, nilai saat ini dari setiap variabel terlihat di sebelah namanya. Pilih ikon penghapus di bagian bawah panel variabel untuk menghapus semua nilai saat ini.

Catatan

Power Automate Secara otomatis menghilangkan variabel tindakan yang dinonaktifkan. Aktifkan tindakan yang dinonaktifkan untuk membuat variabelnya tersedia di panel variabel.

Untuk memeriksa nilai variabel secara lebih rinci, klik dua kali padanya. Penampil nilai variabel menampilkan tipe data dari variabel yang dipilih dan memperluas baris data atau tabel data apa pun untuk menampilkan kontennya.

Tipe data tertentu mungkin berisi elemen bertumpuk. Misalnya, objek kustom mungkin berisi objek kustom lain dalam propertinya. Untuk melihat properti elemen bertumpuk, pilih Lainnya.

Pilih ikon panah di bagian atas dialog untuk kembali ke elemen induk.

Mengganti nama variabel desktop

Untuk mengganti nama variabel alur desktop, klik kanan pada namanya dan pilih Ganti nama. Power Automate Secara otomatis memperbarui nama variabel dalam semua kemunculannya.

Penting

Jika Anda mencoba mengganti nama variabel menjadi nama yang ada, Power Automate Anda akan diminta untuk mengkonfirmasi penggabungan dua variabel. Penggabungan yang tidak disengaja dapat memengaruhi fungsionalitas alur Anda dan menyebabkan kesalahan, jadi pastikan penggabungan diinginkan.

Variabel input dan output

Power Automate Memungkinkan pertukaran data antara aliran cloud dan desktop melalui variabel input dan output, memungkinkan Anda memperluas kemampuan otomatisasi

Selain itu, Anda dapat menggunakan variabel input untuk mengatur nilai secara manual saat alur dipicu melalui konsol.

Untuk menemukan informasi selengkapnya mengenai meneruskan data antara alur cloud dan desktop, lihat Memicu alur desktop dari alur cloud.

Membuat variabel input

Untuk membuat variabel input:

1. Pilih tombol plus (+) di panel variabel lalu Input.

   

2. Saat dialog Variabel input baru muncul, isi bidang berikut:

   • Nama variabel: Nama variabel dalam alur desktop.
   • Jenis data: Jenis variabel: teks, angka, boolean, objek kustom, daftar atau datatable.
   • Nilai default: Nilai default saat alur berjalan melalui desainer alur atau konsol. Saat Anda membuat objek kustom, daftar, atau variabel input datatable, Power Automate memungkinkan Anda untuk membangun nilai default melalui editor visual atau JSON.
   • Nama eksternal: Nama eksternal adalah nama yang muncul di desainer alur awan dan dialog input alur saat memanggil alur dari konsol.
   • Deskripsi: Deskripsi variabel yang muncul di desainer alur cloud dan desktop saat memanggil alur.
   • Tandai sebagai sensitif: Menentukan apakah akan menandai variabel sebagai sensitif atau tidak. Anda dapat menemukan informasi mengenai variabel sensitif dalam variabel sensitif.
   • Tandai sebagai opsional: Menentukan apakah mengisi variabel input ini wajib atau tidak. Dengan menandai variabel input sebagai opsional, Anda mengizinkannya menerima nilai Kosong dan menghilangkan meneruskan nilai aktual, yang tidak mengakibatkan kesalahan. Anda dapat menemukan informasi mengenai variabel input opsional di Variabel input opsional.

   Catatan

   Bidang Nama variabel, tipe data, dan Nama eksternal diperlukan untuk membuat variabel input.

   Penting

   Jika Anda memilih nama variabel aliran yang ada untuk variabel input baru, Power Automate Anda akan diminta untuk mengonfirmasi penggabungan kedua variabel. Penggabungan yang tidak disengaja dapat memengaruhi fungsionalitas alur Anda dan menyebabkan kesalahan. Selain itu, Anda tidak dapat menggunakan nama variabel input atau output yang ada.

   

Saat Anda memicu alur desktop langsung melalui konsol, bukan alur cloud, dialog Input aliran meminta Anda menetapkan nilai untuk variabel input secara manual. Untuk objek, daftar, dan tabel data kustom, dialog memungkinkan Anda mengisi nilai menggunakan editor visual atau JSON.

Membuat variabel output

Untuk membuat variabel output:

1. Pilih tombol plus (+) di panel variabel lalu Output.

   

2. Saat dialog Variabel output baru muncul, isi bidang berikut:

   • Nama variabel: Nama variabel dalam alur desktop.
   • Jenis data: Jenis variabel: teks, angka, boolean, objek kustom, daftar atau datatable.
   • Nama eksternal: Nama eksternal adalah nama yang muncul di desainer alur cloud.
   • Deskripsi: Deskripsi variabel yang muncul di desainer alur cloud atau desktop saat memanggil alur.
   • Tandai sebagai sensitif: Menentukan apakah akan menandai variabel sebagai sensitif atau tidak. Anda dapat menemukan informasi mengenai variabel sensitif dalam variabel sensitif.

   Catatan

   Bidang Nama variabel, tipe data, dan Nama eksternal diperlukan untuk membuat variabel output.

   Penting

   Jika Anda memilih nama variabel aliran yang ada untuk variabel output baru, Power Automate Anda akan diminta untuk mengonfirmasi penggabungan kedua variabel. Penggabungan yang tidak disengaja dapat memengaruhi fungsionalitas alur Anda dan menyebabkan kesalahan. Selain itu, Anda tidak dapat menggunakan nama variabel input atau output yang ada.

   

Mengelola variabel input dan output

Semua variabel input dan output yang dibuat tersedia di bagian panel variabel yang sesuai.

Anda dapat menggunakan panel ini untuk mengganti nama, memperbarui, menghapus, menemukan penggunaan, menyematkan dan memfilter setiap variabel input / output. Pemfilteran memungkinkan Anda memilih apakah akan menerapkannya ke variabel yang disematkan atau tidak.

Untuk memperbarui variabel input/output:

1. Klik kanan pada namanya di panel variabel dan pilih Edit.

   Penting

   Jika Anda mencoba mengganti nama variabel input atau output menjadi nama variabel aliran yang ada, Power Automate Anda akan diminta untuk mengonfirmasi penggabungan kedua variabel. Penggabungan yang tidak disengaja dapat memengaruhi fungsionalitas alur Anda dan menyebabkan kesalahan. Selain itu, Anda tidak dapat menggunakan nama variabel input atau output yang ada.

   

2. Dalam dialog Edit variabel input/output, perbarui bidang yang diinginkan dan pilih Simpan untuk menerapkan perubahan.

   

Variabel sensitif

Penting

Alur yang dikembangkan di versi desktop yang Power Automate lebih lama (v.2.13 atau yang lebih lama) tetap tidak terpengaruh oleh fungsionalitas variabel sensitif selama Anda tidak mengeditnya. Jika Anda menjalankan alur desktop yang ada melalui konsol atau portal tanpa mengeditnya, mereka akan mempertahankan perilaku lama dan berfungsi seperti sebelumnya.

Untuk menerapkan fungsionalitas baru, edit dan simpan alur dengan Power Automate untuk desktop v.2.14 atau yang lebih baru. Power Automate akan mengonversi variabel input terenkripsi masa lalu dan variabel terenkripsi yang dihasilkan oleh Dapatkan kata sandi dari tindakan ke variabel teks yang CyberArk ditandai sebagai sensitif.

Beberapa skenario otomatisasi menangani informasi rahasia dan memerlukan penanganan khusus variabel yang menyimpan dan menggunakan data sensitif selama runtime. Alur desktop mendukung pembuatan variabel sensitif, yang nilainya disembunyikan selama penelusuran kesalahan di panel variabel desainer alur.

Selain itu, jika Anda telah masuk dengan akun premium organisasi, nilai variabel sensitif tidak disimpan dalam riwayat Jalankan di portal, saat alur desktop dijalankan melalui alur konsol atau cloud.

Setiap variabel dapat menjadi sensitif, terlepas dari jenisnya. Sensitivitas berlaku pada tingkat variabel, sehingga daftar, baris data, datatable, dan objek kustom, menjadi sensitif secara keseluruhan. Tidak ada cara untuk menandai item daftar, kolom datatable, atau properti variabel sebagai sensitif dalam variabel yang tidak sensitif.

Anda dapat menggunakan, memanipulasi, dan memproses variabel sensitif dalam setiap tindakan tanpa batasan apa pun, seperti setiap variabel lainnya. Selain itu, Anda dapat menggabungkannya dengan variabel lain dan menyertakannya dalam ekspresi. Dalam hal ini, log menangani seluruh ekspresi sebagai sensitif.

Desainer alur menangani Sensitivitas sebagai topeng yang dapat Anda atur dan nonaktifkan. Dengan demikian, Anda dapat membuka kedok variabel sensitif untuk melihat nilainya dan menutupinya lagi untuk menyembunyikan nilainya.

Penting

Variabel sensitif tidak dimaksudkan untuk memberikan perlindungan atas data hardcode. Anda tidak boleh melakukan hardcode data penting dalam teks biasa, seperti sandi dan PIN, dalam properti tindakan seperti variabel Setel, meskipun variabel tersebut ditandai sebagai sensitif. Log alur desktop akan dilindungi, tetapi nilai hardcoded terlihat di modal dan definisi alur di Microsoft Dataverse.

Untuk menemukan informasi selengkapnya mengenai input sensitif dalam alur cloud, lihat Mengelola input sensitif seperti kata sandi.

Catatan

• Nilai variabel sensitif terlihat saat Anda mengirimnya ke luar alur desktop atau ditampilkan melalui tindakan Tampilkan pesan .
• Sensitivitas tidak dapat diwariskan dalam variabel. Jika Anda menambahkan atau menetapkan variabel sensitif ke variabel lain, variabel yang dihasilkan tidak akan sensitif secara default.
• Menandai variabel sebagai sensitif menyembunyikan nilainya dari ringkasan tindakan Tetapkan variabel .
• Detail input tindakan Atur variabel tidak terlihat di log alur desktop saat variabel yang terkandung telah ditandai sebagai sensitif.
• Masking variabel sensitif selama debugging hanya memberikan bentuk perlindungan dasar kepada pengembang dari pihak ketiga yang melihat layar mereka.

Untuk menandai variabel sebagai sensitif, klik kanan di panel variabel dan pilih Tandai sebagai sensitif. Untuk menghentikan variabel menjadi sensitif, klik kanan padanya dan pilih Tandai sebagai tidak sensitif.

Terlepas dari menu konteks, Anda dapat menggunakan ikon khusus di sebelah setiap variabel untuk menandainya sebagai sensitif atau tidak sensitif.

Variabel input dan output sensitif

Saat membuat atau mengedit variabel input atau output, Anda dapat memilih Tandai sebagai sensitif di dialog masing-masing untuk membuatnya sensitif.

Nilai default variabel input terlihat dalam dialog membuat atau mengedit saat Sensitivitas diaktifkan. Nilai ini hanya ada untuk tujuan pengujian dan debugging, karena Anda harus menginisialisasi setiap input dalam produksi yang dijalankan melalui portal atau konsol. Nilai default tidak dilindungi dalam moda tindakan dan definisi alur di Dataverse.

Di sisi lain, nilai default tidak terlihat di panel variabel dan dialog input Aliran, yang muncul saat Anda menjalankan alur desktop dengan variabel input melalui konsol.

Ikon mata untuk mengungkapkan nilai tidak tersedia kecuali Anda menghapus nilai teks default dan memberikan yang baru. Nilai baru terlihat saat mengisi tipe data lain selain teks.

Variabel input opsional

Saat Anda membuat atau mengedit variabel input atau output, Anda dapat memilih Tandai sebagai opsional di dialog masing-masing untuk menjadikannya opsional.

Secara default, variabel input wajib yang berarti Anda harus menyediakan:

• Nilai default saat membuatnya sehingga dapat digunakan selama debugging (konsol dimulai) berjalan jika Anda tidak meneruskan nilai lain.
• Nilai dari masing-masing jenis untuk memastikan eksekusi yang tepat.

Jika variabel input ditandai sebagai opsional, kedua hal di atas dapat dihilangkan karena dapat menerima nilai Kosong .

Mengatur nilai default input opsional ke Kosong

Variabel teks

Untuk menetapkan nilai default variabel teks ke Kosong:

• Atur properti Tipe data ke Teks.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default kosong.

Input numerik kosong

Untuk menetapkan nilai default variabel numerik ke Kosong:

• Atur properti Tipe data ke Angka.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default kosong.

Input boolean kosong

Untuk menetapkan nilai default variabel boolean ke Kosong:

• Atur properti Tipe data ke Boolean.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default diatur ke Kosong <.>

Input objek kustom kosong

Untuk mengatur nilai default objek kustom ke Kosong:

• Atur properti Tipe data ke objek Kustom.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default diatur ke Kosong <.> Untuk mencapai ini, pilih Edit di sebelah properti dan di jendela Edit objek kustom, aktifkan kontrol editor JSON. Hapus semua konten, lalu pilih Simpan.

Input daftar kosong

Untuk mengatur nilai default daftar ke Kosong:

• Atur properti Tipe data ke Daftar.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default diatur ke Kosong <.> Untuk mencapai ini, pilih Edit di sebelah properti dan di jendela Edit daftar , aktifkan kontrol editor JSON. Hapus semua konten, lalu pilih Simpan.

Input tabel data kosong

Untuk mengatur nilai default tabel data ke Kosong:

• Atur properti Tipe data ke Datatable.
• Aktifkan kontrol Tandai sebagai opsional .
• Pastikan properti Nilai default diatur ke Kosong <.> Untuk mencapai ini, pilih Edit di sebelah properti dan di jendela Edit datatable , aktifkan kontrol editor JSON. Hapus semua konten, lalu pilih Simpan.

Mengedit variabel saat men-debug alur desktop

Di konsol desain, Power Automate desktop mendukung pengeditan jenis variabel umum saat menjalankan aliran di debugger. Saat ini, tipe data yang didukung meliputi, teks, numerik, datetime, dan nilai boolean.

Cara mengedit variabel saat menjalankan alur di debugger

Ada dua metode yang dapat Anda terapkan untuk mulai memodifikasi nilai variabel aliran secara manual di konsol desain.
Tempatkan breakpoint di beberapa titik sebelum Anda ingin mengubah nilai variabel aliran. Jalankan alur lalu tunggu hingga alur berhenti di titik henti sementara yang dipilih. Panel variabel aliran ada di sudut kanan bawah konsol – temukan nama variabel dalam daftar dan klik dua kali di sebelahnya untuk membuka penampil variabel.

Mengubah nilai numerik:

Buka variabel yang memerlukan pengeditan, letakkan kursor pada bidang input dan edit nilai numerik secara manual. Atau, ada tombol untuk menghitung naik, atau turun dari nilai saat ini di sisi kanan input dalam penampil variabel. Catatan, Anda tidak dapat mengubah nilai menjadi sesuatu selain numerik.

Mengubah nilai teks:

Buka variabel yang memerlukan pengeditan, letakkan kursor pada bidang input dan edit nilai teks secara manual. Ada kotak centang untuk membungkus teks di dalam bidang input, yang memudahkan Anda untuk melihat di editor. Variabel nilai teks menerima angka sebagai input, tetapi perlu diingat bahwa jika Anda mengubah nilai ini dan mencoba meneruskannya ke tindakan dengan parameter input yang hanya menerima nilai numerik, alur akan menimbulkan kesalahan pengecualian saat mencapai titik tersebut.

Mengubah nilai boolean:

Buka variabel yang memerlukan pengeditan, letakkan kursor di bidang input, lalu edit nilai boolean secara manual. Gunakan daftar turun bawah untuk memilih true atau false.

Mengubah nilai datetime:

Buka variabel yang memerlukan pengeditan, letakkan kursor pada bidang input dan edit nilai datetime secara manual. Ada pesan peringatan yang muncul di penampil variabel jika Anda memasukkan nilai yang tidak dapat diterima.

Masalah dan batasan umum

• Masalah: Alur yang dibuat atau diedit dengan Power Automate untuk desktop versi 2.14 atau lebih tinggi tidak kompatibel dengan versi desktop yang Power Automate lebih lama. Anda tidak dapat menggunakan versi for desktop yang Power Automate lebih lama untuk membuka atau menjalankan alur ini.

  Solusi: Tidak ada.