Kongsi melalui

Jenis data pemboleh ubah

  • Artikel

Apabila anda membuat pemboleh ubah dalam aliran anda, Power Automate menukarkannya kepada jenis tertentu berdasarkan kandungannya.

Sesetengah jenis data ini digunakan secara meluas di seluruh aplikasi, seperti nombor, manakala yang lain, seperti contoh penyemak imbas, memerlukan tindakan atau kumpulan tindakan yang jelas.

Jenis data mudah

Jenis data mudah mewakili nilai tunggal, seperti teks dan nombor. Anda boleh menggunakan jenis data ini secara bebas atau menggunakannya untuk mencipta struktur data yang lebih kompleks, seperti senarai dan jadual data.

Nilai teks

Ini ialah apa-apa jenis teks, daripada alamat e-mel kepada kandungan teks fail .txt.

Sifat jenis data teks

Untuk mencipta pemboleh ubah nilai Teks , gunakan tindakan Tetapkan pemboleh ubah dan isi parameter input dengan teks yang dikehendaki tanpa sebarang notasi.

Tangkapan skrin tindakan Tetapkan pemboleh ubah yang mencipta pemboleh ubah nilai Teks.

Nilai angka

Angka ialah jenis yang digunakan untuk nombor. Hanya jenis data ini boleh digunakan dalam operasi matematik.

Untuk mencipta pemboleh ubah nilai angka, gunakan tindakan Tetapkan pembolehubah dan isi parameter input dengan nombor tanpa sebarang notasi.

Kecuali untuk nilai angka berkod keras, anda boleh menggunakan ungkapan matematik dengan pembolehubah dalam tanda peratusan. Untuk mendapatkan maklumat lanjut tentang ungkapan matematik, pergi ke Gunakan pembolehubah dan notasi %.

Tangkapan skrin tindakan Tetapkan pemboleh ubah yang mencipta pemboleh ubah Nilai angka.

Nilai Boolean

Nilainya boleh sama ada Benar atau Salah.

Untuk mencipta pembolehubah nilai Boolean, gunakan tindakan Tetapkan pembolehubah dan isi parameter input dengan ungkapan %True% atau %False%.

Selain itu, anda boleh membuat ungkapan kompleks menggunakan pengendali logik, pembolehubah dan notasi peratusan. Untuk mendapatkan maklumat lanjut tentang ungkapan logik, pergi ke Gunakan pembolehubah dan notasi %.

Tangkapan skrin tindakan Tetapkan pemboleh ubah yang mencipta pemboleh ubah nilai Boolean.

Jenis data lanjutan

Jenis data lanjutan mewakili struktur data yang kompleks. Ia berfungsi sebagai koleksi jenis data lain yang boleh anda akses sebagai satu entiti.

Senarai

Senarai ialah koleksi item. Bergantung pada jenis item senarai individu, mungkin terdapat senarai nilai teks, senarai nilai berangka dan sebagainya. Jenis data senarai adalah bersamaan dengan tatasusunan dimensi tunggal dalam istilah pengaturcaraan.

Anda boleh mencipta senarai melalui tindakan Cipta senarai baharu dan menambah item pada senarai tersebut melalui tindakan Tambah item pada senarai .

Tangkapan skrin aliran yang mencipta senarai.

Anda juga boleh mencipta senarai melalui tindakan yang menjana senarai sebagai output. Contohnya, tindakan Baca teks daripada fail boleh mengembalikan senarai nilai teks dan tindakan Dapatkan fail dalam folder mengembalikan senarai fail.

Untuk mendapatkan semula item tertentu dalam senarai, gunakan notasi berikut: %VariableName[ItemNumber]%

Dalam contoh di bawah, aliran menyimpan nombor pertama senarai yang dipaparkan sebelum ini kepada pemboleh ubah baharu. Perlu diingat bahawa indeks hendaklah 0 untuk item pertama senarai.

Tangkapan skrin ungkapan yang mengakses item pertama senarai.

