Muuttujien tietotyypit

Kun luot työnkulkuihin muuttujia, Power Automate muuntaa ne tietyntyyppisiksi työnkulkujen sisällön perusteella.

Joitakin näistä tietotyypeistä käytetään yleisesti koko sovelluksessa. Tällaisia tietotyyppejä ovat esimerkiksi luvut, ja toiset taas, kuten selainesiintymät, edellyttävät eksplisiittisiä toimintoja tai ryhmä toimintoja.

Yksinkertaiset tietotyypit

  • Tekstiarvo ‑ Mikä tahansa teksti sähköpostiosoitteista .txt-tiedoston tekstisisältöön.

    Tekstin tietotyypin ominaisuudet

    Jos haluat luoda tekstiarvo-muuttujan, käytä Määritä muuttuja -toimintoa ja täytä syöteparametriin haluamasi teksti ilman notaatiota.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo tekstiarvomuuttujan.

  • Numeerinen arvo - Tämä on numeroihin käytetty tyyppi. Vain tätä tietotyyppiä voi käyttää matemaattisissa toiminnoissa.

    Jos haluat luoda lukuarvo-muuttujan, käytä Määritä muuttuja -toimintoa ja täytä syöteparametriin haluamasi numero ilman notaatiota.

    Numeerisia arvoja lukuun ottamatta voit käyttää sananvapauslausekkeita, joissa on muuttujia prosenttimerkkien sisällä. Lisätietoja sananvaltalausekkeista on Käytä muuttujia ja %-notaatiota -artikkelissa.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo lukuarvomuuttujan.

  • Totuusarvo - Arvo voi olla Tosi tai Epätosi.

    Jos haluat luoda totuusarvo-muuttujan, käytä Määritä muuttuja -toimintoa ja täytä syöteparametriin lausekkeet %True% tai %False%.

    Lisäksi voit luoda monitasoisia lausekkeita käyttämällä loogisia operaattoreita, muuttujia ja prosenttilukuja. Lisätietoja loogisista lausekkeista on Käytä muuttujia ja %-notaatiota -artikkelissa.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo totuusarvomuuttujan.

