Muutuja andmetüübid

Kui loote oma voogudes muutujaid, Power Automate teisendab see need sisu põhjal kindlasse tüüpi.

Mõnda neist andmetüüpidest kasutatakse laialdaselt kogu rakenduses, näiteks numbrid, samas kui teised, näiteks brauseri eksemplarid, nõuavad selgesõnalisi toiminguid või toimingute rühmi.

Lihtsad andmetüübid

Lihtsad andmetüübid esindavad üksikuid väärtusi, näiteks tekste ja numbreid. Neid andmetüüpe saab kasutada iseseisvalt või keerukamate andmestruktuuride, näiteks loendite ja andmetabelite loomiseks.

Tekstiväärtus

See on igasugune tekst, alates e-posti aadressidest kuni .txt-faili tekstisisuni.

Teksti andmetüübi omadused

Muutuja **Tekstiväärtus** loomiseks kasutage toimingut **Määra muutuja** ja täitke sisendparameeter soovitud tekstiga ilma igasuguse märgetuseta.

Arvväärtus

Numbriline on numbritele rakendatav tüüp. Matemaatilistes tehtes saab kasutada ainult seda andmetüüpi.

Numbrilise väärtusega muutuja loomiseks kasutage toimingut Muutuja määramine ja sisestage sisendparameeter numbriga ilma igasuguse tähistuseta.

Välja arvatud püsikodeeritud arvväärtused, saate kasutada matemaatilisi avaldisi muutujatega protsendimärkide sees. Matemaatiliste avaldiste kohta leiate lisateavet jaotisest Muutujate ja %-tähise kasutamine.

Loogikaväärtus

Väärtus võib olla kas Tõene või Väär.

Boole’i väärtuse muutuja loomiseks kasutage toimingut Muutuja määramine ja täitke sisendparameeter avaldistega %True% või %False%.

Lisaks saate luua keerukaid avaldisi, kasutades loogikaoperaatoreid, muutujaid ja protsendimärki. Loogikaliste avaldiste kohta leiate lisateavet jaotisest Muutujate ja %-tähise kasutamine.

Täiustatud andmetüübid

Täiustatud andmetüübid esindavad keerulisi andmestruktuure. Need toimivad teiste andmetüüpide kogumitena, millele pääsete juurde ühe üksusena.

Loend

Loendid on üksuste kogumid. Sõltuvalt üksikute loendiüksuste tüübist võivad olla tekstiväärtuste loendid, arvväärtuste loendid jne. Loendi andmetüüp on programmeerimise terminoloogias samaväärne ühemõõtmelise massiiviga.

Loendi loomiseks kasutage toimingut Loo uus loend ja loendisse üksuse lisamiseks kasutage toimingut Lisa üksus loendisse .

Loendi saab luua ka toimingute abil, mis genereerivad väljundina loendeid. Näiteks toiming Loe teksti failist tagastab tekstiväärtuste loendi ja toiming Hangi failid kaustast tagastab failide loendi.

Loendis oleva konkreetse üksuse leidmiseks kasutage järgmist tähistust: %MuutujaNimi[ItemNumber]%

Järgmises näites salvestab voog eelnevalt kuvatud loendi esimese numbri uude muutujasse. Pea meeles, et loendi esimese üksuse indeks peaks olema 0.

Levinud tava on kasutada iga toimingu jaoks a loendi üksuste läbimiseks.

Kui teil on vaja juurde pääseda ainult loendi kindlale osale, kasutage tähistust %VariableName[StartIndex:StopIndex]% . Näiteks avaldis %List[2:4]% hankib loendi kolmanda ja neljanda elemendi. Positsioonil **StopIndex** olev objekt on viilutamise piir ja seda ei leita.

Loendi algusest kindla üksuseni tükeldamiseks ärge määrake ``StartIndex`` väärtust, näiteks ``%List[:4]% ``. Loendi viilutamiseks kindlast indeksist lõpuni ärge määrake ` StopIndex ` väärtust, näiteks ` %List[2:]%`.

Loendi andmetüübi omadused

Andmetabel

Andmetabelid sisaldavad andmeid tabeli kujul ja on programmeerimise mõttes samaväärsed kahemõõtmeliste massiividega.

Andmetabel sisaldab ridu ja veerge, mis kirjeldavad iga elemendi asukohta unikaalselt. Andmetabeleid võib pidada loenditeks, mis sisaldavad üksustena andmeridu.

Power Automate pakub toimingut Loo uus andmetabel uute andmetabelite loomiseks. Pärast toimingu juurutamist saate väärtuste täitmiseks ja veerupäiste ümbernimetamiseks kasutada visuaalset koosturit.