Amalan biasa ialah menggunakan Tindakan Untuk setiap untuk mengulangi item senarai.

Jika anda perlu mengakses hanya bahagian tertentu senarai, gunakan notasi%VariableName[StartIndex:StopIndex]%. Contohnya, ungkapan% List[2:4]% mendapatkan semula item ketiga dan keempat senarai. Item dalam kedudukan StopIndex ialah sempadan penghirisan dan tidak diambil.

Untuk menghiris senarai dari permulaan kepada item tertentu, jangan tetapkan nilai StartIndex , contohnya, %List[:4]%. Untuk menghiris senarai daripada indeks tertentu hingga akhir, jangan tetapkan nilai StopIndex , contohnya, %List[2:]%.

Senaraikan sifat jenis data

Jadual data

Jadual data mengandungi data dalam bentuk jadual dan bersamaan dengan tatasusunan dua dimensi dalam istilah pengaturcaraan.

Jadual data mengandungi baris dan lajur yang menerangkan kedudukan setiap item secara unik. Jadual data boleh dianggap sebagai senarai yang mengandungi baris data sebagai item.

Tangkapan skrin kandungan pembolehubah jadual data.

Power Automate menyediakan tindakan Cipta jadual data baharu untuk menjana jadual data baharu. Selepas menggunakan tindakan, anda boleh menggunakan pembina visual untuk mengisi nilai dan menamakan semula pengepala lajur.

Tangkapan skrin pembina visual tindakan Cipta jadual data baharu.

Selain daripada tindakan Cipta jadual data baharu, tiga lagi tindakan menghasilkan jadual data untuk menyimpan data yang diekstrak: baca daripada lembaran kerja Excel, Laksanakan pernyataan SQL dan Ekstrak data daripada tindakan halaman web.

Selain itu, anda boleh membuat jadual data menggunakan tindakan Tetapkan pembolehubah dan notasi tatasusunan pengaturcaraan. Notasi ini terdiri daripada berbilang tatasusunan dimensi tunggal yang dipisahkan oleh koma dan disertakan dalam kurungan kerinting. Ungkapan akhir mesti mempunyai bentuk berikut: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Tangkapan skrin tindakan Tetapkan pembolehubah yang mencipta jadual data.

Jika anda ingin menambah pengepala lajur semasa mencipta jadual data baharu menggunakan notasi tatasusunan, gunakan ungkapan ^['ColumnName1', 'ColumnName2'] untuk baris pertama.

Tangkapan skrin tindakan Tetapkan pemboleh ubah yang mencipta jadual data baharu dengan pengepala lajur.

Untuk menambah baris baharu pada jadual sedia ada, gunakan tindakan Masukkan baris ke dalam jadual data. Sebagai alternatif, cipta ungkapan yang mengandungi nama pembolehubah jadual data, aksara tambah (+) dan nilai yang anda mahu tambah dalam kurungan.

Tangkapan skrin tindakan Tetapkan pemboleh ubah yang menambah baris baharu pada jadual data.

Selain memasukkan baris ke dalam jadual data, aliran desktop menawarkan pelbagai tindakan yang memanipulasi jadual data. Anda boleh mendapatkan senarai penuh dengan tindakan ini dalam rujukan tindakan pembolehubah.

Untuk mendapatkan item tertentu jadual data, gunakan notasi berikut: %VariableName[RowNumber][ColumnNumber]%. Perlu diingat bahawa RowNumber dan ColumnNumber hendaklah 0 untuk item pertama (baris atau lajur).

Contohnya, katakan bahawa aliran mendapatkan semula kandungan lembaran kerja Excel dan menyimpannya dalam pemboleh ubah ExcelData . Untuk mengakses sel pertama pada baris kedua jadual yang diambil, gunakan ungkapan yang dipaparkan di bawah.

Tangkapan skrin ungkapan yang mengakses sel kedua baris pertama bagi fail Excel yang dibaca.

