Arvojen tallentaminen muuttujiin ja niiden hallinta

Tässä artikkelissa käsitellään sellaisten muuttujien luontia ja käyttöä, joihin arvot voidaan tallentaa pilvityönkuluissa. Muuttajat voivat esimerkiksi auttaa seuraamaan, kuinka monta kertaa silmukka suoritetaan. Matriisissa tapahtuvaa iterointia tai matriisin tietyn kohteen tarkistamista varten voidaan käyttää muuttujaa, joka viittaa kuhunkin matriisikohteeseen käytettävään indeksinumeroon.

Esimerkiksi seuraaville tietotyypeille voidaan luoda muuttujia: kokonaisluku, liukuluku, totuusarvo, merkkijono, matriisi ja objekti. Kun olet luonut muuttujan, voit suorittaa muita tehtäviä, kuten:

  • Muuttujan arvon hakeminen tai siihen viittaaminen.
  • Muuttujan suurentaminen tai pienentäminen vakioarvolla, mitä kutsutaan myös lisäykseksi ja vähennykseksi.
  • Toisen arvon määrittäminen muuttujalle.
  • Muuttujan arvon lisääminen tai liittäminen merkkijonon tai matriisin viimeiseksi kohteeksi.

Muuttujat esiintyvät ovat yleisiä vain siinä pilvityönkulussa, jossa ne on luotu. Lisäksi ne säilyvät kaikissa työnkulun sisäisissä silmukkaiteraatioissa.

Kun muuttujaan viitataan, muuttujan nimeä käytetään tunnuksena eikä toiminnon nimenä, mikä on tavallinen tapa viitata toiminnon tuloksiin.

Warning

Kutakin iteraatiota käytetään oletusarvoisesti kuhunkin peräkkäin suoritettavaan silmukkaan. Suorituskykyä voi parantaa suorittamalla silmukkaiteraatiot rinnakkain. Jos muuttujia käytetään kutakin silmukkaan koskevana, silmukkaiteraatiot on suoritettava peräkkäin, jos sillä on merkitystä, että silmukkamuuttujat palauttavat ennakoitavia tuloksia.

Edellytykset

Note

Ennen muuttujien luonti- ja käsittelytoimintojen lisäämistä työnkulku on aloitettava käynnistimellä.

Muuttujan alustaminen

Muuttuja voidaan luoda sekä sen tietotyyppi ja ensimmäinen arvo määritellä yhdessä työnkulun toiminnossa. Muuttujat voidaan määritellä vain yleisessä tasolla, ei vaikutusalueilla, ehdoissa eikä silmukoissa.

  1. Kirjaudu Power Automateiin.

  2. Luo pilvityönkulku ja valitse jokin seuraavista tavoista siinä vaiheessa, johon haluat lisätä muuttujan:

    • Jos toiminto lisätään viimeiseen vaiheeseen, valitse Uusi vaihe.

      Näyttökuvassa on power automate -suunnitteluohjelmassa valittu Uusi vaihe -toiminto

    • Jos toiminto lisätään vaiheiden väliin, siirrä hiiri yhdistävän nuolen päälle siten, että plus-merkki (+) tulee näkyviin. Valitse ensin plus-merkki ja sitten Lisää toiminto.

  3. Määritä variable suodattimeksi Valitse toiminto -kohdan hakuruudussa. Valitse toimintoluettelossa Alusta muuttuja.

    Valitse toiminto.

  4. Anna muuttujalle seuraavat tiedot:

    Ominaisuus Pakollinen Arvo Kuvaus
    Nimi Kyllä <variable-name> Alustettavan muuttujan nimi
    Tyyppi Kyllä <variable-type> Muuttujan tietotyyppi
    Arvo Ei <start-value> Muuttujan alkuarvo

    Vihje: vaikka tämä arvo on valinnainen, arvon määrittäminen on parhaan käytännön mukaisista, sillä silloin muuttujan alkuarvo on aina tiedossa.

    Esimerkki:

    Alusta muuttuja.

  5. Seuraavaksi siirrytään lisäämään toimintoja. Kun olet valmis, valitse Tallenna.

Note

Vaikka Alusta muuttuja -toiminnolla on variable-osa, jonka rakenteena on matriisi, toiminto voi luoda kerralla vain yhden muuttujan. Kukin uusi muuttuja tarvitsee itsenäisen Alusta muuttuja -toiminnon.

Esimerkkejä muista muuttujatyypeistä:

Merkkijonomuuttuja


   "name": "myStringVariable",
   "type": "String",
   "value": "lorem ipsum"

Totuusarvomuuttuja

   "name": "myBooleanVariable",
   "type": "Boolean",
   "value": false

Kokonaislukuja sisältävä matriisi

   "name": "myArrayVariable",
   "type": "Array",
   "value": [1, 2, 3]

Merkkijonona sisältävä matriisi

   "name": "myArrayVariable",
   "type": "Array",
   "value": ["red", "orange", "yellow"]

Muuttujan arvon hakeminen

Muuttujan sisältöjä voi noutaa tai niihin voi viitata käyttämällä variables()-funktiota Power Automate -suunnitteluohjelmassa.

Esimerkiksi seuraava lauseke hakee kohteet matriisimuuttujasta käyttämällä variables()-funktiota. string()-funktio palauttaa muuttujan sisällöt merkkijonomuodossa: "1, 2, 3, red"

@{string(variables('myArrayVariable'))}

Muuttujan lisäys

Muuttujaa voi kasvattaa tai lisätä vakioarvolla lisäämällä Muuttujan lisäys -toiminto työnkulkuun.

Important

Tämä toiminto toimii vain kokonaisluku- ja liukulukumuuttujissa.

  1. Valitse Power Automate -suunnitteluohjelman siinä vaiheessa Uusi vaihe, jossa aiemmin luodun muuttujan arvoa halutaan lisätä.

    Esimerkiksi seuraavassa pilvityönkulussa on jo käynnistin ja toiminto, joka loi muuttujan. Uusi toiminto lisätään siis seuraavissa vaiheissa:

    Lisää toiminto.

    Jos toiminto lisätään aiemmin luotujen vaiheiden väliin, siirrä hiiri yhdistävän nuolen päälle siten, että plus-merkki (+) tulee näkyviin. Valitse ensin plus-merkki ja sitten Lisää toiminto.

  2. Anna hakuruudussa suodattimeksi muuttujan lisäys. Valitse toimintoluettelossa Muuttujan lisäys.

    Muuttujan lisäys -toiminnon valinta

  3. Anna muuttujan arvon lisäämiseen seuraavat tiedot:

    Ominaisuus Pakollinen Arvo Kuvaus
    Nimi Kyllä <variable-name> Lisäävän muuttujan nimi
    Arvo Ei <increment-value> Muuttujan lisäämiseen käytetty arvo. Oletusarvo on yksi.

    Vihje: vaikka tämä arvo on valinnainen, arvon määrittäminen on parhaan käytännön mukaisista, sillä silloin muuttujan lisäysarvo on tiedossa.

    Esimerkki:

    Lisäysarvo-esimerkki.

  4. Kun olet valmis, valitse suunnitteluohjelman työkalurivillä Tallenna.

Esimerkki: silmukkalaskurin luominen

Muuttujia käytetään yleisesti laskemaan, kuinka monta kertaa silmukka suoritetaan. Tämä esimerkki näyttää, miten muuttujat luodaan tätä tehtävää varten ja miten niitä käytetään. Se tapahtuu luomalla silmukka, joka laskee sähköpostissa olevat liitteet.

  1. Luo pilvityönkulku Power Automatessa. Lisää käynnistin, joka etsii uudet sähköpostiviestit ja mahdolliset liitteet.

    Tässä esimerkissä käytetään Office 365 Outlookin käynnistintä Kun uusi sähköpostiviesti saapuu. Tämä käynnistin voidaan määrittää käynnistymään vain, kun sähköpostiviestissä on liitteitä. Voit kuitenkin käyttää yhdistintä, joka etsii liitteitä sisältävät sähköpostit, kuten Outlook.com-yhdistintä.

  2. Liitteet voidaan etsiä ja kyseiset liitteet siirtää työnkulkuun, kun käynnistimessä valitaan seuraavien ominaisuuksien kohdalla Kyllä:

    • Sisällytä liitteet
    • Vain liitteelliset

    Tarkista ja sisällytä liitteet.

  3. Lisää Alusta muuttuja -toiminto. Luo Count-niminen kokonaislukumuuttuja, jonka alkuarvo on nolla.

    Lisää toiminto kohteelle "Alusta muuttuja".

  4. Lisää käytä jokaisessa -silmukka selaamaan liitteitä.

    1. Valitse Alusta muuttuja-toiminnossa Uusi vaihe.

    2. Valitse Valitse toiminto -kohdassa Sisäinen. Anna hakuruudussa hakusuodattimeksi apply to each ja valitse Käytä kaikkiin.

      Käytä kaikkiin -silmukan lisääminen

  5. Valitse silmukassa Valitse tulos edellisistä vaiheista -ruutu. Kun dynaaminen sisältöluettelo avautuu, valitse Liitteet.

    Valitse "Liitteet".

    Liitteet-ominaisuus välittää matriisin, jossa on kaikki sähköpostin liitteet, silmukkaan.

  6. Valitse Käytä kaikkiin -silmukassa Lisää toiminto.

    Valitse "Lisää toiminto".

  7. Anna hakuruudussa suodattimeksi muuttujan lisäys. Valitse toimintoluettelossa Muuttujan lisäys.

    Note

    Muuttujan lisäys -toiminnon on oltava näkyvissä silmukassa.

  8. Valitse Muuttujan lisäys -toiminnon Nimi-luettelossa Määrä-muuttuja.

  9. Lisää silmukkaan mikä tahansa toiminto, joka lähettää liitteiden määrän. Sisällytä toimintoon Määrä-muuttujan arvo, kuten seuraavassa:

    Lisää toiminto, joka lähettää tuloksia.

  10. Valitse suunnitteluohjelman työkalurivillä Tallenna.