Lisaks toimingule Loo uus andmetabel loovad veel kolm toimingut andmetabeleid ekstraheeritud andmete salvestamiseks: toimingud Loe Exceli töölehelt, Käivita SQL-lause ja Andmete ekstraheerimine veebilehelt .

Lisaks saate luua andmetabeli, kasutades toimingut Määra muutuja ja programmeerimise massiivi tähistust. See tähistus koosneb mitmest ühemõõtmelisest massiivist, mis on eraldatud komadega ja pandud looksulgudesse. Lõplik avaldis peab olema järgmisel kujul: %{[’Toode1’, ’10 USD’], [’Toode2’, ’20 USD’]}%.

Kui soovite massiivitähistuse abil uue andmetabeli loomisel lisada veerupäiseid, kasutage esimese rea jaoks avaldist ^[’ColumnName1’, ’ColumnName2’] .

Uue rea lisamiseks olemasolevale tabelile kasutage toimingut Lisa rida andmetabelisse . Teise võimalusena looge avaldis, mis sisaldab andmetabeli muutuja nime, plussmärki (+) ja sulgudes väärtusi, mida soovite lisada.

Lisaks ridade lisamisele andmetabelitesse pakuvad töölauavood mitmesuguseid toiminguid andmetabelitega manipuleerimiseks. Nende toimingute täieliku loendi leiate muutujate toimingute viitest.

Andmetabeli konkreetse elemendi toomiseks kasutage järgmist tähistust: %MuutujaNimi[RowNumber][ColumnNumber]%. Pea meeles, et esimese üksuse (rea või veeru) puhul peaksid rea numbri ja veeru numbri väärtused olema 0.

Näiteks oletame, et voog hangib Exceli töölehe sisu ja salvestab selle muutujasse **ExcelData**. Tagatud tabeli teise rea esimesele lahtrile juurdepääsuks kasutage allpool kuvatavat avaldist.

Märkus.

Muutuja ExcelData sisaldab väärtuste tabelit, mis on ekstraheeritud Exceli töölehelt toimingu Loe Exceli töölehelt abil. See sisaldab konkreetse töölehe mõningaid väärtusi, mitte kogu Exceli faili.

Kui soovite juurde pääseda andmetabeli kindlale veerule, mis sisaldab veerupäiseid, kasutage märget %ExcelData[rowNumber][’ColumnName’]% .

Kui käite andmetabelis läbi toiminguga For Each , loetakse praeguse iteratsiooni andmeid sisaldav muutuja andmereaks.

Sarnaselt loenditega kasutatakse andmetabeli kindlale osale juurdepääsuks tähistust %VariableName[StartRow:StopRow]% . Avaldis hangib ainult kahe indeksi poolt määratletud read, samas kui positsioon StopRow on viilutamise piir ja seda ei hangita.

Andmetabeli esimesest reast kindlale reale lõikamiseks ärge kasutage ``StartRow`` väärtust, näiteks ``%Datatable[:4]% ``. Samamoodi ärge kasutage andmetabeli lõikamiseks kindlast reast lõpuni väärtust StopRow , näiteks %Datatable[2:]%.

Andmetabeli andmetüübi omadused

Andmerida

Andmerida sisaldab andmetabeli ühe rea väärtusi. Kui käite andmetabelis läbi toiminguga `` For Each``, siis on praeguse iteratsiooni andmeid sisaldav muutuja andmerida.

Andmerea konkreetse elemendi toomiseks kasutage järgmist tähistust: %MuutujaNimi[ItemNumber]%

Teise võimalusena võite kasutada tähistust %VariableName[’ColumnName’]% . Iga veeru nime määrab andmetabel, kust te andmerea hankisite.

Andmerea andmetüübi omadused

Kohandatud objekt

Sisaldab omaduste ja väärtuste paare, mida saab hõlpsalt JSON-vormingusse teisendada.

Uue tühja kohandatud objekti loomiseks kasutage toimingut Muutuja määramine ja täitke järgmine avaldis % %{{ }}. Uue kohandatud objekti loomiseks ja selle omaduste ja väärtustega initsialiseerimiseks kasutage järgmise struktuuriga avaldist: % ’Property1’: ’Value1’, ’Property2’: ’Value2’, ’Property3’: ’Value2’{ % }.

Oluline

Reserveeritud märksõnu ei saa kohandatud objekti atribuutidena kasutada. Reserveeritud märksõnade täieliku loendi leiate jaotisest Reserveeritud märksõnad töölaua voogudes.

