Bagikan melalui

Jenis data variabel

  • Artikel

Saat Anda membuat variabel dalam alur Anda, Power Automate mengonversinya ke jenis tertentu berdasarkan kontennya.

Beberapa tipe data ini banyak digunakan di seluruh aplikasi, seperti angka, sementara yang lain, seperti instance browser, memerlukan tindakan eksplisit atau kelompok tindakan.

Tipe data sederhana

Tipe data sederhana mewakili nilai tunggal, seperti teks dan angka. Anda bisa menggunakan tipe data ini secara independen atau menggunakannya untuk membuat struktur data yang lebih kompleks, seperti daftar dan datatable.

Nilai teks

Ini adalah segala jenis teks, dari alamat email hingga konten teks file .txt.

Properti tipe data teks

Untuk membuat variabel nilai Teks, gunakan tindakan Atur variabel dan isi parameter input dengan teks yang diinginkan tanpa notasi apa pun.

Cuplikan layar tindakan Tetapkan variabel yang membuat variabel nilai Teks.

Nilai numerik

Numerik adalah jenis yang diterapkan pada angka. Hanya tipe data ini yang dapat digunakan dalam operasi matematika.

Buat variabel nilai numerik, gunakan tindakan Atur variabel dan isi parameter input dengan angka tanpa notasi apa pun.

Kecuali untuk nilai numerik hardcoded, Anda dapat menggunakan ekspresi matematika dengan variabel dalam tanda persentase. Untuk informasi selengkapnya tentang ekspresi matematika, buka Menggunakan variabel dan notasi %.

Cuplikan layar tindakan Tetapkan variabel yang membuat variabel Nilai numerik.

Nilai Boolean

Nilainya bisa True atau False.

Buat variabel nilai Boolean, gunakan tindakan Atur variabel dan isi parameter input dengan ekspresi %True% atau %False%.

Selain itu, Anda dapat membuat ekspresi kompleks menggunakan operator logis, variabel, dan notasi persentase. Untuk informasi selengkapnya tentang ekspresi logika, buka Menggunakan variabel dan notasi %.

Cuplikan layar tindakan Tetapkan variabel yang membuat variabel nilai Boolean.

Tipe data tingkat lanjut

Tipe data lanjutan mewakili struktur data yang kompleks. Mereka berfungsi sebagai kumpulan tipe data lain yang dapat Anda akses sebagai satu entitas.

Daftar

Daftar adalah kumpulan item. Bergantung pada tipe item daftar individual, bisa ada daftar nilai teks, daftar nilai numerik, dan sebagainya. Tipe data daftar setara dengan array dimensi tunggal dalam istilah pemrograman.

Anda bisa membuat daftar melalui tindakan Buat daftar baru dan menambahkan item ke daftar tersebut melalui tindakan Tambahkan item ke daftar .

Cuplikan layar alur yang membuat daftar.

Anda juga dapat membuat daftar melalui tindakan yang menghasilkan daftar sebagai output. Misalnya, tindakan Baca teks dari file dapat mengembalikan daftar nilai teks dan tindakan Dapatkan file dalam folder mengembalikan daftar file.

Untuk mengambil item tertentu dalam daftar, gunakan notasi berikut: %VariableName[ItemNumber]%

Dalam contoh di bawah ini, alur menyimpan angka pertama dari daftar yang ditampilkan sebelumnya ke variabel baru. Perlu diingat bahwa indeks harus 0 untuk item pertama dari daftar.

Cuplikan layar ekspresi yang mengakses item pertama daftar.

Praktik umum adalah menggunakan Untuk setiap tindakan untuk mengulangi item daftar.

Jika Anda hanya perlu mengakses bagian tertentu dari daftar, gunakan %VariableName[StartIndex:StopIndex]% notation. Misalnya, ekspresi %List[2:4]% mengambil item ketiga dan keempat dari daftar. Item di posisi StopIndex adalah batas pemotongan dan tidak diambil.

Untuk mengiris daftar dari awal ke item tertentu, jangan tetapkan nilai StartIndex , misalnya, %List[:4]%. Untuk memotong daftar dari indeks tertentu sampai akhir, jangan tetapkan nilai StopIndex , misalnya, %List[2:]%.

