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

Yksinkertaiset tietotyypit edustavat yksinkertaisia arvoja, kuten tekstejä ja lukuja. Voit käyttää näitä tietotyyppejä itsenäisesti tai käyttää niitä monitasoisten tietorakenteiden, kuten luetteloiden ja tietotaulukkojen, luomiseen.

Tekstin arvo

Tämä on mitä 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.

Numeerinen arvo

Numeerinen on lukuihin käytettävä 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 matemaattisista lausekkeista on kohdassa Käytä muuttujia ja %-notaatiota.

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 kohdassa Käytä muuttujia ja %-notaatiota.

Lisätietotyypit

Kehittyneet tietotyypit edustavat monitasoisia tietorakenteita. Ne toimivat muiden tietotyyppien kokoelmina, joita voit käyttää yhtenä entiteettinä.

List

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.

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.

Yleinen käytäntö on käyttää Kullekin-toimintoa luettelon kohteiden iteroinnissa.

Jos haluat käyttää vain tiettyä luettelon osaa, käytä %VariableName[StartIndex:StopIndex]% -merkintää. Esimerkiksi lauseke %List[2:4]% noutaa luettelon kolmannen ja neljännen kohdan. StopIndex-positiossa oleva kohde viipalointiraja, eikä sitä noudeta.

Jos haluat viipaloida luettelon alusta tiettyyn kohteeseen, älä määritä StartIndex-arvoa, esimerkiksi %List[:4]%. Jos haluat viipaloida tietystä indeksistä loppuun, älä määritä StopIndex-arvoa, esimerkiksi %List[2:]%.

Luettelotietotyypin ominaisuudet

Tietotaulukko

Tietotaulukot sisältävät taulukkomuotoisia tietoja ja vastaavat 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ä.

Power Automate Luo uusi tietotaulukko -toiminto luo uusia tietotaulukoita. Toiminnon käyttöönottamisen jälkeen arvot voidaan täyttää ja sarakeotsikot nimetä uudelleen visualisoinnin muodostimessa.

Luo uusi tietotaulukko -toiminon on lisäksi kolme muuta toimintoa tuottaa tietotaulukkoja poimitettujen tietojen tallentamiseen: Lue Excel-laskentataulukosta, Suorita SQL-lause ja Tietojen purkaminen verkkosivulta.

Tietotaulukko voidaan luoda myös käyttämällä Määritä muuttuja -toimintoa ja ohjelmointimatriisimerkintää. 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']}%.

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

Uusi rivi lisätään aiemmin luotuun taulukkoon käyttämällä Lisää uusi rivi tietotaulukkoon -toiminto. Vaihtoehtoisesti voit luoda lausekkeen, joka sisältää tietotaulun muuttujan nimen, plusmerkin (+) ja lisättävä arvot sulkeissa.

Rivien tietotaulukkoon lisäämisen lisäksi, työpöytätyönkuluissa erilaisia tietotaulukoiden käsittelytoimintojen. Näitä toimintoja varten on kattava luettelo muuttujien toimintojen viitteessä.

Jos haluat noutaa tietyn datatable-kohteen, käytä seuraavaa säännöstä: %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.

Huomautus

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.

Samalla tavalla kuin luetteloissa, käytetään %VariableName[StartRow:StopRow]% -notaatiota, kun haluat käyttää tiettyä tietotaulukon osaa. Lauseke noutaa vain näiden kahden indeksin määrittämät rivit, ja StopRow-kohta on viipalointiraja eikä sitä noudeta.

Jos haluat viipaloida taulukon ensimmäisestä rivistä tiettyyn riviin, älä käytä StartRow-arvoa, esimerkiksi %Datatable[:4]%. Samoin Jos haluat viipaloida taulukon tietystä rivistä loppuun, älä käytä StopRow-arvoa, esimerkiksi %Datatable[2:]%.

Tietotaulukkotietotyypin ominaisuudet

Tietorivi

Tietorivi sisältää yhden tietotaulukkorivin 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

Custom object

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 käynnistää sen ominaisuuksilla ja arvoilla, käytä lauseketta, jolla on seuraava rakenne: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Tärkeää

Varattuja avainsanoja ei voi käyttää mukautettuina objektiominaisuuksina. Täydellinen luettelo varatuista avainsanoista on kohdassa Varatut avainsanat työpöytätyönkuluissa.

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.

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.

Connector-objekti

Yhdistinobjektit tallentavat tietoja pilviyhdistimistä ja toimivat samalla tavalla kuin mukautetut objektit. Niiden ominaisuudet sisältävät yleensä luetteloita muista yhdistinobjekteista. Arvojen käyttö toimii kuten mukautetuissa objekteissa, vaikka sisäkkäisten arvojen käyttäminen saattaa vaatia monimutkaisempia lausekkeita.

PDF-taulukon tietojen luettelo

Tämän tietotyypin muuttuja voidaan tuottaa vain Poimi taulukot PDF-tiedostosta -toiminnon avulla.

Kukin luettelon kohde kuvaa poimittua taulukkoa ja tarjoaa kaikki sitä koskevat tärkeät tiedot. Jos haluat käyttää tiettyä tietotaulukon tietojen kohdetta, käytä %VariableName[ItemNumber]%-merkintätapaa.