Lisätietotyypit

  • Luettelo - Luettelot ovat kohteiden kokoelmia. Yksittäisten luettelokohteen tyyppien mukaan voi olla luetteloita tekstiarvoista ja numeroarvojen luetteloista. Luettelon tietotyyppi vastaa yksidimensioista matriisityyppiä ohjelmoinnin osalta.

    Voit luoda luettelon Luo uusi luettelo -toiminimellä ja lisätä siihen kohteen Lisää kohde luetteloon -toiminnon avulla.

    Näyttökuva työnkulusta, joka luo luettelon.

    Voit myös luoda luettelon toimilla, jotka luovat luetteloita tulosteena. Esimerkiksi Lue teksti tiedostosta -toiminto voi palauttaa tekstiarvojen luettelon, ja Hae tiedostot kansioon -toiminto palauttaa tiedostoluettelon.

    Voit hakea tietyn luettelon kohteen käyttämällä seuraavaa notaatiota: %VariableName[ItemNumber]%

    Alla olevassa esimerkissä työnkulku tallentaa aiemmin näkyvän luettelon ensimmäisen numeron uuteen muuttujaan. Muista, että luettelon ensimmäisen kohteen indeksin on oltava 0.

    Näyttökuva lausekkeesta, joka käyttää luettelon ensimmäistä kohdetta.

    Yleinen käytäntö on käyttää kunkin toiminnon mukaan luettelon kohteiden läpi iteroinnissa.

    Luettelon tietotyypin ominaisuudet

  • Tietotaulukko - Tietotaulukko sisältää taulukkomuodossa tietoja. Tietotaulukko vastaa ohjelmoinnin kaksidimensioista matriisityyppiä.

    Tietotaulukko sisältää rivejä ja sarakkeita, jotka kuvaavat kunkin kohteen sijaintia yksilöllisesti. Tietotauluja voidaan pitää luetteloina, jotka sisältävät nimikkeinään tietorivejä.

    Näyttökuva tietotaulukkomuuttujan sisällöstä.

    Power Automate sisältää kolme toimintoa, joilla voi luoda tietotaulukoita: Lue Excel-laskentataulukosta -toiminto, Suorita SQL-lause -toiminto ja Tietojen purkaminen verkkosivulta -toiminto.

    Jos taas Power Automate ei tarjoa toimintoa omien tietotaulukkojen luomiseen, voit luoda tietotaulukkoa käyttämällä Määritä muuttuja -toimintoa ja ohjelmointitaulukon merkintää.

    Tämä notaatio koostuu useista yksidimensioisia matriiseista, jotka on erotettu pilkuilla ja jotka ovat aaltosulkeissa. Viimeisellä lausekkeella on oltava seuraava muoto: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo tietotaulun.

    Jos haluat lisätä sarakeotsikot uutta tietotaulua luotaessa, käytä ensimmäiselle riville lauseketta ^['ColumnName1', 'ColumnName2'].

    Näyttökuva aseta muuttuja -toiminnosta, joka luo uuden tietotaulukon, jossa on sarakeotsikot.

    Jos haluat lisätä uuden rivin aiemmin luotuun taulukkoon, luo lauseke, joka sisältää tietotaulun muuttujan nimen, plusmerkin (+) ja arvot, jotka haluat lisätä sulkeisiin.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo tietotauluun uuden rivin.

    Voit hakea tietyn tietotaulukon kohteen käyttämällä seuraavaa merkintää: %VariableName[RowNumber][ColumnNumber]%. Muista, että ensimmäisen kohteen (rivin tai sarakkeen) RowNumber ja ColumnNumber on oltava 0.

    Oletetaan esimerkiksi, että työnkulku noutaa Excel-laskentataulukon sisällön ja tallentaa sen ExcelData-muuttujaan. Noudetun taulukon toisen rivin ensimmäistä solua voi käyttää seuraavalla lausekkeella.

    Näyttökuva lausekkeesta, joka käyttää luetun Excel-tiedoston ensimmäisen rivin toista solua.

    Note

    ExcelData-muuttuja sisältää arvotaulukon, joka on noudettu Excel-laskentataulukosta Lue Excel-laskentataulukosta -toiminnolla. Siinä on joitakin tietyn laskentataulukon arvoja eikä koko Excel-tiedosto.

    Jos haluat käyttää tiettyä tietosaraketta, joka sisältää sarakeotsikot, käytä %ExcelData[rowNumber]['ColumnName']-notaatiota.

    Jos selaat tietotaulukon, jossa on Kullekin-toiminto, nykyisen iteroinnin tiedot sisältävää muuttujaa pidetään tietona.

    Tietotaulukkotietotyypin ominaisuudet

  • Tietorivi - Tietorivi sisältää tietotaulukon yksittäisen rivin arvot. Kun selaat tietotaulukon, jossa on Kullekin-toiminto, nykyisen iteroinnin tiedot sisältävää muuttujaa pidetään tietona.

    Jos haluat noutaa tietyn datarow-osan osan, käytä seuraavaa säännöstä: %VariableName[ItemNumber]%

    Vaihtoehtoisesti voit käyttää %VariableName['ColumnName']% -tunnuksella. Kunkin sarakkeen nimen määrittää tietotaulukko, josta noudettiin tietorivien määrä.

    Tietorivitietotyypin ominaisuudet

    Näyttökuva tietorivimuuttujan sisällöstä.

  • Mukautettu objekti – Sisältää ominaisuuksien ja arvojen pareja, jotka voidaan helposti muuntaa JSON-muotoon.

    Jos haluat luoda uuden tyhjän mukautetun objektin, käytä Määritä muuttuja -toimintoa ja täytä seuraava lauseke %{{ }}%. Jos haluat luoda uuden mukautetun objektin ja alustaa sen ominaisuuksilla ja arvoilla, käytä lauseketta, jolla on seuraava rakenne: %{ 'Ominaisuus1': 'Arvo1', 'Ominaisuus2': 'Arvo2', 'Ominaisuus3': 'Arvo2' }%.

    Näyttökuva aseta muuttuja -toiminnosta, joka luo uuden mukautetun objektin.

    Jos haluat päivittää aiemmin luodun ominaisuuden arvon tai lisätä uuden, ota käyttöön Aseta muuttuja -toiminto, täytä ominaisuuden nimi Määritä-kenttään ja kirjoita sen arvo Kohde-kenttään.

    Näyttökuva aseta muuttuja -toiminnosta, joka lisää uuden ominaisuuden mukautettuun objektiin.

    Literaaliarvojen lisäksi voit määrittää mukautettujen objektien ominaisuudet ja arvot dynaamisesti muuttujien avulla. Esimerkiksi seuraava työnkulku lisää uuden ominaisuuden uuteen tyhjään mukautettuun objektiin kahden muuttujan avulla.

    Näyttökuva työnkulusta, joka lisää uuden ominaisuuden mukautettuun objektiin muuttujien avulla.