Olemasoleva atribuudi väärtuse värskendamiseks või uue lisamiseks käivitage toiming Määra muutuja , sisestage atribuudi nimi väljale Määra ja sisestage selle väärtus väljale Kellele .

Lisaks literaalväärtustele saate muutujate abil dünaamiliselt määrata kohandatud objektide omadusi ja väärtusi. Näiteks kasutab järgmine voog uuele tühjale kohandatud objektile uue atribuudi lisamiseks kahte muutujat.

Konnektoriobjekt

Konnektoriobjektid salvestavad teavet pilvekonnektoritest ja toimivad sarnaselt kohandatud objektidega. Nende omadused sisaldavad tavaliselt teiste ühendusobjektide loendeid. Väärtustele juurdepääs toimib nagu kohandatud objektide puhul, kuigi pesastatud väärtustele juurdepääsemiseks võib vaja minna keerukamaid avaldisi.

PDF-tabeli teabe loend

Selle andmetüübi muutujat saab luua ainult toimingu **Tabelite väljavõtmine PDF-ist** abil.

Iga loendi üksus kirjeldab ekstraheeritud tabelit ja annab selle kohta kogu olulise teabe. Konkreetse andmetabeli infoüksusele juurdepääsuks kasutage tähistust %VariableName[ItemNumber]% .

Igal loendiüksusel on neli omadust, mis võimaldavad teil konkreetset detaili iseseisvalt hankida. Saadaval olevad omadused on järgmised:

• DataTable – Tagastab ekstraheeritud tabeli.
• TableStartingPage – Tagastab faililehe indeksi, mis sisaldab tabeli algust.
• TableEndingPage – Tagastab faililehe indeksi, mis sisaldab tabeli lõppu.
• TableOrderInPage – Tagastab tabeli järjekorra lehel.

Lisateavet selle andmetüübi omaduste kohta leiate jaotisest Muutujate andmetüübi omadused.

Konkreetse atribuudi väärtusele juurdepääsuks kasutage tähistust %VariableName[ItemNumber].PropertyName% . Näiteks järgmine avaldis tagastab muutuja **ExtractedPDFTables** esimese elemendi andmetabeli väärtuse.

Teadaolevad probleemid ja piirangud

• Probleem: Kui andmetabeli või andmerea lahter sisaldab mitmerealist kirjet, kuvab muutujate vaatur ainult selle esimest rida.
• Lahendused: Puuduvad.

Eksemplarid

• Veebibrauseri eksemplar – sisaldab brauseri eksemplari, mis on loodud käsuga Käivita uus Internet Explorer või muude brauseri käivitamise toimingutega.

  Veebibrauseri eksemplari andmetüübi omadused

• Akna eksemplar – Sisaldab toimingu Hangi aken abil loodud akna eksemplari.

  Akna eksemplari andmetüübi omadused

• Exceli eksemplar – sisaldab toimingu Käivita Excel abil loodud Exceli eksemplari.

  Exceli eksemplari andmetüübi atribuudid

• Outlooki eksemplar – Sisaldab toimingu Käivita Outlook abil loodud Outlooki eksemplari.

Ühendused

• SQL-ühendus – Sisaldab ühenduse SQL-andmebaasiga, mis on loodud toimingu Ava SQL-ühendus kaudu.

  SQL-ühenduse andmetüübi omadused

• Exchange’i ühendus – sisaldab toimingu Loo ühendus Exchange’i serveriga kaudu loodud ühendust Exchange’i serveriga.

  Exchange’i ühenduse andmetüübi atribuudid

• FTP-ühendus – Sisaldab FTP-ühendust, mis on loodud toimingute Ava FTP-ühendus ja Ava turvaline FTP-ühendus abil.

  FTP-ühenduse andmetüübi omadused

Muud

Selles jaotises on esitatud kõik saadaolevad andmetüübid, mis ei kuulu ühtegi eelnevasse kategooriasse.

Üldine väärtus

• Üldine väärtus – Seda andmetüüpi kasutatakse disaini ajal, kui Power Automate muutuja või sisendparameetri andmetüüpi ei saa määratleda. Üldised väärtused teisendatakse käitusaja jooksul nende andmete põhjal teisteks andmetüüpideks.

Active Directory

