Partajați prin

Tipurile de date ale variabilelor

  • Articol

Când creați variabile în fluxurile dvs., Power Automate le convertește într-un anumit tip pe baza conținutului lor.

Unele dintre aceste tipuri de date sunt utilizate pe scară largă în întreaga aplicație, cum ar fi numerele, în timp ce altele, cum ar fi instanțele de browser, necesită acțiuni explicite sau grupuri de acțiuni.

Tipuri simple de date

Tipurile de date simple reprezintă valori individuale, cum ar fi texte și numere. Puteți utiliza aceste tipuri de date în mod independent sau le puteți utiliza pentru a crea structuri de date mai complexe, cum ar fi liste și tabele de date.

Valoare text

Acesta este orice fel de text, de la adrese de e-mail la conținutul text al unui fișier .txt.

Proprietățile tipului de date text

Pentru a crea o variabilă Valoare text , utilizați acțiunea Setare variabilă și completați parametrul de intrare cu textul dorit fără orice notatie.

Captură de ecran a unei acțiuni Setare variabilă care creează o variabilă de valoare Text.

Valoare numerică

Numeric este tipul aplicat numerelor. Numai acest tip de date poate fi folosit în operații matematice.

Pentru a crea o variabilă Valoare numerică , utilizați acțiunea Setare variabilă și completați parametrul de intrare cu un număr fără niciun număr. notaţie.

Cu excepția valorilor numerice codificate, puteți utiliza expresii matematice cu variabile în semne procentuale. Pentru mai multe informații despre expresiile matematice, accesați Utilizați variabile și notația %.

Captură de ecran a unei acțiuni Setare variabilă care creează o variabilă cu valoare numerică.

Valoare booleană

Valoarea poate fi fie Adevărat sau Fals.

Pentru a crea o variabilă Valoare booleană , utilizați acțiunea Setare variabilă și completați parametrul de intrare cu expresiile %True% sau %False%.

În plus, puteți crea expresii complexe folosind operatori logici, variabile și notația procentuală. Pentru mai multe informații despre expresiile logice, accesați Utilizați variabile și notația %.

Captură de ecran a unei acțiuni Setare variabilă care creează o variabilă cu valoare booleană.

Tipuri avansate de date

Tipurile avansate de date reprezintă structuri complexe de date. Ele funcționează ca colecții de alte tipuri de date pe care le puteți accesa ca o singură entitate.

Listă

Listele sunt colecții de articole. În funcție de tipurile elementelor individuale ale listei, pot exista liste de valori text, liste de valori numerice și așa mai departe. Tipul de date listă este echivalentul unui tablou cu o singură dimensiune în termeni de programare.

Puteți crea o listă prin acțiunea Creați o nouă listă și adăugați un articol la acea listă prin Adăugați un articol în listă actiune.

Captură de ecran a unui flux care creează o listă.

De asemenea, puteți crea o listă prin acțiuni care generează liste ca rezultat. De exemplu, acțiunea Citiți textul din fișier poate returna o listă de valori de text și Obțineți fișiere în dosar acțiune returnează o listă de fișiere.

Pentru a prelua un anumit articol dintr-o listă, utilizați următoarea notație: %VariableName[ItemNumber]%

În exemplul de mai jos, fluxul stochează primul număr din lista afișată anterior într-o nouă variabilă. Rețineți că indexul ar trebui să fie 0 pentru primul element al listei.

Captură de ecran a unei expresii care accesează primul element al unei liste.

O practică obișnuită este să folosiți o Pentru fiecare acțiune pentru a repeta prin elementele unei liste.

Dacă trebuie să accesați doar o anumită parte a unei liste, utilizați notația %VariableName[StartIndex:StopIndex]% . De exemplu, expresia %List[2:4]% preluează al treilea și al patrulea element din listă. Elementul din poziția StopIndex este limita tăierii și nu este preluat.

Pentru a tăia o listă de la început la un anumit articol, nu setați o valoare StartIndex , de exemplu, %List[:4] %. Pentru a tăia o listă de la un anumit index până la sfârșit, nu setați o valoare StopIndex , de exemplu, %List[2:] %.

Listați proprietățile tipului de date

Tabel de date

Tabelele de date conțin date într-o formă tabelară și sunt echivalentul marilor bidimensionale în termeni de programare.