Tunnetut ongelmat ja rajoitukset

  • Ongelma: Tietorivi- ja tietotaulukkomuuttujien arvot eivät näy oikein muuttujien ruudussa.
  • Kiertotavat: Ei mitään.

Esiintymät

Yhteydet

Muut

Active Directory

  • Active Directory -merkintä ‑ Sisältää yhteyden Muodosta yhteys palvelimeen -toiminnon kautta luotuun Active Directory -palvelimeen.
  • Ryhmän tiedot ‑ Sisältää tietoja määritetystä Active Directory -ryhmästä.
  • Ryhmän jäsen ‑ Edustaa määritetyn Active Directory -ryhmän jäsentä.
  • Käyttäjän tiedot ‑ Sisältää tietoja määritetystä Active Directory -käyttäjästä.

Active Directory -tietotyypin ominaisuudet

AWS

  • EC2-asiakas - Sisältää Luo EY2 -istunto -luontitoiminnosta luodun EC2-istunnon.
  • EC2-ilmentymä - Esittää noudetun EC2-ilmentymän.
  • EC2-ilmentymätiedot - Sisältää tietoja EC2-ilmentymästä.
  • Ilmentymän tilan muutos - Sisältää tietoja aloitetusta tai pysäytetystä EC2-ilmentymästä.
  • EBS-tilannevedos - Esittää EBS-tilannevedoksen.
  • EBS-määrä - Esittää EBS-määrän.

AWS-tietotyypin ominaisuudet

Azure

  • Azure-asiakas - Sisältää Luo istunto -luontitoiminnosta luodun Azure-istunnon.
  • Azure-resurssiryhmä – edustaa haettua Azure-resurssiryhmää.
  • Azure-hallittu levy - edustaa haettua Azure-levyä.
  • Azure-tilannevedos - esittää Azure-tilannevedoksen.
  • Azure-näennäiskone - edustaa haettua Azure-näennäiskonetta.
  • Azure-näennäiskonetiedot - Sisältää tietoja Azure-näennäiskoneista.
  • Azure-tilaus – Edustaa haettua Azure-tilausta.

Azuren tietotyypin ominaisuudet

CMD

  • CMD-istunto - Sisältää Luo CMD -istunto -luontitoiminnosta luodun CMD-istunnon.

CMD-tietotyypin ominaisuudet

Päivämäärät ja aika

  • Päivämäärä ja aika - Sisältää päivämäärä- ja aikatietoja. Jos haluat luoda päivämäärä- ja aikamuuttujan Määritä muuttuja -toiminnilla, täytä syöteparametriin lausekkeet %d"yyyy-MM-dd HH:mm:ss.ff+zzz"%, jossa

    Merkintä Kuvaus
    yyyy Vuosi
    MM kuukausi
    dd päivä
    HH tunti
    mm minuuttia
    ss Sekunnit
    ff millisekuntia
    zzz UTC-poikkeama

Päivämäärät ja kellonaika -tietotyypin ominaisuudet

Sähköposti

  • Sähköpostiviesti - esittää sähköpostiviestin. Nouda sähköpostit -toiminto täyttää nämä muuttujat.

Sähköpostin tietotyypin ominaisuudet

Exchange

  • Exchange-sähköpostiviesti - esittää Exchange-palvelimesta haetun sähköpostiviestin. Hae Exchange-sähköpostiviestit -toiminto täyttää nämä muuttujat.

Exchange-tietotyypin ominaisuudet

Tiedostot ja kansiot

  • Tiedosto - Esittää tiedoston.
  • Kansio - Edustaa kansiota.

Tiedosto- ja kansiotietotyypin ominaisuudet

FTP

  • FTP-tiedosto - Esittää FTP-tiedoston.
  • FTP-hakemisto - edustaa FTP-hakemistoa

FTP-tietotyypin ominaisuudet

OCR

  • OCR-ydin - Sisältää Luo OCR-ytimen -luontitoiminnosta luodun OCR-ytimen.

Outlook

  • Outlook-sähköpostiviesti - esittää Outlook-sähköpostiviestin. Hae Outlook-sähköpostiviestit -toiminto täyttää nämä muuttujat.

Outlook-tietotyypin ominaisuudet

Pääte

  • Pääteistunto - Sisältää Luo pääte-istunto -luontitoiminnosta luodun pääte-istunnon.

Päätetietotyypin ominaisuudet

XML

  • XML-solmu - Sisältää XML-tiedoston sisällön. Lue XML tiedostosta -toiminto täyttää nämä muuttujat.

XML-tietotyypin ominaisuudet.