• Active Directory kirje – sisaldab ühenduse Active Directory serveriga, mis on loodud toimingu Loo ühendus serveriga kaudu.
• Grupi info – Sisaldab määratud Active Directory grupi nime, kuvatavat nime, kirjeldust ja liikmeid.
• Grupi liige – Esindab määratud Active Directory grupi liiget.
• Kasutajateave – Sisaldab teavet määratud Active Directory kasutaja kohta, näiteks ees- ja perekonnanimi, initsiaalid ja eraldusnimi, tööandmed (ettevõte, osakond ja ametinimetus), kontaktandmed (telefoninumber, lisanumber ja e-posti aadress) ning asukoht (riik/regioon, linn, osariik, tänava aadress ja postiindeks).

Active Directory andmetüübi omadused

Amazoni veebiteenused (AWS)

• EC2 klient – Sisaldab toimingu Loo EC2 seanss abil loodud EC2 seanssi.
• EC2 eksemplar – Esindab hangitud EC2 eksemplari.
• EC2 eksemplaride info – Sisaldab teavet EC2 eksemplari kohta.
• Eksemplari oleku muutus – Sisaldab teavet käivitatud või peatatud EC2 eksemplari kohta.
• EBS-i hetktõmmis – kujutab EBS-i hetktõmmist.
• EBS-i maht – Esitab EBS-i mahtu.

AWS-i andmetüübi omadused

Azure

• Azure’i klient – sisaldab Azure’i seanssi, mis on loodud toimingu Loo seanss abil.
• Azure’i ressursirühm – Esindab hangitud Azure’i ressursirühma.
• Azure’i hallatav ketas – tähistab hangitud Azure’i ketast.
• Azure’i hetktõmmis – kujutab Azure’i hetktõmmist.
• Azure’i virtuaalmasin – Esindab hangitud Azure’i virtuaalmasinat.
• Azure’i virtuaalmasina info – sisaldab teavet Azure’i virtuaalmasina kohta.
• Azure’i tellimus – Esindab hangitud Azure’i tellimust.

Azure’i andmetüübi atribuudid

CMD

• CMD seanss – sisaldab toimingu Ava CMD seanss abil loodud CMD seanssi.

CMD andmetüübi omadused

Mandaadid

• Volitus – Sisaldab toimingu Hangi volitus (eelvaade) kaudu hangitud volitust.

Volituste andmetüübi omadused

Kuupäevad ja kellaajad

• Kuupäev ja kellaaeg – Sisaldab kuupäeva ja kellaaja teavet. Kuupäeva ja kellaaja muutuja loomiseks toimingu ` Määra muutuja` (Set Variable) abil sisestage sisendparameeter avaldistega ` "yyyy-MM-dd HH:mm:ss.ff+zzz"% %d, kus:

  Märge	Kirjeldus
  aaaa	aasta
  MM	kuu
  dd	päev
  HH	tund
  mm	minutid
  ss	Sekundid
  ff	Millisekundid
  zzz	UTC-ajavahe

  Näiteks %d "2022-03-25"% määrab sihtmuutujale kuupäevaks 25. märtsi 2022.

Kuupäevade ja kellaaegade andmetüübi omadused

Meiliaadress

• Meilisõnum – Esindab e-kirja. See Meilide toomine tegevus täidab need muutujad.

Meiliandmete tüübi atribuudid

Exchange

• Exchange’i meilisõnum – Tähistab Exchange’i serverist hangitud e-kirja. See Exchange’i e-kirjade toomine tegevus täidab need muutujad.

Exchange’i andmetüübi atribuudid

Failid ja kaustad

• Fail – Esindab faili.
• Kaust – Tähistab kausta.
• FileSystemObject – Tähistab kas kausta või faili. Seda andmetüüpi kasutatakse sisendparameetrites, mis aktsepteerivad kaustu ja faile.

Failide ja kaustade andmetüübi omadused

FTP

• FTP-fail – Esindab FTP-faili.
• FTP-kataloog – Esindab FTP-kataloogi

FTP andmetüübi omadused

OCR

• OCR-mootor – Sisaldab OCR-mootorit, mis on loodud programmi abil Loo OCR-mootor tegevus.

Outlook

• Outlooki meilisõnum – Tähistab Outlooki meilisõnumit. See Outlookist meilisõnumite toomine tegevus täidab need muutujad.

Outlooki andmetüübi atribuudid

Terminal

• Terminali seanss – Sisaldab terminaliseanssi, mis on loodud teenuse kaudu Ava terminaliseanss tegevus.

Terminali andmetüübi omadused

XML

• XML-sõlm – Sisaldab XML-dokumendi sisu. See Loe XML-i failist tegevus täidab need muutujad.

XML-andmetüübi omadused

Tõrge

• Viga – Sisaldab teavet töölaua voos viimase ilmnenud vea kohta. See Hankige viimane viga toiming loob seda tüüpi muutuja.

Vea omadused