Properti tipe data daftar

Tabel data

Datatables berisi data dalam bentuk tabel dan setara dengan array dua dimensi dalam istilah pemrograman.

Datatable berisi baris dan kolom yang menggambarkan posisi setiap item secara unik. Datatables dapat dianggap sebagai daftar yang berisi datarows sebagai item.

Cuplikan layar konten variabel datatable.

Power Automate menyediakan tindakan Buat tabel data baru untuk menghasilkan tabel data baru. Setelah menyebarkan tindakan, Anda dapat menggunakan penyusun visual untuk mengisi nilai dan mengganti nama header kolom.

Cuplikan layar penyusun visual tindakan Buat tabel data baru.

Terlepas dari tindakan Buat tabel data baru, tiga tindakan lagi menghasilkan tabel data untuk menyimpan data yang diekstraksi: lembar kerja Baca dari Excel, Jalankan pernyataan SQL, dan Ekstrak data dari tindakan halaman web.

Selain itu, Anda dapat membuat datatable menggunakan tindakan variabel Set dan notasi array pemrograman. Notasi ini terdiri dari beberapa array dimensi tunggal yang dipisahkan oleh koma dan diapit dalam tanda kurung kurawal. Ekspresi akhir harus memiliki bentuk berikut: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Cuplikan layar tindakan Tetapkan variabel yang membuat datatable.

Jika Anda ingin menambahkan header kolom saat membuat datatable baru menggunakan notasi array, gunakan ekspresi ^['ColumnName1', 'ColumnName2'] untuk baris pertama.

Cuplikan layar tindakan Atur variabel yang membuat tabel data baru dengan header kolom.

Untuk menambahkan baris baru ke tabel yang sudah ada, gunakan tindakan Sisipkan baris ke dalam tabel data. Atau, buat ekspresi yang berisi nama variabel datatable, karakter plus (+), dan nilai yang ingin Anda tambahkan dalam tanda kurung.

Cuplikan layar tindakan Tetapkan variabel yang menambahkan baris baru ke datatable.

Selain menyisipkan baris ke dalam datatable, alur desktop menawarkan berbagai tindakan yang memanipulasi datatable. Anda dapat menemukan daftar lengkap dengan tindakan ini dalam referensi tindakan variabel.

Untuk mengambil item tertentu dari datatable, gunakan notasi berikut: %VariableName[RowNumber][ColumnNumber]%. Perlu diingat bahwa RowNumber dan ColumnNumber harus 0 untuk item pertama (baris atau kolom).

Misalnya, aliran mengambil konten lembar kerja Excel dan menyimpannya dalam variabel ExcelData . Untuk mengakses sel pertama pada baris kedua tabel yang diambil, gunakan ekspresi yang ditampilkan di bawah ini.

Cuplikan layar ekspresi yang mengakses sel kedua baris pertama dari file Excel yang sudah dibaca.

Catatan

Variabel ExcelData berisi tabel nilai yang diekstrak dari lembar kerja Excel menggunakan tindakan Baca dari lembar kerja Excel. Ini berisi beberapa nilai lembar kerja tertentu dan bukan seluruh file Excel.

Jika Anda ingin mengakses kolom tertentu dalam tabel yang berisi header kolom, gunakan% ExcelData[rowNumber]['ColumnName']% notation.

Jika Anda mengulang tabel data dengan tindakan Untuk Setiap , variabel yang berisi data iterasi saat ini dianggap sebagai datarow.

Sama halnya dengan daftar, Anda menggunakan %VariableName[StartRow:StopRow]% notation untuk mengakses bagian tertentu dari datatable. Ekspresi hanya mengambil baris yang ditentukan oleh dua indeks, sedangkan posisi StopRow adalah batas pemotongan dan tidak diambil.

Untuk mengiris datatable dari baris pertama ke baris tertentu, jangan gunakan nilai StartRow , misalnya, %Datatable[:4]%. Demikian juga, untuk mengiris datatable dari baris tertentu ke akhir, jangan gunakan nilai StopRow , misalnya, %Datatable[2:]%.

Properti tipe data datatable

Baris data

Datarow berisi nilai satu baris datatable. Saat Anda mengulang datatable dengan tindakan Untuk Setiap , variabel yang berisi data iterasi saat ini adalah datarow.