Un tabel de date conține rânduri și coloane care descriu în mod unic poziția fiecărui element. Tabelele de date pot fi considerate liste care conțin rânduri de date ca elemente.

Captură de ecran a conținutului unei variabile datatable.

Power Automate furnizează acțiunea Creați un nou tabel de date pentru a genera noi tabele de date. După implementarea acțiunii, puteți utiliza generatorul vizual pentru a popula valori și pentru a redenumi antetele coloanei.

Captură de ecran a constructorului vizual al acțiunii Creare tabel de date nou.

Pe lângă acțiunea Creați un tabel de date nou , alte trei acțiuni produc tabele de date pentru a stoca datele extrase: Citiți din foaia de lucru Excel, Executați instrucțiunea SQL, și Extrageți date din acțiunile de pe pagina web .

În plus, puteți crea un tabel de date utilizând acțiunea Setare variabilă și notația matricei de programare. Această notație constă din mai multe matrice unidimensionale separate prin virgule și cuprinse între paranteze. Expresia finală trebuie să aibă următoarea formă: %{['Product1', '10 USD'], ['Product2', '20 USD']}%.

Captură de ecran a acțiunii Set variabile care creează un tabel de date.

Dacă doriți să adăugați antete de coloană în timp ce creați un nou tabel de date folosind notația matrice, utilizați expresia ^['ColumnName1', 'ColumnName2'] expresia pentru primul rând.

Captură de ecran a unei acțiuni Setare variabilă care creează un nou tabel de date cu antete de coloană.

Pentru a adăuga un rând nou la un tabel existent, utilizați acțiunea Inserați rând în tabelul de date . Alternativ, creați o expresie care să conțină numele variabilei tabelului de date, un caracter plus (+) și valorile pe care doriți să le adăugați între paranteze.

Captură de ecran a unei acțiuni Setare variabilă care adaugă un nou rând la un tabel de date.

Pe lângă inserarea de rânduri în tabele de date, fluxurile desktop oferă diverse acțiuni care manipulează tabele de date. Puteți găsi o listă completă cu aceste acțiuni în referința acțiunilor variabile.

Pentru a prelua un anumit articol dintr-un tabel de date, utilizați următoarea notație: %VariableName[RowNumber][ColumnNumber]%. Rețineți că RowNumber și ColumnNumber ar trebui să fie 0 pentru primul articol (rând sau coloană).

De exemplu, să presupunem că un flux preia conținutul unei foi de lucru Excel și îl stochează în variabila ExcelData . Pentru a accesa prima celulă de pe al doilea rând al tabelului preluat, utilizați expresia afișată mai jos.

Captură de ecran a unei expresii care accesează a doua celulă a primului rând a unui fișier Excel citit.

Notă

Variabila ExcelData conține un tabel de valori extras dintr-o foaie de lucru Excel folosind acțiunea Citire din foaia de lucru Excel . Conține unele valori ale unei anumite foi de lucru și nu întregul fișier Excel.

Dacă doriți să accesați o anumită coloană dintr-un datatable care conține anteturi de coloană, utilizați notația %ExcelData[rowNumber]['ColumnName']% .

Dacă parcurgeți un tabel de date cu o acțiune For Each , variabila care conține datele iterației curente este considerată a fi o linie de date.

În mod similar listelor, utilizați notația %VariableName[StartRow:StopRow]% pentru a accesa o anumită parte a unui tabel de date. Expresia preia numai rândurile definite de cei doi indici, în timp ce poziția StopRow este limita de delimitare și nu este preluată.

Pentru a împărți un tabel de date de la primul rând pe un anumit rând, nu utilizați o valoare StartRow , de exemplu, %Datatable[:4 ]%. De asemenea, pentru a împărți un tabel de date de la un anumit rând până la sfârșit, nu utilizați o valoare StopRow , de exemplu, %Datatable[2 :]%.

Proprietățile tipului de date din tablele de date

Rând de date

Un rând de date conține valorile unui singur rând al unui tabel de date. Când parcurgeți un tabel de date cu o acțiune For Each , variabila care conține datele iterației curente este o linie de date.

Pentru a prelua un anumit articol dintr-un rând de date, utilizați următoarea notație: %VariableName[ItemNumber]%

Alternativ, puteți utiliza notația %VariableName['ColumnName']% . Numele fiecărei coloane este definit de tabelul de date din care ați preluat rândul de date.