Nota

Pemboleh ubah ExcelData mengandungi jadual nilai yang diekstrak daripada lembaran kerja Excel menggunakan tindakan Baca daripada lembaran kerja Excel. Ia mengandungi beberapa nilai lembaran kerja tertentu dan bukan keseluruhan fail Excel.

Jika anda ingin mengakses lajur tertentu dalam datable yang mengandungi pengepala lajur, gunakan %ExcelData[rowNumber]['ColumnName']%notasi .

Jika anda menggelung jadual data dengan tindakan Untuk Setiap , pemboleh ubah yang mengandungi data lelaran semasa dianggap sebagai baris data.

Begitu juga dengan senarai, anda menggunakan notasi %VariableName[StartRow:StopRow]% untuk mengakses bahagian tertentu jadual data. Ungkapan ini hanya mengambil baris yang ditakrifkan oleh dua indeks, manakala kedudukan StopRow ialah sempadan penghirisan dan tidak diambil.

Untuk menghiris jadual data daripada baris pertama kepada baris tertentu, jangan gunakan nilai StartRow , contohnya, %Datatable[:4]%. Begitu juga, untuk menghiris jadual data daripada baris tertentu hingga akhir, jangan gunakan nilai StopRow , contohnya, %Datatable[2:]%.

Sifat jenis data berjadual data

Baris data

Baris data mengandungi nilai baris tunggal jadual data. Apabila anda menggelung jadual data dengan tindakan Untuk Setiap , pemboleh ubah yang mengandungi data lelaran semasa ialah baris data.

Untuk mendapatkan semula item tertentu baris data, gunakan notasi berikut: %VariableName[ItemNumber]%

Sebagai alternatif, anda boleh menggunakan notasi%VariableName['ColumnName']%. Nama setiap lajur ditakrifkan oleh jadual data dari mana anda mendapatkan baris data.

Sifat jenis data datarow

Tangkapan skrin kandungan pembolehubah datarow.

Objek tersuai

Mengandungi pasangan sifat dan nilai, yang boleh ditukar dengan mudah kepada format JSON.

Untuk mencipta objek Tersuai kosong baharu, gunakan tindakan Tetapkanpemboleh ubah dan isi ungkapan berikut% %.{{ }} Untuk mencipta objek Tersuai baharu dan memulakannya dengan sifat dan nilai, gunakan ungkapan struktur berikut: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2'%. }

Tangkapan skrin tindakan Tetapkan pembolehubah yang mencipta objek tersuai baharu.

Penting

Kata kunci terpelihara tidak boleh digunakan sebagai sifat objek tersuai. Untuk senarai penuh kata kunci terpelihara, pergi ke Kata kunci terpelihara dalam aliran desktop.

Untuk mengemas kini nilai sifat sedia ada atau menambah yang baharu, gunakan tindakan Tetapkan pemboleh ubah, isi nama sifat dalam medan Set dan masukkan nilainya dalam medan Kepada .

Tangkapan skrin tindakan Tetapkan pembolehubah yang menambah sifat baharu pada objek tersuai.

Selain daripada nilai literal, anda boleh menggunakan pembolehubah untuk menetapkan sifat dan nilai objek tersuai secara dinamik. Sebagai contoh, aliran berikut menggunakan dua pemboleh ubah untuk menambah sifat baharu pada objek tersuai kosong baharu.

Tangkapan skrin aliran yang menggunakan pemboleh ubah untuk menambah sifat baharu pada objek tersuai.

Objek penyambung

Objek penyambung menyimpan maklumat daripada penyambung awan dan berfungsi sama seperti objek tersuai. Sifat mereka biasanya mengandungi senarai objek penyambung lain. Mengakses nilai berfungsi seperti dalam objek tersuai, walaupun mengakses nilai bersarang mungkin memerlukan ungkapan yang lebih rumit.

Tangkapan skrin pemboleh ubah objek tersuai dalam pemapar pemboleh ubah.