Untuk mengambil item tertentu dari datarow, gunakan notasi berikut: %VariableName[ItemNumber]%

Atau, Anda dapat menggunakan %VariableName['ColumnName']% notation. Nama setiap kolom ditentukan oleh datatable tempat Anda mengambil datarow.

Properti tipe data datarow

Cuplikan layar konten variabel datarow.

Objek kustom

Berisi pasangan properti dan nilai, yang dapat dengan mudah dikonversi ke format JSON.

Untuk membuat objek Kustom kosongbaru, gunakan tindakan Setel variabel dan isi ekspresi berikut%{{ }}%. Untuk membuat objek Kustom baru dan menginisialisasinya dengan properti dan nilai, gunakan ekspresi struktur berikut: % 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2'{ %. }

Cuplikan layar tindakan Atur variabel yang membuat objek kustom baru.

Penting

Kata kunci yang dipesan tidak dapat digunakan sebagai properti objek kustom. Untuk daftar lengkap kata kunci yang dipesan, buka Kata kunci yang dipesan dalam alur desktop.

Untuk memperbarui nilai properti yang ada atau menambahkan properti baru, sebarkan tindakan Atur variabel , isi nama properti di bidang Setel , dan masukkan nilainya di bidang Kepada .

Cuplikan layar tindakan Tetapkan variabel yang menambahkan properti baru ke objek kustom.

Selain nilai literal, Anda dapat menggunakan variabel untuk mengatur properti dan nilai objek kustom secara dinamis. Misalnya, alur berikut menggunakan dua variabel untuk menambahkan properti baru ke objek kustom kosong baru.

Cuplikan layar alur yang menggunakan variabel untuk menambahkan properti baru ke objek kustom.

Objek konektor

Objek konektor menyimpan informasi dari konektor cloud dan berfungsi mirip dengan objek kustom. Properti mereka biasanya berisi daftar objek konektor lainnya. Mengakses nilai berfungsi seperti pada objek kustom, meskipun mengakses nilai bertumpuk mungkin memerlukan ekspresi yang lebih rumit.

Cuplikan layar variabel objek kustom di penampil variabel.

Daftar info tabel PDF

Variabel tipe data ini hanya dapat dihasilkan melalui tindakan Ekstrak tabel dari PDF .

Setiap item dalam daftar menjelaskan tabel yang diekstrak dan menyediakan semua informasi penting tentangnya. Untuk mengakses item info datatable tertentu, gunakan %VariableName[ItemNumber]% notation.

Cuplikan layar Daftar info tabel PDF.

Setiap item daftar menyediakan empat properti yang memungkinkan Anda mendapatkan detail tertentu secara independen. Properti yang tersedia adalah sebagai berikut:

  • DataTable – Mengembalikan tabel yang diekstrak.
  • TableStartingPage – Mengembalikan indeks halaman file yang berisi awal tabel.
  • TableEndingPage – Mengembalikan indeks halaman file yang berisi akhir tabel.
  • TableOrderInPage – Mengembalikan urutan tabel pada halaman.

Anda dapat menemukan informasi selengkapnya mengenai properti tipe data ini di properti tipe data Variabel.

Cuplikan layar properti daftar info tabel PDF.

Untuk mengakses nilai properti tertentu, gunakan %VariableName[ItemNumber]. PropertyName% notasi. Misalnya, ekspresi berikut mengembalikan nilai datatable dari item pertama variabel ExtractedPDFTables .

Cuplikan layar datatable yang terdapat dalam daftar variabel info tabel PDF.

Masalah dan batasan umum

  • Masalah: Saat sel datatable atau datarow berisi entri multibaris, penampil variabel hanya menampilkan baris pertama.
  • Solusi: Tidak ada.

Instans

Koneksi

Lainnya

Bagian ini menyajikan semua tipe data yang tersedia yang tidak termasuk dalam kategori sebelumnya.

Nilai umum

  • Nilai umum– Tipe data ini digunakan selama waktu desain ketika Power Automate tidak dapat menentukan tipe data variabel atau parameter input. Nilai umum dikonversi ke tipe data lain selama runtime berdasarkan datanya.