Muuttujan vähennys

Muuttujaa voi pienentää tai vähentää vakioarvolla samalla tavoin kuin muuttujaa kasvatetaan. Ainoa poikkeus on, että etsittävä ja valittava toiminto on Muuttujan vähennys. Tämä toiminto toimii vain kokonaisluku- ja liukulukumuuttujissa.

Muuttujan vähennys -toiminnon ominaisuudet:

Ominaisuus Pakollinen Arvo Kuvaus
Nimi Kyllä <variable-name> Vähennettävän muuttujan nimi
Arvo Ei <increment-value> Muuttujaa vähentävä arvo. Oletusarvo on yksi.

Vihje: vaikka tämä arvo on valinnainen, arvon määrittäminen on parhaan käytännön mukaisista, sillä silloin muuttujan vähennysarvo on tiedossa.

Aseta muuttuja

Aiemmin luodulle muuttujalle voidaan määrittää toinen arvo samalla tavoin kuin muuttujaa suurennettaessa seuraavin poikkeuksin:

  1. Etsi ja valitse Määritä muuttuja -toiminto.

  2. Anna muuttujan nimi ja määritettävä arvo. Uuden arvon ja muuttujan tietotyypin on oltava sama. Arvo on pakollinen, koska tällä toimilla ei ole oletusarvoa.

Määritä muuttuja -toiminnon ominaisuudet:

Ominaisuus Pakollinen Arvo Kuvaus
Nimi Kyllä <variable-name> Muutettavan muuttujan nimi
Arvo Kyllä <new-value> Muuttujalle määritettävä arvo. Kummallakin on oltava sama tietotyyppi.

Note

Ellei kyse ole muuttujien lisäyksestä tai vähennyksestä, muuttajien muuttaminen silmukoissa saattaa luoda odottamattomia tuloksia, jos silmukat suoritetaan rinnakkain. Tällaisissa tilanteissa voi kokeilla silmukan suorittamista peräkkäin, mikä on oletusasetus.

Muuttujaan lisääminen

Jos muuttujiin on tallennettu merkkijonoja tai matriiseja, muuttajan arvon voi liittää tai lisätä viimeisenä kohteena kyseisiin merkkijonoihin tai matriiseihin. Seuraavia vaiheita lukuun ottamatta toimitaan samalla tavoin kuin muuttujaa suurennettaessa:

  1. Etsi ja valitse jokin seuraavista toiminnoista sen perusteella, onko muuttuja merkkijono vai matriisi.

    • Lisää merkkijonomuuttujaan
    • Lisää matriisimuuttujaan
  2. Anna arvo, joka lisätään viimeisenä kohteena merkkijonoon tai matriisiin. Tämä arvo on pakollinen.

Lisää kohteeseen... -toimintojen ominaisuudet:

Ominaisuus Pakollinen Arvo Kuvaus
Nimi Kyllä <variable-name> Muutettavan muuttujan nimi
Arvo Kyllä <append-value> Lisättävä arvo, jonka tyyppi voi olla mikä tahansa

Seuraavat vaiheet