Mengelola variabel dan panel variabel

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

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

Penampil nilai variabel

Saat alur 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 variabel yang dipilih dan memperluas baris data atau tabel data untuk menampilkan kontennya.

Jenis data tertentu mungkin berisi elemen berlapis. Misalnya, objek kustom mungkin berisi objek kustom lain dalam propertinya. Untuk melihat properti elemen berlapis, 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 di semua kemunculannya.

Penting

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

Variabel input dan output

Power Automate memungkinkan Anda bertukar data antara alur cloud dan desktop menggunakan variabel input dan output, memperluas kemampuan otomatisasi. Variabel input dan output juga memungkinkan Anda meneruskan informasi antar alur desktop melalui tindakan 'Jalankan alur desktop'.

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

Untuk menemukan informasi selengkapnya tentang 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, tabel data, instans, atau sesi.
   • Nilai default: Nilai default saat alur berjalan melalui perancang alur atau konsol. Saat Anda membuat variabel input objek, daftar, atau tabel data kustom, Power Automate memungkinkan Anda membuat nilai default melalui editor visual atau JSON.
   • Subtipe data: Jenis instans yang tepat (hanya tersedia jika Instans atau Sesi sebelumnya dipilih sebagai tipe data): Browser, Excel, Word, Outlook, Access, atau Terminal masing-masing.
   • Nama eksternal: Nama eksternal adalah nama yang muncul di perancang alur cloud dan dialog input alur saat memanggil alur dari konsol.
   • Deskripsi: Deskripsi variabel yang muncul di perancang 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 di 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, Jenis data, danNama eksternal diperlukan untuk membuat variabel input.
   • Variabel input dari jenis instans atau sesi (Browser, Excel, Word, Outlook, Access, atau Terminal) tidak mendukung nilai default. Alur dengan input ini dapat berjalan melalui tindakan 'Jalankan alur desktop' dari alur desktop lain atau melalui perancang untuk pengujian atau penelusuran kesalahan. Dalam eksekusi perancang, variabel input instans dan sesi dapat diinisialisasi sementara dengan menggunakannya sebagai variabel yang dihasilkan dari masing-masing tindakan Peluncuran, Buka, atau Lampirkan.
   • Edge, Chrome, dan Firefox didukung sebagai instance browser untuk variabel input.

   Penting

   Jika Anda memilih nama variabel alur yang ada untuk variabel input baru, Power Automate akan meminta Anda 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 alur meminta Anda untuk mengatur nilai untuk variabel input secara manual. Untuk objek kustom, daftar, dan tabel data, 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 keluaran baru muncul, isi bidang berikut:

   • Nama variabel: Nama variabel dalam alur desktop.
   • Jenis data: Jenis variabel: teks, angka, boolean, objek kustom, daftar, tabel data, instans, atau sesi.
   • Subtipe data: Jenis instans yang tepat (hanya tersedia jika Instans atau Sesi sebelumnya dipilih sebagai tipe data): Browser, Excel, Word, Outlook, Access, atau Terminal masing-masing.
   • Nama eksternal: Nama eksternal adalah nama yang muncul di perancang alur cloud.
   • Deskripsi: Deskripsi variabel yang muncul di perancang 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 di Variabel sensitif.

   Catatan

   • Bidang Nama variabel, Jenis data, danNama eksternal diperlukan untuk membuat variabel output.
   • Edge, Chrome, dan Firefox didukung sebagai instance browser untuk variabel output.

   Penting

   Jika Anda memilih nama variabel alur yang ada untuk variabel output baru, Power Automate akan meminta Anda 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 alur yang ada, Power Automate akan meminta Anda 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 Power Automate lama untuk desktop (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 lebih tinggi. Power Automate akan mengonversi variabel input terenkripsi sebelumnya dan variabel terenkripsi yang dihasilkan oleh tindakan Dapatkan kata sandi dari CyberArk menjadi variabel teks yang 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 ditutupi selama penelusuran kesalahan di panel variabel perancang alur.

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

Variabel apa pun bisa menjadi sensitif, terlepas dari jenisnya. Sensitivitas berlaku di tingkat variabel, sehingga daftar, baris data, tabel data, dan objek kustom, menjadi sensitif secara keseluruhan. Tidak ada cara untuk menandai item daftar, kolom tabel data, 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 memasukkannya ke dalam ekspresi. Dalam hal ini, log menangani seluruh ekspresi sebagai sensitif.

Desainer alur menangani sensitivitas sebagai masker yang dapat Anda aktifkan 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 yang dikodekan keras. Anda tidak boleh membuat hardcode data penting dalam teks biasa, seperti kata sandi dan PIN, dalam properti tindakan seperti Atur variabel, meskipun variabel tersebut ditandai sebagai sensitif. Log alur desktop akan dilindungi, tetapi nilai hardcode terlihat dalam 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 mengirimkannya di 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. Pengecualian untuk aturan ini hanya berlaku untuk jenis variabel kredensial. Variabel kredensial, yang dihasilkan baik oleh tindakan masing-masing atau dengan penugasan ulang dari variabel lain, selalu sensitif, dan sensitivitasnya diterapkan. Pengecualian yang sama juga berlaku untuk properti "Kata Sandi" dari jenis variabel kredensial.
• Menandai variabel sebagai sensitif menyembunyikan nilainya dari ringkasan tindakan Atur variabel .
• Detail input tindakan Atur variabel tidak terlihat di log alur desktop ketika variabel yang terkandung telah ditandai sebagai sensitif.
• Menutupi 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 agar tidak sensitif, klik kanan padanya dan pilih Tandai sebagai tidak sensitif.

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

Variabel input dan output sensitif

Saat Anda membuat atau mengedit variabel input atau output, Anda dapat memilih Tandai sebagai sensitif dalam 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 penelusuran kesalahan, karena Anda harus menginisialisasi setiap input dalam eksekusi produksi melalui portal atau konsol. Nilai default tidak dilindungi dalam modal tindakan dan definisi alur di. Dataverse

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

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

Variabel input opsional

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

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

• Nilai default saat membuatnya sehingga dapat digunakan selama penelusuran kesalahan (dimulai dengan konsol) berjalan jika Anda tidak meneruskan nilai lain.
• Nilai dari jenis masing-masing 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 mengatur 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 mengatur nilai default variabel numerik ke Kosong:

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

Masukan boolean kosong

Untuk mengatur 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 samping properti dan di jendela Edit objek kustom, aktifkan kontrol editor JSON. Hapus semua konten, lalu pilih Simpan.

Masukan daftar kosong

Untuk menyetel 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 samping 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 samping properti dan di jendela Edit tabel data, 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 alur di debugger. Saat ini, jenis data yang didukung meliputi, teks, numerik, tanggalwaktu, dan nilai boolean.

Cara mengedit variabel saat menjalankan alur di debugger

Ada dua metode yang dapat Anda gunakan untuk mulai memodifikasi nilai variabel alur secara manual di konsol desain.
Tempatkan titik henti di beberapa titik sebelum Anda ingin mengubah nilai variabel aliran. Jalankan alur lalu tunggu hingga alur berhenti pada titik henti yang dipilih. Panel variabel alur berada 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, tempatkan kursor pada bidang input dan edit nilai numerik secara manual. Atau, ada tombol untuk menghitung ke atas, atau turun dari nilai saat ini di sisi kanan input di penampil variabel. Perhatikan, Anda tidak dapat mengubah nilai menjadi sesuatu selain numerik.

Mengubah nilai teks:

Buka variabel yang memerlukan pengeditan, tempatkan 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 memodifikasi nilai ini dan mencoba meneruskannya ke tindakan dengan parameter input yang hanya menerima nilai numerik, alur akan melemparkan kesalahan pengecualian ketika mencapai titik tersebut.

Mengubah nilai boolean:

Buka variabel yang memerlukan pengeditan, tempatkan kursor pada bidang input, lalu edit nilai boolean secara manual. Gunakan daftar drop-down untuk memilih benar atau salah.

Mengubah nilai tanggalwaktu:

Buka variabel yang memerlukan pengeditan, tempatkan kursor pada bidang input dan edit nilai tanggalwaktu 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 yang lebih tinggi tidak kompatibel dengan versi Power Automate desktop yang lebih lama. Anda tidak dapat menggunakan versi Power Automate desktop yang lebih lama untuk membuka atau menjalankan alur ini.

  Solusinya: Tidak ada.