Bagikan melalui

Jenis data variabel

  • Artikel

Saat Anda membuat variabel dalam alur Anda, mengubahnya Power Automate menjadi 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 dapat menggunakan tipe data ini secara independen atau menggunakannya untuk membuat struktur data yang lebih kompleks, seperti daftar dan tabel data.

Nilai teks

Ini adalah semua jenis teks, mulai 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 Atur 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.

Untuk membuat variabel Nilai Numerik , gunakan tindakan Set variable dan isi parameter input dengan angka tanpa notasi apa pun.

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

Cuplikan layar tindakan Set variable yang membuat variabel Nilai Numererik.

Nilai Boolean

Nilainya bisa True atau False.

Untuk membuat variabel nilai Boolean, gunakan tindakan Set variable 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 logis, buka Menggunakan variabel dan notasi %.

Cuplikan layar tindakan Set variable yang membuat variabel nilai Boolean.

Jenis data lanjutan

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

Daftar

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

Anda dapat 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 nomor pertama dari daftar yang ditampilkan sebelumnya ke variabel baru. Perlu diingat bahwa indeks harus 0 untuk item pertama daftar.

Cuplikan layar ekspresi yang mengakses item pertama daftar.

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

Jika Anda hanya perlu mengakses bagian tertentu dari daftar, gunakan notasi%VariableName[StartIndex:StopIndex]%. 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 mengiris daftar dari indeks tertentu hingga akhir, jangan atur nilai StopIndex , misalnya, %List[2:]%.

Daftar properti jenis data

Tabel data

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

Tabel data berisi baris dan kolom yang menjelaskan posisi setiap item secara unik. Tabel data dapat dianggap sebagai daftar yang berisi baris data sebagai item.

Cuplikan layar konten variabel tabel data.

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

Cuplikan layar pembuat visual tindakan Buat tabel data baru.

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

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

Cuplikan layar tindakan Atur variabel yang membuat tabel data.

Jika Anda ingin menambahkan header kolom saat membuat tabel data 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 tabel data . Atau, buat ekspresi yang berisi nama variabel tabel data, karakter plus (+), dan nilai yang ingin Anda tambahkan dalam tanda kurung.

Cuplikan layar tindakan Atur variabel yang menambahkan baris baru ke tabel data.

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

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

Misalnya, alur 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 dibaca.

Catatan

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

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

Jika Anda mengulangi tabel data dengan tindakan Untuk Masing-masing , variabel yang berisi data iterasi saat ini dianggap sebagai baris data.

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

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

Properti tipe data tabel data

Baris data

Datarow berisi nilai satu baris tabel data. Saat Anda mengulang tabel data dengan tindakan Untuk Masing-masing , variabel yang berisi data iterasi saat ini adalah baris data.

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

Atau, Anda dapat menggunakan notasi%VariableName['ColumnName']%. Nama setiap kolom ditentukan oleh tabel data 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 kosong baru, gunakan tindakan Aturvariabel 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'{ %. }

Screenshot tindakan Set variable yang membuat objek kustom baru.

Penting

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

Untuk memperbarui nilai properti yang ada atau menambahkan yang baru, sebarkan tindakan Tetapkan variabel, isi nama properti di kolom Set , dan masukkan nilainya di kolom Kepada .

Cuplikan layar tindakan Set 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 bekerja mirip dengan objek kustom. Properti mereka biasanya berisi daftar objek konektor lainnya. Mengakses nilai berfungsi seperti pada objek kustom, meskipun mengakses nilai berlapis mungkin memerlukan ekspresi yang lebih rumit.

Cuplikan layar variabel objek kustom di penampil variabel.

Daftar info tabel PDF

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

Setiap item dalam daftar menjelaskan tabel yang diekstraksi dan memberikan semua informasi penting tentangnya. Untuk mengakses item info tabel data tertentu, gunakan notasi%VariableName[ItemNumber]% .

Tangkapan layar Daftar info tabel PDF.

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

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

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

Tangkapan layar properti daftar info tabel PDF.

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

Tangkapan layar tabel data yang terdapat dalam daftar variabel info tabel PDF.

Masalah dan batasan umum

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

Instans

Koneksi

Lainnya

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

Nilai umum

  • Nilai umum– Jenis 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 Direktori Aktif– Berisi koneksi ke server Direktori Aktif yang dibuat melalui tindakan Sambungkan ke server .
  • Info grup– Berisi nama, nama tampilan, deskripsi, dan anggota grup Direktori Aktif tertentu.
  • Anggota grup– Mewakili anggota grup Direktori Aktif tertentu.
  • Info pengguna– Berisi informasi tentang pengguna Direktori Aktif tertentu, seperti nama belakang dan depan, inisial dan nama yang dibedakan, 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.
  • EBS snapshot – 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.
  • Azure snapshot – Mewakili snapshot 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 tipe data Azure

CMD

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

Properti tipe data CMD

Kredensial

  • Kredensial– Berisi kredensial yang diambil melalui tindakan Dapatkan kredensial (pratinjau).

Properti jenis data kredensial

Tanggal dan waktu

  • Tanggalwaktu – Berisi informasi tanggal dan waktu. Untuk membuat variabel datetime melalui tindakan Set Variabel , isi parameter input dengan ekspresi" %dyyyy-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 ini.

Properti jenis data email

Exchange

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

Properti tipe data Exchange

File dan folder

  • File – Mewakili file.
  • Folder – Mewakili folder.
  • FileSystemObject – Mewakili folder atau file. Jenis 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 ini.

Properti tipe data Outlook

Terminal

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

Properti tipe data terminal

XML

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

Properti tipe data XML

Kesalahan

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

Properti kesalahan