Active Directory

  • Entri Active Directory – Berisi koneksi ke server Active Directory yang dibuat melalui tindakan Connect to server .
  • Info grup– Berisi nama, nama tampilan, deskripsi, dan anggota grup Active Directory tertentu.
  • Anggota grup– Mewakili anggota grup Active Directory tertentu.
  • Info pengguna– Berisi informasi tentang pengguna Active Directory tertentu, seperti depan dan nama belakang, inisial dan nama khusus, detail pekerjaan (perusahaan, departemen, dan jabatan), informasi kontak (nomor telepon, ekstensi, dan email), dan lokasi (negara/wilayah, kota, negara bagian, alamat jalan, dan kode pos).

Properti tipe data Direktori Aktif

Layanan Web Amazon (AWS)

  • Klien EC2– Berisi sesi EC2 yang dibuat melalui tindakan Buat sesi EC2.
  • Instans EC2– Mewakili instans EC2 yang diambil.
  • Info instans EC2– Berisi informasi tentang instans EC2.
  • Perubahan status instans– Berisi informasi tentang instans EC2 yang dimulai atau dihentikan.
  • Snapshot EBS– Mewakili snapshot EBS.
  • Volume EBS– Mewakili volume EBS.

Properti tipe data AWS

Azure

  • Klien Azure– Berisi sesi Azure yang dibuat melalui tindakan Buat sesi .
  • Grup sumber daya Azure– Mewakili grup sumber daya Azure yang diambil.
  • Disk terkelola Azure– Mewakili disk Azure yang diambil.
  • Rekam jepret Azure– Mewakili rekam jepret Azure.
  • Komputer virtual Azure– Mewakili komputer virtual Azure yang diambil.
  • Info komputer virtual Azure– Berisi informasi tentang komputer virtual Azure.
  • Langganan Azure– Mewakili langganan Azure yang diambil.

Properti jenis data Azure

CMD

  • Sesi CMD– Berisi sesi CMD yang dibuat melalui tindakan sesi Open CMD.

Properti tipe data CMD

Tanggal dan waktu

  • Datetime – Berisi informasi tanggal dan waktu. Untuk membuat variabel datetime melalui tindakan Set Variable , isi parameter input dengan ekspresi %d "yyyy-MM-dd HH:mm:ss.ff+zzz"%, di mana:

    Notasi Description
    yyyy Tahun
    MM Bulan
    dd Hari
    HH Jam
    mm Menit
    ss Detik
    Ff Milidetik
    Zzz Offset UTC

    Misalnya, %d"2022-03-25"% menetapkan tanggal 25 Maret 2022 ke variabel target.

Properti tipe data tanggal dan waktu

email

  • Pesan email – Mewakili pesan email. Tindakan Ambil email mengisi variabel-variabel ini.

Properti tipe data email

Exchange

  • Pesan email Exchange– Mewakili pesan email yang diambil dari server Exchange. Tindakan Ambil pesan email Exchange mengisi variabel-variabel ini.

Properti tipe data Exchange

File dan folder

  • File – Mewakili file.
  • Folder – Mewakili folder.
  • FileSystemObject – Mewakili folder atau file. Tipe data ini digunakan dalam parameter input yang menerima folder dan file.

Properti tipe data file dan folder

FTP

  • File FTP – Mewakili file FTP.
  • Direktori FTP – Mewakili direktori FTP

Properti tipe data FTP

OCR

  • Mesin OCR– Berisi mesin OCR yang dibuat melalui tindakan Buat mesin OCR.

Outlook

  • Pesan email Outlook– Mewakili pesan Outlook email. Tindakan Ambil pesan email dari Outlook mengisi variabel-variabel ini.

Properti tipe data Outlook

Terminal

  • Sesi terminal– Berisi sesi terminal yang dibuat melalui tindakan sesi terminal Terbuka.

Properti tipe data terminal

XML

  • XML node – Berisi konten dokumen XML. Tindakan Baca XML dari file mengisi variabel-variabel ini.

Properti tipe data XML

Kesalahan

  • Kesalahan – Berisi informasi tentang kesalahan yang terakhir terjadi dalam alur desktop. Tindakan Dapatkan kesalahan terakhir membuat jenis variabel ini.

Properti kesalahan