Jokainen luettelokohde sisältää neljä ominaisuutta, joiden avulla saat määritetyt tiedot itsenäisesti. Saatavilla olevat ominaisuudet ovat seuraavat.

• DataTable – Palauttaa poimitun taulukon.
• TableStartingPage – Palauttaa tiedostosivun indeksin, joka sisältää taulukon alun.
• TableEndingPage – Palauttaa tiedostosivun indeksin, joka sisältää taulukon lopun.
• TableOrderInPage – Palauttaa sivun taulukkojen järjestyksen.

Lisätietoja tämän tietotyypin ominaisuuksista on kohdassa Muuttujien tietotyypin ominaisuudet.

Jos haluat käyttää tietyn ominaisuuden arvoa, käytä %VariableName[ItemNumber].PropertyName%-merkintätapaa. Esimerkiksi seuraava lauseke palauttaa ExtractedPDFTables-muuttujan ensimmäisen kohteen tietotaulukon arvon.

Tunnetut ongelmat ja rajoitukset

• Ongelma: Kun tietotaulukko- tai tietorivisolu sisältää usean rivin merkinnän, muuttujan katseluohjelma näyttää vain ensimmäisen rivin.
• Kiertotavat: Ei mitään.

Esiintymät

• Selainesiintymä – Sisältää selainesiintymän, joka on luotu Käynnistä uusi Internet Explorer tai muun selaimen käynnistystoiminnon avulla.

  Selaimen ilmentymän tietotyypin ominaisuudet

• Ikkunan ilmentymä – Sisältää Hae ikkuna -toiminnon kautta luodun ikkunan ilmentymän.

  Ikkunan ilmentymän tietotyypin ominaisuudet

• Excel-ilmentymä – Sisältää Excel-ilmentymän, joka on luotu Käynnistä Excel -toiminnolla.

  Excel-ilmentymän tietotyypin ominaisuudet

• Outlook-ilmentymä – Sisältää Outlook-ilmentymän, joka on luotu Käynnistä Outlook -toiminnolla.

Yhteydet

• SQL-yhteys – Sisältää yhteyden Open SQL -yhteys -toiminnon kautta luotuun SQL-tietokantaan.

  SQL-yhteystietotyypin ominaisuudet

• Exchange-yhteys – Sisältää yhteyden Exchange Serveriin, joka on muodostettu Muodosta yhteys Exchange Serveriin -toiminnon kautta.

  Exchange-yhteystietotyypin ominaisuudet

• FTP-yhteys – Sisältää Open FTP -yhteyden kautta luodun FTP-yhteyden ja Avaa suojatut FTP-yhteydet -toiminnot.

  FTP-yhteystietotyypin ominaisuudet

Muut

Tässä osassa näkyvät kaikki käytettävissä olevat tietotyypit, jotka eivät kuulu mihinkään edellä olevista luokista.

Yleinen arvo

• Yleinen arvo – Tätä tietotyyppiä käytetään suunnitteluajan aikana, jolloin Power Automate ei voi määrittää muuttujan tai syöteparametrin tietotyyppiä. Yleiset arvot muunnetaan suorituksen aikana toisiin tietotyyppeihin niiden tietojen perusteella.

Active Directory

• Active Directory -merkintä – Sisältää yhteyden Muodosta yhteys palvelimeen -toiminnon kautta luotuun Active Directory -palvelimeen.
• Ryhmän tiedot – Sisältää tietyn Active Directory -ryhmän nimen, näyttönimen, kuvauksen ja jäsenet.
• Ryhmän jäsen – Edustaa määritetyn Active Directory -ryhmän jäsentä.
• Käyttäjätiedot – Sisältää tiettyä Active Directoryn käyttäjää koskevia tietoja, kuten etu- ja sukunimen, nimikirjaimen ja DN-nimen, työtiedot (yritys, osasto ja titteli), yhteystiedot (puhelinnumero, alanumero ja sähköpostiosoite) sekä sijainnin (maa/alue, kaupunki, osavaltio, katuosoite ja postinumero).

Active Directory -tietotyypin ominaisuudet

Amazon Web Services (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

Tunnistetiedot

• Tunnistetiedot – Sisältää tunnistetiedot, jotka on noudettu Hae tunnistetiedot (esiversio) -toiminnolla.

Tunnistetiedot-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ä/aika-muuttujan toiminnolla Määritä muuttuja, 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	Minuutit
  ss	Sekunnit
  ff	Millisekunnit
  zzz	UTC-poikkeama

  Esimerkiksi %d"2022-03-25"% määrittää päivämäärän 25. maaliskuuta 2022 kohdemuuttujaan.

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

Email

• 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 Serveristä 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.
• FileSystemObject – Esittää joko kansion tai tiedoston. Tätä tietotyyppiä käytetään syöteparametreissa, jotka hyväksyvät kansiot ja tiedostot.

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

Error

• Virhe – Sisältää tietoja työpöytätyönkulussa tapahtuneesta viimeisestä virheestä. Hae viimeinen virhe -toiminto luo tämäntyyppisen muuttujan.

Virheen ominaisuudet