Senarai maklumat jadual PDF

Pemboleh ubah jenis data ini boleh dihasilkan hanya melalui tindakan Ekstrak jadual daripada PDF .

Setiap item dalam senarai menerangkan jadual yang diekstrak dan menyediakan semua maklumat penting mengenainya. Untuk mengakses item maklumat jadual data tertentu, gunakan notasi%VariableName[ItemNumber]% .

Tangkapan skrin Senarai maklumat jadual PDF.

Setiap item senarai menyediakan empat sifat yang membolehkan anda mendapatkan butiran tertentu secara bebas. Sifat yang tersedia adalah seperti berikut:

  • DataTable – Mengembalikan jadual yang diekstrak.
  • TableStartingPage – Mengembalikan indeks halaman fail yang mengandungi permulaan jadual.
  • TableEndingPage – Mengembalikan indeks halaman fail yang mengandungi penghujung jadual.
  • TableOrderInPage – Mengembalikan tertib jadual pada halaman.

Anda boleh mendapatkan maklumat lanjut mengenai sifat jenis data ini dalam sifat jenis data Pembolehubah.

Tangkapan skrin sifat senarai maklumat jadual PDF.

Untuk mengakses nilai sifat tertentu, gunakan %VariableName[ItemNumber]. PropertyName%notasi . Contohnya, ungkapan berikut mengembalikan nilai jadual data item pertama pemboleh ubah ExtractedPDFTables .

Tangkapan skrin jadual data yang terkandung dalam senarai pembolehubah maklumat jadual PDF.

Isu dan had yang diketahui

  • Isu: Apabila sel jadual data atau baris data mengandungi entri berbilang baris, pemapar pemboleh ubah hanya memaparkan baris pertamanya.
  • Penyelesaian: Tiada.

Tika

  • Contoh pelayar web– Mengandungi contoh pelayar yang dibuat melalui tindakan pelancaran pelayar baharu Internet Explorer atau pelayar lain.

    Sifat jenis data contoh pelayar web

  • Contoh tetingkap– Mengandungi contoh tetingkap yang dibuat melalui tindakan Dapatkan tetingkap .

    Sifat jenis data tika tetingkap

  • Contoh Excel– Mengandungi contoh Excel yang dibuat melalui tindakan Lancarkan Excel .

    Sifat jenis data tika Excel

  • Contoh Outlook– Mengandungi contoh Outlook yang dibuat melalui tindakan Lancarkan Outlook .

Sambungan

Lain-lain

Bahagian ini membentangkan semua jenis data yang tersedia yang tidak tergolong dalam mana-mana kategori sebelumnya.

Nilai umum

  • Nilai umum– Jenis data ini digunakan semasa masa reka bentuk apabila Power Automate tidak dapat mentakrifkan jenis data pembolehubah atau parameter input. Nilai umum ditukar kepada jenis data lain semasa masa jalan berdasarkan data mereka.

Active Directory

  • Entri Direktori Aktif– Mengandungi sambungan ke pelayan Direktori Aktif yang diwujudkan melalui tindakan Sambung ke pelayan .
  • Maklumat kumpulan– Mengandungi nama, nama paparan, perihalan dan ahli kumpulan Active Directory yang ditentukan.
  • Ahli kumpulan– Mewakili ahli kumpulan Direktori Aktif yang ditentukan.
  • Maklumat pengguna– Mengandungi maklumat tentang pengguna Direktori Aktif yang ditentukan, seperti nama pertama dan nama akhir, inisial dan nama yang dibezakan, butiran kerja (syarikat, jabatan dan tajuk), maklumat hubungan (nombor telefon, sambungan dan e-mel) dan lokasi (negara/wilayah, bandar, negeri, alamat jalan dan poskod).

Sifat jenis data Active Directory