Proprietățile tipului de date Datarow

Captură de ecran a conținutului unei variabile de rând de date.

Obiect particularizat

Conține perechi de proprietăți și valori, care pot fi ușor convertite în format JSON.

Pentru a crea un nou Obiect personalizat, utilizați acțiunea Setare variabilă și completați următoarea expresie %{{ }}%. Pentru a crea un nou obiect particularizat și a-l inițializa cu proprietăți și valori, utilizați o expresie a următoarei structuri: %{ 'Property1': 'Value1', 'Property2': 'Value2', 'Property3': 'Value2' }%.

Captură de ecran cu Setare acțiune variabilă care creează un nou obiect particularizat.

Important

Cuvintele cheie rezervate nu pot fi utilizate ca proprietăți ale obiectelor personalizate. Pentru lista completă a cuvintelor cheie rezervate, accesați Cuvinte cheie rezervate în fluxurile desktop.

Pentru a actualiza valoarea unei proprietăți existente sau pentru a adăuga una nouă, implementați o acțiune Setare variabilă , populați numele proprietății în câmpul Set și introduceți valoarea acesteia în câmpul Către .

Captură de ecran a unei acțiuni Setare variabilă care adaugă o proprietate nouă la un obiect particularizat.

În afară de valorile literale, puteți utiliza variabile pentru a seta dinamic proprietățile și valorile obiectelor personalizate. De exemplu, următorul flux utilizează două variabile pentru a adăuga o proprietate nouă la un nou obiect particularizat gol.

Captură de ecran a unui flux care utilizează variabile pentru a adăuga o proprietate nouă la un obiect particularizat.

Obiect conector

Obiectele conector stochează informații de la conectorii cloud și funcționează similar cu obiectele particularizate. Proprietățile lor conțin de obicei liste de alte obiecte conector. Accesarea valorilor funcționează la fel ca în cazul obiectelor particularizate, deși accesarea valorilor imbricate poate necesita expresii mai complicate.

Captură de ecran a unei variabile de obiect particularizat în vizualizatorul de variabile.

Lista informațiilor despre tabelul PDF

O variabilă a acestui tip de date poate fi produsă numai prin acțiunea Extragere tabele din PDF .

Fiecare element din listă descrie un tabel extras și oferă toate informațiile esențiale despre acesta. Pentru a accesa un anumit element de informații din tabelul de date, utilizați notația %NumeVariabilă[ItemNumber]%.

Captură de ecran a unei liste de informații despre tabelul PDF.

Fiecare element din listă oferă patru proprietăți care vă permit să obțineți un anumit detaliu în mod independent. Proprietățile disponibile sunt următoarele:

  • DataTable – Returnează tabelul extras.
  • TableStartingPage – Returnează indexul paginii de fișier care conține începutul tabelului.
  • TableEndingPage – Returnează indexul paginii de fișier care conține sfârșitul tabelului.
  • TableOrderInPage – Returnează ordinea tabelului în pagină.

Puteți găsi mai multe informații despre proprietățile acestui tip de date în Proprietăți tip de date variabile.

Captură de ecran cu proprietățile unei liste de informații despre tabelul PDF.

Pentru a accesa valoarea unei anumite proprietăți, utilizați %VariableName[ItemNumber]. PropertyName% notație. De exemplu, următoarea expresie returnează valoarea tabelului de date pentru primul element al variabilei ExtractedPDFTables .

Captură de ecran a tabelului de date conținut într-o listă de variabile cu informații despre tabelul PDF.

Probleme și limitări cunoscute

  • Problemă: Când un tabel de date sau o celulă de rând de date conține o intrare cu mai multe linii, vizualizatorul de variabile afișează numai prima linie a acesteia.
  • Soluții: Niciuna.

Instanțe

Conexiuni

Alții

Această secțiune prezintă toate tipurile de date disponibile care nu aparțin niciunei dintre categoriile anterioare.

Valoare generală

  • Valoare generală – Acest tip de date este utilizat în timpul proiectării când Power Automate nu poate defini tipul de date al unei variabile sau al unui parametru de intrare. Valorile generale sunt convertite în alte tipuri de date în timpul rulării pe baza datelor lor.