Perkhidmatan Web Amazon (AWS)

  • Klien EC2– Mengandungi sesi EC2 yang dibuat melalui tindakan Buat sesi EC2.
  • Contoh EC2– Mewakili contoh EC2 yang diambil.
  • Maklumat contoh EC2– Mengandungi maklumat tentang contoh EC2.
  • Perubahan keadaan contoh– Mengandungi maklumat tentang tika EC2 yang telah dimulakan atau dihentikan.
  • Petikan petikan EBS– Mewakili petikan EBS.
  • Jumlah EBS– Mewakili volum EBS.

Sifat jenis data AWS

Azure

  • Klien Azure– Mengandungi sesi Azure yang dicipta melalui tindakan Buat sesi .
  • Kumpulan sumber Azure– Mewakili kumpulan sumber Azure yang diambil.
  • Cakera terurus Azure– Mewakili cakera Azure yang diambil.
  • Petikan Azure – Mewakili petikan Azure.
  • Mesin maya Azure– Mewakili mesin maya Azure yang diambil.
  • Maklumat mesin maya Azure– Mengandungi maklumat tentang mesin maya Azure.
  • Langganan Azure– Mewakili langganan Azure yang diambil.

Sifat jenis data Azure

CMD

  • Sesi CMD– Mengandungi sesi CMD yang dibuat melalui tindakan sesi CMD Terbuka .

Sifat jenis data CMD

Kelayakan

  • Kelayakan – Mengandungi kelayakan yang diperoleh melalui tindakan Dapatkan kelayakan (pratonton).

Sifat jenis data kelayakan

Tarikh dan masa

  • Tarikh masa – Mengandungi maklumat tarikh dan masa. Untuk mencipta pemboleh ubah tarikh masa melalui tindakan Tetapkan Pemboleh Ubah, isi parameter input dengan ungkapan" %dyyyy-MM-dd HH:mm:ss.ff+zzz"%, di mana:

    Notasi Description
    yyyy Tahun
    MM Bulan
    Dd Hari
    HH Jam
    Mm Minit
    Ss Saat
    ff milisaat
    zzz Ofset UTC

    Sebagai contoh, %d"2022-03-25"%memperuntukkan tarikh 25 Mac 2022 kepada pemboleh ubah sasaran.

Sifat jenis data tarikh dan masa

E-mel

  • Mesej mel– Mewakili mesej e-mel. Tindakan Dapatkan e-mel mengisi pemboleh ubah ini.

Sifat jenis data e-mel

Exchange

  • Mesej mel Exchange– Mewakili mesej e-mel yang diperoleh daripada pelayan Exchange. Tindakan Dapatkan semula mesej e-mel Exchange mengisi pemboleh ubah ini.

Sifat jenis data Exchange

Fail dan folder

  • Fail – Mewakili fail.
  • Folder – Mewakili folder.
  • FileSystemObject – Mewakili sama ada folder atau fail. Jenis data ini digunakan dalam parameter input yang menerima folder dan fail.

Sifat jenis data fail dan folder

FTP

  • Fail FTP– Mewakili fail FTP.
  • Direktori FTP– Mewakili direktori FTP

Sifat jenis data FTP

OCR

  • Enjin OCR– Mengandungi enjin OCR yang dibuat melalui tindakan Buat enjin OCR.

Outlook

  • Mesej mel Outlook– Mewakili mesej Outlook e-mel. Tindakan Dapatkan mesej e-mel daripada Outlook mengisi pemboleh ubah ini.

Sifat jenis data Outlook

Terminal

  • Sesi terminal– Mengandungi sesi terminal yang dicipta melalui tindakan Buka sesi terminal.

Sifat jenis data terminal

XML

  • Nod XML– Mengandungi kandungan dokumen XML. Tindakan Baca XML daripada fail mengisi pemboleh ubah ini.

Sifat jenis data XML

Ralat

  • Ralat – Mengandungi maklumat tentang ralat yang terakhir berlaku dalam aliran desktop. Tindakan Dapatkan ralat terakhir mencipta jenis pemboleh ubah ini.

Sifat ralat