Active Directory

  • Intrarea Active Directory – Conține o conexiune la un server Active Directory stabilită prin acțiunea Conectare la server .
  • Informații grup – Conține numele, numele afișat, o descriere și membrii unui grup Active Directory specificat.
  • Membru al grupului – Reprezintă un membru al unui grup Active Directory specificat.
  • Informații utilizator – Conține informații despre un utilizator Active Directory specificat, cum ar fi primul și nume de familie, inițiale și un nume distinctiv, detalii despre serviciu (companie, departament și titlu), informații de contact (număr de telefon, extensie)., și e-mail) și locație (țară/regiune, oraș, stat, adresă stradală și cod poștal).

Proprietățile tipului de date Active Directory

Servicii web Amazon (AWS)

  • Client EC2 – Conține o sesiune EC2 creată prin acțiunea Creează sesiune EC2 .
  • EC2 instance – Reprezintă o instanță EC2 preluată.
  • EC2 instances info – Conține informații despre o instanță EC2.
  • Modificarea stării instanței – Conține informații despre o instanță EC2 care a fost pornită sau oprită.
  • EBS snapshot – Reprezintă un snapshot EBS.
  • Volum EBS – Reprezintă un volum EBS.

Proprietățile tipului de date AWS

Azure

  • Client Azure – Conține o sesiune Azure creată prin acțiunea Creare sesiune .
  • Grup de resurse Azure – Reprezintă un grup de resurse Azure preluat.
  • Disc gestionat Azure – Reprezintă un disc Azure preluat.
  • Azure snapshot – Reprezintă un instantaneu Azure.
  • Mașină virtuală Azure – Reprezintă o mașină virtuală Azure preluată.
  • Informații despre mașina virtuală Azure – Conține informații despre o mașină virtuală Azure.
  • Abonament Azure – Reprezintă un abonament Azure preluat.

Proprietățile tipului de date Azure

CMD

  • Sesiune CMD – Conține o sesiune CMD creată prin acțiunea Deschidere sesiune CMD .

Proprietățile tipului de date CMD

Date și ora

  • Datetime – Conține informații despre dată și oră. Pentru a crea o variabilă dată și oră prin acțiunea Setare variabilă , completați parametrul de intrare cu expresiile %d"aaaa-LL-zz HH:mm:ss .ff+zzz"%, unde:

    Notaţie Descriere
    yyyy An
    MM Luna
    dd Ziua
    HH Oră
    mm Minute
    ss Secunde
    ff Milisecunde
    zzz Decalaj UTC

    De exemplu, %d"2022-03-25"% atribuie data de 25 martie 2022 variabilei țintă.

Date și proprietăți ale tipului de date de oră

Poştă electronică

  • Mesaj de e-mail – Reprezintă un mesaj de e-mail. Acțiunea Preluare e-mailuri populează aceste variabile.

Proprietățile tipului de date de e-mail

Exchange

  • Mesaj de e-mail Exchange – Reprezintă un mesaj de e-mail preluat de pe un server Exchange. Acțiunea Preluare mesaje de e-mail Exchange populează aceste variabile.

Schimbați proprietăți ale tipului de date

Fișiere și foldere

  • Fișier – Reprezintă un fișier.
  • Folder – Reprezintă un folder.
  • FileSystemObject – Reprezintă fie un folder, fie un fișier. Acest tip de date este utilizat în parametrii de intrare care acceptă foldere și fișiere.

Proprietățile tipului de date ale fișierelor și folderelor

FTP

  • Fișier FTP – Reprezintă un fișier FTP.
  • Director FTP – Reprezintă un director FTP

Proprietățile tipului de date FTP

OCR

  • Motor OCR – Conține un motor OCR creat prin acțiunea Creare motor OCR .

Outlook

  • Mesaj de e-mail Outlook – Reprezintă un mesaj de e-mail Outlook. Acțiunea Preluare mesaje de e-mail din Outlook populează aceste variabile.

Proprietățile tipului de date Outlook

Terminal

  • Sesiune terminal – Conține o sesiune terminal creată prin acțiunea Deschidere sesiune terminal .

Proprietățile tipului de date ale terminalului

XML

  • Nodul XML – Conține conținutul unui document XML. Acțiunea Citire XML din fișier populează aceste variabile.

Proprietățile tipului de date XML

Eroare

  • Eroare – Conține informații despre ultima eroare apărută în fluxul desktop. Acțiunea Obține ultima eroare creează acest tip de variabilă.

Proprietăți de eroare